EDI Bridge#

Popis funkcionality#

Rozšíření EDI Bridge zajišťuje elektronickou výměnu obchodních dokladů (EDI – Electronic Data Interchange) mezi Microsoft Dynamics 365 Business Central a obchodními partnery prostřednictvím poskytovatele EDI služeb Editel a jeho platformy Orion. Rozšíření pokrývá celý cyklus EDI komunikace – příjem objednávek od zákazníků, automatické vytváření prodejních dokladů v BC a odesílání zpracovaných dokladů (potvrzení objednávky, dodacího listu, faktury) zpět partnerovi.

Komunikace probíhá výhradně formou XML zpráv ve formátu odpovídajícím standardu Editel. Rozšíření nevyžaduje žádné externí komponenty ani middleware – veškerá komunikace s Orion API probíhá přímo z Business Central přes standardní HTTP volání.

Podporované typy zpráv#

Kód	Název	Směr	Popis
ORDERS	Objednávka	Příchozí	Nákupní objednávka zákazníka → Prodejní objednávka v BC
ORDRSP	Potvrzení objednávky	Odchozí	Potvrzení přijaté objednávky zákazníkovi
DESADV	Avízo o dodávce	Odchozí	Avízo o expedici zásilky (ze zaúčtované prodejní dodávky)
INVOIC	Faktura	Odchozí	Odeslání zaúčtované prodejní faktury zákazníkovi

---

Nastavení (jednorazové, před prvním použitím)#

Nastavení EDI komunikace#

Otevřete kartu Nastavení EDI komunikace (EDI Setup NTC). Kartu najdete vyhledáním v Business Central nebo přes příslušné menu.

Karta obsahuje tři sekce:

Obecné:

Pole	Popis
Ověřit odchozí zprávu	Pokud je zapnuto, systém před odesláním ověří, zda vygenerovaný XML soubor je formálně správně strukturovaný. Doporučeno ponechat zapnuto.
Automatické odesílání dokumentů EDI	Pokud je zapnuto, odchozí zprávy se odesílají automaticky ihned po zaúčtování zdrojového dokladu nebo po uvolnění prodejní objednávky. Bez tohoto zapnutí je nutné zprávy odesílat ručně ze seznamu odchozích zpráv.
EAN společnosti	EAN kód vaší společnosti přidělený v rámci registrace u EDI poskytovatele.
Číslo dodavatele EDI	Interní kód poskytovatele EDI služeb.

Licence:

Do pole Licenční kód zadejte kód Vaší licence. Bez licenčního kód je rozšíření EDI komunikace možné vužívat jej pro zkušební účely a odeslat 10 EDI zásilek za rok. Pro získání kódu se obraťte na helpdesk@navitec.cz.

Orion (API připojení):

Client Id a Client Secret vám poskytne váš správce Orion účtu (generují se v Orion webovém portálu). URL adresy jsou standardní pro prostředí Orion od Editel a jsou předvyplněny níže.

Pole	Hodnota / Popis
Orion Token URL	https://orion.grit.eu/gateway/oauth/token
Orion Client Id	Identifikátor klienta z Orion webového portálu (specifický pro každého zákazníka).
Orion Client Secret	Tajný klíč z Orion webového portálu. Hodnota je v rozhraní maskována.
Orion Upload URL	https://orion.grit.eu/gateway/api/public/v1/package
Orion Incoming List URL	https://orion.grit.eu/gateway/api/public/v1/package
Orion Incoming Download URL	https://orion.grit.eu/gateway/api/public/v1/package/%1
Orion Incoming Confirm URL	https://orion.grit.eu/gateway/api/public/v1/package/%1/confirm

%1 v URL adresách je zástupný symbol, který systém automaticky nahradí identifikátorem konkrétní zprávy při volání Orion API — vyplňte URL přesně jak je uvedeno výše.

Nastavení EDI správce#

Některé funkce jsou dostupné jen pro EDI správce. Takový uživatel má v nastavení uživatelů aktivní příznak EDI správce.

Registrace aplikace v Orion EDI#

Před vyplněním Client Id a Client Secret je nutné vygenerovat API klíče v portálu Orion EDI. Přihlaste se do aplikace Orion EDI a v sekci Uživatelská zóna → API klíče přidejte nový klíč.

