Added
New `schematron_validation_status` field on Customer Invoices
July 10th, 2026 by Integrations Squad
We've added a schematron_validation_status field to the Customer Invoice resource, so you can now check the outcome of Schematron structural validation for Factur-X invoices directly from the API.
New field: schematron_validation_status
schematron_validation_statusEvery Customer Invoice response now includes a schematron_validation_status field, right next to factur_x:
{
"id": 123,
"factur_x": true,
"schematron_validation_status": "valid",
...
}| Value | Meaning |
|---|---|
null | The invoice is not a Factur-X document (factur_x: false) |
"pending" | The invoice is Factur-X, and structural validation hasn't completed yet |
"valid" | The invoice passed Schematron structural validation |
"invalid" | The invoice failed Schematron structural validation |
If you're importing Factur-X invoices through the API, you can poll schematron_validation_status to know whether an invoice is structurally valid before relying on it further downstream.
Affected endpoints
GET /customer_invoicesGET /customer_invoices/:idPOST /customer_invoicesPUT /PATCH /customer_invoices/:idPOST /customer_invoices/importsPOST /customer_invoices/create_from_quotePUT /customer_invoices/:id/update_importedPUT /customer_invoices/:id/finalizePOST /customer_invoices/:id/link_credit_note

