DEV Community: Anthony Jekanyika

Creating your first ZIMRA Fiscal Invoice with Panier: A Step By Step Guide

Anthony Jekanyika — Thu, 26 Feb 2026 16:13:46 +0000

Now that your ZIMRA Fiscalisation integration is now live, let's create our very first Fiscal Tax Invoice on Panier. If you want to apply for ZIMRA Fiscalisation on Panier see Appling for ZIMRA Fiscalisation with Panier: A Step By Step Guide.

Create Invoice

Go to the Invoices page of your Panier company and click Create.

Add a customer

Click Add Customer in order to create a new customer.

Then after click Create in order to add our new customer to our invoice.

Add Additional Information

Now we add the Payment information, Terms and Conditions and Payment Due date. However the Payment information and; Terms and Conditions are optional fields and can be skipped.

Add a product

Now click Add Product in order to create a new product

Now we create our product making sure to put the HS Code and ZIMRA Tax which in this case is Standard Rated 15.5%. Panier can also help you find your product's HS Code if you add a product description and click Help me find an HS Code. An HS Code is a unique identifiers that can be used to describe any kind of physical product and as of 2025 is now a pre-requisite if you want to create a Fiscal Tax Invoice.

ZIMRA Fiscalise

Now we click the checkbox on the bottom left labelled ZIMRA Fiscalise and click Create.

Preview Invoice

A preview of the Fiscal Tax Invoice will popup.

Panier also allows you choose from 30 background templates.

And 22 color palettes in order to customize your invoice.

Now we click Continue when we are satisfied with our invoice.

Et Voila 🎉

And if you followed the instructions carefully you should have successfully created your very first Fiscal Tax Invoice.

I want you to pay close attention to the QR Code in the center. That is confirmation that our invoice has been fiscalised and if we click the verify link next to it. We will be redirected this ZIMRA portal.

Now lets go back to our invoice page and try to download our Fiscal Tax Invoice.

Your Fiscal Tax Invoice should look something like this:

If you have any questions, please contact me on support@panier.app or on WhatsApp on +263783836915.

Smile & Pay and ZIMRA Fiscalisation Integration with the Panier API: a Step-by-Step Guide

Anthony Jekanyika — Mon, 25 Aug 2025 13:54:29 +0000

Today we will learn how we can use Smile & Pay to receive an instant Ecocash, Innbucks, O'mari or Smile Cash payment and automatically create and send a ZIMRA Fiscal Invoice using a single Panier API call 💪.

First you need to have a Panier account that has been setup with ZIMRA Fiscalisation. If you don't have one, please follow this tutorial.

Setup Smile & Pay Account

Register a Smile Cash account here
Once you have gotten your account approved, go to the API Keys section
Next, we go to the Payment Methods page to select who bearers the transaction cost for each payment method and then click the Save Configurations
Next, click the Generate API Key button and then copy the API Key and API Secret into the fields below and then click Test Integration

When your Smile & Pay integration is now live your Payment Provider page should look like this:

Make an Ecocash Payment

Now lets do an Ecocash payment and automatically create a ZIMRA Fiscal Invoice. You need to go to the Create Sale endpoint and use this payload, making sure to replace the customer_id, product and phone with ones from your Panier account:

{
  "data": {
    "customer_id": "cmaccp0vy0000zmksubook8hd",
    "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "selling_price": 0.10,
          "quantity": 1
        }
     ]
  },
  "zimra_fiscalize": true,
  "payment_method": {
    "type": "SMILE_PAY_ECOCASH",
    "phone": "0772000001",
    "email": "youremail@gmail.com"
  }
}

You should get the following response:

{
  "instructions": "Dial *151*2*7# and enter your EcoCash PIN. Once you have authorized the payment via your handset, please click Check For Payment below to conclude this transaction",
  "pollurl": "https://panier.app/api/v1/payment-provider/check-payment-status?pollurl=https://zbnet.zb.co.zw/wallet_gateway/payments-gateway/payments/transaction/cmeo4ca3r0000v1f8p5wzc99e/status/check"
}

You need to get your customer to follow the instructions on how to make the Ecocash payment. Use the pollurl or Check Payment Status endpoint to check the payment status at regular intervals of about 5 seconds.

When the payment is successful you should get a response like this:

{
  "merchantId": "20250711113952",
  "reference": "GZSZ1181TOCP",
  "orderReference": "cmepw25l9000lv1s07w1gyci9",
  "itemName": null,
  "amount": 0.10,
  "currency": "USD",
  "paymentOption": "ECOCASH",
  "status": "Completed",
  "createdDate": "2025-08-24T18:14:26.416946",
  "returnUrl": "https://panier.app?orderReference=cmepw25l9000lv1s07w1gyci9&transactionReference=GZSZ1181TOCP&status=PENDING",
  "resultUrl": "https://panier.app/api/v1/payment-provider/smile-pay/webhook",
  "clientFee": 0,
  "merchantFee": 0,
  "pollurl": "https://zbnet.zb.co.zw/wallet_gateway/payments-gateway/payments/transaction/cmeo4ca3r0000v1f8p5wzc99e/status/check",
  "sale": {
    "id": "cmaxpey550004zm3nthcoocph",
    "receipt_number": "IPID5V3JJ87E",
    "phone": "0772000001",
    "email": "john@cornerbakery.com",
    "currency": {
      "symbol": "$",
      "name": "US Dollar",
      "symbol_native": "$",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "USD",
      "name_plural": "US dollars",
      "exchange_rate": 1
    },
    "products": [
      {
        "id": "cma5e7aca0000zm1x9aiabiil",
        "name": "Eggs",
        "description": "One dozen large eggs",
        "buying_price": 2.51,
        "sku": "",
        "hs_code": "0808.01.01",
        "is_inventory_item": true,
        "applicable_tax": {
          "id": "cmac8znbu0005zm0gdy8xxoi6",
          "name": "VAT Exempt",
          "percentage": null,
          "code": null,
          "zimra_tax_id": 1
        },
        "_selling_price": 0.10,
        "_quantity": 1,
        "_discount": 0,
        "_total_excluding_tax": 0.10,
        "_tax": 0,
        "_total_including_tax": 0.10
      }
    ],
    "total": 0.01,
    "discount": 0,
    "is_refunded": false,
    "refunded_at": null,
    "is_voided": false,
    "voided_at": null,
    "template_preference": {
      "template": 1,
      "color": "no_color",
      "table_layout": "Plain"
    },
    "updated_at": "2025-05-21T08:51:45.145Z",
    "created_at": "2025-05-21T08:51:45.109Z",
    "customer": {
      "id": "cmaccp0vy0000zmksubook8hd",
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": ""
    },
    "invoice": {
      "id": "cmaxpey460002zm3nryg5glz1",
      "number": "SSK2BURLOLDA",
      "date_format": "dd/mm/yy",
      "date_issued": "2025-05-21T08:51:45.073Z",
      "recipients": [
        "john@cornerbakery.com"
      ],
      "payment_due": "2025-05-21T08:51:45.073Z",
      "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": 2,
        "rounding": 0,
        "code": "USD",
        "name_plural": "US dollars",
        "exchange_rate": 1
      },
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "name": "Eggs",
          "description": "One dozen large eggs",
          "buying_price": 2.51,
          "sku": "",
          "hs_code": "0808.01.01",
          "is_inventory_item": true,
          "applicable_tax": {
            "id": "cmac8znbu0005zm0gdy8xxoi6",
            "name": "VAT Exempt",
            "percentage": null,
            "code": null,
            "zimra_tax_id": 1
          },
          "_selling_price": 0.10,
          "_quantity": 1,
          "_discount": 0,
          "_total_excluding_tax": 0.10,
          "_tax": 0,
          "_total_including_tax": 0.10
        }
      ],
      "total": 0.10,
      "discount": 0,
      "payment_information": null,
      "terms_n_conditions": null,
      "sending_status": "Send Email Notification",
      "quotation_id": null,
      "template_preference": {
        "template": 1,
        "color": "no_color",
        "table_layout": "Plain"
      },
      "is_paid": true,
      "updated_at": "2025-05-21T08:51:45.077Z",
      "created_at": "2025-05-21T08:51:45.077Z",
      "zimra_receipt": {
        "id": "cmaxpey350001zm3n20cv98iv",
        "device_id": 24455,
        "device_serial_number": "HQAUR8QVG29BBY33",
        "receipt_type": "FISCALINVOICE",
        "receipt_currency": "USD",
        "receipt_counter": 2,
        "receipt_global_no": 14,
        "receipt_date": "2025-05-21T10:51:44",
        "receipt_total": 0.10,
        "receipt_taxes": [
          {
            "taxID": 1,
            "taxAmount": 0,
            "salesAmountWithTax": 0.10
          }
        ],
        "previous_receipt_hash": "RNlOmC9SFzBf1f6teHf1sdRvndEBxRrsLmgTEzs2VEw=",
        "result_used_to_hash": "24455FISCALINVOICEUSD142025-05-21T10:51:44101RNlOmC9SFzBf1f6teHf1sdRvndEBxRrsLmgTEzs2VEw=",
        "receipt_hash": "O325QgESIiw1oe+91aHtTlHsVrZDYU1QLqcPYTaiGHI=",
        "signature": "PZuW4HH4x1fkYwKdMj8YQGVI76IF3eP51cpUHdiq42xnZi1SPEGBN7h5rtECOOLkl6egUhlXWXr35Q+TtBgDHitYuc/2J13iJwhdy3xdZCSlz8NV29d73/lziH80AjBYsOC6fV+vJToSWcYuqdSKeIbgBDcOj6CFvCCQegmU9G0mY/e3uqnmXb29TfhiTUQUNz5Y3X2RRWCCfrpFGEZk/S9PeWnjKY7RxJNrKcl11Yp+9GXYjtpsyrbP42JF6gLcGjPbj436ihUmScDoouNdKLEbWabt5FOjtmdUkJ1Xxv1aEpfjt7Nv03d6zofuQ79otLM41bisn0sFMtIjSLGGow==",
        "qr_code_url": "https://fdmstest.zimra.co.zw/0000024455210520250000000014067E79C20E8CEFCE",
        "verification_code": "067E-79C2-0E8C-EFCE",
        "receipt_data": {
          "receipt": {
            "receiptType": "FiscalInvoice",
            "receiptCurrency": "USD",
            "receiptCounter": 2,
            "receiptGlobalNo": 14,
            "receiptDate": "2025-05-21T10:51:44",
            "receiptLinesTaxInclusive": false,
            "receiptLines": [
              {
                "receiptLineType": "Sale",
                "receiptLineNo": 1,
                "receiptLineHSCode": "08080101",
                "receiptLineName": "Eggs",
                "receiptLinePrice": 0.10,
                "receiptLineQuantity": 1,
                "receiptLineTotal": 0.10,
                "taxID": 1
              }
            ],
            "receiptTaxes": [
              {
                "taxID": 1,
                "taxAmount": 0,
                "salesAmountWithTax": 0.10
              }
            ],
            "receiptPayments": [
              {
                "moneyTypeCode": "MobileWallet",
                "paymentAmount": 0.10
              }
            ],
            "receiptTotal": 0.10,
            "receiptPrintForm": "InvoiceA4",
            "receiptDeviceSignature": {
              "hash": "O325QgESIiw1oe+91aHtTlHsVrZDYU1QLqcPYTaiGHI=",
              "signature": "PZuW4HH4x1fkYwKdMj8YQGVI76IF3eP51cpUHdiq42xnZi1SPEGBN7h5rtECOOLkl6egUhlXWXr35Q+TtBgDHitYuc/2J13iJwhdy3xdZCSlz8NV29d73/lziH80AjBYsOC6fV+vJToSWcYuqdSKeIbgBDcOj6CFvCCQegmU9G0mY/e3uqnmXb29TfhiTUQUNz5Y3X2RRWCCfrpFGEZk/S9PeWnjKY7RxJNrKcl11Yp+9GXYjtpsyrbP42JF6gLcGjPbj436ihUmScDoouNdKLEbWabt5FOjtmdUkJ1Xxv1aEpfjt7Nv03d6zofuQ79otLM41bisn0sFMtIjSLGGow=="
            },
            "invoiceNo": "SSK2BURLOLDA"
          }
        },
        "server_response": {
          "receiptID": 5960796,
          "serverDate": "2025-05-21T10:51:44",
          "receiptServerSignature": {
            "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
            "hash": "IESbgGq5bHwGtZnm4lzknj785mCkcfTG24hZWP7L65M=",
            "signature": "gZC4ZSmOqDiBtXmxaIJF0jTunrFBnRfk9dizbBpGVp62i4+0jopEbkmgjjsShXDGv8NtxNjoeJ6Pi65IdrL7UhQ9dEbeA9x9Lmp8dzko138uMg9Ey9WVYMmHoISSwdHSUuetHUk0x6x2RvyUjaV32RlotHMDoyPhvEjDxkZu/+ar58n+9dCvl5hBP6u2yaFGe5QX6wrr5WxhgPZhkLAqyayPTow2m6LNVVP5GK66VZdC+xRFxealMx2BdbPrxpzHNOb5GmMACfqHz5wvPpMYuZL8LEzSYAJzKzQFbNgRgqNg5YNHKRp2L+vQbEbcy/hszjVn0v3UysFo3xTlYkzXDg=="
          },
          "validationErrors": [],
          "operationID": "0HNCDUV5BOVT4:00000001"
        },
        "validation_errors": [],
        "fiscal_day_no": 4,
        "updated_at": "2025-05-21T08:51:45.077Z",
        "created_at": "2025-05-21T08:51:45.041Z"
      }
    }
  }
}

