Propojení Unit4 s eConnect: ERPx přes Autopilot, ERP CR přes SFTP a Financials přes HTTPS.
Unit4 v roce 2026 nabízí tři varianty, z nichž každá má vlastní integrační metodu. Která z nich platí pro Vás, závisí na Vašem produktu Unit4.
Unit4 ERPx propojíte přes Autopilot. Nákupní faktury se automaticky načítají a účtují. Konfigurace se nastavuje během implementace s eConnect.
Konfigurace Autopilota probíhá přes průvodce krok za krokem na platformě eConnect:
Pozor: Nejdříve zpracujte všechny dokumenty přes starou cestu, teprve potom přepněte. Konfiguraci propojení neprovádí zákazník sám, ale během implementace.
Při účtování přes Unit4 ERPx se může objevit hlášení [U4OK.JSON]: System.Int32 overflow. Příčina: číslo faktury je numericky tak velké, že přesahuje limit 32bitového celého čísla (maximálně 2.147.483.647). V této části zpracování Unit4 pak systém číslo nemůže zpracovat. Jde o omezení samotného Unit4, ne propojení eConnect ani našeho integračního kódu.
V praxi to vidíte u organizací, které pro odchozí čísla faktur používají velmi vysoké řady (například hodnoty výrazně nad 2 miliardy).
Co můžete udělat? Řešení musí přijít od Unit4. Změna čísla faktury ve zdrojovém XML přes eConnect není proveditelná workaround bez rizika pro Vaši administraci a číslování. Unit4 je informován a pracuje na strukturální opravě. Do té doby eskalujte na svého správce nebo partnera Unit4 a v případě potřeby použijte stažení XML z platformy eConnect (Doručená pošta) k doložení případu.
Unit4 ERP CR (včetně ERP7) a Unit4 Financials by Coda propojujete přes SFTP a HTTPS. Tyto enterprise propojení vyžadují smlouvu a konfigurují je Unit4 nebo partner Unit4 ve spolupráci s eConnect.
Standardní integrační metoda pro Unit4 ERP CR a ERP7 je SFTP (Secure File Transfer Protocol). Více informací o technickém nastavení SFTP propojení najdete v článku SFTP integrace.
V minulosti se mohlo stát, že faktura byla v Unit4 ERPx úspěšně zaúčtována, ale PDF příloha se nepřenesla. Příčinou bylo přerušení spojení na straně Unit4, při kterém bylo PDF zahozeno. Od května 2026 se tyto případy automaticky opakují, potvrzeno týmem Platform & Integraties. Ve většině situací byste tento problém už neměli vidět.
Pokud se Vám přesto ještě stane, že faktura je zaúčtovaná, ale PDF příloha chybí, jde o zbytkový případ. Postupujte podle diagnostické cesty níže a zjistěte, zda byl dokument skutečně ztracen, nebo zda jde o idempotentní shodu.
Tip: Samotnou fakturu si můžete vždy stáhnout z platformy eConnect (Doručená pošta, tři tečky u dokumentu). V případě potřeby dokument ručně přepošlete svému správci Unit4.
Unit4 ERPx nemůže zpracovat nákupní faktury bez data splatnosti (DueDate/PaymentDueDate); pole není v XML povinné. Pokud přijde faktura bez tohoto pole, eConnect standardně nastaví PaymentDueDate na IssueDate (datum faktury) plus 30 dní. Tím zabráníme selhání účtování kvůli formálně chybějícímu poli, zatímco skutečná platební lhůta je v praxi obvykle 30 dní.
Jde o standardní Rule Based Enrichment (RBE), konfigurované pro každého zákazníka jako PrivateObject v PSB (typicky s Id unit4-setDueDate-30days). Chcete-li jinou standardní lhůtu, kontaktujte podporu; nejde o self-service nastavení.
Tato diagnostická cesta platí pro stížnosti typu „faktura má v eConnect stav Booked, ale v ERPx ji nevidím“ nebo „faktura se zřejmě nikdy nedostala, Document Journal neukazuje nic“. Kontext: trasa Autopilot ↔ Unit4 ERPx je idempotentní (shoda podle čísla faktury plus zákazníka plus dodavatele). Při shodě eConnect znovu nevolá ERPx a nahrává pouze chybějící PDF, zatímco platforma stále ukazuje Booked. Prázdný Document Journal pro druhé podání tedy obvykle neznamená, že faktura byla ztracena, ale že se aktivovala idempotentní kontrola. Viz také Autopilot — idempotentní účtování.
Význam stavových štítků se liší podle typu propojení. Zjistěte, zda jde o Autopilot (Unit4 ERPx), jinou PSB trasu, přímé SOAP API nebo SFTP propojení. Tabulku stavů a význam podle typu propojení najdete v Autopilot — stavy účtování.
Poznamenejte si alespoň jedno z těchto dvou ID dokumentu:
documentId (z PSB), neboconsignmentId (z platformy).Jedno z nich stačí k vyhledání dokumentu ve všech interních systémech.
Otevřete dokument v interní Management API podle documentId nebo consignmentId a projděte časovou osu Events. U každého kroku je vidět, jaká akce na dokumentu proběhla: přijetí, validace, podání ERPx, opakování, idempotentní shoda a nahrání PDF. U SFTP propojení je to jediné místo, kde je vidět stav doručení, protože softwarový balík přes SFTP neposkytuje zpětnou vazbu o stavu.
Vidíte v časové ose Events, že eConnect fakturu rozpoznal jako existující (stejné číslo faktury, zákazník a dodavatel) a provedl pouze nahrání PDF? Pak jde o očekávané chování. Faktura už byla v ERPx z dřívějšího podání. Sdělte to zákazníkovi; eskalace není potřeba.
Pouze pokud časová osa Events nedává ucelený obraz, eskalujte na technický tým. Uveďte minimálně:
documentId nebo consignmentId,partyId příjemce,Při zpracování faktur přes transformaci ABWInvoice (používanou u integrací Agresso/Unit4) se může objevit chybové hlášení [API400]: Initializing failed. Unhandled error occurred.. Příčinou je, že transformace byla vytvořena na základě původních testovacích dokumentů. Odlišné varianty dokumentů (například free text faktury) obsahují pole, která v mapování chybí, a transformace proto selže.
Probíhá požadavek na změnu, který transformaci rozšíří pro více typů dokumentů. Pokud se s tímto hlášením setkáte, kontaktujte podporu.
U integrací Unit4 s cizí měnou (např. USD s kurzem) je konfigurace měny odpovědností zákazníka v prostředí Unit4. eConnect zpracovává to, co ERP dodá. Dotazy podpory k cizí měně směřujte na konfiguraci ERP zákazníka.
Chybová hlášení začínající prefixem U4 pocházejí z Unit4 ERPx. Řešení je téměř vždy na straně Unit4. Soubor XML si můžete sami stáhnout z platformy eConnect (Doručená pošta, tři tečky u dokumentu) a předat svému správci Unit4.
Mapování DPH: rozdíl mezi příchozími a odchozími fakturami
U příchozích faktur (Autopilot) zajišťuje eConnect mapování DPH. Schéma konfigurujete přes Platforma > Autopilot > Připojení > Schéma zaúčtování > SPRAVOVAT SCHÉMATA > DPH. U odchozích faktur eConnect mapování DPH neprovádí: Unit4 musí sám dodat správné kódy UNCL5305 v XML faktury.
Jde o obecné chybové hlášení s více možnými příčinami: timeout u Unit4, faktura s více než 200 řádky, řádky faktury s částkou € 0, nebo duplicitní kódy DPH v účtovacím schématu. Znovu podajte fakturu přes Doručenou poštu. Pokud chyba přetrvává, zaúčtujte fakturu ručně v ERPx a zkontrolujte schéma DPH na duplicity.
Kombinace dodavatele a čísla faktury v Unit4 už existuje. Zkontrolujte, zda byla faktura dříve podána (například jinou cestou) a zda IDR správně rozpoznalo číslo faktury. Pokud jde skutečně o duplicitu, nemusíte nic dělat. Pokud jde o jiný dokument se stejným číslem, zkontrolujte rozpoznání na platformě eConnect.
XML faktury obsahuje kód DPH, který není v účtovacím schématu Autopilot. Stává se to hlavně u faktur doručených e-mailem s odlišným nebo chybným kódem DPH. Přidejte chybějící mapování přes Platforma > Autopilot > Připojení > Schéma zaúčtování > SPRAVOVAT SCHÉMATA > DPH, nebo požádejte dodavatele o odeslání faktury přes Peppol (kde se používají standardní kódy DPH).
Věřitel v Unit4 ERPx nemá nastavenou platební podmínku (BET.VOORW). eConnect sám Unit4 datum splatnosti nepředává. Nastavte platební podmínku na kartě dodavatele v Unit4 ERPx.
Dummy Crediteur v Unit4 není aktivní. Aktivujte Dummy Crediteur v Unit4 ERPx a faktury znovu podajte.
Celková částka faktury je € 0,00. Fakturu bez částky nelze v Unit4 zaúčtovat.
Účtovací období (boekingscyclus) v Unit4 ERPx není správně nastaveno nebo není aktivní pro dané období. Zkontrolujte a aktivujte správné účtovací období v Unit4.
Platební symbol na faktuře je delší než 27 znaků, což Unit4 nepřijímá. Jako dočasné řešení můžete fakturu odeslat jako PDF místo automatického propojení. Trvale musí dodavatel platební symbol zkrátit.
Uživatel machine-to-machine (M2M), kterým se eConnect přihlašuje do Unit4, má nedostatečná oprávnění nebo je deaktivován. Nechte správce Unit4 zkontrolovat a obnovit oprávnění uživatele M2M eConnect.
Faktura byla zaúčtována na Dummy Crediteur, ale dřívější dokument se stejným číslem faktury tam už je. Nejdříve zpracujte existující fakturu na Dummy Crediteur a poté novou fakturu znovu podajte.
Konfiguraci směrování v Unit4 ERPx chybí uzel pro zadaný workflow. Jde o problém na straně Unit4. Stáhněte XML z platformy eConnect a předejte ho svému správci Unit4 k úpravě směrování.
Připojené PDF obsahuje neplatný prefix „data“ v Base64 datech (například dataJVBERi0x... místo JVBERi0x...). U faktur doručených přes IDR se to automaticky opraví. U faktur doručených přímo přes Peppol se tento problém může ještě vyskytnout. Odesílatel ve zdroji musí XML opravit.
Unit4 ERPx propojíte přes Autopilot pro automatické přijímání nákupních faktur. Unit4 ERP CR a ERP7 používají SFTP a Unit4 Financials by Coda se propojuje přes HTTPS. Obě poslední varianty vyžadují smlouvu a konfigurují je Unit4 nebo partner Unit4.
U Unit4 ERPx se konfigurace nastavuje během implementace s eConnect, ne zákazníkem sám. U Unit4 ERP CR a Financials by Coda konfiguraci provádí Unit4 nebo partner Unit4 ve spolupráci s eConnect.
::e-accordion-item{value="item-3" header="Co mám dělat při chybovém hlášení "Int32 overflow" u velkých čísel faktur?"} Jde o omezení samotného Unit4, když je číslo faktury větší než 2.147.483.647. Řešení musí přijít od Unit4. Eskalujte na svého správce nebo partnera Unit4 a v případě potřeby použijte stažení XML z platformy eConnect k doložení případu. ::
Chcete propojit Unit4? Kontaktujte Unit4 nebo svého partnera Unit4, nebo eConnect sales pro úvodní schůzku.
Spustit propojení