eFaktúraBIS BILLING

FOR INTEGRATORS

One XML, three operations.

Each endpoint accepts multipart/form-data with the field file. Every operation performs full server-side validation. Documents are not archived.

POST endpointResult
/api/v1/validateJSON report (200 even for invalid XML)
/api/v1/previewReport, model and HTML; 422 for invalid XML
/api/v1/pdfPDF; 422 with a JSON report for invalid XML

Output language

The lang=sk or lang=en parameter sets the language of messages, previews and PDFs. The default is sk. Source XML content is not translated.

Validation

curl -F 'file=@faktura.xml' https://efaktura.dynacore.app/api/v1/validate?lang=en

PDF

curl --fail-with-body -F 'file=@faktura.xml' \
  https://efaktura.dynacore.app/api/v1/pdf?lang=en --output faktura.pdf

Check the HTTP status and Content-Type before saving the response. Errors return JSON, not PDF.

Errors and limits

400: missing file or invalid language · 413: oversized input · 415: wrong HTTP content type · 422: invalid/unsupported document · 503: service unavailable, busy or timed out. Operational errors use application/problem+json and include a requestId.

Default limits: 10 MiB XML, 30 seconds, two concurrent jobs. Format: UBL 2.1 Invoice/CreditNote, Peppol BIS Billing 3.0, Billing 01.

← Back to validation