Akceptované formáty
Začněte tím, co umí vyexportovat váš účetní nebo ERP systém. Pokud to data v souboru umožňují, vystavíme z něj dodací list v PDK; mapování na vstup brány si vezmeme na sebe při onboardingu. Níže formáty, se kterými se běžně setkáváme. Pro nové integrace bez zavedeného exportu je k dispozici i náš kanonický pdk-conversion-delivery-note (JSON / XML) s veřejným schematem a ukázkami.
Formáty, se kterými se běžně setkáváme
Většina dodavatelů má v účetnictví, ERP nebo EDI middleware nějaký strojově čitelný výstup. Když nám při onboardingu pošlete ukázku, mapování na vstup brány doděláme my. Níže typické skupiny formátů a systémů.
Mezinárodní standardy
- EDIFACT DESADV (eASN)
- Globální EDI standard Despatch Advice spravovaný UN/CEFACT (release D.96B – D21A a další). Avizo dodávky odběrateli s detaily zásilky, položek a balení. Typicky se přenáší přes EDI VAN nebo AS2.
- SAP IDoc – DELVRY (DELVRY03 / DELVRY05 / DELVRY06)
- SAP-specifický kontejner pro avizo dodávky. Hlavička
E1EDL20(číslo dokladu, shipping point, sales organization, hmotnosti, počet balení, Incoterms), položkyE1EDL24(materiál, šarže, dodávané množství), partneřiE1ADRM1. Lze předávat ve fixed-length i XML variantě. - ISDOC
- Český národní standard pro elektronické dokumenty spravovaný Ministerstvem vnitra ČR (aktuální verze 6.0.2). Definuje XML schema pro daňové i neplatební dokumenty; soubory mají koncovku
.isdoc, archiv s přílohami.isdocx, případně PDF/A-3 s vloženým XML. Některé dodavatelské profily ISDOC pokrývají i dodací listy.
Exporty z účetních / ERP systémů (XML, XLSX, CSV)
- SAP (S/4 HANA, Business One)
- Vedle nativního IDoc kanálu zpracujeme i prosté XML / CSV exporty z reportů. Užitečné pro dodavatele, kteří nemají k dispozici plnohodnotné EDI propojení.
- Helios (Inuvio, Nephrite – Asseco Solutions)
- Český ERP s dlouhou historií na trhu (linie Inuvio pro střední firmy, Nephrite pro velké). Standardně z něj přebíráme XML / CSV exporty – pole se mapují podle konkrétní instalace.
- Money S3 / S5 (Solitea)
- Účetní a ERP řada Solitea (dříve Cígler Software); S3 pro menší firmy, S5 pro střední a větší. Standardní exporty XML / CSV pokrývají hlavičku i položky.
- Byznys ERP (Seyfor / J.K.R.)
- Český ERP zaměřený na výrobu, sklady, finance a projektové řízení (35+ let na trhu, řádově tisíce zákazníků). Exporty přebíráme typicky v XML / CSV.
- Premier System
- Český informační a účetní systém pokrývající malé i větší firmy (4 800+ zákazníků). Standardně řešíme XML / CSV exporty z modulu skladu / fakturace.
- Pohoda (Stormware)
- Rozšířený český účetní program pro menší firmy. Dodavatelé typicky exportují doklady jako XML – Pohoda XML schema mapujeme na kanonický vstup brány.
- Servant
- Menší český fakturační / účetní systém. Pro dodavatele s nižšími objemy nebo specifickými workflow řešíme CSV / XML exporty.
- Vlastní výstupy a další systémy
- Pro zákazníky bez výše uvedených systémů (nebo s vlastním řešením) navrhneme mapování individuálně. V mezních případech doporučujeme rovnou nasadit kanonický formát
pdk-conversion-delivery-note(viz níže).
Specifikace dat nezbytných pro export do PDK
Údaje, které pro vystavení dodacího listu v PDK potřebujeme, jsou popsané v následujícím schematu. Pro nové integrace, kde zákaznický systém ještě nemá zavedený export, lze brány obsluhovat rovnou tímto kanonickým vstupem – JSON nebo XML s pevně definovanou strukturou. Schema je v obou variantách stejné; XML doplňuje XSD pro toolchainy, které ho preferují.
Ke stažení
- JSON Schema (standard Draft 2020-12): pdk-conversion-delivery-note.schema.json
- XSD (XML Schema 1.0): pdk-conversion-delivery-note.xsd
- Ukázka JSON: pdk-conversion-delivery-note.example.json
- Ukázka XML: pdk-conversion-delivery-note.example.xml
Struktura payloadu
| Sekce / pole | Význam | Povinnost |
|---|---|---|
| Identifikace stran | ||
supplier.code | Identifikátor dodavatele (IČ nebo dohodnutý identifikátor). | povinné |
recipient.internalId | Interní stabilní ID odběratele v evidenci dodavatele. | povinné |
recipient.nationalCode | IČ odběratele (8 číslic). | povinné |
recipient.name | Název odběratele. | povinné |
recipient.email | E-mail pro doručovací notifikace. | povinné |
| Hlavička dokumentu | ||
deliveryNoteNumber | Číslo dodacího listu v namespace dodavatele. | povinné |
orderNumber | Číslo objednávky odběratele. | volitelné |
dateOfIssue | Datum vystavení. | povinné |
dateOfDelivery | Datum dodání (pokud se liší od vystavení). | volitelné |
deliveryPlace | Místo doručení (oddělení, pavilon). | volitelné |
totalPriceWithoutTax | Celková cena dokumentu bez DPH. | povinné |
totalPriceWithTax | Celková cena dokumentu s DPH. | povinné |
Položky (items[]) | ||
pdkCode | PDK kód (oficiální od PharmData nebo dohodnutý katalogový). | povinné |
name | Název produktu. | volitelné |
quantity | Počet kusů. | povinné |
unitPriceWithoutTax | Jednotková cena bez DPH. | povinné |
unitPriceWithTax | Jednotková cena s DPH. | povinné |
vatRate | Sazba DPH (např. 12, 21). | povinné |
batchCode | Šarže produktu. | podmíněně |
expirationDate | Datum expirace. | podmíněně |
barcode | EAN / GTIN. | volitelné |
udiCode | UDI (povinné pro zdravotnické prostředky podle EU MDR). | podmíněně |
Přesné regulární výrazy, rozsahy a doplňující popisy jsou v JSON Schema (primární zdroj pravdy; XSD ho zrcadlí 1:1 pro XML).
Doručovací kanály k odběrateli
Vystavený PDK soubor doručujeme odběrateli automaticky. Kromě standardních kanálů (e-mail, doručovací API, sdílená úložiště) podporujeme i specifická řešení podle preference konkrétního odběratele – například eKurýr (uváděný také jako E-kurýr) a další.