Make an Innbucks Payment

Now lets do an Innbucks payment and automatically create a ZIMRA Fiscal Invoice. You need to go to the Create Sale endpoint and use this payload, making sure to replace the customer_id, product and phone with ones from your Panier account:

{
  "data": {
    "customer_id": "cmaccp0vy0000zmksubook8hd",
    "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "selling_price": 0.10,
          "quantity": 1
        }
     ]
  },
  "zimra_fiscalize": true,
  "payment_method": {
    "type": "SMILE_PAY_INNBUCKS",
    "phone": "0772000001",
    "email": "youremail@gmail.com"
  }
}

You should get the following response:

{
  "innbucksPaymentCode": "601822521",
  "deep_link_url": "schinn.wbpycode://innbucks.co.zw?pymInnCode=601822521",
  "qr_code": "https://chart.googleapis.com/chart?cht=qr&chs=200x200&chl=601822521",
  "innbucks_expires_at": "21-May-2025 12:19",
  "pollurl": "https://panier.app/api/v1/payment-provider/check-payment-status?pollurl=https://zbnet.zb.co.zw/wallet_gateway/payments-gateway/payments/transaction/cmepw25l9000lv1s07w1gyci9/status/check",
  "responseMessage": "success",
  "responseCode": "00",
  "status": "AWAITING_PAYMENT",
  "orderReference": "cmepw25l9000lv1s07w1gyci9",
  "transactionReference": "GZSZ1181TOCP"
}

You need to get your customer to follow the instructions on how to make the Innbucks payment. Use the pollurl or Check Payment Status endpoint to check the payment status at regular intervals of about 5 seconds.

When the payment is successful you should get a response like this:

{
  "merchantId": "20250711113952",
  "reference": "GZSZ1181TOCP",
  "orderReference": "cmepw25l9000lv1s07w1gyci9",
  "itemName": null,
  "amount": 0.10,
  "currency": "USD",
  "paymentOption": "ECOCASH",
  "status": "Completed",
  "createdDate": "2025-08-24T18:14:26.416946",
  "returnUrl": "https://panier.app?orderReference=cmepw25l9000lv1s07w1gyci9&transactionReference=GZSZ1181TOCP&status=PENDING",
  "resultUrl": "https://panier.app/api/v1/payment-provider/smile-pay/webhook",
  "clientFee": 0,
  "merchantFee": 0,
  "pollurl": "https://zbnet.zb.co.zw/wallet_gateway/payments-gateway/payments/transaction/cmepw25l9000lv1s07w1gyci9/status/check",
  "sale": {
    "id": "cmaxsdzpl000rzm0dqilmlkh0",
    "receipt_number": "KMY7WYXEMOM9",
    "phone": "0772000001",
    "email": "john@cornerbakery.com",
    "currency": {
      "symbol": "$",
      "name": "US Dollar",
      "symbol_native": "$",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "USD",
      "name_plural": "US dollars",
      "exchange_rate": 1
    },
    "products": [
      {
        "id": "cma5e7aca0000zm1x9aiabiil",
        "name": "Eggs",
        "description": "One dozen large eggs",
        "buying_price": 2.51,
        "sku": "",
        "hs_code": "0808.01.01",
        "is_inventory_item": true,
        "applicable_tax": {
          "id": "cmac8znbu0005zm0gdy8xxoi6",
          "name": "VAT Exempt",
          "percentage": null,
          "code": null,
          "zimra_tax_id": 1
        },
        "_selling_price": 0.01,
        "_quantity": 1,
        "_discount": 0,
        "_total_excluding_tax": 0.01,
        "_tax": 0,
        "_total_including_tax": 0.01
      }
    ],
    "total": 0.01,
    "discount": 0,
    "is_refunded": false,
    "refunded_at": null,
    "is_voided": false,
    "voided_at": null,
    "template_preference": {
      "template": 1,
      "color": "no_color",
      "table_layout": "Plain"
    },
    "updated_at": "2025-05-21T10:14:59.357Z",
    "created_at": "2025-05-21T10:14:59.338Z",
    "customer": {
      "id": "cmaccp0vy0000zmksubook8hd",
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": ""
    },
    "invoice": {
      "id": "cmaxsdzor000pzm0dnh8cfbtl",
      "number": "39DC6U5EM65J",
      "date_format": "dd/mm/yy",
      "date_issued": "2025-05-21T10:14:59.305Z",
      "recipients": [
        "john@cornerbakery.com"
      ],
      "payment_due": "2025-05-21T10:14:59.305Z",
      "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": 2,
        "rounding": 0,
        "code": "USD",
        "name_plural": "US dollars",
        "exchange_rate": 1
      },
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "name": "Eggs",
          "description": "One dozen large eggs",
          "buying_price": 2.51,
          "sku": "",
          "hs_code": "0808.01.01",
          "is_inventory_item": true,
          "applicable_tax": {
            "id": "cmac8znbu0005zm0gdy8xxoi6",
            "name": "VAT Exempt",
            "percentage": null,
            "code": null,
            "zimra_tax_id": 1
          },
          "_selling_price": 0.01,
          "_quantity": 1,
          "_discount": 0,
          "_total_excluding_tax": 0.01,
          "_tax": 0,
          "_total_including_tax": 0.01
        }
      ],
      "total": 0.01,
      "discount": 0,
      "payment_information": null,
      "terms_n_conditions": null,
      "sending_status": "Send Email Notification",
      "quotation_id": null,
      "template_preference": {
        "template": 1,
        "color": "no_color",
        "table_layout": "Plain"
      },
      "is_paid": true,
      "updated_at": "2025-05-21T10:14:59.307Z",
      "created_at": "2025-05-21T10:14:59.307Z",
      "zimra_receipt": {
        "id": "cmaxsdzoc000ozm0dee2jtytg",
        "device_id": 24455,
        "device_serial_number": "HQAUR8QVG29BBY33",
        "receipt_type": "FISCALINVOICE",
        "receipt_currency": "USD",
        "receipt_counter": 4,
        "receipt_global_no": 16,
        "receipt_date": "2025-05-21T12:14:58",
        "receipt_total": 0.01,
        "receipt_taxes": [
          {
            "taxID": 1,
            "taxAmount": 0,
            "salesAmountWithTax": 0.01
          }
        ],
        "previous_receipt_hash": "fNFmaw6tK30NEVJP/bF0wIp5S0xWMrRu6EG8EFOJ/ss=",
        "result_used_to_hash": "24455FISCALINVOICEUSD162025-05-21T12:14:58101fNFmaw6tK30NEVJP/bF0wIp5S0xWMrRu6EG8EFOJ/ss=",
        "receipt_hash": "qUk5/6/cdCyoo/T2FTk9mq2tPHDDp1tNgo/pG11fwoU=",
        "signature": "AfuRWXk1X2Hw5wjjiPizGQAdug6M+e5+jQ7iSFXabPgmXTGRzhcw3EH6LEiAX6B/MN+c2l15x0DTBqN51C0Z97MvL+DPhq0+skb0CJoFydLJBAzYhR/nf6tZvIIcokYWHl6rtSVr3bgF8XNpEB8Q6foN+dn2CpLlvZdwB4eqRu5o8oxjoTH/VKbChDdGeWYwjuwYiMPGPdB2Ov1sFSIcNNHL2qkmhoE4balSugYvjhagNLDca27r2S2uXJSHZh+70BregHuxYr5xuWUNbiP6NmeZl8T8VB8lm8i/oDl7WC22sTePYObggygOkbjvguk0kp2mktwahDlY3tqELnk9fg==",
        "qr_code_url": "https://fdmstest.zimra.co.zw/0000024455210520250000000016737506EB7E49AE71",
        "verification_code": "7375-06EB-7E49-AE71",
        "receipt_data": {
          "receipt": {
            "receiptType": "FiscalInvoice",
            "receiptCurrency": "USD",
            "receiptCounter": 4,
            "receiptGlobalNo": 16,
            "receiptDate": "2025-05-21T12:14:58",
            "receiptLinesTaxInclusive": false,
            "receiptLines": [
              {
                "receiptLineType": "Sale",
                "receiptLineNo": 1,
                "receiptLineHSCode": "08080101",
                "receiptLineName": "Eggs",
                "receiptLinePrice": 0.01,
                "receiptLineQuantity": 1,
                "receiptLineTotal": 0.01,
                "taxID": 1
              }
            ],
            "receiptTaxes": [
              {
                "taxID": 1,
                "taxAmount": 0,
                "salesAmountWithTax": 0.01
              }
            ],
            "receiptPayments": [
              {
                "moneyTypeCode": "MobileWallet",
                "paymentAmount": 0.01
              }
            ],
            "receiptTotal": 0.01,
            "receiptPrintForm": "InvoiceA4",
            "receiptDeviceSignature": {
              "hash": "qUk5/6/cdCyoo/T2FTk9mq2tPHDDp1tNgo/pG11fwoU=",
              "signature": "AfuRWXk1X2Hw5wjjiPizGQAdug6M+e5+jQ7iSFXabPgmXTGRzhcw3EH6LEiAX6B/MN+c2l15x0DTBqN51C0Z97MvL+DPhq0+skb0CJoFydLJBAzYhR/nf6tZvIIcokYWHl6rtSVr3bgF8XNpEB8Q6foN+dn2CpLlvZdwB4eqRu5o8oxjoTH/VKbChDdGeWYwjuwYiMPGPdB2Ov1sFSIcNNHL2qkmhoE4balSugYvjhagNLDca27r2S2uXJSHZh+70BregHuxYr5xuWUNbiP6NmeZl8T8VB8lm8i/oDl7WC22sTePYObggygOkbjvguk0kp2mktwahDlY3tqELnk9fg=="
            },
            "invoiceNo": "39DC6U5EM65J"
          }
        },
        "server_response": {
          "receiptID": 5961141,
          "serverDate": "2025-05-21T12:14:59",
          "receiptServerSignature": {
            "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
            "hash": "aWJBHwqQR2M40iWgiVEAqtc8UtrFBKkz0eRoBkGPXdc=",
            "signature": "F35BHzB5BHurc3jEBsVeexZNkl8kwpQn4Sp8K1xGr13SjEqKdF6WkkPo9xqBBAJ8jQHZunnINrX0nluPbMUmJIte5Cea9esth95nH68fiMWhSdtWR3ikmrQ61+KxJKSCGX9rLzVcQzvYDX7jjVO8WEU5tLymrM0uCMZWMQ4npDsNK9aLRekcbf9L+2kFJLnMqs4qf2/PMvFsvIRCFdrQXOYYFzPDm8LuKpCx3yybS9RIG/7b4JmQ4auOmrEQxaGH+TWUPlxtjeJTFM8nUY7G/Afhpe7txJGs/X3ksHgw0CzdCgz5eEZC23tjfAs1UBKtyWowP7LTuL6CxkbhFYfnVg=="
          },
          "validationErrors": [],
          "operationID": "0HNCDUV5BQ539:00000001"
        },
        "validation_errors": [],
        "fiscal_day_no": 4,
        "updated_at": "2025-05-21T10:14:59.307Z",
        "created_at": "2025-05-21T10:14:59.292Z"
      }
    }
  }
}

