DEV Community: Anthony Jekanyika

Using SQLite (Fast SQL) with Drizzle ORM in Capacitor 8

Anthony Jekanyika — Tue, 09 Jun 2026 14:10:24 +0000

In this post we will be looking into how to implement SQLite with Drizzle ORM in Capacitor 8 using Nuxt 4 as our Vite wrapper (You can use any other Vite framework). We will be using the Fast SQL for our Android and iOS implementation and SQLocal for the Web implementation. This post will also how to manage Drizzle migrations inside Capacitor 8.

Here is the demo repo of the full implementation to compare with.

Lets get started

Firstly, we need to create our Nuxt 4 app

npm create nuxt@latest capacitor-nuxt-fastsql-drizzle

cd capacitor-nuxt-fastsql-drizzle

Install core Capacitor and CLI

npm i @capacitor/core && npm i -D @capacitor/cli

Install the plugins

npm i @capacitor/app @capacitor/keyboard @capacitor/splash-screen @capacitor/status-bar @capacitor/preferences

Initialize Capacitor with our project details

npx cap init my-app com.example.myapp --web-dir .output/public

Replace my-app with your app name and com.example.myapp with your app ID (reverse domain notation).

Update the capacitor.config.ts file with the following configurations

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.myapp',
  appName: 'my-app',
  webDir: '.output/public',
  plugins: {
    SplashScreen: {
      launchShowDuration: 2000,
      launchAutoHide: true,
      androidScaleType: 'CENTER_CROP',
      splashFullScreen: true,
      splashImmersive: true,
    },
    Keyboard: {
      resize: 'body',
      resizeOnFullScreen: true,
    },
    StatusBar: {
      overlaysWebView: false,
      style: 'dark',
      backgroundColor: '#ffffffff'
    },
  },
};

export default config;

Install native platforms

npm i @capacitor/ios @capacitor/android

Add the native platform folders

npx cap add ios
npx cap add android

Capacitor will create ios and android folders at the root of your project containing the native projects.

To build the Android project, you need Android Studio. For iOS, you need a Mac with Xcode.

Add these scripts to your package.json

{
  "scripts": {
    "dev": "nuxt dev",
    "build": "nuxt build",
    "generate": "nuxt generate",
    "preview": "nuxt preview",
    "mobile": "npm run generate && npx cap sync",
    "mobile:ios": "npm run mobile && npx cap open ios",
    "mobile:android": "npm run mobile && npx cap open android"
  }
}

Lets test if we did the setup correctly
For Android

npm run mobile:android

For iOS

npm run mobile:ios

Build and run the app

In Android Studio, wait for the project to be ready, and then click on the “Run” button to deploy the app to a connected device or emulator.

In Xcode, set up your signing account to deploy the app to a real device. If you haven’t done this before, Xcode will guide you through the process (note that you need to be enrolled in the Apple Developer Program). Once set up, click on the “Play” button to run the app on your connected device.

If you have been successful you should see this on your device. If not go over the steps again and try again.

Setup

SQLocal makes it easy to run SQLite3 in the browser, backed by the Origin Private File System which provides high-performance read/write access to a SQLite database file stored on the user's device. We will be this for the web implementation of our application.

Install SQLocal, Fast SQL and Drizzle

npm i sqlocal drizzle-orm@1.0.0-beta.22 drizzle-kit@1.0.0-beta.22 @noble/hashes

At the time of writing this blog v1.0.0-beta.22 is the latest version of Drizzle.

In order to persist data to the Origin Private File System, SQLocal relies on APIs that require cross-origin isolation, so we have to globally add the these headers to all the pages of our application:

Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin

We will do this by updating our nuxt.config.ts file to the following:

import sqlocal from 'sqlocal/vite';

export default defineNuxtConfig({
  vite: {
    plugins: [
      sqlocal()
    ],
    server: {
      headers: {
        'Cross-Origin-Opener-Policy': 'same-origin',
        'Cross-Origin-Embedder-Policy': 'require-corp'
      }
    },
    optimizeDeps: {
      exclude: ['@sqlite.org/sqlite-wasm'],
    },
    assetsInclude: [
      "**/*.sql"
    ]
  }
})

