---
title: "Add Purchase Invoice"
method: POST
path: "/purchase-invoice"
---

# Add Purchase Invoice

`POST /purchase-invoice`

## Headers

- `api-token` string
- `x-api-key` string

## Request body

- object
  - `purchase_number` integer — Purchase number in purchase invoice
  - `bill_number` string — Supplier's invoice or bill number
  - `pur_inv_date` string, date — Date of the invoice
  - `due_date` string — The payment due date
  - `purchase_order_id` integer — 0 indicates no linked purchase order
  - `tax_id1_type` '0' | '1' | '2' — Tax applicability: - 0: No GST - 1: SGST+CGST - 2: IGST
  - `currency` string — Currency code
  - `taxable_amount` string — Sum of all taxable values
  - `non_taxable_amount` string — Sum of all non taxable values
  - `gst_amount` string — Total gst amount
  - `cess_amount` string — CESS applicable under GST
  - `adjust_amount` string — Additional adjustments
  - `addvalue_amount` string — Additional value amount
  - `total_amount` string — Sum of all amounts
  - `payable_amount` string — Final amount to be paid
  - `reverse_charge` '0' | '1' — 1-reverse charge mechanism applied, 0-reverse charge mechanism not applied
  - `spl_supply` '0' | '1' | '2' | '3' — Type of supply: - 0: Regular - 1: Import - 2: Input service - 3: Composition
  - `basic_custom_duty` string
  - `counter_duty` string
  - `counter_duty_add` string
  - `tax_credit_type` '0' | '1' — GST ITC is claimable (1) or not (0).
  - `gst_tax_credit` integer — Amount eligible for ITC.
  - `status` '0' | '1' — Status-0 for deleted, 1 for active
  - `currency_info` object[]
    - `currency_rate` string
    - `currency_default_rate` string
    - `from` string
    - `to` string
    - `converted_amount` string
  - `business_info` object[]
    - `id` string
    - `name` string
    - `email` string
    - `mobile` string
    - `logo_url` string
    - `tax_no` string
    - `addr1` string
    - `addr2` string
    - `city` string
    - `pincode` string
    - `state` string
    - `country` string
    - `bill_copy_file` string
    - `pos` string
  - `export_details` object[]
    - `export_type` string
    - `export_bill_no` string
    - `export_bill_date` string
    - `export_port_code` string
  - `seller_info` object[]
    - `supplier_id` string
    - `supplier_name` string
    - `supplier_business_name` string
    - `supplier_addr1` string
    - `supplier_addr2` string
    - `supplier_city` string
    - `supplier_pincode` string
    - `supplier_state` string
    - `supplier_country` string
    - `supplier_gstin` string
    - `business_country` string
    - `supplier_address_index` string
  - `billing_details` object[]
    - `bill_company` string
    - `bill_addr1` string
    - `bill_addr2` string
    - `bill_city` string
    - `bill_pincode` string
    - `bill_state` string
    - `bill_country` string
    - `bill_ship_address_same` string
  - `shipping_details` object[]
    - `ship_company` string
    - `ship_addr1` string
    - `ship_addr2` string
    - `ship_city` string
    - `ship_pincode` string
    - `ship_state` string
    - `ship_country` string
  - `items` object[]
    - `pid` string
    - `vid` string
    - `item_name` string
    - `sku` string
    - `item_description` string
    - `item_code` string
    - `item_type` string
    - `quantity` string
    - `rate` string
    - `price_type` string
    - `discount` string
    - `taxable_amt` string
    - `non_taxable_amt` string
    - `gst_rate` string
    - `gst_amt` string
    - `igst_amt` string
    - `igst_rate` string
    - `sgst_amt` string
    - `sgst_rate` string
    - `cgst_amt` string
    - `cgst_rate` string
    - `cess_amt` string
    - `cess_per` string
    - `cess_type` string
    - `item_total_amt` string
    - `sale_customer_id` string
    - `sale_customer_name` string
    - `expense_type` string
    - `expense_id` string
    - `units` string
    - `status` string
    - `converted_amount` string
    - `extra_field` string

## Response `200`

200

- object
  - `status` integer
  - `id` integer
  - `msg` string
  - `download_url` string
  - `pdf_url` string

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `500` — 500
- `501` — 501
- `502` — 502
- `503` — 503

---

[API](https://skmtc.net/ledgers/apis/authentication.md) · [All operations](https://skmtc.net/ledgers/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ledgers/authentication/versions/605f28ef08ef/schema)