Chybové zprávy a řešení podle balíčku ERP. Tento článek se zabývá chybami specifickými pro každý balíček. Pro obecné problémy s API, webhooky a konektivitou: viz Řešení problémů s integracemi.

Chybové zprávy s předponou U4 pocházejí z Unit4 ERPx. Řešení se téměř vždy nachází na straně softwaru, ne v eConnect. Zákazník může stáhnout soubor XML z platformy a předat ho správci Unit4.

Kompenzace DueDate: Unit4 nemůže zpracovat faktury bez DueDate/PaymentDueDate (pole není v XML povinné). eConnect standardně nastavuje PaymentDueDate na IssueDate (datum faktury) plus 30 dní, když toto pole chybí. Jde o standardní Rule Based Enrichment, konfigurované pro každého zákazníka jako PrivateObject v PSB (typicky s Id unit4-setDueDate-30days).

Faktura zaúčtována, ale chybí příloha PDF: dřívější přerušení připojení na straně Unit4, kde byl PDF ztracen, jsou nyní opakovány (potvrzeno Platform & Integrace, květen 2026). Zbývající případy: viz diagnostická cesta níže.

Tato cesta se vztahuje na stížnosti jako „Zaúčtováno v eConnect, ale neviditelné v ERPx" nebo „Faktura zřejmě nikdy nedorazila, žádná zpráva v Document Journal".

Kontext: Trasa Autopilot -- Unit4 ERPx je idempotentní (shoda na číslo faktury + zákazník + dodavatel). Při shodě není ERPx znovu volán a nahraje se pouze chybějící PDF, zatímco platforma stále zobrazuje Booked. Prázdný Document Journal pro druhé odeslání tedy neznamená, že faktura zmizela, ale obvykle že byla aktivována idempotentní kontrola.

Toto nejdříve zkontrolujte u partnera Unit4 s více fakturami:

0. Pouze doručeno, žádný journal: stav Delivered/Přijato v příchozí schránce s 0 výsledky v Document Journals znamená, že ještě nedošlo k žádnému pokusu o zaúčtování Autopilot (Booked/Booking failed). Nejprve znovu odešlete faktury do připojeného softwaru; vyšetřování Events začněte až poté. Viz Autopilot -- Deníky dokumentů.
1. Oddělte strany: přijímající zákazník (uživatel ERPx) není totožný s dodavatelem na faktuře, ani s případnou zprostředkující stranou v přiloženém logu.
2. Správný log nebo dokument: ověřte, zda je příloha nebo eConnect log požadovaným dokumentem (číslo faktury, dodavatel k příjemci). Chybný log je jiný dokument; nezačínejte na něm vyšetřování ERPx.
3. Identifikátor na požadovanou fakturu: minimálně číslo faktury, nejlépe i documentId nebo consignmentId. Více chybějících čísel faktur jsou samostatné dokumenty; Booked na faktuře A nepokrývá fakturu B.
4. Booked plus chyba duplicity (např. invoice number already exists, nebo po opětovném odeslání): často bylo znovu odesláno stejné číslo faktury. Platforma může zobrazovat Booked na dřívějším zaúčtování; to není důkaz, že jiné číslo faktury je v ERPx. Potvrďte to přes Events (krok 3 níže) nebo existující registraci ERPx.

Kroky:

Transformace ABWInvoice byla vytvořena na základě původních testovacích dokumentů. Nestandardní varianty dokumentů (např. faktury ve volném textu) mohou selhat s "API400: Initializing failed". Řešení: žádost o změnu vývojovému týmu pro rozšíření transformace.

Chybové zprávy s předponou BC pocházejí z Business Central. Malý vliv ze strany eConnect; zákazník musí zkontrolovat konfiguraci BC.

Předpona v hranatých závorkách označuje typ odpovědi, kterou eConnect obdržel od Business Central při zaúčtování faktury:

• [BC400] -- požadavek odmítnutý Business Central (BC vrátilo chybu typu 400). Jde téměř vždy o chybu validace nebo vztahu tabulky v konfiguraci BC zákazníka (např. chybějící hodnota v přidružené tabulce nebo pole nesplňující podmínku BC). Text přímo po [BC400]: (jako Internal_InvalidTableRelation nebo Application_FieldValidationException) pojmenovává konkrétní chybu BC a ukazuje na pole nebo tabulku k opravě.
• [BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- podobné odpovědi ze strany BC (odmítnutý požadavek, nenalezeno, omezení rychlosti).
• [API400] -- odmítnuto samotným API eConnect, pro BC (např. nesprávné nastavení připojení).

Ve všech případech předpony BC leží řešení na straně BC (konfigurace zákazníka); eConnect zde má malý vliv.

Známý výpadek? Nejprve zkontrolujte status.exact.com, zda nejde o aktuální výpadek Exact -- nezávisle na vlastní stavové stránce eConnect (support.econnect.eu/status/). Výpadek na straně Exact (např. Exact Online, Exact API) někdy vysvětluje chyby, které nesouvisejí s propojením eConnect.

Propojení: SOAP-enterprise, pouze příjem (nákupy). Nastavení: Propojit ECI Inventive.

Dvě příčiny, nezaměňovat je:

1. Porucha platformy eConnect: například chybějící přílohy PDF. Zkontrolujte stav faktury v Doručené poště eConnect.
2. Vlastní chyba validace payloadu na straně Inventive: mimo rozsah podpory eConnect. Správce Inventive to vyšetřuje.

Stav "zpracováno" v Doručené poště eConnect znamená, že eConnect fakturu správně doručil. Pokud faktura pořád chybí v Inventive, zkontrolujte nejprve payload/import Inventive (dávkové úlohy), ne znovu příjem eConnect.

Pro každý balíček ERP platí následující kroky:

1. Testovat připojení: všechny balíčky vyžadují port 443 k endpointu eConnect.
2. Odvolat softwarovou integraci: Platforma > Připojení > Odvolat klíč > odebrat také v připojeném softwaru.
3. Znovu odeslat dokumenty: Doručená pošta/Odeslaná pošta > tři tečky > "Znovu odeslat stahování API". Při označení jako duplikát nejprve "Označit jako originál".