---
title: "Add reverse invoice"
method: POST
path: "/reverse-invoices"
tags: ["Reverse Invoices"]
---

# Add reverse invoice

`POST /reverse-invoices`

Add reverse invoice

## Request body

- object
  - `supplier_id` string, required
  - `sale_date` string, required — The date of sale (YYYY-MM-DD)
  - `customer_tin` string
  - `customer_name` string
  - `customer_phone` string
  - `customer_email` string
  - `payment_type_code` string
  - `invoice_details` string
  - `trader_invoice_number` string, required
  - `callback_url` string
  - `items` object[], required
    - `id` string, required
    - `quantity` number, required
    - `unit_price` number, required
    - `total_amount` number, required
    - `package_unit_quantity` number
    - `discount_rate` number, required
    - `discount_amount` number, required
    - `item_description` string

## Response `201`

Success

- Sale
  - `id` string, required
  - `date` string, required — The receipt date (DD/MM/YYYY), as printed on the physical receipt
  - `time` string, required
  - `trader_invoice_number` string, required
  - `receipt_type_code` string, required
  - `sale_detail_url` string, url, required
  - `serial_number` string, required
  - `receipt_number` integer, required
  - `invoice_number` integer, required
  - `customer_id` string, required
  - `customer_name` string, required
  - `customer_tin` string, required
  - `customer_phone_number` string
  - `customer_email` string
  - `internal_data` string, required
  - `receipt_signature` string, required
  - `etims_url` string, url, required
  - `original_sale_id` string
  - `offline_url` string, url
  - `status` 'PENDING' | 'FAILED' | 'COMPLETED' — status against KRA
  - `sales_tax_summary` object, required
    - `taxable_amount_a` number, required
    - `taxable_amount_b` number, required
    - `taxable_amount_c` number, required
    - `taxable_amount_d` number, required
    - `taxable_amount_e` number, required
    - `tax_rate_a` integer, required
    - `tax_rate_b` integer, required
    - `tax_rate_c` integer, required
    - `tax_rate_d` integer, required
    - `tax_rate_e` integer, required
    - `catering_levy_rate` integer
    - `service_charge_rate` integer
    - `tax_amount_a` number, required
    - `tax_amount_b` number, required
    - `tax_amount_c` number, required
    - `tax_amount_d` number, required
    - `tax_amount_e` number, required
    - `catering_levy_amount` number
    - `service_charge_amount` number
  - `item_list` SaleItem[]
    - `id` string, required
    - `quantity` number, required
    - `unit_price` number, required
    - `total_amount` number, required
    - `taxable_amount` number, required
    - `tax_amount` number, required
    - `tax_rate` number, required
    - `tax_type_code` string, required
    - `discount_rate` number, required
    - `discount_amount` number, required
    - `etims_item_code` string, required
    - `is_stockable` boolean, required
    - `item_id` string, required

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/digitax/apis/digitax-kenya-api-endpoints.md) · [All operations](https://skmtc.net/digitax/apis/digitax-kenya-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitax/digitax-kenya-api-endpoints/versions/1fc0cdf61f70/schema)