Po přidání klíče systém zobrazí vygenerované hodnoty – Client Id a Client Secret. Zkopírujte je do odpovídajících polí v Nastavení EDI komunikace.

Client Secret lze zobrazit pouze bezprostředně po vygenerování. Po zavření dialogu jej nelze znovu zobrazit – uložte si ho na bezpečné místo před zavřením okna.

---

Číselník EDI zpráv#

Číselník EDI zpráv definuje, které typy zpráv systém zpracovává a jak. Otevřete seznam Zprávy EDI (EDI Message List NTC).

Pro každý typ zprávy je nutné vyplnit kartu:

Pole	Popis
Kód	Kód zprávy (např. ORDERS, ORDRSP, DESADV, INVOIC).
Poskytovatel	EDI poskytovatel – aktuálně podporován Editel.
Směr	Příchozí nebo Odchozí (z pohledu BC).
Popis	Volný popis zprávy pro přehlednost.
ID objektu	ID codeunit, která zprávu zpracovává nebo generuje. Vyplňuje se vývojářem při implementaci.
Název objektu	Automaticky vyplněný název codeunit (jen pro zobrazení).
Záložka Export (pouze odchozí)
Použít mezinárodní standardní kód	Zajistí použití mezinárodního standardu kódů v XML (např. UN/ECE pro měrné jednotky).
ID tabulky	Číslo tabulky, ze které se vytváří odchozí XML (zaúčtované faktury, dodávky, dobropisy…).
Název tabulky	Automaticky vyplněný název tabulky.
Záložka Editel (pouze Editel)
Název zprávy	Název pro pojmenování XML souboru (např. INVOIC, DESADV).

---

EDI partneři#

Aby systém věděl, se kterými zákazníky/dodavateli/lokacemi komunikuje přes EDI, je nutné nastavit EDI partnery. Otevřete seznam EDI partneři (EDI Partners NTC).

Pro každého EDI partnera vyplňte:

Pole	Popis
Odkaz na tabulku	Zákazník, Dodavatel nebo Lokace – s kým je partner svázán.
Číslo	Číslo zákazníka / dodavatele / lokace z BC.
Kód adresy pro dodání/objednávky	Pokud partner využívá různé adresy dodání (Ship-to Address), vyplňte konkrétní kód. Jinak ponechte prázdné.
EAN partnera	EAN kód obchodního partnera pro identifikaci v EDI komunikaci.
Výchozí umístění EDI	Výchozí sklad (Location) pro příchozí objednávky tohoto partnera.

Vztahy EDI partnera (přiřazení zpráv)#

Na kartě partnera nebo přes akci Partner otevřete seznam vztahů – zde přiřadíte, které typy zpráv jsou pro daného partnera aktivní.

Pole	Popis
Odkaz na tabulku	Zákazník / Dodavatel / Lokace.
Číslo	Číslo zákazníka/dodavatele/lokace.
Kód zprávy	Kód zprávy z číselníku EDI zpráv (např. ORDERS, INVOIC…).

Kódy typů zpráv stačí přiřadit partnerovi na úrovni centrály. Typy zpráv pro pobočky (Ship-to adresy) nelze definovat odděleně – pobočky automaticky dědí nastavení centrály.

---

Příchozí zprávy (Incoming)#

Jak importovat prodejní objednávky do systému#

Objednávky zákazníků přicházejí jako EDI zprávy formátu ORDERS a lze je do BC dostat dvěma způsoby:

Způsob 1 – Import přes Orion API (standardní provoz)

1. Otevřete stránku Příchozí EDI zprávy.
2. Klikněte na akci Import z ORION.
3. Systém se automaticky připojí k Orion, stáhne všechny nové zprávy čekající ve frontě a každou okamžitě zpracuje.
4. Po úspěšném vytvoření prodejní objednávky v BC systém zprávu v Orion potvrdí (confirm).
5. Ve sloupci ID dokumentu uvidíte číslo vytvořené prodejní objednávky.
6. Klikněte na akci Otevřít dokument pro přechod přímo na objednávku.

Způsob 2 – Ruční import ze souboru (výjimečné případy, testování)

