Raw schema
{
"type": "object",
"properties": {
"invoice": {
"type": "object",
"properties": {
"invoiceNumber": {
"type": "string",
"minLength": 1
},
"issueDate": {
"type": "string",
"description": "ISO date, e.g. '2026-09-01'"
},
"dueDate": {
"type": "string"
},
"typeCode": {
"default": "380",
"type": "string"
},
"currency": {
"type": "string",
"minLength": 3,
"maxLength": 3,
"description": "ISO 4217, e.g. 'EUR'"
},
"buyerReference": {
"type": "string"
},
"seller": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Legal name of the party"
},
"vatId": {
"description": "VAT identifier, e.g. 'FR40303265045'",
"type": "string"
},
"legalId": {
"description": "Legal registration id, e.g. SIREN",
"type": "string"
},
"addressLine": {
"type": "string"
},
"city": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2, e.g. 'FR'"
}
},
"required": [
"name",
"countryCode"
],
"additionalProperties": false
},
"buyer": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Legal name of the party"
},
"vatId": {
"description": "VAT identifier, e.g. 'FR40303265045'",
"type": "string"
},
"legalId": {
"description": "Legal registration id, e.g. SIREN",
"type": "string"
},
"addressLine": {
"type": "string"
},
"city": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"countryCode": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO 3166-1 alpha-2, e.g. 'FR'"
}
},
"required": [
"name",
"countryCode"
],
"additionalProperties": false
},
"lines": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"description": "Item name"
},
"quantity": {
"type": "number"
},
"unitCode": {
"default": "C62",
"type": "string"
},
"unitPrice": {
"type": "number"
},
"netAmount": {
"type": "number"
},
"vatCategory": {
"default": "S",
"description": "VAT category code, e.g. 'S' standard, 'Z' zero, 'E' exempt",
"type": "string"
},
"vatRate": {
"type": "number"
}
},
"required": [
"id",
"name",
"quantity",
"unitPrice",
"netAmount"
],
"additionalProperties": false
}
},
"vatExemptions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"category": {
"type": "string",
"minLength": 1,
"description": "VAT category code the reason applies to, e.g. 'AE'"
},
"reasonCode": {
"description": "VATEX code, e.g. 'VATEX-EU-AE'",
"type": "string"
},
"reasonText": {
"description": "Reason in words, e.g. 'Reverse charge'. Either text or code is enough.",
"type": "string"
}
},
"required": [
"category"
],
"additionalProperties": false
}
},
"prepaidAmount": {
"type": "number"
},
"paymentTerms": {
"type": "string"
},
"payeeIban": {
"type": "string"
}
},
"required": [
"invoiceNumber",
"issueDate",
"currency",
"seller",
"buyer",
"lines"
],
"additionalProperties": false,
"description": "The invoice to produce"
},
"profile": {
"default": "en16931",
"description": "Which specification identifier to stamp on the document",
"type": "string",
"enum": [
"en16931",
"peppol"
]
}
},
"required": [
"invoice"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}