v1

latestOpenAPI 3.0.1Apache 2.02026-07-26401961.7 KB

Sales

Offline url for sales

This endpoint allows you to generate a URL for offline sales and share with clients to monitor sale status

get/sale/{business_id}/{trader_invoice_number}

Path parameters

business_idstring required

Business ID on DigiTax

Example:business_01HC3HTDAXQ50E07CWR2A2CFBD

trader_invoice_numberstring required

Trader Invoice Number

Response

Success

datestring required

The document date (YYYY-MM-DD)

timestring required

trader_invoice_numberstring required

invoice_numberinteger required

original_invoice_numberinteger required

digitax_idstring required

serial_numberstring required

receipt_numberinteger required

internal_datastring required

receipt_signaturestring required

etims_urlstring required

statusstring required

status against KRA

kra_receipt_urlstring required

totalnumber required

logo_urlstring required

Example response

{
  "date": "2026-07-14",
  "time": "12:00:00",
  "trader_invoice_number": "12345678901",
  "invoice_number": 38,
  "original_invoice_number": 38,
  "digitax_id": "sale_01HC3HTDAXQ50E07CWR2A2CFBD",
  "serial_number": "KRACU0400000001",
  "receipt_number": 38,
  "internal_data": "PB3ZSZP3RZR3AUPYBYLUTFJDIA",
  "receipt_signature": "3JYZVPTPMYBGHG4A",
  "etims_url": "https://etims.kra.go.ke/common/link/etims/receipt/indexEtimsReceptData?{P053100692D+00+3JYZVPTPMYBGHG4A}",
  "sales_tax_summary": {
    "taxable_amount_b": 517.24,
    "tax_rate_b": 16,
    "tax_rate_e": 8,
    "catering_levy_rate": 2,
    "tax_amount_b": 82.76
  },
  "status": "completed",
  "kra_receipt_url": "https://etims.kra.go.ke/common/link/etims/receipt/indexEtimsReceptData?{P053100692D+00+3JYZVPTPMYBGHG4A}",
  "total": 600,
  "business_details": {
    "name": "Business Name",
    "pin": "P012345678P",
    "email": "support@digitax.tech",
    "location": "Nairobi"
  },
  "customer_details": {
    "name": "John Doe",
    "pin": "P012345678P",
    "email": "support@namiri.tech"
  },
  "items": [
    {
      "id": "item_01HC3J1VVVM05YCTS61G7V3KC6",
      "name": "DigiTax Product 01",
      "price": 600,
      "currency": "KES",
      "quantity": 1
    }
  ]
}