1. Otevřete stránku Příchozí EDI zprávy.
2. Klikněte na akci Import ze souboru.
3. V dialogovém okně vyberte XML soubor ORDERS z vašeho počítače a potvrďte.
4. Systém soubor uloží, vytvoří nový záznam a okamžitě ho zpracuje stejným způsobem jako při importu z Orion.

Co se stane po importu

Po příjmu zprávy (oběma způsoby) systém automaticky:

• ověří, že XML je formálně platný dokument,
• dohledá zákazníka podle EAN partnera v číselníku EDI partnerů,
• vytvoří prodejní objednávku se všemi řádky, množstvím, cenami a datumovými údaji z XML,
• nastaví stav záznamu na Úspěch.

Pokud import skončí chybou

Záznam přejde do stavu Chyba a příčina je popsána v poli Popis. Nejčastější příčiny:

• zákazník s daným EAN není nastaven v číselníku EDI partnerů,
• XML soubor má neplatnou strukturu nebo chybějící povinný element,
• kód zprávy ORDERS není v číselníku EDI zpráv.

Po odstranění příčiny spusťte zpracování znovu akcí Zpracovat.

Seznam příchozích EDI zpráv#

Otevřete Příchozí EDI zprávy (EDI Incoming Message Entries NTC).

Sloupec	Popis
Kód zprávy	Typ příchozí zprávy (např. ORDERS).
Soubor zprávy	Zaškrtnuto = XML soubor byl uložen do systému.
Název souboru	Název importovaného XML souboru.
Datum/čas vytvoření	Kdy byla zpráva přijata.
Stav	Aktuální stav zpracování (viz níže).
Popis	Chybová zpráva (při stavu Chyba) nebo informace o zrušení.
Datum/čas zpracování	Kdy proběhlo poslední zpracování.
Typ zdroje	Zákazník / Dodavatel / Lokace.
Číslo zdroje	Číslo zákazníka/dodavatele, ze kterého zpráva pochází.
ID dokumentu	Typ a číslo vytvořeného dokladu v BC.
ID dokumentu odesílatele	Číslo objednávky zákazníka (referenční číslo partnera).
Délka souboru	Velikost importovaného souboru.

Stavy příchozí zprávy#

Stav	Popis
(prázdný)	Nová zpráva, dosud nezpracována.
Zpracovává se	XML byl ověřen a probíhá import do BC.
Úspěch	Doklad byl v BC úspěšně vytvořen.
Chyba	Při importu došlo k chybě – doklad nebyl vytvořen. Příčina je v poli Popis.
Zrušeno	Položka byla ručně zrušena.

Kliknutím na hodnotu ve sloupci Stav se otevře stránka Historie stavů příchozí zprávy se záznamy o všech změnách stavu daného záznamu, včetně přesného data a času každé změny.

Dostupné akce na příchozích zprávách#

Akce	Popis
Import ze souboru	Otevře dialog pro výběr XML souboru z vašeho počítače, vytvoří nový záznam a okamžitě ho zpracuje.
Import z ORION	Stáhne nové zprávy z platformy Orion a ihned je zpracuje.
Dávkové zpracování	Zpracuje všechny existující záznamy ve stavu (prázdný). Používá se jako záchranná funkce, ne pro import souborů.
Zpracovat	Restartuje zpracování záznamu ve stavu Chyba (po opravě příčiny chyby).
Zrušit	Ručně zruší záznam ve stavu Chyba nebo Zpracovává se.
Nastavit jako nové	Resetuje stav záznamu na nový (smaže historii stavů) – umožní nové zpracování.
Uložit XML	Stáhne XML soubor zprávy do počítače pro kontrolu nebo manuální opravu.
Otevřít dokument	Otevře prodejní doklad, který byl z dané zprávy vytvořen.
Komunikační Log	Funkce zobrazí HTTP komunikační log pro vybranou EDI zprávu (volání API Orion a odpovědi)
Smazat záznam	Funkce vymaže vybranou EDI zprávu ze seznamu beze stopy. Tlačítko se zobrazí pouze uživateli s nastavením EDI správce

Aktuální stav zprávy i jeho klikatelný detail jsou viditelné přímo v seznamu:

---

Odchozí zprávy (Outgoing)#

Jak odeslat potvrzení objednávky (ORDRSP)#