If your customer was created with an email address in your Panier account, they will receive a PDF attached email like this:

Closing Statement

We also recommend that you go over our article on ZIMRA Fiscalisation with the Panier API: A Step-by-Step Guide so that you can also learn how to Create Credit Notes and Create Debit Notes. If you have any questions feel free to ask in the comments section or contact me directly on support@panier.app and I will get back to you has quickly as I can.

Paynow and ZIMRA Fiscalisation Integration with the Panier API: a Step-by-Step Guide

Anthony Jekanyika — Wed, 21 May 2025 14:29:05 +0000

Today we will learn how we can use Paynow to receive an instant Ecocash or Innbucks payment and automatically create and send a ZIMRA Fiscal Invoice using a single Panier API call 💪.

First you need to have a Panier account that has been setup with ZIMRA Fiscalisation. If you don't have one, please follow this tutorial.

Setup Paynow Account

Register as a Paynow Merchant here
Go to the Payment Methods section and then add Ecocash (USD) and Innbucks (USD) payment methods (Panier currently only supports these payment methods and only in USD)
Next, go to the Create 3rd Party Shopping Cart or Link section and fill out the form, making sure to select all the previously added payment methods, that is, Ecocash and Innbucks
Unselect the Require Customer Name and Require Customer Phone check boxes (You can enter anything that you want under name)
Click Save to complete the form
Go to the Payment Provider page of your Panier account and copy down the Email that you used to create the Paynow merchant account, Integration ID and Integration Key into the fields in the image below and then click Test Transaction

When your Paynow integration is now live your Payment Provider page should look like this:

Make an Ecocash Payment

{
  "data": {
    "customer_id": "cmaccp0vy0000zmksubook8hd",
    "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "selling_price": 0.10,
          "quantity": 1
        }
     ]
  },
  "zimra_fiscalize": true,
  "payment_method": {
    "type": "PAYNOW_ECOCASH",
    "phone": "0772000001",
    "email": "youremail@gmail.com"
  }
}

You should get the following response:

{
  "instructions": "Dial *151*2*7# and enter your EcoCash PIN. Once you have authorized the payment via your handset, please click Check For Payment below to conclude this transaction",
  "pollurl": "https://panier.app/api/v1/payment-provider/paynow/check-payment-status?pollurl=https://www.paynow.co.zw/Interface/CheckPayment/?guid=c3909f34-7a1f-4dda-a99c-2954cfa67e11"
}

When the payment is successful you should get a response like this:

