Debit Note

The SaveDebitNoteAsync() method taxpayers to issue debit notes for adjustments such as price corrections or additional charges related to an original invoice. This endpoint ensures proper fiscal recording of adjustments with ZRA through Smart Invoice.

SaveDebitNoteAsync() method

This method is used to submit a debit note to Smart Invoice. It references an original invoice and includes all relevant customer, item, and transaction information.

It ensures the debit note is recorded with the correct amounts, tax details, and reason for adjustment.

If the original invoice number is invalid or missing, the call will fail.

Request Parameters

Parameter	Type	Description
CISInvoiceNumber	string	Unique debit note invoice number
OriginalInvoiceNumber	int	Reference to the original invoice
CustomerTPIN	string	Customer TPIN
CustomerName	string	Customer name
SalesTypeCode	string	“D” for debit note
ReceiptTypeCode	string	“D” for debit note
PaymentTypeCode	string	Payment method code (e.g., “01” for cash)
SalesStatusCode	string	Status code for the sale
ConfirmationDateTime	string	Date/time of confirmation (yyyyMMddHHmmss)
SalesDate	string	Date of sale (yyyyMMdd)
TotalItemCount	int	Total number of items in the debit note
SaleCategoryCode	string	Code representing debit note category
DebitReasonCode	string	Code for reason of debit adjustment
InvoiceAdjustmentReason	string	Reason for invoice adjustment (text)
CurrencyTypeCode	string	Currency (e.g., “ZMW”)
ExchangeRate	decimal	Exchange rate applied
ItemList	list	List of items included in the debit note
TotalTaxableAmount	decimal	Total taxable amount of items
TotalTaxAmount	decimal	Total tax amount
TotalAmount	decimal	Total amount including tax

Usage Example

Example Successful Response

{
  "success": true,
  "code": "000",
  "message": "Operation completed successfully",
  "timestamp": "2025-09-19 13:39:32",
  "data": {
    "rcptNo": 72,
    "intrlData": "226VSL4W45WGDF2ZGT3KNVCAZ4",
    "rcptSign": "TDNXJGZZBXYMO6OR",
    "vsdcRcptPbctDate": "20250919133926",
    "sdcId": "SDC0010002702",
    "mrcNo": "WIS00003709  ",
    "qrCodeUrl": "https://sandboxportal.zra.org.zm/indexInvoiceData?Data=1002890781000TDNXJGZZBXYMO6OR"
  },
  "error": null
}