Add Reverse Credit Note with Barcodes

POST/api/v1/reverse-credit-notes-barcode

Submit a reverse credit note where items are identified by barcode. Use POST {{API_PATH}}/sales/credit-note-barcode, the same endpoint used for standard barcode credit notes, with salesSttsCd '05' to indicate a credit note on returned goods.

Requires x-api-key

http://localhost:8100/api/v1/reverse-credit-notes-barcode

How to Submit

Field	Type	Required	Description
original.invcNo	number	Required	Original invoice number.
lineItems[].bcd	string	Required	Product barcode for item identification.
reason	string	Required	Reason code. Use '05' for credit note on returned goods.

Request

{
  "original": {
    "invcNo": 42,
    "creditNoteInvcNo": 10042,
    "pmtTyCd": "09"
  },
  "reason": "05",
  "regrId": "USR01",
  "regrNm": "Admin",
  "lineItems": [
    {
      "bcd": "5900000123456",
      "itemNm": "Product Name",
      "qtyUnitCd": "U",
      "qty": 1,
      "prc": 500,
      "taxTyCd": "B",
      "taxblAmt": 431.03,
      "taxAmt": 68.97,
      "totAmt": 500
    }
  ]
}

Response

{
  "success": true,
  "message": "Credit note submitted to Kenya Revenue Authority.",
  "data": {
    "cisInvcNo": 45,
    "intrlData": "AbCdEfGhIjKlMnOpQrStUvWxYz...",
    "rcptSign": "XxXxXxXxXxXxXxXxXxXxXxXx...",
    "sdcDateTime": "20240116110000"
  }
}

curl -X POST http://localhost:8100/api/v1/sales/credit-note-barcode \\
  -H "x-api-key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "original": { "invcNo": 42, "pmtTyCd": "09" },
    "reason": "05",
    "regrId": "USR01",
    "regrNm": "Admin",
    "lineItems": [{
      "bcd": "5900000123456",
      "itemNm": "Product Name",
      "qtyUnitCd": "U",
      "qty": 1,
      "prc": 500,
      "taxTyCd": "B",
      "taxblAmt": 431.03,
      "taxAmt": 68.97,
      "totAmt": 500
    }]
  }'