Parse FI — UBL (Peppol BIS 3.0)

Parse a FI — UBL (Peppol BIS 3.0) document. No pre-generated sample is shipped for this country/format yet — replace the data field with your own base64-encoded document before sending. Requires e-invoice:fi:ubl:parse entitlement.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
datastringRequired

Base64 encoded document (XML or PDF with embedded XML)

filenamestringOptional

Original filename (helps detect format)

Response

Invoice parsed successfully
successboolean
Whether parsing was successful
invoiceobjectOptional
Extracted invoice data
formatstringOptional

Detected format (e.g., ZUGFERD_EN16931)

hashstringOptional

SHA-256 hash of the input document

errorslist of objectsOptional

Parsing errors (if any)

warningslist of objectsOptional

Parsing warnings (if any)

infoslist of objectsOptional

Informational messages (e.g., XML extracted from PDF)

Errors

400
Ubl Fi Request Bad Request Error
401
Ubl Fi Request Unauthorized Error
403
Ubl Fi Request Forbidden Error
429
Ubl Fi Request Too Many Requests Error
500
Ubl Fi Request Internal Server Error