Skip to main content
Products (items) are what you sell and buy. They appear as items on every document, and stocked products are tracked by Inventory.

​
The item model

Items use the same ID model as customers: every call carries your item_id, unknown IDs are auto-created (including inline during document creation), and Update items mapping re-links your IDs in bulk if they change. The fields that matter most:
  • item_type — Product (stocked, tracked by inventory) or Service
  • unit_price, tax_rate, price_with_tax — pricing with GST; only valid GST tax rates are accepted
  • hsn_code — the HSN/SAC code that GST compliance (and e-invoicing) relies on
  • unit — a GST-approved UQC unit such as kg, pcs, mtr

​
Add an item

Item details sent inside a document apply to that document only — they never overwrite the catalog record. To change the master record, use Update an item.
Products and services list in the Swipe dashboard

The product catalog in the Swipe dashboard

​
Endpoints

Add an item

Create an item with your own ID.

Get item details

Fetch one item by your item_id.

Update an item

Change the catalog record.

Delete an item

Remove an item from the catalog.

Get list of items

Page through the catalog.

Update items mapping

Re-link your IDs to Swipe records in bulk.
Tracking stock levels too? Continue to Inventory.