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 endpoint | Result |
|---|---|
| /api/v1/validate | JSON report (200 even for invalid XML) |
| /api/v1/preview | Report, model and HTML; 422 for invalid XML |
| /api/v1/pdf | PDF; 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
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.