How to Generate ZATCA-Compliant Credit Notes: A Complete Guide for Saudi SMEs

Introduction

In the evolving landscape of Saudi Arabia’s digital economy, compliance with the General Authority of Zakat, Tax and Customs Authority (ZATCA) is not just a legal obligation but a cornerstone of operational excellence. While most businesses have mastered the art of issuing e-invoices, many still struggle with the complexities of Credit Notes.

Whether it is a product return, a pricing error, or a post-invoice discount, generating a ZATCA-compliant credit note requires precision, especially as we transition deeper into Phase 2 (Integration Phase) of the Fatoora project. In this guide, the Qeemah team provides a comprehensive breakdown of how to handle credit notes in accordance with Saudi law.

What is a ZATCA Credit Note?

A credit note (إشعار دائن) is a legal document issued by a seller to a buyer. It serves as a formal notification that the amount owed by the buyer is being reduced. Under ZATCA regulations, credit notes are considered ‘Electronic Notes’ and must follow the same technical standards as the original e-invoices.

Common Scenarios for Credit Notes

1. Sales Returns: When a customer returns goods after the tax invoice has been issued.
2. Pricing Adjustments: If the original invoice had an incorrect price or tax calculation.
3. Damaged Goods: When items arrive damaged and a partial or full refund is granted.
4. Cancellations: When an entire order is cancelled after the invoice has been finalized.

Phase 1 vs. Phase 2 Requirements

Compliance requirements for credit notes differ significantly depending on which phase of e-invoicing your business currently falls under.

Phase 1 (Generation Phase)

In Phase 1, the focus is on generating the document electronically and including the mandatory fields.

• QR Codes: Mandatory for Simplified Credit Notes (B2C).
• Storage: Must be stored in a non-tamperable electronic format.
• Prohibition: Manual or handwritten credit notes are strictly prohibited.

Phase 2 (Integration Phase)

Phase 2 introduces technical ‘Clearance’ and ‘Reporting’ requirements.

• B2B (Standard Credit Notes): Must be sent to ZATCA in real-time for clearance before being shared with the customer.
• B2C (Simplified Credit Notes): Must be reported to ZATCA within 24 hours of issuance.
• XML Format: All credit notes must be generated in UBL 2.1 XML format.
• Cryptographic Stamp: Every note must be digitally signed by your E-Invoicing Solution (EGS).

Mandatory Fields for a Compliant Credit Note

To avoid penalties and rejection, your credit note must include the following data elements:

Field Name	Description	Requirement
Document Type	Must clearly state ‘Credit Note’	Mandatory
Original Invoice Reference	The unique ID of the invoice being adjusted	Mandatory
UUID	A 128-bit Universally Unique Identifier	Phase 2 Mandatory
ICV	Invoice Counter Value (Sequential number)	Phase 2 Mandatory
PIH	Previous Invoice Hash (linking the chain)	Phase 2 Mandatory
QR Code	Encoded TLV data including Seller Name, VAT ID, Timestamp, Total, and VAT Total	Mandatory
Reason for Issuance	A brief description (e.g., ‘Goods Return’)	Highly Recommended

Technical Architecture: The Chain of Trust

In ZATCA Phase 2, credit notes are part of a continuous chain. Every credit note contains a Previous Invoice Hash (PIH). This means that Credit Note #5 must contain a hash of Credit Note #4 (or the previous invoice in the sequence). This ensures that no document can be deleted or altered without breaking the entire chain of records. Use our ZATCA XML Viewer to inspect how these hashes are structured in your files.

Step-by-Step: Generating a Credit Note in Qeemah

Qeemah’s Sales & CRM module automates the entire process to ensure you remain 100% compliant without manual data entry.

1. Locate the Original Invoice: Navigate to the ‘Sales’ tab and find the specific invoice that requires adjustment.
2. Initiate Credit Note: Click on ‘Issue Credit Note’. Qeemah will automatically pull the customer details, VAT registration number, and original line items.
3. Adjust Quantities/Prices: Enter the items being returned or the amount to be credited. Our VAT calculator ensures the tax adjustment is accurate.
4. Review ZATCA Fields: Qeemah automatically generates the UUID, ICV, and links the Original Invoice Reference in the background.
5. Sync with ZATCA: For Phase 2 users, simply click ‘Submit’. Qeemah communicates with the Fatoora portal, receives the cryptographic stamp, and updates the status to ‘Cleared’ or ‘Reported’.
6. Share with Customer: Once cleared, you can email the PDF (containing the compliant QR code) directly to the customer.

Common ZATCA Rejection Errors and How to Fix Them

If your e-invoicing system is not properly configured, ZATCA may reject your credit notes. Here are common error codes:

• BR-KSA-09: The original invoice reference is missing. Fix: Ensure your software links the credit note to a valid invoice ID.
• BR-KSA-10: The credit note total exceeds the original invoice total. Fix: You cannot credit more than what was originally billed.
• KSA-2: The QR code encoding is invalid. Fix: Use our ZATCA QR Decoder to verify your TLV encoding.

Why Manual Compliance is a Risk

Trying to manage ZATCA Phase 2 requirements manually or through legacy software is a high-risk strategy. Errors in XML structure or hashing can lead to significant fines and audits.

💡 Pro Tip: Always verify your readiness before the next integration wave using the ZATCA Readiness Checker.

How Qeemah Helps Your Saudi Business

Qeemah is designed specifically for the Saudi market, ensuring that every financial transaction—from payroll to inventory transfers—is documented according to local regulations.

• Automated Phase 2 Integration: We handle the XML, UUID, and PIH generation so you don’t have to.
• Real-time Validation: Our system checks for errors before submission to ZATCA.
• Integrated Accounting: Credit notes automatically update your Accounting & Finance ledgers and inventory levels.
• Compliance Dashboard: Track the status of every invoice and note sent to the Fatoora portal.

Ready to simplify your ZATCA compliance? Explore Qeemah’s E-Invoicing Features or View our Pricing Plans today.