{
  "reference": "cmaxpemg40007zm1gd5x5jng7",
  "paynowreference": "25107608",
  "amount": "0.10",
  "status": "Completed",
  "pollurl": "https%3a%2f%2fwww.paynow.co.zw%2fInterface%2fCheckPayment%2f%3fguid%3daf008834-edf0-4e41-aea1-5e0422095fae",
  "hash": "C06C9AB2B90823B0D39B1CD058D0943C944DD75FC2EE1BA4D66F506FE8F6DD4C0D7F3925DF667D20EB4A4C10AA1C511AF327D06D059FCE691B9140545468BA00",
  "direct_paynow_pollurl": "https://www.paynow.co.zw/Interface/CheckPayment/?guid=af008834-edf0-4e41-aea1-5e0422095fae",
  "sale": {
    "id": "cmaxpey550004zm3nthcoocph",
    "receipt_number": "IPID5V3JJ87E",
    "phone": "0772000001",
    "email": "john@cornerbakery.com",
    "currency": {
      "symbol": "$",
      "name": "US Dollar",
      "symbol_native": "$",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "USD",
      "name_plural": "US dollars",
      "exchange_rate": 1
    },
    "products": [
      {
        "id": "cma5e7aca0000zm1x9aiabiil",
        "name": "Eggs",
        "description": "One dozen large eggs",
        "buying_price": 2.51,
        "sku": "",
        "hs_code": "0808.01.01",
        "is_inventory_item": true,
        "applicable_tax": {
          "id": "cmac8znbu0005zm0gdy8xxoi6",
          "name": "VAT Exempt",
          "percentage": null,
          "code": null,
          "zimra_tax_id": 1
        },
        "_selling_price": 0.10,
        "_quantity": 1,
        "_discount": 0,
        "_total_excluding_tax": 0.10,
        "_tax": 0,
        "_total_including_tax": 0.10
      }
    ],
    "total": 0.01,
    "discount": 0,
    "is_refunded": false,
    "refunded_at": null,
    "is_voided": false,
    "voided_at": null,
    "template_preference": {
      "template": 1,
      "color": "no_color",
      "table_layout": "Plain"
    },
    "updated_at": "2025-05-21T08:51:45.145Z",
    "created_at": "2025-05-21T08:51:45.109Z",
    "customer": {
      "id": "cmaccp0vy0000zmksubook8hd",
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": ""
    },
    "invoice": {
      "id": "cmaxpey460002zm3nryg5glz1",
      "number": "SSK2BURLOLDA",
      "date_format": "dd/mm/yy",
      "date_issued": "2025-05-21T08:51:45.073Z",
      "recipients": [
        "john@cornerbakery.com"
      ],
      "payment_due": "2025-05-21T08:51:45.073Z",
      "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": 2,
        "rounding": 0,
        "code": "USD",
        "name_plural": "US dollars",
        "exchange_rate": 1
      },
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "name": "Eggs",
          "description": "One dozen large eggs",
          "buying_price": 2.51,
          "sku": "",
          "hs_code": "0808.01.01",
          "is_inventory_item": true,
          "applicable_tax": {
            "id": "cmac8znbu0005zm0gdy8xxoi6",
            "name": "VAT Exempt",
            "percentage": null,
            "code": null,
            "zimra_tax_id": 1
          },
          "_selling_price": 0.10,
          "_quantity": 1,
          "_discount": 0,
          "_total_excluding_tax": 0.10,
          "_tax": 0,
          "_total_including_tax": 0.10
        }
      ],
      "total": 0.10,
      "discount": 0,
      "payment_information": null,
      "terms_n_conditions": null,
      "sending_status": "Send Email Notification",
      "quotation_id": null,
      "template_preference": {
        "template": 1,
        "color": "no_color",
        "table_layout": "Plain"
      },
      "is_paid": true,
      "updated_at": "2025-05-21T08:51:45.077Z",
      "created_at": "2025-05-21T08:51:45.077Z",
      "zimra_receipt": {
        "id": "cmaxpey350001zm3n20cv98iv",
        "device_id": 24455,
        "device_serial_number": "HQAUR8QVG29BBY33",
        "receipt_type": "FISCALINVOICE",
        "receipt_currency": "USD",
        "receipt_counter": 2,
        "receipt_global_no": 14,
        "receipt_date": "2025-05-21T10:51:44",
        "receipt_total": 0.10,
        "receipt_taxes": [
          {
            "taxID": 1,
            "taxAmount": 0,
            "salesAmountWithTax": 0.10
          }
        ],
        "previous_receipt_hash": "RNlOmC9SFzBf1f6teHf1sdRvndEBxRrsLmgTEzs2VEw=",
        "result_used_to_hash": "24455FISCALINVOICEUSD142025-05-21T10:51:44101RNlOmC9SFzBf1f6teHf1sdRvndEBxRrsLmgTEzs2VEw=",
        "receipt_hash": "O325QgESIiw1oe+91aHtTlHsVrZDYU1QLqcPYTaiGHI=",
        "signature": "PZuW4HH4x1fkYwKdMj8YQGVI76IF3eP51cpUHdiq42xnZi1SPEGBN7h5rtECOOLkl6egUhlXWXr35Q+TtBgDHitYuc/2J13iJwhdy3xdZCSlz8NV29d73/lziH80AjBYsOC6fV+vJToSWcYuqdSKeIbgBDcOj6CFvCCQegmU9G0mY/e3uqnmXb29TfhiTUQUNz5Y3X2RRWCCfrpFGEZk/S9PeWnjKY7RxJNrKcl11Yp+9GXYjtpsyrbP42JF6gLcGjPbj436ihUmScDoouNdKLEbWabt5FOjtmdUkJ1Xxv1aEpfjt7Nv03d6zofuQ79otLM41bisn0sFMtIjSLGGow==",
        "qr_code_url": "https://fdmstest.zimra.co.zw/0000024455210520250000000014067E79C20E8CEFCE",
        "verification_code": "067E-79C2-0E8C-EFCE",
        "receipt_data": {
          "receipt": {
            "receiptType": "FiscalInvoice",
            "receiptCurrency": "USD",
            "receiptCounter": 2,
            "receiptGlobalNo": 14,
            "receiptDate": "2025-05-21T10:51:44",
            "receiptLinesTaxInclusive": false,
            "receiptLines": [
              {
                "receiptLineType": "Sale",
                "receiptLineNo": 1,
                "receiptLineHSCode": "08080101",
                "receiptLineName": "Eggs",
                "receiptLinePrice": 0.10,
                "receiptLineQuantity": 1,
                "receiptLineTotal": 0.10,
                "taxID": 1
              }
            ],
            "receiptTaxes": [
              {
                "taxID": 1,
                "taxAmount": 0,
                "salesAmountWithTax": 0.10
              }
            ],
            "receiptPayments": [
              {
                "moneyTypeCode": "MobileWallet",
                "paymentAmount": 0.10
              }
            ],
            "receiptTotal": 0.10,
            "receiptPrintForm": "InvoiceA4",
            "receiptDeviceSignature": {
              "hash": "O325QgESIiw1oe+91aHtTlHsVrZDYU1QLqcPYTaiGHI=",
              "signature": "PZuW4HH4x1fkYwKdMj8YQGVI76IF3eP51cpUHdiq42xnZi1SPEGBN7h5rtECOOLkl6egUhlXWXr35Q+TtBgDHitYuc/2J13iJwhdy3xdZCSlz8NV29d73/lziH80AjBYsOC6fV+vJToSWcYuqdSKeIbgBDcOj6CFvCCQegmU9G0mY/e3uqnmXb29TfhiTUQUNz5Y3X2RRWCCfrpFGEZk/S9PeWnjKY7RxJNrKcl11Yp+9GXYjtpsyrbP42JF6gLcGjPbj436ihUmScDoouNdKLEbWabt5FOjtmdUkJ1Xxv1aEpfjt7Nv03d6zofuQ79otLM41bisn0sFMtIjSLGGow=="
            },
            "invoiceNo": "SSK2BURLOLDA"
          }
        },
        "server_response": {
          "receiptID": 5960796,
          "serverDate": "2025-05-21T10:51:44",
          "receiptServerSignature": {
            "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
            "hash": "IESbgGq5bHwGtZnm4lzknj785mCkcfTG24hZWP7L65M=",
            "signature": "gZC4ZSmOqDiBtXmxaIJF0jTunrFBnRfk9dizbBpGVp62i4+0jopEbkmgjjsShXDGv8NtxNjoeJ6Pi65IdrL7UhQ9dEbeA9x9Lmp8dzko138uMg9Ey9WVYMmHoISSwdHSUuetHUk0x6x2RvyUjaV32RlotHMDoyPhvEjDxkZu/+ar58n+9dCvl5hBP6u2yaFGe5QX6wrr5WxhgPZhkLAqyayPTow2m6LNVVP5GK66VZdC+xRFxealMx2BdbPrxpzHNOb5GmMACfqHz5wvPpMYuZL8LEzSYAJzKzQFbNgRgqNg5YNHKRp2L+vQbEbcy/hszjVn0v3UysFo3xTlYkzXDg=="
          },
          "validationErrors": [],
          "operationID": "0HNCDUV5BOVT4:00000001"
        },
        "validation_errors": [],
        "fiscal_day_no": 4,
        "updated_at": "2025-05-21T08:51:45.077Z",
        "created_at": "2025-05-21T08:51:45.041Z"
      }
    }
  }
}

Make an Innbucks Payment

{
  "data": {
    "customer_id": "cmaccp0vy0000zmksubook8hd",
    "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "selling_price": 0.10,
          "quantity": 1
        }
     ]
  },
  "zimra_fiscalize": true,
  "payment_method": {
    "type": "PAYNOW_INNBUCKS",
    "phone": "0772000001",
    "email": "youremail@gmail.com"
  }
}

You should get the following response:

{
  "instructions": "Dial *569#. Log into your Innbucks Account. Select Pay and enter 601822521 as your 2D Code.",
  "authorizationcode": "601822521",
  "deep_link_url": "schinn.wbpycode://innbucks.co.zw?pymInnCode=601822521",
  "qr_code": "https://chart.googleapis.com/chart?cht=qr&chs=200x200&chl=601822521",
  "expires_at": "21-May-2025 12:19",
  "pollurl": "https://panier.app/api/v1/payment-provider/paynow/check-payment-status?pollurl=https://www.paynow.co.zw/Interface/CheckPayment/?guid=b73f9d55-4a9d-46b6-a221-b0bca0d9ef47"
}

When the payment is successful you should get a response like this:

