Create Credit Note

The SaveCreditNoteAsync() method allows taxpayers to issue credit notes for previously issued invoices.
Credit notes must always reference the original ZRA invoice (rcptNo) that was returned when the initial sale was posted.

⚠️ Important Notes:

• Credit notes are only valid if they are linked to a prior successful Normal Sale transaction.
• A valid OriginalInvoiceNumber (ZRA’s rcptNo) must be supplied.
• A refund reason must be provided (e.g., product return, discount, error correction).

---

SaveCreditNoteAsync() Method

• Request Parameters:

Field	Type	Required	Description
CISInvoiceNumber	string	Yes	Unique invoice number from the POS/ERP system
CustomerTPIN	string	Yes	Customer’s TPIN
CustomerName	string	Yes	Name of the customer
SalesTypeCode	string	Yes	R = Return (Credit Note)
ReceiptTypeCode	string	Yes	R = Credit Note
OriginalInvoiceNumber	int	Yes	ZRA invoice number (rcptNo) from the original sale
RefundReasonCode	string	Yes	Code explaining reason for credit note (e.g., 01 = Product return)
PaymentTypeCode	string	Yes	01 = Cash, 02 = Credit, etc.
SalesStatusCode	string	Yes	02 = Approved
ConfirmationDateTime	string	Yes	Date/time of credit note (yyyyMMddHHmmss)
SalesDate	string	Yes	Credit note issue date (yyyyMMdd)
TotalItemCount	int	Yes	Number of line items
CurrencyTypeCode	string	Yes	Currency, e.g. ZMW
ExchangeRate	decimal	Yes	Exchange rate used
SaleCategoryCode	string	Yes	2 = Credit Note
ItemList	array	Yes	List of items being credited (similar structure to sale items)

---

Usage Example

Example Successful Response

{
  "success": true,
  "code": "000",
  "message": "Operation completed successfully",
  "timestamp": "2025-09-19 13:35:12",
  "data": {
    "rcptNo": 71,
    "intrlData": "W2I3QZMPW3VKRTFVBFPJMF7WAI",
    "rcptSign": "4JPHZ4JIYSOHNZWH",
    "vsdcRcptPbctDate": "20250919133504",
    "sdcId": "SDC0010002702",
    "mrcNo": "WIS00003709  ",
    "qrCodeUrl": "https://sandboxportal.zra.org.zm/indexInvoiceData?Data=10028907810004JPHZ4JIYSOHNZWH"
  },
  "error": null
}