Create a TRA VFD fiscal receipt in DigiTax

DigiTax Tanzania and the TRA VFD System

DigiTax Tanzania integrates you with the TRA VFD System

DigiTax is a solution that sits between you - the taxpayer - and TRA's Virtual Fiscal Device system.

With DigiTax, you gain access to a streamlined fiscal receipt system that ensures compliance and supports your business's growth. Together, DigiTax and the TRA VFD System are transforming how businesses in Tanzania manage their tax obligations.

For DigiTax to support businesses in generating TRA fiscal receipts, DigiTax is registered as a TRA-approved VFD solution provider.

The speed at which fiscal receipts are processed is dependent on network capacity, connectivity, and the responsiveness of TRA's VFD server at the time of submission.

A TRA fiscal receipt

A TRA fiscal receipt documents a taxable supply and contains:

• customer details (at minimum, a buyer identifier for B2B transactions)
• at least one line item (product or service sold)
• payment allocations covering the full invoice amount

Creating a TRA fiscal receipt

To create a fiscal receipt via DigiTax TZ, follow these steps:

1. Create an item with the appropriate TRA tax_type.
2. Optionally, create a customer (required for B2B receipts with TIN).
3. Submit an invoice via POST /invoices (DigiTax fiscalizes the invoice with TRA EFDMS).
4. Retrieve the fiscal details (including the verification_code, verification_url, and receipt_number).

TRA fiscal receipt request example

Submit the invoice to POST /invoices:

{
  "customer_id": "customer_01HC3J1VVVM05YCTS61G7V3KC6",
  "invoice_date": "2026-07-14",
  "invoice_amount_type": "EXCLUSIVE",
  "trader_invoice_number": "INV-2026-001",
  "items": [
    {
      "item_id": "item_01HC3J1VVVM05YCTS61G7V3KC6",
      "quantity": 2,
      "unit_amount": 50000,
      "discount_rate": 0,
      "fixed_discount": 0,
      "description": "Professional IT Support (2 months)"
    }
  ],
  "payments": [
    {
      "type": "CASH",
      "amount": 118000
    }
  ]
}

TRA fiscal receipt response

Expect a response similar to the following when you create or retrieve a fiscalized invoice:

{
  "id": "invoice_01HC3J1VVVM05YCTS61G7V3KC6",
  "invoice_number": "INV26-195-120000123-ABCDEF",
  "invoice_date": "2026-07-14",
  "invoice_amount_type": "EXCLUSIVE",
  "customer_id": "customer_01HC3J1VVVM05YCTS61G7V3KC6",
  "trader_invoice_number": "INV-2026-001",
  "receipt_number": 42,
  "status": "ISSUED",
  "tax_exclusive_total": 100000,
  "tax_inclusive_total": 118000,
  "verification_code": "ABCD1234",
  "verification_url": "https://virtual.tra.go.tz/efdmsRctVerify/Home/Index?rctvnum=ABCD1234",
  "issued_at": "2026-07-14T12:00:00Z",
  "z_number": "20260714001",
  "items": [
    {
      "id": "invoice_item_01HC3J1VVVM05YCTS61G7V3KC6",
      "item_id": "item_01HC3J1VVVM05YCTS61G7V3KC6",
      "description": "Professional IT Support (2 months)",
      "quantity": 2,
      "unit_amount": 50000,
      "discount_rate": 0,
      "fixed_discount": 0,
      "tax_type": "STANDARD",
      "tax_rate": 0.18,
      "tax_exclusive_total": 100000,
      "tax_inclusive_total": 118000
    }
  ],
  "created_at": "2026-07-14T00:00:00Z",
  "updated_at": "2026-07-14T00:00:00Z"
}

📘

verification_url powers the QR code

Use the verification_url value directly to generate the scannable QR code printed on the fiscal receipt for TRA verification.

Next, let's explore creating the prerequisites of an invoice: an item and a customer.