Chybové hlásenia a riešenia podľa balíčka ERP. Tento článok sa zaoberá chybami špecifickými pre každý balíček. Pre všeobecné problémy s API, webhookmi a konektivitou: pozri Riešenie problémov s integráciami.

Chybové hlásenia s predponou U4 pochádzajú z Unit4 ERPx. Riešenie sa nachádza takmer vždy na strane softvéru, nie v eConnect. Zákazník môže stiahnuť súbor XML z platformy a odovzdať ho správcovi Unit4.

Kompenzácia DueDate: Unit4 nemôže spracovávať faktúry bez DueDate/PaymentDueDate (pole nie je v XML povinné). eConnect štandardne nastavuje PaymentDueDate na IssueDate (dátum faktúry) plus 30 dní, keď toto pole chýba. Ide o štandardné Rule Based Enrichment, konfigurované pre každého zákazníka ako PrivateObject v PSB (typicky s Id unit4-setDueDate-30days).

Faktúra zaúčtovaná, ale chýba príloha PDF: predchádzajúce prerušenia pripojenia na strane Unit4, kde bol PDF stratený, sú teraz opakované (potvrdené Platform & Integrácie, máj 2026). Zostávajúce prípady: pozri diagnostickú cestu nižšie.

Táto cesta sa vzťahuje na sťažnosti ako „Zaúčtované v eConnect, ale neviditeľné v ERPx" alebo „Faktúra zrejme nikdy nedorazila, žiadna správa v Document Journal".

Kontext: Trasa Autopilot -- Unit4 ERPx je idempotentná (zhoda na číslo faktúry + zákazník + dodávateľ). Pri zhode nie je ERPx znovu volaný a nahrá sa iba chýbajúci PDF, zatiaľ čo platforma stále zobrazuje Booked. Prázdny Document Journal pre druhé odoslanie teda neznamená, že faktúra zmizla, ale zvyčajne že bola aktivovaná idempotentná kontrola.

Toto najskôr skontrolujte u partnera Unit4 s viacerými faktúrami:

0. Iba doručené, žiadny journal: stav Delivered/Prijaté v prijatej pošte s 0 výsledkami v Document Journals znamená, že ešte nedošlo k žiadnemu pokusu o zaúčtovanie Autopilot (Booked/Booking failed). Najprv znova odošlite faktúru do pripojeného softvéru; vyšetrovanie Events začnite až potom. Pozri Autopilot -- Denníky dokumentov.
1. Oddeľte strany: prijímajúci zákazník (užívateľ ERPx) nie je totožný s dodávateľom na faktúre, ani s prípadnou sprostredkujúcou stranou v priloženom logu.
2. Správny log alebo dokument: overte, či je príloha alebo eConnect log požadovaným dokumentom (číslo faktúry, dodávateľ k prijímateľovi). Nesprávny log je iný dokument; nezačínajte na ňom vyšetrovanie ERPx.
3. Identifikátor na požadovanú faktúru: minimálne číslo faktúry, najlepšie aj documentId alebo consignmentId. Viac chýbajúcich čísiel faktúr sú samostatné dokumenty; Booked na faktúre A nepokrýva faktúru B.
4. Booked plus chyba duplicity (napr. invoice number already exists, alebo po opätovnom odoslaní): často bolo znova odoslané rovnaké číslo faktúry. Platforma môže zobrazovať Booked na skoršom zaúčtovaní; to nie je dôkaz, že iné číslo faktúry je v ERPx. Potvrďte to prostredníctvom Events (krok 3 nižšie) alebo existujúcej registrácie ERPx.

Kroky:

Transformácia ABWInvoice bola vytvorená na základe pôvodných testovacích dokumentov. Neštandardné varianty dokumentov (napr. faktúry vo voľnom texte) môžu zlyhať s "API400: Initializing failed". Riešenie: žiadosť o zmenu vývojovému tímu pre rozšírenie transformácie.

Chybové hlásenia s predponou BC pochádzajú z Business Central. Malý vplyv zo strany eConnect; zákazník musí skontrolovať konfiguráciu BC.

Predpona v hranatých zátvorkách označuje typ odpovede, ktorú eConnect dostal od Business Central pri zaúčtovaní faktúry:

• [BC400] -- požiadavka odmietnutá Business Central (BC vrátilo chybu typu 400). Ide takmer vždy o chybu validácie alebo vzťahu tabuľky v konfigurácii BC zákazníka (napr. chýbajúca hodnota v pridruženej tabuľke alebo pole nespĺňajúce podmienku BC). Text priamo po [BC400]: (ako Internal_InvalidTableRelation alebo Application_FieldValidationException) pomenúva konkrétnu chybu BC a ukazuje na pole alebo tabuľku na opravu.
• [BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- podobné odpovede zo strany BC (odmietnutá požiadavka, nenájdené, obmedzenie rýchlosti).
• [API400] -- odmietnuté samotným API eConnect, pre BC (napr. nesprávne nastavenie pripojenia).

Vo všetkých prípadoch predpony BC leží riešenie na strane BC (konfigurácia zákazníka); eConnect tu má malý vplyv.

Známy výpadok? Najprv skontrolujte status.exact.com, či nejde o aktuálny výpadok Exact -- nezávisle od vlastnej stavovej stránky eConnect (support.econnect.eu/status/). Výpadok na strane Exact (napr. Exact Online, Exact API) niekedy vysvetľuje chyby, ktoré nesúvisia s prepojením eConnect.

Prepojenie: SOAP-enterprise, iba príjem (nákupy). Nastavenie: Prepojiť ECI Inventive.

Dve príčiny, nezamieňať si ich:

1. Porucha platformy eConnect: napríklad chýbajúce prílohy PDF. Skontrolujte stav faktúry v Doručenej pošte eConnect.
2. Vlastná chyba validácie payloadu na strane Inventive: mimo rozsah podpory eConnect. Správca Inventive to preverí.

Stav "spracované" v Doručenej pošte eConnect znamená, že eConnect faktúru správne doručil. Ak faktúra stále chýba v Inventive, skontrolujte najprv payload/import Inventive (dávkové úlohy), nie znova príjem eConnect.

Pre každý balíček ERP platia nasledujúce kroky:

1. Testovať pripojenie: všetky balíčky vyžadujú port 443 k endpointu eConnect.
2. Odvolať softvérovú integráciu: Platforma > Pripojenia > Odvolať kľúč > odstrániť aj v pripojenom softvéri.
3. Znovu odoslať dokumenty: Doručená pošta/Odoslaná pošta > tri bodky > "Znovu odoslať stiahnutie API". Pri označení ako duplikát najprv "Označiť ako originál".