{
  "reference": "cmaxsceop0005zm1fe8ue6bte",
  "paynowreference": "25111200",
  "amount": "0.01",
  "status": "Completed",
  "pollurl": "https%3a%2f%2fwww.paynow.co.zw%2fInterface%2fCheckPayment%2f%3fguid%3d252399f2-ea8b-4a25-989d-0f7e1baefff0",
  "hash": "C7C85B344262A1B2A8C10FB154151C71D01FB62CF0CC8397964F879B3CAEB2D3BE29EEA82EF43BD997B870A0ECC24F4BEFAA9328748876F5D0E919F493865805",
  "direct_paynow_pollurl": "https://www.paynow.co.zw/Interface/CheckPayment/?guid=252399f2-ea8b-4a25-989d-0f7e1baefff0",
  "sale": {
    "id": "cmaxsdzpl000rzm0dqilmlkh0",
    "receipt_number": "KMY7WYXEMOM9",
    "phone": "0772000001",
    "email": "john@cornerbakery.com",
    "currency": {
      "symbol": "$",
      "name": "US Dollar",
      "symbol_native": "$",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "USD",
      "name_plural": "US dollars",
      "exchange_rate": 1
    },
    "products": [
      {
        "id": "cma5e7aca0000zm1x9aiabiil",
        "name": "Eggs",
        "description": "One dozen large eggs",
        "buying_price": 2.51,
        "sku": "",
        "hs_code": "0808.01.01",
        "is_inventory_item": true,
        "applicable_tax": {
          "id": "cmac8znbu0005zm0gdy8xxoi6",
          "name": "VAT Exempt",
          "percentage": null,
          "code": null,
          "zimra_tax_id": 1
        },
        "_selling_price": 0.01,
        "_quantity": 1,
        "_discount": 0,
        "_total_excluding_tax": 0.01,
        "_tax": 0,
        "_total_including_tax": 0.01
      }
    ],
    "total": 0.01,
    "discount": 0,
    "is_refunded": false,
    "refunded_at": null,
    "is_voided": false,
    "voided_at": null,
    "template_preference": {
      "template": 1,
      "color": "no_color",
      "table_layout": "Plain"
    },
    "updated_at": "2025-05-21T10:14:59.357Z",
    "created_at": "2025-05-21T10:14:59.338Z",
    "customer": {
      "id": "cmaccp0vy0000zmksubook8hd",
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": ""
    },
    "invoice": {
      "id": "cmaxsdzor000pzm0dnh8cfbtl",
      "number": "39DC6U5EM65J",
      "date_format": "dd/mm/yy",
      "date_issued": "2025-05-21T10:14:59.305Z",
      "recipients": [
        "john@cornerbakery.com"
      ],
      "payment_due": "2025-05-21T10:14:59.305Z",
      "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": 2,
        "rounding": 0,
        "code": "USD",
        "name_plural": "US dollars",
        "exchange_rate": 1
      },
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "name": "Eggs",
          "description": "One dozen large eggs",
          "buying_price": 2.51,
          "sku": "",
          "hs_code": "0808.01.01",
          "is_inventory_item": true,
          "applicable_tax": {
            "id": "cmac8znbu0005zm0gdy8xxoi6",
            "name": "VAT Exempt",
            "percentage": null,
            "code": null,
            "zimra_tax_id": 1
          },
          "_selling_price": 0.01,
          "_quantity": 1,
          "_discount": 0,
          "_total_excluding_tax": 0.01,
          "_tax": 0,
          "_total_including_tax": 0.01
        }
      ],
      "total": 0.01,
      "discount": 0,
      "payment_information": null,
      "terms_n_conditions": null,
      "sending_status": "Send Email Notification",
      "quotation_id": null,
      "template_preference": {
        "template": 1,
        "color": "no_color",
        "table_layout": "Plain"
      },
      "is_paid": true,
      "updated_at": "2025-05-21T10:14:59.307Z",
      "created_at": "2025-05-21T10:14:59.307Z",
      "zimra_receipt": {
        "id": "cmaxsdzoc000ozm0dee2jtytg",
        "device_id": 24455,
        "device_serial_number": "HQAUR8QVG29BBY33",
        "receipt_type": "FISCALINVOICE",
        "receipt_currency": "USD",
        "receipt_counter": 4,
        "receipt_global_no": 16,
        "receipt_date": "2025-05-21T12:14:58",
        "receipt_total": 0.01,
        "receipt_taxes": [
          {
            "taxID": 1,
            "taxAmount": 0,
            "salesAmountWithTax": 0.01
          }
        ],
        "previous_receipt_hash": "fNFmaw6tK30NEVJP/bF0wIp5S0xWMrRu6EG8EFOJ/ss=",
        "result_used_to_hash": "24455FISCALINVOICEUSD162025-05-21T12:14:58101fNFmaw6tK30NEVJP/bF0wIp5S0xWMrRu6EG8EFOJ/ss=",
        "receipt_hash": "qUk5/6/cdCyoo/T2FTk9mq2tPHDDp1tNgo/pG11fwoU=",
        "signature": "AfuRWXk1X2Hw5wjjiPizGQAdug6M+e5+jQ7iSFXabPgmXTGRzhcw3EH6LEiAX6B/MN+c2l15x0DTBqN51C0Z97MvL+DPhq0+skb0CJoFydLJBAzYhR/nf6tZvIIcokYWHl6rtSVr3bgF8XNpEB8Q6foN+dn2CpLlvZdwB4eqRu5o8oxjoTH/VKbChDdGeWYwjuwYiMPGPdB2Ov1sFSIcNNHL2qkmhoE4balSugYvjhagNLDca27r2S2uXJSHZh+70BregHuxYr5xuWUNbiP6NmeZl8T8VB8lm8i/oDl7WC22sTePYObggygOkbjvguk0kp2mktwahDlY3tqELnk9fg==",
        "qr_code_url": "https://fdmstest.zimra.co.zw/0000024455210520250000000016737506EB7E49AE71",
        "verification_code": "7375-06EB-7E49-AE71",
        "receipt_data": {
          "receipt": {
            "receiptType": "FiscalInvoice",
            "receiptCurrency": "USD",
            "receiptCounter": 4,
            "receiptGlobalNo": 16,
            "receiptDate": "2025-05-21T12:14:58",
            "receiptLinesTaxInclusive": false,
            "receiptLines": [
              {
                "receiptLineType": "Sale",
                "receiptLineNo": 1,
                "receiptLineHSCode": "08080101",
                "receiptLineName": "Eggs",
                "receiptLinePrice": 0.01,
                "receiptLineQuantity": 1,
                "receiptLineTotal": 0.01,
                "taxID": 1
              }
            ],
            "receiptTaxes": [
              {
                "taxID": 1,
                "taxAmount": 0,
                "salesAmountWithTax": 0.01
              }
            ],
            "receiptPayments": [
              {
                "moneyTypeCode": "MobileWallet",
                "paymentAmount": 0.01
              }
            ],
            "receiptTotal": 0.01,
            "receiptPrintForm": "InvoiceA4",
            "receiptDeviceSignature": {
              "hash": "qUk5/6/cdCyoo/T2FTk9mq2tPHDDp1tNgo/pG11fwoU=",
              "signature": "AfuRWXk1X2Hw5wjjiPizGQAdug6M+e5+jQ7iSFXabPgmXTGRzhcw3EH6LEiAX6B/MN+c2l15x0DTBqN51C0Z97MvL+DPhq0+skb0CJoFydLJBAzYhR/nf6tZvIIcokYWHl6rtSVr3bgF8XNpEB8Q6foN+dn2CpLlvZdwB4eqRu5o8oxjoTH/VKbChDdGeWYwjuwYiMPGPdB2Ov1sFSIcNNHL2qkmhoE4balSugYvjhagNLDca27r2S2uXJSHZh+70BregHuxYr5xuWUNbiP6NmeZl8T8VB8lm8i/oDl7WC22sTePYObggygOkbjvguk0kp2mktwahDlY3tqELnk9fg=="
            },
            "invoiceNo": "39DC6U5EM65J"
          }
        },
        "server_response": {
          "receiptID": 5961141,
          "serverDate": "2025-05-21T12:14:59",
          "receiptServerSignature": {
            "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
            "hash": "aWJBHwqQR2M40iWgiVEAqtc8UtrFBKkz0eRoBkGPXdc=",
            "signature": "F35BHzB5BHurc3jEBsVeexZNkl8kwpQn4Sp8K1xGr13SjEqKdF6WkkPo9xqBBAJ8jQHZunnINrX0nluPbMUmJIte5Cea9esth95nH68fiMWhSdtWR3ikmrQ61+KxJKSCGX9rLzVcQzvYDX7jjVO8WEU5tLymrM0uCMZWMQ4npDsNK9aLRekcbf9L+2kFJLnMqs4qf2/PMvFsvIRCFdrQXOYYFzPDm8LuKpCx3yybS9RIG/7b4JmQ4auOmrEQxaGH+TWUPlxtjeJTFM8nUY7G/Afhpe7txJGs/X3ksHgw0CzdCgz5eEZC23tjfAs1UBKtyWowP7LTuL6CxkbhFYfnVg=="
          },
          "validationErrors": [],
          "operationID": "0HNCDUV5BQ539:00000001"
        },
        "validation_errors": [],
        "fiscal_day_no": 4,
        "updated_at": "2025-05-21T10:14:59.307Z",
        "created_at": "2025-05-21T10:14:59.292Z"
      }
    }
  }
}

If your customer was created with an email address in your Panier account, they will receive a PDF attached email like this:

Closing Statement

ZIMRA Fiscalisation with the Panier API: A Step-by-Step Guide

Anthony Jekanyika — Tue, 06 May 2025 12:27:02 +0000

Panier is a system built for small business with features including Point of Sale, Invoices, Credit Notes, Debit Notes, Delivery Notes, Quotations, Multi-Currency, Stock Management, Profit and Loss and much more. Panier also includes the ability to ZIMRA Fiscalize and extends this ability to the Panier API allowing you to integrate with it from your project. In this article we will show you how you can integrate your project with ZIMRA's FDMS through the Panier API.

Setup Panier

First you need to register an account on Panier and create a company if you don't already have one. You will get a 14 day FREE trial when you register, after which you will have to pay a US$4.99 monthly subscription for each company that you have.

Next navigate to the Developer API page of your company and generate the API Credentials.

Next go to the API Credentials tab and copy down the APP ID and API KEY, we are going to need them later.

ZIMRA Fiscalisation Integration

We are now going to generate a ZIMRA Virtual Fiscal Device by going to the ZIMRA Fisc page of our company and filling in the form with your ZIMRA VAT information.

This will automatically generate the virtual fiscal device for you in about 5 minutes (depending on your internet connection) and automatically submit it for approval to ZIMRA (This might take up to 3 working days).

Whilst you wait for your virtual fiscal device to be approved and put into production, you can use the API inside ZIMRA's test environment, which is what we will be doing today.

ZIMRA Taxes

When generate a virtual fiscal device, ZIMRA will send us a list of applicable taxes that you can use. We then add these ZIMRA Taxes, as readonly taxes on your company's Taxes page.

All the products you create must be linked to one of these ZIMRA Taxes in order to fiscalize.

Setup API Credentials

You need to open the Panier API Documentation and add the APP ID and API KEY in order to get access to the API.

Get the ZIMRA Taxes

Go to Search Taxes endpoint and run the request, with the following payload so that we get all the taxes associated with your company:

{
  "data": {
    "query": "*"
  }
}

If everything went well, you should get a response similar to this:

{
  "searched": [
    {
      "id": "cmac8znc00008zm0gxrwpm55t",
      "name": "VAT",
      "percentage": 5,
      "code": null,
      "zimra_tax_id": 514,
      "updated_at": "2025-05-06T08:28:53.673Z",
      "created_at": "2025-05-06T08:28:47.712Z"
    },
    {
      "id": "cmac8znby0006zm0gppkcd15d",
      "name": "VAT",
      "percentage": 0,
      "code": null,
      "zimra_tax_id": 2,
      "updated_at": "2025-05-06T08:28:53.658Z",
      "created_at": "2025-05-06T08:28:47.710Z"
    },
    {
      "id": "cmac8znby0007zm0gilfcssvi",
      "name": "VAT",
      "percentage": 15,
      "code": null,
      "zimra_tax_id": 3,
      "updated_at": "2025-05-06T08:28:53.656Z",
      "created_at": "2025-05-06T08:28:47.710Z"
    },
    {
      "id": "cmac8znbu0005zm0gdy8xxoi6",
      "name": "VAT Exempt",
      "percentage": null,
      "code": null,
      "zimra_tax_id": 1,
      "updated_at": "2025-05-06T08:28:53.653Z",
      "created_at": "2025-05-06T08:28:47.707Z"
    }
  ]
}

