---
title: "Offline url for sales"
method: GET
path: "/sale/{business_id}/{trader_invoice_number}"
tags: ["Sales"]
---

# Offline url for sales

`GET /sale/{business_id}/{trader_invoice_number}`

## Request

- Base URL: `https://api.digitax.tech/ke/v2`
- URL: `https://api.digitax.tech/ke/v2/sale/{business_id}/{trader_invoice_number}`
- Auth: none declared

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

## Path parameters

- `business_id` string, required: The DigiTax ID of the business.
- `trader_invoice_number` string, 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 `200`

Success

- OfflineUrlSale
  - `date` string, required: The document date (YYYY-MM-DD)
  - `time` string, required: The document creation timestamp in RFC 3339 format, including the date and timezone.
  - `trader_invoice_number` string, 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_number` integer, required: The invoice number assigned to the sale.
  - `original_invoice_number` integer, required: The original invoice number associated with the sale.
  - `digitax_id` string, required: The DigiTax ID of the sale.
  - `serial_number` string, required: The eTIMS serial number of the sale.
  - `receipt_number` integer, required: The receipt number assigned to the sale.
  - `internal_data` string, required: The internal data associated with the eTIMS receipt.
  - `receipt_signature` string, required: The signature associated with the eTIMS receipt.
  - `etims_url` string, required: The URL of the eTIMS receipt.
  - `sales_tax_summary` object, required: Taxable amounts, tax rates, and tax amounts grouped by tax category.
    - `taxable_amount_a` number, required: The taxable amount for tax category A (exempt).
    - `taxable_amount_b` number, required: The taxable amount for tax category B (16% VAT).
    - `taxable_amount_c` number, required: The taxable amount for tax category C (zero-rated).
    - `taxable_amount_d` number, required: The taxable amount for tax category D (non-VAT).
    - `taxable_amount_e` number, required: The taxable amount for tax category E (8% VAT).
    - `tax_rate_a` integer, required: The tax rate percentage for tax category A (exempt).
    - `tax_rate_b` integer, required: The tax rate percentage for tax category B (16% VAT).
    - `tax_rate_c` integer, required: The tax rate percentage for tax category C (zero-rated).
    - `tax_rate_d` integer, required: The tax rate percentage for tax category D (non-VAT).
    - `tax_rate_e` integer, required: The tax rate percentage for tax category E (8% VAT).
    - `catering_levy_rate` integer: The catering levy rate percentage.
    - `tax_amount_a` number, required: The tax amount for tax category A (exempt).
    - `tax_amount_b` number, required: The tax amount for tax category B (16% VAT).
    - `tax_amount_c` number, required: The tax amount for tax category C (zero-rated).
    - `tax_amount_d` number, required: The tax amount for tax category D (non-VAT).
    - `tax_amount_e` number, required: The tax amount for tax category E (8% VAT).
    - `catering_levy_amount` number: The total catering levy amount.
  - `status` string, required: The status of the sale with KRA.
  - `kra_receipt_url` string, required: The URL of the KRA eTIMS receipt.
  - `total` number, required: The total amount of the sale.
  - `business_details` object, required: Business information displayed on the receipt.
    - `name` string, required: The name of the business.
    - `pin` string, required: The KRA PIN of the business.
    - `email` string, required: The business's email address.
    - `phone` string, required: The business's phone number.
    - `location` string, required: The business's location.
  - `customer_details` object, required: Customer information displayed on the receipt.
    - `name` string, required: The name of the customer.
    - `pin` string, required: The KRA PIN of the customer.
    - `email` string, required: The customer's email address.
    - `phone` string, required: The customer's phone number.
  - `items` object[], required: The list of items included in the sale.
    - `id` string, required: The DigiTax ID of the sale line, not the catalogue item ID.
    - `name` string, required: The name of the item.
    - `price` integer, required: The price of the item.
    - `currency` string, required: The currency used for the item price.
    - `quantity` integer, required: The quantity of the item sold.
  - `logo_url` string, required: The URL of the business logo.

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints.md) - [All operations](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/digitax/apis/digitax-kenya-api-endpoints/revisions/6a186b8718c5?raw)