GadgetOS

Sell-through rate per product: units sold per day, and estimated days of stock remaining at that rate.

get_inventory_velocity

One invoice in full: header totals, payment method and every line item on it. With view=list it returns recent sales newest-first instead, cursor-paginated, with voided ones flagged.

get_sale

Products in the business's own catalog, optionally narrowed by free-text q, barcode or sku, with the matching total count.

list_products

Writes one operating-expense row: amount in paisa, category, date and an optional note.

log_expense

Products at or below their reorder level, with current stock on hand and the reorder point.

get_low_stock_items

Opens a new warranty claim, or advances an existing one to a later status and moves the unit ledger with it. The PIN-gated rejection and refund closes are not reachable here.

manage_warranty_claim

The state of the most recent photo-upload link minted for one product — waiting, uploaded, failed part-way, expired, or never requested — and whether that product has a main photo now. A photo the owner sent that did not finish storing reads as failed, never as uploaded.

get_product_image_upload

Gross profit (revenue minus cost of goods sold) over a date range. With a group_by dimension it returns the same figures broken down by that dimension instead of a single total.

get_profit_summary

Writes one serialized unit into stock, identified by its IMEI or serial number.

receive_unit

Writes a new pooled stock batch: quantity, unit cost, and optional batch number and expiry date. The stock becomes sellable immediately.

receive_stock

Writes a settlement row against one customer's khata balance and reduces what that customer owes. An overpayment is refused rather than banked.

record_customer_payment

Suggested purchase quantities per product, derived from recent sales velocity, current stock and reorder level.

get_reorder_suggestions

Writes one sale: an invoice with a receipt number, the stock decrement, and the payment. The branch, the stock lot, the price and the change are resolved by the business. Voiding or refunding it is not on this server.

create_sale

Completed-sale count and revenue totals (subtotal, discount, VAT, total) for a date range, for the signed-in business's own data only. Voided, refunded and pending sales are excluded.

get_sales_summary

Revenue and sale count bucketed over time (by day, week or month) across a date range.

get_sales_trend

Searches the SHARED reference catalog, which is not the business's own stock, so a new product can be linked to a canonical entry.

search_catalog

The signed-in business's own storefront details: name, address, working hours, contact channels, BIN/TIN, storefront URL, theme and plan.

get_shop_profile

Mints one single-use browser link, valid 30 minutes, that attaches a single image of up to 5 MB as a product’s main photo — replacing and deleting the previous one where there is any. Nothing is written to the product until that file arrives.

create_product_image_upload

The supplier directory with accounts payable per supplier, shop-wide totals and aging buckets. Also the source of a supplier_id for a purchase order.

get_suppliers

Best-selling items over a date range, ranked by quantity sold or by revenue, capped at 50 rows.

get_top_products

Overwrites editable fields on an EXISTING product: name, selling price, purchase cost, storage location, reorder level, or discontinued status.

update_product

Warranty and RMA claims: the claim board, one claim's detail with its audited event timeline, view=summary for desk-health aggregates, or view=unit for a serial/IMEI coverage check.

get_warranty_claims

Stock written off over a date range as damaged, expired or lost, with the value destroyed per reason.

get_wastage