API: bills and online orders

Read bills

GET /api/developer/v1/sales?shop=ADY001&from=2026-10-01&to=2026-10-31&limit=50&offset=0

The key needs Sales and invoices · Read. Days are the shop's own days. Each bill has id, invoiceNo, soldAt, customerId, customer, subtotal, discount, taxTotal, total, payment and cancelled; totals covers every bill the filter matches. Pass nextOffset as offset for the next page.

GET /api/developer/v1/sales/3391?shop=ADY001

One bill, with its items.

Send an online order in

POST /api/developer/v1/orders
{
  "shop": "ADY001",
  "orderRef": "WEB-1182",
  "items": [{ "productId": 812, "qty": 2 }],
  "method": "upi"
}

The key needs Online orders · Send in. The order becomes a bill at the shop: priced by dhivi POS as every bill is — any price you send is ignored — with its GST, taken off the shelf, and numbered as the shop numbers bills. The answer is the bill (201).

• Once per order. Sending the same orderRef to the same shop again answers the bill it already made (200, "created": false). Safe to retry.
• Paid by default, by upi, card or cash. Send "paid": false with a customerId to leave it owed by that customer, where the shop allows it.