Dynamics

Dynamics 365 Business Central

Microsoft Dynamics 365 Business Central je cloudový podnikový systém od společnosti Microsoft. Integrace umožňuje automatický export přijatých faktur z Alice přímo do Dynamics, včetně automatického párování dodavatelů, správy příloh a práce s více měnami.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) Alice se přihlásí do Microsoft Identity Platform pomocí OAuth 2.0 Client Credentials Flow a získá access token. S tímto tokenem vytvoří v Dynamics nákupní fakturu (Purchase Invoice), připojí položky a komentář, a nahraje přílohy. Po úspěšném zápisu se v Alici doklad přesune do stavu Exportovaný, při chybě do stavu Chyba -- viz Diagnostika. Přehled všech stavů viz Stavy dokumentů.

Schéma datového toku

graph LR
    A[Alice] -->|doklad| B[Dynamics 365 BC]
    B -.->|potvrzení| A

Podporované verze a předpoklady

Oblast	Požadavek
Aplikace	Microsoft Dynamics 365 Business Central (cloud, environment `production`)
Autentizace	OAuth 2.0 (Client Credentials Flow) přes Azure Active Directory
Azure AD	Tenant ID (Authority) -- získáte od správce Azure prostředí
Aplikační registrace	Redque enterprise app musí mít přístup k vašemu tenantu (požádejte správce)
Síť	Žádné speciální požadavky -- vše je cloud-to-cloud
Můstek	Není potřeba

Podporované přenosy


Česká přijatá faktura	Podporováno
	Přenesená daňová povinnost	Podporováno
	Zálohová faktura	Podporováno
	Dobropis	Podporováno
Vydané faktury	Nepodporováno
Účtenka	Nepodporováno

Postup napojení

Kroky, které jsou potřeba k úspěšnému napojení:

Připravte si účetní jednotky

Je nutné mít vytvořenou účetní jednotku.
Vytvořte napojení na Dynamics

Přidejte novou definici exportu typu Dynamics.

Podporované typy dokumentů

Integrace s Dynamics 365 Business Central podporuje následující typy dokumentů:

Typ dokumentu	Agenda v Dynamics	Popis
Česká přijatá faktura	Nákupní faktury (Purchase Invoices)	Faktury od dodavatelů

Podporované varianty dokladů

Varianta	Podpora
Zálohové faktury	Podporováno
Dobropisy	Podporováno
Přenesená daňová povinnost (reverse charge)	Podporováno

Nepodporované typy

V současné době integrace nepodporuje export vydaných faktur, slovenských faktur a účtenek.

Vytvoření integrace

V nastavení na kartě Integrace přidejte Dynamics 365 Business Central.

Podrobný postup, jak vytvořit integraci pro účetní systémy, naleznete v části Integrace.

Konfigurace

Nová definice importu

Popis polí