For Android and iOS we will be using Fast SQL a high-performance SQLite Database that locally hosts an HTTP server on your device to greatly increase the speed and throughput of our SQL queries.

Install Fast SQL and sync capacitor

npm i @capgo/capacitor-fast-sql
npx cap sync

Add Fast SQL configurations to capacitor.config.ts file

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.myapp',
  appName: 'my-app',
  webDir: '.output/public',
  plugins: {
    SplashScreen: {
      launchShowDuration: 2000,
      launchAutoHide: true,
      androidScaleType: 'CENTER_CROP',
      splashFullScreen: true,
      splashImmersive: true,
    },
    Keyboard: {
      resize: 'body',
      resizeOnFullScreen: true,
    },
    StatusBar: {
      overlaysWebView: false,
      style: 'dark',
      backgroundColor: '#ffffffff'
    },
    CapacitorSQLite: {
      iosDatabaseLocation: 'Library/CapacitorDatabase',
      iosIsEncryption: true,
      iosKeychainPrefix: 'nuxt-sqlocal-capacitor',
      iosBiometric: {
        biometricAuth: false,
        biometricTitle : "Biometric login for capacitor sqlite"
      },
      androidIsEncryption: true,
      androidBiometric: {
        biometricAuth : false,
        biometricTitle : "Biometric login for capacitor sqlite",
        biometricSubTitle : "Log in using your biometric"
      },
      electronIsEncryption: true,
      electronWindowsLocation: "C:\\ProgramData\\CapacitorDatabases",
      electronMacLocation: "/Volumes/Development_Lacie/Development/Databases",
      electronLinuxLocation: "Databases"
    }
  }
};

export default config;

Sync capacitor

npx cap sync

Create the Drizzle Schema

Create the db/schema.ts file and add the following:

import { sqliteTable, int , text } from 'drizzle-orm/sqlite-core';

export const groceries = sqliteTable('groceries', {
    id: int('id').primaryKey({ autoIncrement: true }),
    name: text('name').notNull(),
    quantity: int('quantity').notNull()
});

See Drizzle Documentation to see how to define your schema using the functions that Drizzle ORM provides.

Instantiate Drizzle

This will allow us to use only one instance of Drizzle in our application and to have it defined globally across our application without needing to import it.

Create the file app/utils/db.ts and copy add the following:

import { SQLocalDrizzle } from 'sqlocal/drizzle';
import { type SqliteRemoteDatabase, drizzle } from 'drizzle-orm/sqlite-proxy';
import { Capacitor } from '@capacitor/core';
import { FastSQL } from '@capgo/capacitor-fast-sql';

let db: SqliteRemoteDatabase<Record<string, never>, any>;
const DATABASE_NAME = "database";
if(Capacitor.getPlatform() === "web") {
    const { driver, batchDriver } = new SQLocalDrizzle('database.sqlite3');
    db = drizzle(driver, batchDriver);
} else {
    try {
        const conn = await FastSQL.connect({ database: DATABASE_NAME });

        const driver = async (sql: string, params: (string | number)[], method: 'get' | 'all' | 'values' | 'run') => {
            try {
                const result = await conn.execute(sql, params);

                if(method === 'get') {
                    return { rows: result.rows.flatMap(row => Object.values(row)) }
                } else {
                    return { rows: result.rows.map(row => Object.values(row)) }
                }
            } catch (e: any) {
                alert('Error from sqlite proxy server: ' + e.response.data)
                return { rows: [] };
            }
        }

        const batchDriver = async (queries: { sql: string, params: any[], method: 'all' | 'run' | 'get' | 'values'}[]) => {
            try {
                const result = await conn.executeBatch([
                    ...queries.map(({ sql, params }) => ({
                        statement: sql,
                        params
                    }))
                ]);

                return result
            } catch (e: any) {
                alert('Error from sqlite proxy server: ' + e);
                throw e;
            }
        }

        db = drizzle(driver, batchDriver);
    } catch(error) {
        alert(error)
    }
}