Zpráva ORDRSP (order response / potvrzení objednávky) se odesílá zákazníkovi po uvolnění prodejní objednávky a potvrzuje přijetí jeho EDI objednávky.

Automatické odeslání (doporučeno)

Pokud je v Nastavení EDI zapnuto Automatické odesílání dokumentů EDI, systém odešle ORDRSP sám okamžitě po uvolnění objednávky akcí Uvolnit – žádný další krok není potřeba. Ve stránce Odchozí EDI zprávy pak uvidíte nový záznam se stavem Odesláno.

Ruční odeslání

Pokud automatické odesílání není zapnuto nebo zpráva skončila chybou:

1. Otevřete stránku Odchozí EDI zprávy.
2. Vyhledejte záznam s kódem zprávy ORDRSP a číslem objednávky v poli ID dokumentu.
3. Klikněte na akci Zpracovat – systém znovu vygeneruje XML a odešle ho do Orion.
4. Ověřte, že stav přešel na Odesláno.

Zákazník musí mít v číselníku Vztahy EDI partnera přiřazen kód zprávy ORDRSP, jinak se záznam nevytvoří. Zároveň platí, že po odeslání ORDRSP nelze prodejní objednávku znovu otevřít (znovu ji uvolnit) – systém to blokuje, protože odpověď zákazníkovi již odešla.

---

Jak odeslat dodací list (DESADV)#

Zpráva DESADV (avízo o dodávce / despatch advice) se odesílá zákazníkovi po zaúčtování prodejní dodávky a informuje ho o expedici zásilky.

Automatické odeslání (doporučeno)

Pokud je v Nastavení EDI zapnuto Automatické odesílání dokumentů EDI, systém odešle DESADV sám okamžitě po zaúčtování dodávky – žádný další krok není potřeba. Ve stránce Odchozí EDI zprávy pak uvidíte nový záznam se stavem Odesláno.

Ruční odeslání

Pokud automatické odesílání není zapnuto nebo zpráva skončila chybou:

1. Otevřete stránku Odchozí EDI zprávy.
2. Vyhledejte záznam s kódem zprávy DESADV a příslušným číslem dodávky v poli ID dokumentu.
3. Klikněte na akci Zpracovat – systém znovu vygeneruje XML a odešle ho do Orion.
4. Ověřte, že stav přešel na Odesláno.

Zákazník musí mít v číselníku Vztahy EDI partnera přiřazen kód zprávy DESADV, jinak se záznam nevytvoří.

---

Jak odeslat prodejní fakturu (INVOIC)#

Zpráva INVOIC se odesílá zákazníkovi po zaúčtování prodejní faktury.

Automatické odeslání (doporučeno)

Pokud je v Nastavení EDI zapnuto Automatické odesílání dokumentů EDI, systém odešle INVOIC sám ihned po zaúčtování faktury. Ve stránce Odchozí EDI zprávy pak uvidíte nový záznam se stavem Odesláno.

Ruční odeslání

Pokud automatické odesílání není zapnuto nebo zpráva skončila chybou:

1. Otevřete stránku Odchozí EDI zprávy.
2. Vyhledejte záznam s kódem zprávy INVOIC a číslem faktury v poli ID dokumentu.
3. Klikněte na akci Zpracovat – systém znovu vygeneruje XML a odešle ho do Orion.
4. Ověřte, že stav přešel na Odesláno.

Zákazník musí mít v číselníku Vztahy EDI partnera přiřazen kód zprávy INVOIC, jinak se záznam nevytvoří.

Pokud odeslání skončí chybou

Záznam přejde do stavu Chyba a příčina je popsána v poli Popis. Nejčastější příčiny:

• chybná nebo nedostupná URL v Nastavení EDI (Orion Upload URL),
• vypršel nebo je neplatný přístupový token (zkontrolujte Orion Client Id a Client Secret),
• XML obsahuje neplatnou strukturu – ověřte nastavení codeunit a mapování tabulky v číselníku zpráv.

Po odstranění příčiny spusťte odeslání znovu akcí Zpracovat. XML soubor lze před opakovaným odesláním stáhnout akcí Uložit XML a zkontrolovat jeho obsah.

---

Jak funguje odesílání zpráv#

Odchozí zprávy (potvrzení objednávky, avízo o dodávce, faktura) se generují automaticky nebo ručně:

