eFaktúraOpenAPI JSON ↗

PRE INTEGRÁTOROV

Jedno XML, tri operácie.

Každý endpoint prijíma multipart/form-data s poľom file. Všetky operácie vykonajú plnú serverovú validáciu. Dokumenty sa nearchivujú.

POST endpointVýsledok
/api/v1/validateJSON report (200 aj pri neplatnom XML)
/api/v1/previewReport, model a HTML; 422 pri neplatnom XML
/api/v1/pdfPDF; 422 s JSON reportom pri neplatnom XML

Validácia

curl -F 'file=@faktura.xml' http://localhost:8080/api/v1/validate

PDF

curl --fail-with-body -F 'file=@faktura.xml' \
  http://localhost:8080/api/v1/pdf --output faktura.pdf

Pred uložením odpovede overte HTTP status a Content-Type. Pri chybe dostanete JSON, nie PDF.

Chyby a limity

400: chýbajúci súbor · 413: veľký vstup · 415: nesprávny HTTP obsah · 422: neplatný/nepodporovaný dokument · 503: služba nedostupná, vyťažená alebo časový limit. Prevádzkové chyby majú formát application/problem+json a requestId.

Predvolené limity: 10 MiB XML, 30 sekúnd, dve súbežné úlohy. Formát: UBL 2.1 Invoice/CreditNote, Peppol BIS Billing 3.0, Billing 01.

← Späť na validáciu