Název pole	Popis pole
Název	Vlastní název exportu
Typ	Dynamics
Účetní jednotka¹	Účetní jednotka, do které budou dokumenty importovány
Adresa	Adresa serveru (https://api.businesscentral.dynamics.com)
Název společnosti	Vaše společnost v Dynamics
Autorita	Microsoft tenant

Autentizace

Připojení k Dynamics 365 Business Central využívá protokol OAuth 2.0 prostřednictvím Azure Active Directory (Client Credentials Flow). Přihlašovací údaje pro připojení zadáváte při vytváření integrace v Alice.

Azure AD tenant

V poli Autorita zadejte identifikátor vašeho Microsoft tenanta (Azure AD). Tento identifikátor získáte od správce vašeho Azure prostředí.

Synchronizace číselníků

Alice umožňuje jednosměrně (Dynamics -> Alice) synchronizovat hodnoty číselníků. Synchronizace zajišťuje, že máte v Alice k dispozici aktuální hodnoty z vašeho účetního systému.

Číselník	Popis	Použití
Předkontace - Přijaté faktury	Účty pro přiřazení nákladů na řádcích faktur (pouze účty typu Expense)	Doklad i položka
Členění DPH	Daňové skupiny z Dynamics pro klasifikaci DPH	Doklad

Synchronizace

Číselníky doporučujeme synchronizovat po vytvoření integrace a následně vždy, když dojde ke změně hodnot v Dynamics.

Mapování polí dokumentu

Pro správný export dokladu do Dynamics je potřeba nastavit mapování vlastních polí v Alice. Tato pole určují, jak bude dokument zaúčtován.

Povinná pole

Pole	Popis
Předkontace	Účet pro přiřazení nákladů na řádcích faktury. Synchronizuje se z Dynamics (pouze účty kategorie Expense) - POVINNÉ POLE

Volitelná pole

Pole	Popis
Členění DPH	Daňová skupina pro klasifikaci DPH na řádcích faktury

Automaticky přenášená pole

Následující pole se přenášejí automaticky z dokumentu v Alice do Dynamics:

Pole	Popis
Datum vystavení	Datum vystavení z dokumentu
Datum splatnosti	Datum splatnosti z dokumentu
Datum zdanitelného plnění	Datum zdanitelného plnění
Číslo faktury	Číslo faktury dodavatele (max 35 znaků)
Měna	Kód měny (ověřuje se proti číselníku měn v Dynamics)
Poznámka	Poznámka dokumentu (přenese se jako komentářový řádek, max 100 znaků)

Nastavení vlastních polí

Podrobný návod pro nastavení mapování vlastních polí najdete v sekci Vlastní pole.

Podporované DPH sazby

Sazba	Popis
0%	Osvobozeno od DPH
12%	Snížená sazba
21%	Základní sazba

Pravidla pro DPH

DPH se exportuje pouze v případě, že dodavatel je plátcem DPH a zároveň účetní jednotka je také plátce DPH. Pokud některá z těchto podmínek není splněna, u všech položek se nastaví sazba 0 %.

Práce s dodavateli

Systém automaticky vyhledá dodavatele v Dynamics a přiřadí ho k dokladu:

Vyhledání dodavatele podle DIČ v adresáři Dynamics
Pokud je dodavatel nalezen, přiřadí se k nákupní faktuře
Pokud dodavatel neexistuje, automaticky se vytvoří nový záznam v adresáři Dynamics
Při vytvoření nového dodavatele se přenesou: název firmy, DIČ, adresa, město, PSČ, země a způsob platby

DIČ je povinné

Dodavatel se vyhledává výhradně podle DIČ (Tax Registration Number). Pokud DIČ na dokumentu chybí nebo je neplatné, export se neprovede.

Položky faktury

Export podporuje přenos položek faktury do Dynamics včetně všech detailů:

Název položky (max 100 znaků)
Množství (výchozí hodnota 1, pokud není na dokladu uvedeno)
Měrná jednotka (automaticky se vytvoří, pokud v Dynamics neexistuje)
Cena za jednotku
DPH členění (Tax Code)

Na každém řádku faktury se nastavuje předkontace (účet nákladů), která určuje, kam budou náklady zaúčtovány.

Poznámka dokumentu

Poznámka z dokumentu se exportuje jako komentářový řádek faktury (max 100 znaků).

Podpora měn

Integrace podporuje práci s více měnami. Kód měny na dokumentu se ověřuje proti číselníku měn v Dynamics.

Příklady podporovaných měn: CZK, EUR, USD, CHF, GBP, HUF, PLN, NOK, RON, AUD, DKK, SEK, ISK, CAD, INR a další.

Neexistující měna

Pokud měna uvedená na dokumentu neexistuje v číselníku měn ve vašem Dynamics, export se neprovede. Zkontrolujte, zda máte v Dynamics nastaveny všechny měny, které používáte.

Přílohy dokumentů

K dokladu v Dynamics se automaticky připojí originální dokument z Alice a všechny jeho přílohy. Soubory se nahrají jako přílohy nákupní faktury v Dynamics.

Ukázka exportu

Dynamics vendor Dynamics invoice

Po úspěšném exportu

Po úspěšném exportu dokumentu do Dynamics 365 Business Central:

Alice obdrží identifikátor dokladu z Dynamics
Dokument je spárován s nákupní fakturou v Dynamics
V detailu dokumentu v Alice se zobrazí informace o provedeném exportu

Diagnostika

Při chybě se dokument v Alici přesune do stavu error Chyba s detailem v náhledu.

Authentication failed (OAuth)

Příčina: Neplatné Azure AD Tenant ID (Authority), nebo Redque enterprise app nemá přístup k vašemu tenantu.

Řešení: Ověřte správnost Tenant ID v nastavení integrace. U Azure správce nechte schválit oprávnění Redque aplikace pro váš tenant.

companyNotFound

Příčina: V Dynamics neexistuje společnost (company) s názvem zadaným v poli Název společnosti.

Řešení: V nastavení integrace zkontrolujte přesný název společnosti -- musí odpovídat hodnotě v Dynamics Business Central.

currencyNotFound

Příčina: Měna na dokumentu (např. USD) není v číselníku měn vašeho Dynamics.

Řešení: V Dynamics doplňte chybějící měnu, nebo upravte dokument na podporovanou měnu.

supplierVatIdMissing / DIČ je povinné

Příčina: Dokument nemá vyplněné DIČ (nebo má méně než 2 znaky).

Řešení: Doplňte DIČ dodavatele -- v Dynamics se podle něj vyhledává/vytváří dodavatel.

invoiceCreationFail

Příčina: Dynamics odmítlo vytvořit fakturu (chybí povinné pole, neplatná předkontace, ...).

Řešení: Zkontrolujte detail chyby v náhledu dokumentu. Často pomůže ověřit synchronizaci číselníků a doplnit Předkontaci.

Časté dotazy | FAQ

Jak se přihlašuje Alice do Dynamics?

Připojení využívá protokol OAuth 2.0 prostřednictvím Azure Active Directory. Přihlašovací údaje a identifikátor tenanta zadáváte při konfiguraci integrace v Alice.

Jaké typy dokumentů mohu exportovat?

V současné době integrace podporuje export českých přijatých faktur (včetně zálohových faktur, dobropisů a dokladů s přenesenou daňovou povinností). Vydané faktury, slovenské faktury a účtenky nejsou podporovány.

Jak se vyhledávají dodavatelé v Dynamics?

Systém automaticky vyhledá dodavatele podle DIČ v adresáři Dynamics. Pokud dodavatel neexistuje, automaticky se vytvoří nový záznam včetně názvu firmy, adresy a způsobu platby. DIČ na dokumentu musí být vyplněno, jinak export nelze provést.

Co se stane, když v Dynamics neexistuje potřebná měrná jednotka?

Systém automaticky vytvoří novou měrnou jednotku v Dynamics, pokud ještě neexistuje.

Můžu exportovat faktury v cizích měnách?

Ano, integrace podporuje více měn (CZK, EUR, USD, GBP a další). Kód měny se ověřuje proti číselníku měn v Dynamics. Pokud měna v Dynamics neexistuje, export se neprovede.

Je potřeba předkontace pro každý dokument?

Ano, předkontace (účet nákladů) je povinné pole pro správný export dokladu do Dynamics. Bez předkontace nelze dokument exportovat. Předkontace se synchronizuje z Dynamics a obsahuje pouze účty kategorie Expense.

Přenáší se do Dynamics i přílohy dokumentu?

Ano, k dokladu v Dynamics se automaticky připojí originální dokument a všechny jeho přílohy z Alice.

Jak funguje DPH při exportu?

DPH se exportuje pouze v případě, že dodavatel je plátcem DPH a zároveň účetní jednotka je také plátce DPH. V opačném případě se u všech položek nastaví sazba 0 %. Podporované sazby jsou 0 %, 12 % a 21 %.

Dostupné pouze, pokud pracujete s účetními jednotkami. ↩