Rozhodnutie
Vstupné formáty
Za jednu kontrolu zistíte, či máte hotové Peppol UBL, mapovateľné údaje, alebo súbor, ktorý vyžaduje konverziu.
Predpoklady
- Jeden konkrétny príklad dokumentu, ktorý váš softvér dnes vytvorí alebo prijme.
Tri typy vstupu
| Vstup | Ako to spoznáte | Ďalší krok |
|---|---|---|
| Hotové Peppol UBL 2.1 | XML s hlavičkou UBL, profilom Peppol BIS Billing a kompletnými fakturačnými údajmi. | SAPI — dokument sa posiela tak, ako je. |
| Štruktúrované údaje bez UBL | Položky, sumy a strany existujú ako polia, ale XML nevzniká. | Connector — údaje sa vedome mapujú na jeho JSON kontrakt. |
| PDF, sken alebo vlastné XML | Súbor nemá štandardnú UBL štruktúru ani úplné polia. | Nie je to automaticky Connector vstup; najprv overte mapovanie. |
Ako formát overiť
Hotový UBL overte cez POST /api/validate bez autentifikácie: application/xml alebo JSON s poľom xml. Limit je 2 MB a 20 volaní za minútu na IP. Výsledok obsahuje XSD, EN 16931 a Peppol BIS pravidlá; samotné HTTP 200 neznamená platný doklad. Validácia nič neposiela a nepotvrdzuje oprávnenia ani dostupnosť príjemcu.
- Skontrolujte koreňový element, hlavičku a profil dokumentu; názov súboru nič neznamená.
- Overte, že dokument obsahuje všetky povinné fakturačné údaje vrátane strán, položiek a súčtov.
- Pri neistote pošlite jeden reprezentatívny príklad podpore; neposielajte produkčné klientske doklady verejne.
curl -X POST "https://dev.epostak.sk/api/validate" \
-H "Content-Type: application/xml" \
--data-binary @invoice.xmlOčakávaný výsledok
Viete pomenovať svoj vstup a máte priradenú jednu cestu alebo jeden konkrétny overovací krok.
Keď to nefunguje
- Súbor vyzerá ako XML, ale nemá UBL profil: patrí na overenie, nie priamo do SAPI.
- Údaje sú v PDF: PDF nie je dokumentové API; potrebujete konverziu alebo vlastnú tvorbu UBL.