Notice that ZIMRA Taxes have a non-null zimra_tax_id.

Create a Product

Go to the Create Product endpoint and create a product. Making sure to link one of the ZIMRA Taxes above. For this example we will use the id of the ZIMRA VAT Exempt tax as the applicable_tax_id in the following payload:

{
  "data": [
    {
      "name": "Eggs",
      "description": "One dozen large eggs",
      "buying_price": 2.51,
      "selling_price": 5.81,
      "initial_quantity": 100,
      "hs_code": "0808.01.01",
      "is_inventory_item": true,
      "applicable_tax_id": "cmac8znbu0005zm0gdy8xxoi6"
    }
  ],
  "overwrite_duplicates": true
}

According to the ZIMRA Guidelines all products now need to have an HS Code in order to fiscalize.

You should get a similar response to this:

{
  "created": [
    {
      "id": "cma5e7aca0000zm1x9aiabiil",
      "name": "Eggs",
      "description": "One dozen large eggs",
      "buying_price": 2.51,
      "sku": "",
      "hs_code": "0808.01.01",
      "selling_price": 5.81,
      "quantity": 100,
      "is_inventory_item": true,
      "updated_at": "2025-05-06T09:26:12.407Z",
      "created_at": "2025-05-01T13:20:18.970Z",
      "applicable_tax": {
        "id": "cmac8znbu0005zm0gdy8xxoi6",
        "name": "VAT Exempt",
        "percentage": null,
        "code": null,
        "zimra_tax_id": 1
      }
    }
  ],
  "excluded_duplicates": []
}

Create a Customer

Now let's create a customer by going to the Create Customer endpoint and using the following payload:

{
  "data": [
    {
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": ""
    }
  ],
  "overwrite_duplicates": true
}

You should get a similar response to this:

{
  "created": [
    {
      "id": "cmaccp0vy0000zmksubook8hd",
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": "",
      "updated_at": "2025-05-06T10:12:30.527Z",
      "created_at": "2025-05-06T10:12:30.527Z"
    }
  ],
  "excluded_duplicates": []
}

Create a ZIMRA Fiscal Invoice

Panier has a smart automated ZIMRA Open day and Close day feature, so it will first check if the fiscal day is opened or not, if not it automatically open it before it creates a Fiscal Invoice. In addition, if the fiscal day has been opened for close to 24 hours, it will automatically close the fiscal day for you. However if you wish to manually open or close the fiscal day you can use the ZIMRA Open Day and ZIMRA Close Day endpoints on the Panier API.

Now let us create a Fiscal Invoice by going to the Create Invoice endpoint and using the following payload:

{
  "data": [
    {
      "customer_id": "cmaccp0vy0000zmksubook8hd",
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "quantity": 1
        }
      ],
      "date_format": "dd/mm/yy",
      "payment_due": "2025-04-18T15:40:00.546Z",
      "payment_information": "Please make all payments to our CBZ Bank Account XXXXXXXXXXX",
      "terms_n_conditions": "This invoice will be considered invalid when the payment due date has lapsed"
    }
  ],
  "zimra_fiscalize": true
}

Et voila, here is our ZIMRA Fiscal Invoice 💪

{
  "created": [
    {
      "id": "cmacdp73c0005zmjpdime2h47",
      "number": "WGYM9GMJ639N",
      "date_format": "dd/mm/yy",
      "date_issued": "2025-05-06T10:40:30.102Z",
      "recipients": [],
      "payment_due": "2025-04-18T15:40:00.546Z",
      "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": 2,
        "rounding": 0,
        "code": "USD",
        "name_plural": "US dollars",
        "exchange_rate": 1
      },
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "name": "Eggs",
          "description": "One dozen large eggs",
          "buying_price": 2.51,
          "sku": "",
          "hs_code": "0808.01.01",
          "is_inventory_item": true,
          "applicable_tax": {
            "id": "cmac8znbu0005zm0gdy8xxoi6",
            "name": "VAT Exempt",
            "percentage": null,
            "code": null,
            "zimra_tax_id": 1
          },
          "_selling_price": 5.81,
          "_quantity": 1,
          "_discount": 0,
          "_total_excluding_tax": 5.81,
          "_tax": 0,
          "_total_including_tax": 5.81
        }
      ],
      "total": 5.81,
      "discount": 0,
      "payment_information": "Please make all payments to our CBZ Bank Account XXXXXXXXXXX",
      "terms_n_conditions": "This invoice will be considered invalid when the payment due date has lapsed",
      "sending_status": "Do not send",
      "template_preference": {
        "template": 1,
        "color": "primary",
        "table_layout": "Plain"
      },
      "is_paid": false,
      "updated_at": "2025-05-06T10:40:38.185Z",
      "created_at": "2025-05-06T10:40:38.185Z",
      "zimra_receipt": {
        "id": "cmacdp72x0004zmjpchd3veni",
        "device_id": 24455,
        "device_serial_number": "HQAUR8QVG29BBY33",
        "receipt_type": "FISCALINVOICE",
        "receipt_currency": "USD",
        "receipt_counter": 1,
        "receipt_global_no": 4,
        "receipt_date": "2025-05-06T12:40:34",
        "receipt_total": 5.81,
        "receipt_taxes": [
          {
            "taxID": 1,
            "taxAmount": 0,
            "salesAmountWithTax": 5.81
          }
        ],
        "previous_receipt_hash": "",
        "result_used_to_hash": "24455FISCALINVOICEUSD72025-05-06T12:40:345810581",
        "receipt_hash": "oDCrjJ5wjYdt+DjjqEJ6Z9zEtjttpb5OYLlYh9Avsic=",
        "signature": "rsMdb9briDnowH7cVyu67heYdZgVzImYQSCz+tLo4LWhS/+lkGQOoPIHUmsnv+y6PAjKR2HMP9hwKesViGQRf3xeqryzwM2+Yb6QtRh9ZfwRvj7qbM99pbd+111CStGimwrXuWRYhBRJpKbaSi0awD2rlOq4ZIAdM2tHVXb8Zvw+Xc6bZk8KmmY6Wa+RlzpGCP9m2rc3bep+sT5FHLf5CzOkCUtpNvJJBcjEowGSuU6nbe8peRMxX7gVifup7+pwmYnh6oShK4oyIlWvbzYVtdI9H50hlzomTy7EOs9eLoZH1iEXumHejCuI09mGqPjaLTTzpgX7CdVjvNwkJdf04w==",
        "qr_code_url": "https://fdmstest.zimra.co.zw/000002445506052025000000000724F42D4F3579D932",
        "verification_code": "24F4-2D4F-3579-D932",
        "receipt_data": {
          "receipt": {
            "receiptType": "FiscalInvoice",
            "receiptCurrency": "USD",
            "receiptCounter": 1,
            "receiptGlobalNo": 4,
            "receiptDate": "2025-05-06T12:40:34",
            "receiptLinesTaxInclusive": false,
            "receiptLines": [
              {
                "receiptLineType": "Sale",
                "receiptLineNo": 1,
                "receiptLineHSCode": "08080101",
                "receiptLineName": "Eggs",
                "receiptLinePrice": 5.81,
                "receiptLineQuantity": 1,
                "receiptLineTotal": 5.81,
                "taxID": 1
              }
            ],
            "receiptTaxes": [
              {
                "taxID": 1,
                "taxAmount": 0,
                "salesAmountWithTax": 5.81
              }
            ],
            "receiptPayments": [
              {
                "moneyTypeCode": "Cash",
                "paymentAmount": 5.81
              }
            ],
            "receiptTotal": 5.81,
            "receiptPrintForm": "InvoiceA4",
            "receiptDeviceSignature": {
              "hash": "oDCrjJ5wjYdt+DjjqEJ6Z9zEtjttpb5OYLlYh9Avsic=",
              "signature": "rsMdb9briDnowH7cVyu67heYdZgVzImYQSCz+tLo4LWhS/+lkGQOoPIHUmsnv+y6PAjKR2HMP9hwKesViGQRf3xeqryzwM2+Yb6QtRh9ZfwRvj7qbM99pbd+111CStGimwrXuWRYhBRJpKbaSi0awD2rlOq4ZIAdM2tHVXb8Zvw+Xc6bZk8KmmY6Wa+RlzpGCP9m2rc3bep+sT5FHLf5CzOkCUtpNvJJBcjEowGSuU6nbe8peRMxX7gVifup7+pwmYnh6oShK4oyIlWvbzYVtdI9H50hlzomTy7EOs9eLoZH1iEXumHejCuI09mGqPjaLTTzpgX7CdVjvNwkJdf04w=="
            },
            "invoiceNo": "WGYM9GMJ639N"
          }
        },
        "server_response": {
          "receiptID": 5856878,
          "serverDate": "2025-05-06T12:40:37",
          "receiptServerSignature": {
            "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
            "hash": "n40uljhSBpFdAJ2RTDkh1QQ2hpoEQ/vN+pxVjLQQdTk=",
            "signature": "DHzjt+sNDnS86CTY7iCl0IapitZEmpFoNTaY1h/UfXsi95KXLyEHh3Aqu/v40Y5bld8OrCBRph7+Ro91ADe3iJcP1Hn6MeOKDPw9NWqWoSayBlMX/HAfjzKMgV/88W/CGFBGLrAoAU4XsOo2MNOODqtXMHHa0RpaCjgjoPW8gZT5GywQWhkQMwXVF+eNUpb+9uwUL+ZAxwQhXbjm+Wp3K2SEg3dMPmRZuSiYeIWoCmRmrxCj8DRe/UOo6/+kHWRclk4ej90q8kgq6dhxG6R8Y4R0jwB5D/KvB1Qn2RFzLprgW6qS86fuC0l4QDpQsvCpqfQz3mCUwAdf6tdZbb9iKQ=="
          },
          "validationErrors": [],
          "operationID": "0HNBSPOBISK2Q:00000001"
        },
        "validation_errors": [],
        "fiscal_day_no": 2,
        "updated_at": "2025-05-06T10:40:38.185Z",
        "created_at": "2025-05-06T10:40:38.170Z"
      },
      "customer": {
        "id": "cmaccp0vy0000zmksubook8hd",
        "name": "Corner Bakery",
        "contact_person": "John Smith",
        "phone": "0772000001",
        "email": "john@cornerbakery.com",
        "address": "123 Road Drive, City, Country",
        "fax": "02888881",
        "website": "https://example.com",
        "tax_reg_number": "",
        "company_reg_number": "",
        "tin_number": "",
        "vat_number": ""
      }
    }
  ]
}

