Pripojenie Unit4 k eConnect: ERPx cez Autopilot, ERP CR cez SFTP a Financials cez HTTPS.
Unit4 v roku 2026 ponúka tri varianty, z ktorých každá má vlastnú integračnú metódu. Ktorá z nich platí pre Vás, závisí od Vášho produktu Unit4.
Unit4 ERPx pripojíte cez Autopilot. Nákupné faktúry sa automaticky načítavajú a účtujú. Konfigurácia sa nastavuje počas implementácie s eConnect.
Konfigurácia Autopilota prebieha cez sprievodcu krok za krokom na platforme eConnect:
Pozor: Najprv spracujte všetky dokumenty cez starú cestu, až potom prepnite. Konfiguráciu pripojenia nevykonáva zákazník sám, ale počas implementácie.
Pri účtovaní cez Unit4 ERPx sa môže objaviť hlásenie [U4OK.JSON]: System.Int32 overflow. Príčina: číslo faktúry je numericky tak veľké, že presahuje limit 32bitového celého čísla (maximálne 2.147.483.647). V tejto časti spracovania Unit4 potom systém číslo nemôže spracovať. Ide o obmedzenie samotného Unit4, nie pripojenia eConnect ani nášho integračného kódu.
V praxi to vidíte u organizácií, ktoré pre odchádzajúce čísla faktúr používajú veľmi vysoké rady (napríklad hodnoty výrazne nad 2 miliardy).
Čo môžete urobiť? Riešenie musí prísť od Unit4. Zmena čísla faktúry v zdrojovom XML cez eConnect nie je uskutočniteľná workaround bez rizika pre Vašu administratívu a číslovanie. Unit4 je informovaný a pracuje na štrukturálnej oprave. Dovtedy eskalujte na Vášho správcu alebo partnera Unit4 a v prípade potreby použite stiahnutie XML z platformy eConnect (Doručená pošta) na doloženie prípadu.
Unit4 ERP CR (vrátane ERP7) a Unit4 Financials by Coda pripájate cez SFTP a HTTPS. Tieto enterprise pripojenia vyžadujú zmluvu a konfiguruje ich Unit4 alebo partner Unit4 v spolupráci s eConnect.
Štandardná integračná metóda pre Unit4 ERP CR a ERP7 je SFTP (Secure File Transfer Protocol). Viac informácií o technickom nastavení SFTP pripojenia nájdete v článku SFTP integrácia.
V minulosti sa mohlo stať, že faktúra bola v Unit4 ERPx úspešne zaúčtovaná, ale PDF príloha sa neprebrala. Príčinou bolo prerušenie spojenia na strane Unit4, pri ktorom bolo PDF zahodené. Od mája 2026 sa tieto prípady automaticky opakujú, potvrdené tímom Platform & Integraties. Vo väčšine situácií by ste tento problém už nemali vidieť.
Ak sa Vám napriek tomu ešte stane, že faktúra je zaúčtovaná, ale PDF príloha chýba, ide o zvyškový prípad. Postupujte podľa diagnostickej cesty nižšie a zistite, či bol dokument skutočne stratený, alebo či ide o idempotentnú zhodu.
Tip: Samotnú faktúru si môžete vždy stiahnuť z platformy eConnect (Doručená pošta, tri bodky pri dokumente). V prípade potreby dokument ručne prepošlite Vášmu správcovi Unit4.
Unit4 ERPx nemôže spracovať nákupné faktúry bez dátumu splatnosti (DueDate/PaymentDueDate); pole nie je v XML povinné. Ak príde faktúra bez tohto poľa, eConnect štandardne nastaví PaymentDueDate na IssueDate (dátum faktúry) plus 30 dní. Tým zabránime zlyhaniu účtovania kvôli formálne chýbajúcemu poľu, zatiaľ čo skutočná platobná lehota je v praxi zvyčajne 30 dní.
Ide o štandardné Rule Based Enrichment (RBE), konfigurované pre každého zákazníka ako PrivateObject v PSB (typicky s Id unit4-setDueDate-30days). Ak chcete inú štandardnú lehotu, kontaktujte podporu; nejde o self-service nastavenie.
Táto diagnostická cesta platí pre sťažnosti typu „faktúra má v eConnect stav Booked, ale v ERPx ju nevidím“ alebo „faktúra sa zrejme nikdy nedostala, Document Journal neukazuje nič“. Kontext: trasa Autopilot ↔ Unit4 ERPx je idempotentná (zhoda podľa čísla faktúry plus zákazníka plus dodávateľa). Pri zhode eConnect znova nevolá ERPx a nahráva iba chýbajúce PDF, zatiaľ čo platforma stále ukazuje Booked. Prázdny Document Journal pre druhé podanie teda zvyčajne neznamená, že faktúra bola stratená, ale že sa aktivovala idempotentná kontrola. Pozrite aj Autopilot — idempotentné účtovanie.
Význam stavových štítkov sa líši podľa typu pripojenia. Zistite, či ide o Autopilot (Unit4 ERPx), inú PSB trasu, priame SOAP API alebo SFTP pripojenie. Tabuľku stavov a význam podľa typu pripojenia nájdete v Autopilot — stavy účtovania.
Poznačte si aspoň jedno z týchto dvoch ID dokumentu:
documentId (z PSB), aleboconsignmentId (z platformy).Jedno z nich stačí na vyhľadanie dokumentu vo všetkých interných systémoch.
Otvorte dokument v internej Management API podľa documentId alebo consignmentId a prejdite časovú os Events. Pri každom kroku je vidieť, aká akcia na dokumente prebehla: prijatie, validácia, podanie ERPx, opakovania, idempotentná zhoda a nahratie PDF. Pri SFTP pripojeniach je to jediné miesto, kde je viditeľný stav doručenia, pretože softvérový balík cez SFTP neposkytuje spätnú väzbu o stave.
Vidíte v časovej osi Events, že eConnect faktúru rozpoznal ako existujúcu (rovnaké číslo faktúry, zákazník a dodávateľ) a vykonal iba nahratie PDF? Potom ide o očakávané správanie. Faktúra už bola v ERPx z predchádzajúceho podania. Sdélte to zákazníkovi; eskalácia nie je potrebná.
Iba ak časová os Events nedáva ucelený obraz, eskalujte na technický tím. Uveďte minimálne:
documentId alebo consignmentId,partyId príjemcu,Pri spracovaní faktúr cez transformáciu ABWInvoice (používanú pri integráciách Agresso/Unit4) sa môže objaviť chybové hlásenie [API400]: Initializing failed. Unhandled error occurred.. Príčinou je, že transformácia bola vytvorená na základe pôvodných testovacích dokumentov. Odlišné varianty dokumentov (napríklad free text faktúry) obsahujú polia, ktoré v mapovaní chýbajú, a transformácia preto zlyhá.
Prebieha požiadavka na zmenu, ktorá transformáciu rozšíri pre viac typov dokumentov. Ak sa s týmto hlásením stretnete, kontaktujte podporu.
Pri integráciách Unit4 s cudzou menou (napr. USD s kurzom) je konfigurácia meny zodpovednosťou zákazníka v prostredí Unit4. eConnect spracováva to, čo ERP dodá. Otázky podpory k cudzej mene smerujte na konfiguráciu ERP zákazníka.
Chybové hlásenia začínajúce prefixom U4 pochádzajú z Unit4 ERPx. Riešenie je takmer vždy na strane Unit4. Súbor XML si môžete sami stiahnuť z platformy eConnect (Doručená pošta, tri bodky pri dokumente) a odovzdať Vášmu správcovi Unit4.
Mapovanie DPH: rozdiel medzi prichádzajúcimi a odchádzajúcimi faktúrami
Pri prichádzajúcich faktúrach (Autopilot) zabezpečuje eConnect mapovanie DPH. Schému konfigurujete cez Platforma > Autopilot > Pripojenie > Schéma zaúčtovania > SPRAVOVAŤ SCHÉMY > DPH. Pri odchádzajúcich faktúrach eConnect mapovanie DPH nevykonáva: Unit4 musí sám dodať správne kódy UNCL5305 v XML faktúry.
Ide o všeobecné chybové hlásenie s viacerými možnými príčinami: timeout u Unit4, faktúra s viac ako 200 riadkami, riadky faktúry s sumou € 0, alebo duplicitné kódy DPH v účtovacom schéme. Znova podajte faktúru cez Doručenú poštu. Ak chyba pretrváva, zaúčtujte faktúru ručne v ERPx a skontrolujte schému DPH na duplicity.
Kombinácia dodávateľa a čísla faktúry v Unit4 už existuje. Skontrolujte, či bola faktúra skôr podaná (napríklad inou cestou) a či IDR správne rozpoznalo číslo faktúry. Ak ide skutočne o duplicitu, nemusíte nič robiť. Ak ide o iný dokument s rovnakým číslom, skontrolujte rozpoznanie na platforme eConnect.
XML faktúry obsahuje kód DPH, ktorý nie je v účtovacom schéme Autopilot. Deje sa to hlavne pri faktúrach doručených e-mailom s odlišným alebo chybným kódom DPH. Pridajte chýbajúce mapovanie cez Platforma > Autopilot > Pripojenie > Schéma zaúčtovania > SPRAVOVAŤ SCHÉMY > DPH, alebo požiadajte dodávateľa o odoslanie faktúry cez Peppol (kde sa používajú štandardné kódy DPH).
Veriteľ v Unit4 ERPx nemá nastavenú platobnú podmienku (BET.VOORW). eConnect sám Unit4 dátum splatnosti nepredáva. Nastavte platobnú podmienku na karte dodávateľa v Unit4 ERPx.
Dummy Crediteur v Unit4 nie je aktívny. Aktivujte Dummy Crediteur v Unit4 ERPx a faktúry znova podajte.
Celková suma faktúry je € 0,00. Faktúru bez sumy nemožno v Unit4 zaúčtovať.
Účtovné obdobie (boekingscyclus) v Unit4 ERPx nie je správne nastavené alebo nie je aktívne pre dané obdobie. Skontrolujte a aktivujte správne účtovné obdobie v Unit4.
Platobný symbol na faktúre je dlhší ako 27 znakov, čo Unit4 neprijíma. Ako dočasné riešenie môžete faktúru odoslať ako PDF namiesto automatického pripojenia. Trvalo musí dodávateľ platobný symbol skrátiť.
Používateľ machine-to-machine (M2M), ktorým sa eConnect prihlasuje do Unit4, má nedostatočné oprávnenia alebo je deaktivovaný. Nechajte správcu Unit4 skontrolovať a obnoviť oprávnenia používateľa M2M eConnect.
Faktúra bola zaúčtovaná na Dummy Crediteur, ale skorší dokument s rovnakým číslom faktúry tam už je. Najprv spracujte existujúcu faktúru na Dummy Crediteur a potom novú faktúru znova podajte.
Konfigurácii smerovania v Unit4 ERPx chýba uzol pre zadaný workflow. Ide o problém na strane Unit4. Stiahnite XML z platformy eConnect a odovzdajte ho Vášmu správcovi Unit4 na úpravu smerovania.
Pripojené PDF obsahuje neplatný prefix „data“ v Base64 dátach (napríklad dataJVBERi0x... namiesto JVBERi0x...). Pri faktúrach doručených cez IDR sa to automaticky opraví. Pri faktúrach doručených priamo cez Peppol sa tento problém môže ešte vyskytnúť. Odosielateľ v zdroji musí XML opraviť.
Unit4 ERPx pripojíte cez Autopilot na automatické prijímanie nákupných faktúr. Unit4 ERP CR a ERP7 používajú SFTP a Unit4 Financials by Coda sa pripája cez HTTPS. Oba posledné varianty vyžadujú zmluvu a konfiguruje ich Unit4 alebo partner Unit4.
Pri Unit4 ERPx sa konfigurácia nastavuje počas implementácie s eConnect, nie zákazníkom sám. Pri Unit4 ERP CR a Financials by Coda konfiguráciu vykonáva Unit4 alebo partner Unit4 v spolupráci s eConnect.
::e-accordion-item{value="item-3" header="Čo mám robiť pri chybovom hlásení "Int32 overflow" pri veľkých číslach faktúr?"} Ide o obmedzenie samotného Unit4, keď je číslo faktúry väčšie ako 2.147.483.647. Riešenie musí prísť od Unit4. Eskalujte na Vášho správcu alebo partnera Unit4 a v prípade potreby použite stiahnutie XML z platformy eConnect na doloženie prípadu. ::
Chcete pripojiť Unit4? Kontaktujte Unit4 alebo Vášho partnera Unit4, alebo eConnect sales na úvodné stretnutie.
Spustiť pripojenie