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

# Add Invoice

`POST /invoice`

## Request body

- object
  - `contact` object, required
    - `id` integer, required — The unique identifier for the contact.
    - `name` string, required — The name of the contact.
    - `business_name` string — he business name of the contact.
    - `email` string — The email address of the contact.
    - `mobile` string — The mobile phone number of the contact.
    - `business_country` string — The country where the contact’s business is based
    - `country_code` string — The country code for the contact’s phone number.
    - `place_of_supply` string
  - `items` object[], required
    - `pid` integer — The unique identifier for the product.
    - `variant_id` integer — The variant identifier for the item.
    - `name` string — The name of the product.
    - `description` string — A description of the product.
    - `item_code` string — The item code of the product.
    - `item_type` integer — The type of the item.
    - `quantity` integer — The number of units for the item.
    - `units` string — The unit of measure for the item.
    - `rate` number, float — The unit rate for the item.
    - `discount` integer — Discount applied to the item.
    - `taxable_per_item` integer — The taxable amount for the item.
    - `non_taxable_per_item` integer — The non-taxable amount for the item.
    - `gst_rate` string — The GST rate applied to the item.
    - `cess_amt` string — CESS amount applied to the item.
    - `price_type` string — The price type for the item.
  - `seller_branch_id` string, required — The identifier for the seller's branch.
  - `billing_address` object
    - `bill_addr1` string — First line of the billing address.
    - `bill_addr2` string — Second line of the billing address.
    - `bill_gstin` string — GSTIN for billing
    - `bill_city` string — City for billing.
    - `bill_state` string — State for billing
    - `bill_country` string — Country for billing
    - `bill_pincode` string — Postal code for billing
  - `shipping_address` object
    - `ship_addr1` string — First line of the shipping address.
    - `ship_addr2` string — Second line of the shipping address.
    - `ship_gstin` string — GSTIN for shipping.
    - `ship_city` string — City for shipping.
    - `ship_state` string — State for shipping.
    - `ship_country` string — Country for shipping.
    - `ship_pincode` string — Postal code for shipping.
  - `bank_id` string — The identifier for the bank associated with the estimate.
  - `billings_currency` string — The currency used for billing.
  - `invoice_number` string — Unique number identifying the invoice.
  - `invoice_date` string — Date of invoice creation (YYYY-MM-DD).
  - `validity_date` string — Expiry date for the invoice (YYYY-MM-DD).
  - `currency_info` object
    - `name` string — The name of the currency.
    - `exchange_time` string — The date and time when the exchange rate was recorded.
    - `exchange_rate` string — The exchange rate for the currency
  - `notes` string — Additional notes or instructions.
  - `terms_conditions` string — Invoice terms and conditions.
  - `notification` 'Yes' | 'No' — Indicates whether notifications are enabled for the Invoice.
  - `payment_link` 'Yes' | 'No' — Indicates whether a payment link is provided in the Invoice
  - `additional_charges` object[] — Any additional charges for the Invoice.
    - `charge_type` string, required
    - `charge_value` integer, required

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `inv_number` string
    - `url` string
    - `pdf_link` string

## Other responses

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

---

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