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
- 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. Protože nese i ceny a DPH na úrovni položek, pokrývá většinu polí, která PDK dodací list vyžaduje; některé dodavatelské profily ISDOC slouží přímo jako dodací list. - EDI zprávy – DESADV (eASN), INVOIC, ORDERS
- Avizo dodávky, faktura a objednávka podle standardu UN/EDIFACT, běžně v podmnožině EANCOM od GS1. Zpracováváme je i v XML podobě, včetně profilů komunikátoru ORION (GRIT), které oproti generickému EDIFACTu nesou i ceny, DPH, šarži a expiraci. Podrobnosti a rozsah polí na samostatné stránce EDI.
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
- Česká logistická a fulfillmentová firma (skladování a distribuce, vlastní skladový systém / WMS, na trhu od roku 1990) – není to účetní systém. Pro dodavatele, kteří přes Servant skladují a expedují, zpracováváme CSV exporty z jeho skladového systému; nesou položku, množství, šarži, expiraci i EAN.
- 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).
Výstupní formáty
Vstupní podklad je jedna strana věci; druhou je formát, který očekává konkrétní odběratel. Ten se volí per odběratel, nikoli per dodavatel – jeden vstupní soubor tak podle příjemce skončí v různých výstupech.
- PDK dodací list
- Standard PharmData a hlavní formát elektronických dodacích listů v českém zdravotnictví. Pokrýváme verze 7 až 21, od revize z roku 2008 po verzi platnou od 1. 1. 2026; konkrétní verzi volí to, co umí přijmout systém odběratele. Novější verze přinášejí mimo jiné UDI (od verze 19), zvláštní obchodní přirážky podle § 77g zákona o léčivech nebo referenční číslo EUDR.
- Lekis DL a Lekis XML
- Rozhraní dodacích listů systému Lekis, rozšířeného v lékárnách včetně nemocničních. Umíme textové rozhraní DL6 i DL7 a aktuální Lekis XML v4, které jako jediné z této řady nese UDI. Doručuje se e-mailem.
- ADC / NR SYS (Slovensko)
- Obdoba PDK pro slovenský zdravotnický trh, s kódy ŠÚKL SR. Se standardem PDK není kompatibilní a řeší se jako samostatný výstup.
Doručovací kanály k odběrateli
Vystavený soubor doručujeme odběrateli automaticky. Kromě standardních kanálů jako MEDIDATA e-kurýr (uváděný také jako eKurýr), doručovací API gate, sdílená úložiště či e-mailové adresy podporujeme i specifická řešení podle preference konkrétního odběratele.