Raw schema
{
"type": "object",
"properties": {
"seller_legal_entity_id": {
"type": "string",
"description": "REQUIRED. The Storecove legalEntityId of the sender (created in your Storecove account under Senders). Numeric id, passed through to Storecove."
},
"seller_name": {
"type": "string",
"description": "Seller legal/company name."
},
"seller_vat": {
"type": "string",
"description": "Seller Luxembourg VAT (TVA) number, format LUxxxxxxxx (LU + 8 digits). Required — Luxembourg parties are identified on Peppol by their VAT number (scheme 9938)."
},
"seller_address": {
"type": "string",
"description": "Seller street address."
},
"seller_city": {
"type": "string",
"description": "Seller city."
},
"seller_zip": {
"type": "string",
"description": "Seller postal code."
},
"seller_country": {
"type": "string",
"description": "Seller country code. Default LU."
},
"customer_name": {
"type": "string",
"description": "Buyer legal/company name."
},
"customer_vat": {
"type": "string",
"description": "Buyer Luxembourg VAT number LUxxxxxxxx (used to route on Peppol, scheme 9938, if no explicit recipient id is given)."
},
"customer_address": {
"type": "string",
"description": "Buyer street address."
},
"customer_city": {
"type": "string",
"description": "Buyer city."
},
"customer_zip": {
"type": "string",
"description": "Buyer postal code."
},
"customer_country": {
"type": "string",
"description": "Buyer country code. Default LU."
},
"recipient_peppol_scheme": {
"type": "string",
"description": "Optional explicit Peppol routing scheme (EAS/ISO6523). Luxembourg: 9938 (LU VAT number). Default 9938 when routing by VAT number."
},
"recipient_peppol_id": {
"type": "string",
"description": "Optional explicit Peppol participant identifier to route to (overrides deriving from the customer VAT number)."
},
"recipient_email": {
"type": "string",
"description": "Optional email fallback — used if the recipient is not on Peppol (Storecove can email a copy)."
},
"invoice_number": {
"type": "string",
"description": "Invoice number. Auto-generated if omitted."
},
"issue_date": {
"type": "string",
"description": "Invoice issue date, YYYY-MM-DD. Default: today (UTC)."
},
"due_date": {
"type": "string",
"description": "Optional payment due date, YYYY-MM-DD."
},
"currency": {
"type": "string",
"description": "Document currency. Default EUR."
},
"note": {
"type": "string",
"description": "Optional free-text note on the invoice."
},
"lines": {
"type": "array",
"minItems": 1,
"description": "Invoice line items. Each: description, unit_price (net, VAT-exclusive, EUR), vat_rate (17|14|8|3|0), optional quantity (default 1), optional tax_category (S standard / Z zero-rated / E exempt / AE reverse charge; default S for rate>0, Z for rate 0), optional item_name.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "Line description."
},
"unit_price": {
"type": "number",
"description": "Net unit price in EUR, VAT-exclusive."
},
"vat_rate": {
"type": "number",
"description": "Luxembourg VAT rate percent: 17 (standard), 14 (intermediate), 8 (reduced), 3 (super-reduced), or 0."
},
"quantity": {
"type": "number",
"description": "Quantity. Default 1."
},
"tax_category": {
"type": "string",
"description": "Optional EN 16931 tax category: S / Z / E / AE. Default derived from vat_rate."
},
"item_name": {
"type": "string",
"description": "Optional item name (defaults to description)."
}
},
"required": [
"description",
"unit_price",
"vat_rate"
]
}
}
},
"required": [
"seller_legal_entity_id",
"seller_name",
"seller_vat",
"seller_address",
"seller_city",
"seller_zip",
"customer_name",
"customer_address",
"customer_city",
"customer_zip",
"lines"
]
}