Create a Credit Note

Now the we have created a ZIMRA Fiscal Invoice let now create a credit note. We do this by going to the Create Credit Note endpoint and use this payload (Pay close attention to the invoice_id):

{
  "data": [
    {
      "invoice_id": "cmacdp73c0005zmjpdime2h47",
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "quantity": 1
        }
      ]
    }
  ],
  "zimra_fiscalize": true
}

You should get the following response:

{
  "created": {
    "id": "cmace14zn0000zmktr4vcujs4",
    "number": "KXI20Y8G4TRV",
    "invoice_id": "cmacdp73c0005zmjpdime2h47",
    "created_by": null,
    "recipients": [],
    "currency": {
      "symbol": "$",
      "name": "US Dollar",
      "symbol_native": "$",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "USD",
      "name_plural": "US dollars",
      "exchange_rate": 1
    },
    "products": [
      {
        "id": "cma5e7aca0000zm1x9aiabiil",
        "name": "Eggs",
        "description": "One dozen large eggs",
        "buying_price": 2.51,
        "sku": "",
        "hs_code": "0808.01.01",
        "is_inventory_item": true,
        "applicable_tax": {
          "id": "cmac8znbu0005zm0gdy8xxoi6",
          "name": "VAT Exempt",
          "percentage": null,
          "code": null,
          "zimra_tax_id": 1
        },
        "_selling_price": 5.81,
        "_credited_quantity": 1,
        "_total_excluding_tax": 5.81,
        "_tax": 0,
        "_total_including_tax": 5.81
      }
    ],
    "total": 5.81,
    "template_preference": {
      "template": 1,
      "color": "primary",
      "table_layout": "Plain"
    },
    "created_at": "2025-05-06T10:49:55.329Z",
    "zimra_receipt": {
      "id": "cmace7eng0000zmmu6uj06lxy",
      "device_id": 24455,
      "device_serial_number": "HQAUR8QVG29BBY33",
      "receipt_type": "CREDITNOTE",
      "receipt_currency": "USD",
      "receipt_counter": 2,
      "receipt_global_no": 5,
      "receipt_date": "2025-05-06T12:54:46",
      "receipt_total": -5.81,
      "receipt_taxes": [
        {
          "taxID": 1,
          "taxAmount": 0,
          "salesAmountWithTax": -5.81
        }
      ],
      "previous_receipt_hash": "oDCrjJ5wjYdt+DjjqEJ6Z9zEtjttpb5OYLlYh9Avsic=",
      "result_used_to_hash": "24455CREDITNOTEUSD82025-05-06T12:54:46-5810-581oDCrjJ5wjYdt+DjjqEJ6Z9zEtjttpb5OYLlYh9Avsic=",
      "receipt_hash": "F7ZV6q3zDkgKK2/d2970TkxtrwyyQwg9AUXeu6b1Pr8=",
      "signature": "f1GUv50l0ttvlunQ++qcRvHYOpKIaasEQxTC5UZRNVq3xdwB5lKkbdffn4NB6/9rwMvVHKJSQ2MhaSJ8U43JiU23NR1U/4vel0NTjfwsespeuuSStN2L4HEkYoEYrTXVM4xm/5GNhHefCX4q8uimoawZvqfAgSL05QvUS6gA2nDP/QUp78KUkOzz52yjAmc5rXHFvbLOLYsvqNgnuQibOaUlfTDfkF3Ywq1cYHawcp3vVgxFC+xR1zEXAvDK2cE/Bnsm8p8GVvmYZEQD/wuTgKvLznm/rDEZBSAwcTsTGHTF6+QMKah42vsZpbk2S4FoDDN9p73ZvsHec5kBdcu96g==",
      "qr_code_url": "https://fdmstest.zimra.co.zw/000002445506052025000000000862174C46EF1A3EB0",
      "verification_code": "6217-4C46-EF1A-3EB0",
      "receipt_data": {
        "receipt": {
          "receiptType": "CreditNote",
          "receiptCurrency": "USD",
          "receiptCounter": 2,
          "receiptGlobalNo": 5,
          "receiptDate": "2025-05-06T12:54:46",
          "receiptLinesTaxInclusive": false,
          "receiptLines": [
            {
              "receiptLineType": "Sale",
              "receiptLineNo": 1,
              "receiptLineHSCode": "08080101",
              "receiptLineName": "Eggs",
              "receiptLinePrice": -5.81,
              "receiptLineQuantity": 1,
              "receiptLineTotal": -5.81,
              "taxID": 1
            }
          ],
          "receiptTaxes": [
            {
              "taxID": 1,
              "taxAmount": 0,
              "salesAmountWithTax": -5.81
            }
          ],
          "receiptPayments": [
            {
              "moneyTypeCode": "Cash",
              "paymentAmount": -5.81
            }
          ],
          "receiptTotal": -5.81,
          "receiptPrintForm": "InvoiceA4",
          "receiptDeviceSignature": {
            "hash": "F7ZV6q3zDkgKK2/d2970TkxtrwyyQwg9AUXeu6b1Pr8=",
            "signature": "f1GUv50l0ttvlunQ++qcRvHYOpKIaasEQxTC5UZRNVq3xdwB5lKkbdffn4NB6/9rwMvVHKJSQ2MhaSJ8U43JiU23NR1U/4vel0NTjfwsespeuuSStN2L4HEkYoEYrTXVM4xm/5GNhHefCX4q8uimoawZvqfAgSL05QvUS6gA2nDP/QUp78KUkOzz52yjAmc5rXHFvbLOLYsvqNgnuQibOaUlfTDfkF3Ywq1cYHawcp3vVgxFC+xR1zEXAvDK2cE/Bnsm8p8GVvmYZEQD/wuTgKvLznm/rDEZBSAwcTsTGHTF6+QMKah42vsZpbk2S4FoDDN9p73ZvsHec5kBdcu96g=="
          },
          "invoiceNo": "MMKAJ3ZXM8LJ",
          "creditDebitNote": {
            "receiptID": 5856878,
            "deviceID": 24455,
            "receiptGlobalNo": 5,
            "fiscalDayNo": 2
          },
          "receiptNotes": "This is a Credit Note for Fiscal Invoice No. MMKAJ3ZXM8LJ"
        }
      },
      "server_response": {
        "receiptID": 5856906,
        "serverDate": "2025-05-06T12:54:47",
        "receiptServerSignature": {
          "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
          "hash": "PLOzmw3mkeODBlAd3GR8gUHMZmcfRTvz73ON5jZTpp4=",
          "signature": "YsI0+mo0mjSbZfVkiGkCJ2SDjXbiIqdSDk3+sYgxjshMledi3BZWiEk8SSm4d3iyH3cHoEP3gJIv39obh7x2SrGztWNHbFbCNQ34k46DI3niGBiuxyXkn9MhYJAWvY5UcMqBrOKIcLQ5x8LL/DjTJbmPAS5ts4cDuLRFjn7SvkEISzJ638GFCWhe2TyKfniS12JS3jYW8NpHojt4U5bgHrgaXhhp09NV+7Gvi9GISVFyMfLo6h43MDdQdnSx9SpzoUDjUfnXpYi7hs8VNkYrJbh+R4fnRYjh6syr3wl5GF8Qz/GbTHCzgPeTI6J3flUgZ7qK5sQxooHsUumrCFtGwg=="
        },
        "validationErrors": [],
        "operationID": "0HNBSPOBISO8M:00000001"
      },
      "validation_errors": [],
      "fiscal_day_no": 2,
      "updated_at": "2025-05-06T10:54:47.801Z",
      "created_at": "2025-05-06T10:54:47.788Z"
    },
    "customer": {
      "id": "cmaccp0vy0000zmksubook8hd",
      "name": "Corner Bakery",
      "contact_person": "John Smith",
      "phone": "0772000001",
      "email": "john@cornerbakery.com",
      "address": "123 Road Drive, City, Country",
      "fax": "02888881",
      "website": "https://example.com",
      "tax_reg_number": "",
      "company_reg_number": "",
      "tin_number": "",
      "vat_number": ""
    }
  }
}

Create a Debit Note

To create a debit note we need to go to the Create Debit Note endpoint and use this payload:

{
  "data": [
    {
      "invoice_id": "cmacdp73c0005zmjpdime2h47",
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "quantity": 1
        }
      ]
    }
  ],
  "zimra_fiscalize": true
}

You should get the following response:

