---
title: "Add Catalog"
method: POST
path: "/catalog"
---

# Add Catalog

`POST /catalog`

## Request body

- object
  - `item_name` string, required — The name or title of the item, such as a product or service, used for identification and display purposes in catalogs, invoices, and other records.
  - `item_type` 'Goods' | 'Services', required — The type of the item, typically categorized as Goods or Services.
  - `gst_rate` '18%' | 'Nil-Rated' | 'Zero-Rated' | 'Exempted Supply' | 'Non-GST Supply' | '0%' | '0.1%' | '0.25%' | '1%' | '1.5%' | '3%' | '5%' | '7.5%' | '12%' | '28%', required — The Goods and Services Tax (GST) rate applied to the item.
  - `units` 'UNT-UNITS' | 'BAG-BAGS' | 'BAL-BALE' | 'BDL-BUNDLES' | 'BKL-BUCKLES' | 'BOU-BILLIONS OF UNITS' | 'BOX-BOX' | 'BTL-BOTTLES' | 'BUN-BUNCHES' | 'CAN-CANS' | 'CBM-CUBIC METERS' | 'CCM-CUBIC CENTIMETERS' | 'CMC-CENTIMETERS' | 'CTN-CARTONS' | 'DOZ-DOZENS' | 'DRM-DRUMS' | 'GGK-GREAT GROSS' | 'GMS-GRAMMES' | 'GRS-GROSS' | 'GYD-GROSS YARDS' | 'KGS-KILOGRAMS' | 'KLR-KILOLITRE' | 'KME-KILOMETRE' | 'MLT-MILILITRE' | 'MTR-METERS' | 'MTS-METRIC TON' | 'NOS-NUMBERS' | 'OTH-OTHERS' | 'PAC-PACKS' | 'PCS-PIECES' | 'PRS-PAIRS' | 'QTL-QUINTAL' | 'ROL-ROLLS' | 'SET-SETS' | 'SQF-SQUARE FEET' | 'SQM-SQUARE METERS' | 'SQY-SQUARE YARDS' | 'TBS-TABLETS' | 'TGM-TEN GROSS' | 'THD-THOUSANDS' | 'TON-TONNES' | 'TUB-TUBES' | 'UGS-US GALLONS' | 'YDS-YARDS', required — The unit of measurement for the item.
  - `catalog_type` 'sales' | 'purchase', required — Indicates the type of catalog the item belongs to, such as sales or purchase.
  - `hsn_sac` integer — The HSN (Harmonized System of Nomenclature) or SAC (Service Accounting Code) assigned to a product or service under the GST framework in India.
  - `cess` number, float — The additional tax (Cess) amount or rate applied on top of the standard GST, as mandated for specific goods or services (such as luxury items or sin goods). This value can be a fixed amount or a percentage, depending on the item classification.
  - `description` string — A detailed explanation or summary of the item, including its features, specifications, usage, or any other relevant information.
  - `variants` object[], required — A list of different versions or options of a product, each representing a unique combination of attributes such as size, color, model, or configuration.
    - `variant_name` string — The currency in which the variant's price is defined.
    - `price` string — The price of the variant.
    - `gst_type` 'inclusive of gst' | 'exclusive of gst' — GST type inclusive of GST or Exclusive of GST
    - `variant_description` string — A description of the variant, providing additional details.
    - `non_taxable` string — The amount of the variant's price that is non-taxable.
    - `currency` 'INR' | 'CNY' | 'USD' | 'IDR' | 'PKR' | 'NGN' | 'BRL' | 'BDT' | 'RUB' | 'ETB' | 'MXN' | 'JPY' | 'PHP' | 'EGP' | 'CDF' | 'VND' | 'IRR' | 'TRY' | 'EUR' | 'THB' | 'TZS' | 'GBP' | 'ZAR' | 'KES' | 'MMK' | 'COP' | 'KRW' | 'UGX' | 'SDG' | 'IQD' | 'DZD' | 'ARS' | 'AFN' | 'PLN' | 'CAD' | 'MAD' | 'UAH' | 'AOA' | 'SAR' | 'UZS' | 'YER' | 'MZN' | 'GHS' | 'PEN' | 'MYR' | 'NPR' | 'MGA' | 'VES' | 'XAF' | 'XOF' | 'AUD' | 'KPW' | 'SYP' | 'TWD' | 'LKR' | 'MWK' | 'ZMW' | 'KZT' | 'CLP' | 'RON' | 'SOS' | 'GTQ' | 'KHR' | 'ZWB' | 'GNF' | 'RWF' | 'BIF' | 'BOB' | 'TND' | 'HTG' | 'DOP' | 'JOD' | 'SSP' | 'CUP' | 'HNL' | 'SEK' | 'PGK' | 'CZK' | 'AZN' | 'TJS' | 'HUF' | 'AED' | 'BYN' | 'ILS' | 'SLL' | 'CHF' | 'LAK' | 'HKD' | 'NIO' | 'RSD' | 'LYD' | 'PYG' | 'KGS' | 'BGN' | 'TMT' | 'SGD' | 'DKK' | 'LRD' | 'NOK' | 'NZD' | 'CRC' | 'LBP' | 'MRU' | 'OMR' | 'PAB' | 'KWD' | 'ERN' | 'GEL' | 'MNT' | 'UYU' | 'MDL' | 'BAM' | 'GMD' | 'ALL' | 'JMD' | 'AMD' | 'QAR' | 'BWP' | 'NAD' | 'LSL' | 'MKD' | 'TTD' | 'BHD' | 'MUR' | 'SZL' | 'DJF' | 'FJD' | 'KMF' | 'GYD' | 'BTN' | 'SBD' | 'MOP' | 'SRD' | 'CVE' | 'MVR' | 'BND' | 'BZD' | 'BSD' | 'ISK' | 'VUV' | 'XPF' | 'BBD' | 'STN' | 'WST' | 'XCD' | 'KID' | 'JEP' | 'TOP' | 'SCR' | 'AWG' | 'IMP' | 'KYD' | 'BMD' | 'GGP' | 'ANG' | 'GIP' | 'CKD' | 'TVD' | 'FKP' — The currency in which the variant's price is defined.
    - `sku_id` string — The Stock Keeping Unit (SKU) identifier for inventory tracking.

## Response `200`

200

- object
  - `status` string
  - `message` string
  - `catalog_id` integer

## 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)