export { db }

Add Pages

Replace the contents of your app/app.vue file with this

<template>
  <NuxtPage />
</template>

Create the folder app/pages and then add the file app/pages/index.vue and add the following contents

<template>
    <main>
        <h2>Create Groceries</h2>
        <form @submit.prevent="createGroceries">
            <div>
                <input v-model="name" placeholder="Enter the name" required />
            </div>
            <div>
                <input v-model="quantity" type="number" placeholder="Enter the quantity" validate required />
            </div>
            <button type="submit">Submit</button>
        </form>

        <h2>Grocery List ({{ grocery_list.length }})</h2>
        <div>
            <input v-model="search_query" placeholder="Search" validate required />
        </div>
        <table>
            <thead>
                <tr>
                    <th>ID</th>
                    <th>Name</th>
                    <th>Quantity</th>
                </tr>
            </thead>
            <tbody>
                <tr v-for="{ id, name, quantity} of grocery_list">
                    <td>{{ id }}</td>
                    <td>{{ name }}</td>
                    <td>{{ quantity }}</td>
                </tr>
            </tbody>
        </table>
    </main>
</template>

<script setup lang="ts">
    import { like } from 'drizzle-orm';
    import { groceries } from "~~/db/schema";
    import { migrate } from '~~/db/migrator'

    const name = ref<string>("");
    const quantity = ref<number>(0);
    const search_query = ref<string>();
    const grocery_list = ref<typeof groceries.$inferInsert[]>([]);

    watch(search_query, (value) => search(value))

    onMounted(async () => {
        await migrate()
        grocery_list.value = await db.select().from(groceries)
    })

    const createGroceries = async () => {
        try {
            await db.insert(groceries).values({
                name: name.value,
                quantity: quantity.value
            })

            grocery_list.value = await db.select({
                id: groceries.id,
                name: groceries.name,
                quantity: groceries.quantity
            })
            .from(groceries)

            // Clear the form
            name.value = "";
            quantity.value = 0;
        } catch (error) {
            alert(error)
        }
    }

    const search = async (query: string | undefined) => {
        if(search_query.value) {
            grocery_list.value = await db.select()
                .from(groceries)
                .where(like(groceries.name, `%${ query }%`))
        } else {
            grocery_list.value = await db.select().from(groceries)
        }
    }
</script>

Drizzle Migrations

When ever you change the Drizzle schema db/schema.ts. You need to create the migration files. You can do this by first creating the drizzle.config.ts file in your project's root directory and then adding the following:

import { defineConfig } from 'drizzle-kit'

export default defineConfig({
  out: './db/migrations',
  schema: './db/schema.ts',
  dialect: 'sqlite'
})

Update the scripts in your package.json to the following:

{
  "scripts": {
    "dev": "nuxt dev",
    "build": "nuxt build",
    "generate": "nuxt generate",
    "preview": "nuxt preview",
    "mobile": "npm run generate && npx cap sync",
    "mobile:ios": "npm run mobile && npx cap open ios",
    "mobile:android": "npm run mobile && npx cap open android",
    "drizzle:generate": "drizzle-kit generate --dialect=sqlite --driver=durable-sqlite --schema=./db/schema.ts --out=./db/migrations"
  }
}

Then to generate the migration files you need to run the following:

npm run drizzle:generate

This will create SQL migration files in the db/migrations directory.

Drizzle Client-Side Migration

Drizzle does not have an in-built system to track migration files on the client-side of your add as drizzle-kit, the Drizzle migration management CLI tool, doesn't run on the client-side. We are going to have to implement our own custom solution to apply the migration files and keep track of the migrations that have already been applied in a _drizzle_migrations table. To do this we need to create the db/migrator.ts file and add the following:

import { sha256 } from "@noble/hashes/sha2.js";
import { Buffer } from "buffer";
import { sql } from "drizzle-orm";
import { db } from "../app/utils/db";
import migration_summary from "./migrations/migrations.js"