{
  "created": [
    {
      "id": "cmacels1a0001zmly40q7xwxn",
      "number": "VFPS372JJPWL",
      "invoice_id": "cmacdp73c0005zmjpdime2h47",
      "recipients": [],
      "currency": {
        "symbol": "$",
        "name": "US Dollar",
        "symbol_native": "$",
        "decimal_digits": 2,
        "rounding": 0,
        "code": "USD",
        "name_plural": "US dollars",
        "exchange_rate": 1
      },
      "products": [
        {
          "id": "cma5e7aca0000zm1x9aiabiil",
          "name": "Eggs",
          "description": "One dozen large eggs",
          "buying_price": 2.51,
          "sku": "",
          "hs_code": "0808.01.01",
          "is_inventory_item": true,
          "applicable_tax": {
            "id": "cmac8znbu0005zm0gdy8xxoi6",
            "name": "VAT Exempt",
            "percentage": null,
            "code": null,
            "zimra_tax_id": 1
          },
          "_selling_price": 5.81,
          "_debited_quantity": 1,
          "_total_excluding_tax": 5.81,
          "_tax": 0,
          "_total_including_tax": 5.81
        }
      ],
      "total": 5.81,
      "template_preference": {
        "template": 7,
        "color": "primary",
        "table_layout": "Plain"
      },
      "created_at": "2025-05-06T11:05:58.319Z",
      "zimra_receipt": {
        "id": "cmacels0s0000zmly29jdl0sb",
        "device_id": 24455,
        "device_serial_number": "HQAUR8QVG29BBY33",
        "receipt_type": "DEBITNOTE",
        "receipt_currency": "USD",
        "receipt_counter": 3,
        "receipt_global_no": 9,
        "receipt_date": "2025-05-06T13:05:57",
        "receipt_total": 5.81,
        "receipt_taxes": [
          {
            "taxID": 1,
            "taxAmount": 0,
            "salesAmountWithTax": 5.81
          }
        ],
        "previous_receipt_hash": "F7ZV6q3zDkgKK2/d2970TkxtrwyyQwg9AUXeu6b1Pr8=",
        "result_used_to_hash": "24455DEBITNOTEUSD92025-05-06T13:05:575810581F7ZV6q3zDkgKK2/d2970TkxtrwyyQwg9AUXeu6b1Pr8=",
        "receipt_hash": "IOAf+DHOzM7J0aXRdkz30YGImwmBBARWFbQhPJKZ/UY=",
        "signature": "NKR4qaZcvwB9D0so9zglc905UdWHR3yPbqWs5UYHNiwb0xKkVyoutMqT1vfx5DLzYl67BmegX7TQfoMz7p8b//x5abDRCP6+hcOuDQbHV6UMgPhMWlcMpLpNTgPhIH8/vOCIWy80IMw9Ae20DbejQ+ARhc2bFGFiwVxG7DFnBD7HUFxqcLlLkbnhMYWipOG/cf8TYjz6nEGWRpbGNyIuqs+ksOMye2jGIL3qezpAuf6MdXtbqiEhff1moEin79TpPWRvUO8ThL/yw2YqO6x6r0NahlycpY6xzVBGa7eXrI3tKWAh56HyjP2AY0pygVrFjqXsVinY3wArZViZKalc/g==",
        "qr_code_url": "https://fdmstest.zimra.co.zw/000002445506052025000000000954386E38A698E4DB",
        "verification_code": "5438-6E38-A698-E4DB",
        "receipt_data": {
          "receipt": {
            "receiptType": "DebitNote",
            "receiptCurrency": "USD",
            "receiptCounter": 3,
            "receiptGlobalNo": 9,
            "receiptDate": "2025-05-06T13:05:57",
            "receiptLinesTaxInclusive": false,
            "receiptLines": [
              {
                "receiptLineType": "Sale",
                "receiptLineNo": 1,
                "receiptLineHSCode": "08080101",
                "receiptLineName": "Eggs",
                "receiptLinePrice": 5.81,
                "receiptLineQuantity": 1,
                "receiptLineTotal": 5.81,
                "taxID": 1
              }
            ],
            "receiptTaxes": [
              {
                "taxID": 1,
                "taxAmount": 0,
                "salesAmountWithTax": 5.81
              }
            ],
            "receiptPayments": [
              {
                "moneyTypeCode": "Cash",
                "paymentAmount": 5.81
              }
            ],
            "receiptTotal": 5.81,
            "receiptPrintForm": "InvoiceA4",
            "receiptDeviceSignature": {
              "hash": "IOAf+DHOzM7J0aXRdkz30YGImwmBBARWFbQhPJKZ/UY=",
              "signature": "NKR4qaZcvwB9D0so9zglc905UdWHR3yPbqWs5UYHNiwb0xKkVyoutMqT1vfx5DLzYl67BmegX7TQfoMz7p8b//x5abDRCP6+hcOuDQbHV6UMgPhMWlcMpLpNTgPhIH8/vOCIWy80IMw9Ae20DbejQ+ARhc2bFGFiwVxG7DFnBD7HUFxqcLlLkbnhMYWipOG/cf8TYjz6nEGWRpbGNyIuqs+ksOMye2jGIL3qezpAuf6MdXtbqiEhff1moEin79TpPWRvUO8ThL/yw2YqO6x6r0NahlycpY6xzVBGa7eXrI3tKWAh56HyjP2AY0pygVrFjqXsVinY3wArZViZKalc/g=="
            },
            "invoiceNo": "VFPS372JJPWL",
            "creditDebitNote": {
              "receiptID": 5856878,
              "deviceID": 24455,
              "receiptGlobalNo": 8,
              "fiscalDayNo": 2
            },
            "receiptNotes": "This is a Debit Note for Fiscal Invoice No. VFPS372JJPWL"
          }
        },
        "server_response": {
          "receiptID": 5856938,
          "serverDate": "2025-05-06T13:05:58",
          "receiptServerSignature": {
            "certificateThumbprint": "F9B295CA65BA22B94F6D4B27E48D08BF6CD7F7C8",
            "hash": "3gHhVyHCPRBILq7JwGZd5rXFA8VQUunQBdqUvMxmZFA=",
            "signature": "cFCHQvgcVcTxamUTqING1q7MJgnqZdf4WbtRagCSB2ISG7Ezv3Gnd6hDb7RdzL+C5/6uAZgNjf+XnwStde4zZzlZ9PBvRyvPhCQp3qb84FriSGpn+LQanrh9KLuQybDwPDIlWj42GXEv+PN0IqVKZnEUkNkWJiVMeIV8pZd/SnLgyhd8FR5uXt0RT9ofE7HdfYdNPk9jpXRp+KNSgu1riEREneTuwyGEW1wokE8H6waiA0i63HEZ5Qkab+v5uB/gBt1WmNHZvSu0a6b8lWKysWNWNLPXMo/Jco61QKnoxwRTFSPL0ZTJvfq7HvqPmRKguYuWki3K0Cvdl0f2mLs+KQ=="
          },
          "validationErrors": [],
          "operationID": "0HNBSPOBISSDG:00000001"
        },
        "validation_errors": [],
        "fiscal_day_no": 2,
        "updated_at": "2025-05-06T11:05:58.319Z",
        "created_at": "2025-05-06T11:05:58.300Z"
      },
      "customer": {
        "id": "cmaccp0vy0000zmksubook8hd",
        "name": "Corner Bakery",
        "contact_person": "John Smith",
        "phone": "0772000001",
        "email": "john@cornerbakery.com",
        "address": "123 Road Drive, City, Country",
        "fax": "02888881",
        "website": "https://example.com",
        "tax_reg_number": "",
        "company_reg_number": "",
        "tin_number": "",
        "vat_number": ""
      }
    }
  ]
}

Fiscalizing an existing Invoice, Credit Note or Debit Note

Panier allows you to create an invoice, credit note or debit note then fiscalize it later. This can be done by using the Fiscalize endpoint.

Closing Remarks

This API is based on the official ZIMRA Fiscal Device Gateway API Specs v7.2 and so we recommend that you get acquainted with it in order to get the most out of this API.

If you have any questions. Feel free to ask us in the comments sections of this article or email us directly on support@panier.app.

Vue 3: Extending entire CSS/SCSS files to the children of a scoped parent component using :deep()

Anthony Jekanyika — Sat, 18 May 2024 10:32:27 +0000

Lets say for some reason you have now come to the realisation that you know have to isolate the CSS in a specific component from rest of the your project. Then, like the great Vue developer that you are you confidently scroll to your component's opening style tag and add the scoped attribute then call it a day. You check the project to confirm that your fix worked but you forgot that your component has its own child components which no longer inherit the CSS from the parent component because its now scoped. How do we fix this?

Enter the :deep() pseudo-class

The deep selector allows us to share CSS classes between a scoped parent and its child components. Today I am going to show you how to do it with entire CSS/SCSS files.

First install SASS into your project with the following code in your terminal npm i -D sass sass-loader

Here is an example of how a parent component will extend its imported CSS files to its child components:

<template>
   <Child-1 />
   <Child-2 />
   <Child-2 />
</template>

<style lang="scss" scoped>
  :deep() {
    @import "./css/style-1";
    @import "./css/style-2";
  }
</style>

Important Note. Remember in SASS when importing a CSS/SCSS file you don't add the .css, .scss or .sass extension.

Using performance.now() instead of Date.now() to prevent timestamp collisions

Anthony Jekanyika — Fri, 11 Aug 2023 09:45:54 +0000

Say you have an array of data entries and you need to attach a unique identifier to each entry. The popular approach would be use Date.now() as a unique identifier. The problem with this approach is that there is a chance of two or more entries having the same identifier. This is because the timestamps returned by Date.now() have a resolution of one-millisecond. Thus it is highly probably that you could have collisions between the unique identifiers of the data entries. Let us consider the following example that loops 5 times, printing out a Date.now() timestamp every loop. Let's open up our command prompt and let's run the following code in node (to enter node just type the word node in your command prompt assuming that you already have it in your environment).

CODE:

for (let index = 0; index < 5; index++) {
    console.log(Date.now())
}

OUTPUT:

1691741535783
1691741535784
1691741535785 < Identical
1691741535785 < Identical
1691741535785 < Identical

As you can see in the output that the last three outputs were the same, so if you where using these as unique identifiers you would have collisions.

Enter performance.now()

Unlike Date.now() the timestamps returned by performance.now() represent floating point numbers with a resolution of up to 5 microsecond rather than the one-millisecond resolution of Date.now() timestamps. Also performance.now() timestamps always increase at a constant rate being independent of the system clock which can be manually adjusted or susceptible to change by software such as the Network Time Protocol. Lets see the same example that we did above but this time with performance.now().

CODE:

for (let index = 0; index < 5; index++) {
    console.log(performance.now())
}

OUTPUT:

7908.96749997139
7910.144699931145
7910.284399986267
7910.412899971008
7910.533899903297

Let's test performance.now() further by logging two timestamps at the same time.

CODE:

console.log(`${ performance.now() } ${ performance.now() }`)

OUTPUT:

773756.6698999405 773756.6811999083

As you can see that even when you log it at the same time the timestamps are different thus there is no chance of collisions occurring. I highly recommend that you take a look at the MDN docs for performance.now() if you want to read more about it (https://developer.mozilla.org/en-US/docs/Web/API/Performance/now).