GadgetOS

Products with no sales in the lookback window, and the capital tied up in each one.

get_dead_stock

Removes one photo from a MODEL's gallery and permanently deletes its file, addressed by photo_id — not a serialized unit's photo.

remove_product_photo

Revokes EVERY assistant connection the signed-in operator holds to this business, not only the calling one: any other ChatGPT, Claude or connected app they signed in from stops too, on every brand. Other operators and counter devices are unaffected.

logout

Operating spend over a date range, totalled and broken down by expense category.

get_expense_summary

Records that the customer collected the device and closes the warranty claim for good: no reopen, advance or note after it.

hand_over_warranty_claim

Current stock value at cost and at retail, with per-category subtotals and a shop-wide total.

get_inventory_valuation

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.

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

Starts a branch's cash-drawer session with the cash counted into it; every later variance is measured against that float. One drawer per branch: a second open is refused.

open_shift

Books a device in as a NEW warranty claim by serial or IMEI, with the fault in the customer's words, adding the customer by phone only if new. A device with a claim already open is refused. Returns the new claim number.

open_warranty_claim

The most recent photo-upload link’s state for one product — awaiting_upload, uploaded, failed (sent but not stored, so nothing changed), expired or never_requested — plus the shop’s own photos in order with their photo_id, and whether it shows a shared-catalog picture instead.

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

Records that the supplier repaired the customer's OWN device and returned it with the same serial or IMEI; a different device is refused. A new unit in its place is receive_warranty_replacement.

receive_warranty_repaired

Writes one serialized unit into stock, 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

Puts the supplier's unit for a warranty claim on the shelf as sellable stock — the tail of a claim already settled from the shop's own stock — by serial or IMEI.

receive_warranty_supplier_restock

Records the DIFFERENT unit a supplier sent in place of a claimed device, by its serial or IMEI, and whether its warranty continues or starts fresh. The same device, repaired, is receive_warranty_repaired.

receive_warranty_replacement

Recent sales newest-first, header rows only, cursor-paginated, with voided ones flagged. get_sale with a sale_id gives one sale line by line.

list_sales

Records money a customer paid against their khata (on-account) balance, reducing what they owe. It moves no money at any gateway. Paying past zero is refused unless allow_advance is set. Only cash completes; other tenders need a reference it cannot take.

record_customer_payment

Rewrites the order of a MODEL's photos, main photo first, listing every current photo_id once — not a serialized unit's photos. A gallery edited elsewhere is reported, not overwritten.

reorder_product_photos

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

get_reorder_suggestions

Writes one sale: invoice and receipt number, stock decrement, payment; the business resolves lot and price. May SMS the customer a receipt (if on); on khata, alerts the owner's linked Telegram (default on) and SMSes the customer (if on). Voidable 24 h via void_sale; no refunds.

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 published in-app user manual for this business's vertical — how the app works and how to do things in it. Product documentation only: no sales, stock, customer or staff data. A slug returns one article in full, in English and Bangla; otherwise matching titles.

search_help

Records a warranty claim's device going to a supplier for repair or replacement: the supplier, its RMA number, and when it is due back.

send_warranty_claim_to_supplier

Makes one of a MODEL's existing photos the main one, addressed by the photo_id the status tool lists — not a serialized unit's photo. No file is uploaded or deleted.

set_primary_product_photo

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 one image of up to 5 MB as a product’s main photo. An earlier photo from this flow is deleted; one added in the app moves to position 2 and is kept. Nothing is written until the file arrives.

create_product_image_upload

The supplier directory, and — for owner, admin, regional-manager and pharmacist callers — accounts payable per supplier, shop-wide totals and aging buckets; other roles receive the directory alone. 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 fields of an EXISTING product (name, prices, missing cost, location, reorder level, status, listing, barcode, category, MRP, description, key features, FAQ, specifications). Listed products and prices are public: storefront, marketplace if joined, linked Meta catalog.

update_product

Cancels one sale within 24 hours of ringing it up: the stock returns to its branch, payments are reversed and any khata amount is credited back. The invoice number is kept. Older sales need a refund, not on this server.

void_sale

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 the last N days (max 366), in units: totals by kind (damaged, and other wastage such as stolen or lost), entry counts, and the most-wasted products. No money value. Items written off by weight add entries but no units.

get_wastage