export const migrate = async () => {
    // Create the migration table to keep track of all the applied migrations
    const MIGRATIONS_TABLE_NAME = sql.identifier("_drizzle_migrations");

    await db.run(
        sql`
          CREATE TABLE IF NOT EXISTS ${ MIGRATIONS_TABLE_NAME } (
            id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,
            name TEXT NOT NULL,
            hash TEXT NOT NULL,
            created_at INTEGER NOT NULL
          );
        `,
    );

    type AppliedMigration = {
        id: number,
        name: string,
        hash: string,
        created_at: number
    }

    const appliedMigrations = await db.all(sql`SELECT * FROM ${ MIGRATIONS_TABLE_NAME };`)

    for(let migration_name of Object.keys(migration_summary.migrations)) {
        // Get migration file a raw text
        let migration_sql = (await import(`./migrations/${ migration_name }/migration.sql?raw`)).default;

        // Change CREATE TABLE to CREATE TABLE IF NOT EXISTS
        migration_sql = migration_sql.replace(/CREATE TABLE/gm, 'CREATE TABLE IF NOT EXISTS');

        // Generate a hash of the migration file
        const hash = Buffer.from(sha256(Buffer.from(migration_sql))).toString("hex")

        // Check if the migration file was applied to the SQLite DB  
        // @ts-ignore
        if (appliedMigrations.some((applied_migration) => applied_migration.at(2) === hash)) continue;

        // Now run the migration on to the SQLite DB
        try {
            const query_statements = migration_sql.split(/--> statement-breakpoint/gm);

            for(const query of query_statements) {
                await db.run(query)
            }

            // Log this migration as applied onto the SQLite DB
            await db.run(
                sql`
                    INSERT INTO ${ MIGRATIONS_TABLE_NAME } ("name", "hash", "created_at") VALUES (
                    ${ sql.raw(`'${ migration_name }'`) },
                    ${ sql.raw(`'${ hash }'`) },
                    ${ sql.raw(`${ Date.now() }`) }
                    );
                `,
            );
        } catch(error) {
            alert(error)
        }
    }
}

Deploy

Now that we are done creating our app, let us generate the static files for our app and deploy them to either Android Studio or Xcode

For Android Studio

npm run mobile:android

For Xcode

npm run mobile:ios

If you have been successful, you should have an app that you can use to store grocery lists like this:

Checkout the demo repo with everything that we have discussed above.

Feel free to ask me any questions in the comments section below and I will try to respond to them as quickly as I can. Thank you guys and have a great day.

Reference List

Using Server-Sent Events (SSE) in Capacitor 8 with Nuxt 4

Anthony Jekanyika — Sun, 31 May 2026 08:39:59 +0000

Using Server-Sent Events using EventSource or microsoft's popular fetchEventSource library does work in Capacitor 8 as was clearly detailed in #6582.

Special thanks to the brilliant work done by the chatboxai team for their library capacitor-stream-http and for mbmaas3-tech who forked it and updated it to support Capacitor 8 with capacitor-stream-http-v2.

This is a demostration on how to do Server-Sent Events (SSE) in Capacitor 8 using Nuxt 4 (You can achieve the same with other Vite based frameworks).

Step 1

Clone the repo

git clone https://github.com/jeky1950/capacitor-nuxt-sse-demo.git

Step 2

Install packages

npm Install

Step 3

Sync the capacitor plugins

npx cap sync

Step 4

Build the static files

npm run generate

Step 5

Copy the static files to Capacitor

npx cap copy

Step 6

Open Android Studio (or Xcode if you are building for iOS)

npx cap open android

Step 7

Run the app in Android Studio (or Xcode if you are building for iOS)

Step 8

Switch on the Nuxt Development Server with the public flag

npx nuxi dev --public

Make sure that the Network url on the command line output matches the url ref on line 18 in file /app/pages/index.vue

App Structure

On the app there are two buttons, the one on the left demonstrates the current functionality of trying the use SSE in Capacitor 8 that is detailed in #6582. The button on the right shows SSE working with the help of capacitor-stream-http-v2.

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).