• Automaticky: pokud je v nastavení EDI zapnuto Automatické odesílání dokumentů EDI, zprávy se odesílají okamžitě:
  • ORDRSP – po uvolnění (Release) prodejní objednávky, pokud zákazník má přiřazen kód zprávy ORDRSP.
  • DESADV – po zaúčtování prodejní dodávky.
  • INVOIC – po zaúčtování prodejní faktury.
  • Dobropis (Credit Memo) – po zaúčtování prodejního dobropisu.
• Ručně: ze seznamu odchozích zpráv lze kdykoli spustit opakované odeslání nebo vygenerovat nový záznam.

Seznam odchozích EDI zpráv#

Otevřete Odchozí EDI zprávy (EDI Outgoing Message Entries NTC).

Sloupec	Popis
Kód zprávy	Typ odchozí zprávy (ORDRSP, DESADV, INVOIC…).
Soubor zprávy	Zaškrtnuto = XML soubor byl vygenerován.
Název souboru	Název vygenerovaného XML souboru.
Datum/čas vytvoření	Kdy byl záznam vytvořen.
Stav	Aktuální stav odeslání (viz níže).
Popis	Chybová zpráva při stavu Chyba.
Datum/čas odeslání	Kdy bylo odeslání naposledy provedeno.
Typ zdroje	Zákazník / Dodavatel / Lokace.
Číslo zdroje	Číslo zákazníka, pro kterého je zpráva určena.
ID dokumentu	Typ a číslo zdrojového dokladu v BC.

Stavy odchozí zprávy#

Stav	Popis
(prázdný)	Nový záznam, dosud nebyl zpracován.
Chyba	Při generování nebo odesílání XML došlo k chybě.
Zpracovává se	XML byl vygenerován, probíhá odeslání do Orion.
Odesláno	Zpráva byla úspěšně odeslána přes Orion.
Zrušeno	Záznam byl ručně zrušen.

Kliknutím na hodnotu ve sloupci Stav se otevře stránka Historie stavů odchozí zprávy se záznamy o všech změnách stavu, včetně přesného data a času každé změny. Pro záznamy ve stavu Chyba je v popisu stavu uvedena konkrétní chybová zpráva z Orion API.

Dostupné akce na odchozích zprávách#

Akce	Popis
Odeslat/Příjmout	Znovu vygeneruje XML a odešle vybraný záznam do Orion. Používá se po opravě chyby nebo pro první odeslání záznamu ve stavu (prázdný).
Odeslat do ORION	Odešle již vygenerovaný XML soubor do Orion bez jeho opětovného vygenerování. Vhodné pokud XML je správný, ale odeslání selhalo kvůli síťové chybě.
Odeslat do ORION znovu	Znovu vygeneruje XML ze zdrojového dokladu a odešle ho do Orion. Používá se pokud se zdrojový doklad změnil nebo pokud chcete XML zcela přegenerovat.
Vygeneruj odpovědi PO	Hromadně vygeneruje ORDRSP odpovědi pro všechny uvolněné prodejní objednávky importované přes EDI, které dosud nemají odeslanou odpověď zákazníkovi.
Dávkové odeslání a kontrola	Spustí dávkový report pro hromadné odeslání více odchozích zpráv najednou.
Zrušit	Ručně zruší vybraný záznam (nelze zrušit záznamy ve stavu Zpracovává se, Odesláno nebo Zrušeno).
Opravit prázdný stav	Opraví záznamy, které mají vygenerovaný XML soubor, ale chybí jim stavový záznam. Záchranná funkce pro případ neočekávaného přerušení zpracování.
Uložit XML	Stáhne vygenerovaný XML soubor do počítače pro kontrolu obsahu.
Otevřít dokument	Otevře zdrojový doklad v BC (prodejní objednávku, zaúčtovanou dodávku nebo zaúčtovanou fakturu) propojený s daným záznamem.
Komunikační Log	Funkce zobrazí HTTP komunikační log pro vybranou EDI zprávu (volání API Orion a odpovědi)
Smazat záznam	Funkce vymaže vybranou EDI zprávu ze seznamu beze stopy. Tlačítko se zobrazí pouze uživateli s nastavením EDI správce

---

Akce na prodejních dokladech#

