Ako napojiť ERP na digitálneho poštára bez bolesti hlavy
Praktický návod pre ERP, účtovný softvér alebo interný fakturačný systém: ako poslať export do ePošťák Connectora, dostať čitateľný mapper preview a pripraviť Peppol odosielanie bez ručného UBL projektu.
Rýchla odpoveď: ERP napojíte na digitálneho poštára tak, že do ePošťák Connectora pošlete vzorku exportu z ERP. Connector z nej pripraví mapper preview, ukáže nájdené a chýbajúce polia, navrhne opravy a po schválení používa uložený templateKey pre ďalšie Peppol faktúry.
XML, CSV, JSON, TXT
found / missing / confidence
riadok, pole, patch
ďalšie faktúry už cez endpoint
Čo je digitálny poštár pre ERP integráciu?
Digitálny poštár je Peppol Access Point, ktorý za firmu prijíma a odosiela e-faktúry cez sieť Peppol. Pri ERP integrácii je jeho úloha jednoduchá: ERP dodá obchodné údaje faktúry a ePošťák sa postará o Peppol doručenie, validáciu a technický formát.
ePošťák bol od začiatku developer-first produkt. Reálne integrácie nevznikajú v peknom formulári, ale v starom ERP, v CSV exporte s divnými názvami stĺpcov, v XML, ktoré je skoro dobré, alebo v PDF faktúre, ktorú niekto používa už desať rokov.
Preto sme do integrátorského portálu pridali nástroj, ktorý interne voláme integračný co-pilot. Je súčasťou ePošťák Connector funkcionality. Drag & dropnete súbor, ktorý vie váš ERP vypluť: XML, CSV, JSON, TXT, PDF alebo obrázok. Co-pilot skúsi prečítať všetko, čo bezpečne vie, a potom nepovie len “chyba”. Povie: toto som našiel, toto chýba, toto treba potvrdiť, a takto to doplníte.
Ako funguje napojenie ERP na digitálneho poštára bez UBL projektu?
- 1. Pošlete vzorku exportu. Stačí jeden reálny výstup z ERP. V portáli cez drag & drop, v API cez
sourceTextalebosourceJson. - 2. Mapper vráti preview. Odpoveď obsahuje
copilot.found,copilot.missing,repairActionsa návrh Connector Autopilot payloadu. - 3. Opravíte iba to, čo treba. Ak je chyba na konkrétnom riadku, ukážeme riadok. Ak chýba Peppol ID, ukážeme pole a odporúčaný formát, napríklad
0245:<DIČ>. - 4. Uložíte mapping profil. Keď vzorka prejde, uloží sa
templateKey. Ďalšie faktúry z rovnakého ERP už voláte cez API.
Ako vyzerá mapper preview v praxi?
Mapper preview je prvý bezpečný krok ERP integrácie. Verejná ukážka nižšie spracuje textový XML, CSV, JSON alebo TXT export, vráti nájdené polia a označí najbližšiu opravu bez toho, aby ukladala doklad alebo vytvárala produkčný mapping.
Drag & drop mapper napojený na backend
Toto nie je mock. Komponent volá /api/public/connector-mapper-demo a route používa rovnaký mapper engine ako Connector Studio. Verejná ukážka neposiela doklady a neukladá template-y.
Čo vieme prečítať
Po analýze tu uvidíte číslo dokladu, odberateľa alebo položky.
Čo ešte chýba
Zatiaľ neevidujeme chýbajúce polia.
Ako zavolá ePošťák Connector váš backend?
Produkčný endpoint je autentifikovaný integrátorským tokenom. To je zámer: preview síce vie bežať bezpečne, ale uloženie template, stage a send už patria pod konkrétnu integrátorskú firmu a jej sandbox alebo produkčné oprávnenia.
const response = await fetch("https://epostak.sk/api/v1/connector/mapper", {
method: "POST",
headers: {
"Authorization": "Bearer sk_int_live_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
templateKey: "pohoda-csv-v1",
customerRef: "cust_123",
sourceType: "csv",
sourceText: erpExport,
execute: "preview"
})
});
const { preview, launchChecklist } = await response.json();
if (preview.repairActions.length) {
// Ukážte používateľovi presný ďalší krok:
// riadok, pole, návrh hodnoty alebo patch.
console.log(preview.repairActions[0]);
}Prečo je mapper demo použiteľné aj pre reálnu integráciu?
Verejný blog nemôže ukladať vaše template-y ani púšťať OCR nad cudzími faktúrami bez prihlásenia. Ukážka vyššie však nie je mock: posiela vstup na backend route, ktorá volá rovnaký buildConnectorMapperPreview engine ako integrátorský portál. Rozdiel je iba v tom, že demo je preview-only.
// Verejné demo v tomto článku nie je mock.
// Route volá rovnaký backend mapper engine ako Connector Studio.
import { buildConnectorMapperPreview } from "@/lib/connector/mapper";
const preview = buildConnectorMapperPreview({
sourceType: "xml",
sourceText,
customerRef: "blog-demo"
});Čo vráti mapper preview vývojárovi?
found
Hodnoty, ktoré sme vedeli prečítať: číslo dokladu, odberateľ, položky, mena alebo raw UBL.
missing
Povinné polia, ktoré ešte chýbajú pred preflightom alebo stage krokom.
repairActions
Konkrétne opravy: cieľ editácie, riadok, návrh hodnoty, potvrdenie alebo patch.
Ako požiadať o prístup k ePošťák Connectoru?
Ak máte ERP, účtovný systém alebo interný fakturačný nástroj a chcete ho napojiť na Peppol bez vlastnej UBL implementácie, požiadajte o prístup cez kontaktný formulár. Pošleme vám prístup do integrátorského portálu a sandbox prostredia.
Požiadať o prístupTechnický prehľad Connectora nájdete aj na stránke ePošťák Connector a v dokumentácii Enterprise API.
A ešte jedna ľudská poznámka na záver: ďakujeme za maily, kde nám posielate reálne exporty a divné edge cases. Presne z nich tento nástroj vzniká. Nie z workshopovej prezentácie, ale z faktúr, ktoré sa v skutočnom ERP naozaj objavia.