{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Credit Note — Note de Crédit / Creditnota (BE)","description":"Belgian credit note per Code TVA Art. 79 and AR n°1 du 29.12.1992 Art. 13. Must contain all invoice mandatory mentions plus original invoice reference.","type":"object","additionalProperties":false,"required":["letter","entity","client","credit_note"],"properties":{"letter":{"type":"object","additionalProperties":false,"required":["place","date","language"],"description":"Document metadata.","properties":{"place":{"type":"string"},"date":{"type":"string","format":"date"},"language":{"type":"string","enum":["fr","nl","de","en"]},"document_reference":{"type":"string"}}},"entity":{"type":"object","additionalProperties":false,"required":["name","bce_number","vat_number","address","postal_code","commune"],"description":"Credit note issuer identification (Art. 5 §1 3° AR n°1).","properties":{"name":{"type":"string"},"legal_form":{"type":"string"},"bce_number":{"type":"string","pattern":"^[0-9]{4}\\.[0-9]{3}\\.[0-9]{3}$"},"vat_number":{"type":"string","pattern":"^BE0[0-9]{9}$"},"address":{"type":"string"},"postal_code":{"type":"string"},"commune":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string","format":"email"},"iban":{"type":"string","description":"IBAN for refund if applicable."},"bic":{"type":"string"}}},"client":{"type":"object","additionalProperties":false,"required":["name"],"description":"Recipient of the credit note (Art. 5 §1 4° AR n°1).","properties":{"name":{"type":"string"},"vat_number":{"type":"string","description":"Client VAT number if B2B."},"bce_number":{"type":"string"},"address":{"type":"string"},"postal_code":{"type":"string"},"commune":{"type":"string"},"contact_person":{"type":"string"}}},"credit_note":{"type":"object","additionalProperties":false,"required":["number","date","original_invoice_number","original_invoice_date","lines","total_excl_vat","total_incl_vat"],"description":"Credit note body.","properties":{"number":{"type":"string","description":"Sequential credit note number (series CN-YYYY-NNN)."},"date":{"type":"string","format":"date"},"original_invoice_number":{"type":"string","description":"Number of the invoice being corrected (Art. 13 AR n°1)."},"original_invoice_date":{"type":"string","format":"date","description":"Date of the original invoice."},"reason":{"type":"string","description":"Reason for credit note (commercial dispute, return, pricing error, etc.)."},"ratification_required":{"type":"boolean","default":true,"description":"Whether recipient ratification is required per Art. 79 §1 al. 2 Code TVA."},"peppol_routing_id":{"type":"string","description":"Peppol routing identifier for e-invoicing (mandatory B2B from 1.1.2026)."},"lines":{"type":"array","minItems":1,"description":"Credit note lines — each representing a credited item or service.","items":{"type":"object","additionalProperties":false,"required":["description","amount_excl_vat"],"properties":{"description":{"type":"string"},"quantity":{"type":"number","minimum":0},"unit":{"type":"string"},"unit_price_excl_vat":{"type":"number","description":"Unit price excl. VAT (€)."},"vat_rate":{"type":"number","enum":[0,6,12,21],"description":"VAT rate in percent (0/6/12/21 per Code TVA)."},"amount_excl_vat":{"type":"number","description":"Line amount excl. VAT (€). Positive = credit to client."},"vat_amount":{"type":"number","description":"VAT amount for this line (€)."}}}},"vat_breakdown":{"type":"array","description":"VAT summary by rate.","items":{"type":"object","additionalProperties":false,"required":["rate","base_excl_vat","vat_amount"],"properties":{"rate":{"type":"number","enum":[0,6,12,21]},"base_excl_vat":{"type":"number"},"vat_amount":{"type":"number"}}}},"total_excl_vat":{"type":"number","description":"Total credit excl. VAT (€)."},"total_vat":{"type":"number","description":"Total VAT credited (€)."},"total_incl_vat":{"type":"number","description":"Total credit incl. VAT (€)."},"structured_communication":{"type":"string","description":"OGM/VCS structured communication (12 digits, modulo 97)."},"refund_method":{"type":"string","enum":["bank_transfer","deduction_next_invoice","other"],"description":"How the credit will be applied."},"payment_terms":{"type":"string"}}}}}