Rozšíření přidává tlačítka přímo na stránky prodejních dokladů pro ruční odeslání EDI zpráv nebo korekce:

Prodejní objednávka#

Akce (v menu Funkce)	Popis
EDI Odeslat potvrzení PO	Vygeneruje a odešle ORDRSP (potvrzení objednávky) pro tuto konkrétní prodejní objednávku do Orion. Akci lze spustit pouze jednou – pokud je ORDRSP již odesláno (pole EDI Entry No. Out. ORDRSP je vyplněno), akce hlásí chybu.

Zaúčtovaná prodejní dodávka#

Akce (v menu Funkce)	Popis
Odeslat EDI	Vygeneruje a odešle DESADV (avízo o dodávce) pro tuto zaúčtovanou dodávku do Orion.
Vymazat číslo EDI záznamu	Vymaže číslo záznamu odchozí EDI zprávy pro možnost vygenerovat celou EDI zprávu znovu. Funkce je viditelná pouze správcům EDI.

Zaúčtovaná prodejní faktura#

Akce (v menu Funkce)	Popis
Odeslat EDI	Vygeneruje a odešle INVOIC (fakturu) pro tuto zaúčtovanou fakturu do Orion.
Vymazat číslo EDI záznamu	Vymaže číslo záznamu odchozí EDI zprávy pro možnost vygenerovat celou EDI zprávu znovu. Funkce je viditelná pouze správcům EDI.

Zaúčtovaný prodejní dobropis#

Akce (v menu Funkce)	Popis
Odeslat EDI	Vygeneruje a odešle INVOIC (dobropis) pro tento zaúčtovaný dobropis do Orion.
Vymazat číslo EDI záznamu	Vymaže číslo záznamu odchozí EDI zprávy pro možnost vygenerovat celou EDI zprávu znovu. Funkce je viditelná pouze správcům EDI.

---

Prodejní doklady – rozšíření polí#

Rozšíření přidává do prodejní objednávky a řádků prodeje doplňková pole pro sledování EDI komunikace. Tato pole jsou vyplňována automaticky při importu a nejsou určena pro ruční úpravy.

Prodejní objednávka – záložka EDI NTC#

Ve formuláři prodejní objednávky je dostupná záložka EDI NTC, která zobrazuje základní údaje o zpracování objednávky při importu EDI zprávy.

Prodejní objednávka (záhlaví)#

Pole	Popis
EDI Order Date and Time	Datum a čas objednávky z EDI zprávy.
EDI Line Count	Počet řádků přijatých z EDI objednávky (slouží k ověření při uvolnění).
EDI Imported	Příznak – objednávka byla vytvořena z EDI zprávy.
EDI Import Error	Příznak – jeden nebo více řádků obsahuje chybu importu.
Expedition Date	Požadované datum expedice z EDI zprávy.
Requested Delivery Time	Požadovaný čas dodávky.

Prodejní řádek#

Rozšíření přidává do řádků prodejní objednávky tato pole (zobrazena v subformu objednávky):

Pole	Popis
EDI Required Quantity	Požadované množství z EDI zprávy zákazníka.
EDI Required Price	Požadovaná cena z EDI zprávy zákazníka.
EDI Calculated Price	Cena vypočtená systémem BC na základě EDI zprávy.
EDI Import Status	Stav importu řádku (OK, Nižší cena, Chybí EAN).
EDI Canceled Item	Příznak – zákazník zrušil tento řádek prostřednictvím EDI.

---

Nastavení prodejů a pohledávek#

V nastavení prodejů a pohledávek (Sales & Receivables Setup) přidává rozšíření sekci EDI s těmito poli:

Pole	Popis
Cenová tolerance prodejní objednávky %	Procentuální hranice cenového rozdílu mezi cenou v EDI zprávě a cenou v BC. Při překročení je zobrazen varující stav importu na řádku objednávky.
Číselná řada EDI objednávek	Číselná řada používaná pro přidělování čísel prodejním objednávkám importovaným přes EDI.
Výchozí umístění EDI	Výchozí sklad (Location) pro příchozí EDI objednávky, pokud není nastaveno umístění specifické pro konkrétního EDI partnera.

---

Kontakt#

V případě nejasností kontaktujte technickou podporu na helpdesk(at)navitec.cz