add-debit-note

POST

/api/debit-note

Request

Header Params

Body Params application/json

Example

{
  "deviceID": "27322",
  "invoiceNo": "INV-32",
  "receiptNotes": "Add more airtime",

  "receiptLineRequests": [
    {
      "receiptLineId": 31,
      "receiptLineType": "Goods",
      "receiptLineNo": 1,
      "receiptLineName": "Airtime",
      "receiptLinePrice": 200.00,
      "receiptLineQuantity": 4,
      "receiptLineTotal": 800.00,
      "taxPercent": 15.00
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/debit-note' \
--header 'X-Merchant-Id: 311722504951049' \
--header 'X-Merchant-Api-Key: V8S5M2C3L0nYPz8ZDVRhq' \
--header 'X-Merchant-Key: 959d936d-c79a-4711-9528-2d0dc4399142' \
--header 'Content-Type: application/json' \
--data-raw '{
  "deviceID": "27322",
  "invoiceNo": "INV-32",
  "receiptNotes": "Add more airtime",

  "receiptLineRequests": [
    {
      "receiptLineId": 31,
      "receiptLineType": "Goods",
      "receiptLineNo": 1,
      "receiptLineName": "Airtime",
      "receiptLinePrice": 200.00,
      "receiptLineQuantity": 4,
      "receiptLineTotal": 800.00,
      "taxPercent": 15.00
    }
  ]
}'

Responses

🟢200add-debit-note-example

application/json

Body

Example

{
    "statusCode": 200,
    "message": "Successfully submitted receipt",
    "data": {
        "receiptID": 6405633,
        "serverDate": "2025-09-10T16:06:21",
        "receiptServerSignature": {
            "certificateThumbprint": "967C31EBE3BCE74C0255848E999A727A539FC719",
            "hash": "B2C4HyaHV/yYzHyQHm8AKmPSM7iByHR4jGD+J8CgAgY=",
            "signature": "taCT9RISwpwiE4bDSnbNR7pgVQac6B6nu8tgi2Vczj3EnwW1nwWmD0T5ZccZE3gEKeTGnEOmIj+opW/c8o0qrTU23ZMfVLoYfqDa9T/6ORoxl0w/KPbG1dB6hgh5TLc9hYMjZynrVQavslhpHdYlqCIexOcTwyLgivNLYFfRnye3EJzmu/s59a1XOFRFmcDSOPnQcv0I5U38j1HfvWtao++RnzCLq7KqCUFBJDdlFcPEzdA/z3gereb3SGTr/LCgBR0dVpvF2UZkpoBYd8kkSFmFcC1i/XGAEBCYMY6Mu3/hs4DC294E89zqmxjRII6fRT2b8FltCxPqHzHb2DDnJQ=="
        },
        "validationErrors": [
            {
                "validationErrorCode": "RCPT041",
                "validationErrorColor": "Yellow"
            }
        ],
        "operationID": "0HNFGCGSSTBJR:00000001"
    },
    "list": null,
    "qrData": "https://fdmstest.zimra.co.zw/Receipt/Result?ReceiptGlobalNo=0000000035&ReceiptDate=2025-09-10&DeviceId=0000027322&ReceiptQrData=ADE6-C484-FC6B-09B0"
}

Modified at 2025-09-11 11:06:10

add-invoice

add-credit-note