Sales

Offline url for sales

Generates a URL that clients can use to view the status of an offline sale.

get/sale/{business_id}/{trader_invoice_number}

Request

Base URL
https://api.digitax.tech/ke/v2
Auth
none declared

Path parameters

business_idstring required

The DigiTax ID of the business.

Example:business_01HC3HTDAXQ50E07CWR2A2CFBD

trader_invoice_numberstring required

The invoice reference from your system. It must be unique across sales and credit notes in the business. References from failed transactions can be reused.

Response

Success

datestring required

The document date (YYYY-MM-DD)

timestring required

The document creation timestamp in RFC 3339 format, including the date and timezone.

trader_invoice_numberstring required

The invoice reference from your system. It must be unique across sales and credit notes in the business. References from failed transactions can be reused.

invoice_numberinteger required

The invoice number assigned to the sale.

original_invoice_numberinteger required

The original invoice number associated with the sale.

digitax_idstring required

The DigiTax ID of the sale.

serial_numberstring required

The eTIMS serial number of the sale.

receipt_numberinteger required

The receipt number assigned to the sale.

internal_datastring required

The internal data associated with the eTIMS receipt.

receipt_signaturestring required

The signature associated with the eTIMS receipt.

etims_urlstring required

The URL of the eTIMS receipt.

statusstring required

The status of the sale with KRA.

kra_receipt_urlstring required

The URL of the KRA eTIMS receipt.

totalnumber required

The total amount of the sale.

logo_urlstring required

The URL of the business logo.

Example response

{
  "date": "2026-07-14",
  "time": "2026-07-14T12:00:00Z",
  "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": "saleitem_01HC3J1VVVM05YCTS61G7V3KC6",
      "name": "DigiTax Product 01",
      "price": 600,
      "currency": "KES",
      "quantity": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.