BEKSAR

Search the business's products by name words, barcode or articul. Returns product ids, sale and wholesale price, unit, category, whether it has a photo and current stock per branch. Call it before create_income to get productId, before create_product to avoid a duplicate, and before set_product_photo.

find_products

Search the business's suppliers by name (or list them without a query). Returns ids, phone and how much the business still owes each supplier (debt). create_income also accepts supplierName and finds or creates the supplier itself.

find_suppliers

Current stock analysis based on sales velocity over the last lookbackDays (default 30): low_stock = will run out within 7 days or at/below the minimum; dead_stock = in stock but not sold during lookback (with frozen value at cost); reorder = suggested quantity to cover coverDays (default 14) of sales; overview = counts and top items of each. Use for 'what is about to run out', 'what should I buy', 'what is stuck in the warehouse'.

get_inventory_health

List the BEKSAR businesses (organizations) the signed-in user can access, with their branches (shops). Call this first to get organizationId and branch ids for every other analytics tool.

list_my_businesses

Revenue, cost of goods, gross profit and margin for a period (default: this month), per branch, with the 10 most profitable products; optionally compared with another period (margin change in percentage points). Use for 'gross profit this month', 'how much did I earn', 'how did profitability change'.

get_profitability

Record in BEKSAR a payment the business already made to a supplier against its debt (it does not move any money): for one income (incomeId) or for a supplier's unpaid incomes, oldest first. Without an amount it records the whole debt as paid. The payment is added to the till and cannot be undone from ChatGPT. Before calling, show the user the debt, the amount and how it is paid, and get an explicit confirmation.

record_supplier_payment

Record an income (приход), i.e. goods received from a supplier into a branch: increases stock, updates cost and records how the supplier was paid; cannot be undone from ChatGPT. Use productIds from find_products (create missing products with create_product first). Give the supplier as supplierName: an existing supplier with that name is used, a new one is created; if only similar names exist the tool asks which one. Ask the user how the supplier was paid when they did not say. Before calling, show the user the branch, supplier (say if it will be new), every line (product, quantity, purchase price, sum), the total, extra costs and the payment, and get an explicit confirmation.

create_income

Revenue, number of receipts, average receipt, items sold, discounts, refunds and net revenue for a period (default: today), optionally compared with the previous period or the same period last year. Use for 'how much did I sell today/this week', 'compare this week with last week'.

get_sales_summary

Revenue, receipts and average receipt over time, bucketed by day, week or month (auto by period length, max ~120 points). Default period: last 90 days. Use for 'show sales dynamics for the last three months'.

get_sales_trend

Make a photo the user attached in the chat the picture of a product that has none yet (JPG, PNG or WEBP up to 5 MB); an existing photo is never replaced. Confirm the product with the user first.

set_product_photo

Full details of one income: lines, payments to the supplier and extra costs.

get_income

Best or worst selling products by revenue, quantity or gross profit for a period (default: last 30 days), with revenue share and margin. Use for 'which products sell best', 'most profitable products'.

get_top_products