ZATCA Debit Note Handling in Sales Invoices

This update introduces Debit Note handling within Sales Invoices for ZATCA compliance.A Debit Note (Invoice Type Code 383) can now be submitted through the same process as Sales Invoices, with proper reference to the original invoice and inclusion of explanatory fields.

Update Summary

• Added support for Debit Note creation in Sales Invoices.
• Applicable to Sales Invoice ( sales_invoice_doc.is_debit_note == 1 ).
• Invoice Type Code for Debit Note is set to 383.
• Includes Invoice Type Code and Billing Reference for the original invoice.
• Supports price adjustments or additional charges referencing an earlier issued invoice.

Implementation Details

1. Invoice Type Code Update

When sales_invoice_doc.is_debit_note == 1, the system sets the invoice type code to 383 (Debit Note).


2. Instruction Note

A descriptive note is added to explain the reason for issuing the debit note.


3. Original Invoice Reference (Billing Reference)

Each Debit Note must reference the original invoice against which it was issued.

Testing Checklist

• Create Sales Invoice (Normal) → Generates InvoiceTypeCode 388.
• Create Debit Note → Generates InvoiceTypeCode 383.
• Debit Note with return_against field → Includes Billing Reference.
• Submit to ZATCA Sandbox → Accepted and validated as Debit Note.