Issue credit notes to reverse or partially reverse a submitted invoice. Required for refunds, returns, and error corrections under Kenya Revenue Authority eTIMS.

What is a Credit Note

A credit note formally reverses a previously submitted invoice in Kenya Revenue Authority eTIMS. Every refund or return that was originally invoiced must have a corresponding credit note submitted to Kenya Revenue Authority. Without a credit note, the original invoice remains outstanding in Kenya Revenue Authority's system.

When to Issue a Credit Note

Every credit note requires a reason code. Kenya Revenue Authority-approved reason codes:

Submit a Credit Note

Use POST /api/v1/sales/credit-note with KRA-native fields:

• original.invcNo, original invoice number in Kenya Revenue Authority
• lineItems, items being credited
• reason, reason code from the table above

Express Credit Note

Use POST /api/v1/sales/credit-note-express for a simplified flow with orgInvcNo, reason, and lineItems. Ushuru maps these to the full KRA credit note payload.

Barcode Credit Notes

Use POST /api/v1/sales/credit-note-barcode when line items are identified by barcode (bcd field).

Partial Credit Notes

To partially reverse an invoice, include only the items being returned in the lineItems array, with the quantities and amounts being credited. Items not included are not reversed.

After the Credit Note

The receipt for the credit note also requires internalData and receiptSignature from the Kenya Revenue Authority response. Issue a new receipt to the customer showing these fields alongside the credit amount.