BILLZ
BILLZ is a cloud retail management and POS platform used by retail chains across Uzbekistan and Central Asia. AllMCP provides 12 tools for the product catalog, sales history, customers, and shop reference data.
All providers How connecting worksConnect
Section titled “Connect”BILLZ connects with a single secret integration key that you create inside BILLZ.
-
Create an integration key
In BILLZ, go to Настройки → Настройки компании → Ключи интеграции, click Новый ключ, give it a name such as “AllMCP”, and copy the key.
-
Give the key a role
On the same screen, select the key you just created and assign it a Роль, then grant rights for the sections you want your agent to reach — products, customers, sales. A key without a role can still sign in but is refused on most methods.
-
Connect through your agent
Ask your agent to connect BILLZ and paste the key when prompted. The single field required is:
- Secret integration key — the value you copied above.
Tools by category
Section titled “Tools by category”Once BILLZ is connected, your agent can use the tools below. You don’t need to call anything by name — just describe what you want in plain language and the agent picks the right tool.
Catalog
Section titled “Catalog”| Tool | What it does |
|---|---|
billz_list_products | Lists products with per-shop stock levels and pricing. Searches by name, SKU or barcode, filters by shop, category, brand, supplier, SKU or price range, and can return only what changed since a given time for incremental syncs. |
| Tool | What it does |
|---|---|
billz_list_sales | Searches completed sales by date range, shop, payment type, seller, cashier or receipt total, and returns each sale’s totals, discounts and payment summary. |
billz_get_sale | Retrieves one sale with its full basket — every line item, quantity, price, discount and any returns. |
Clients
Section titled “Clients”| Tool | What it does |
|---|---|
billz_list_clients | Searches customers by name, phone number or Telegram chat ID and returns their short cards with loyalty balance. |
billz_get_client | Retrieves one customer’s full card — loyalty programme and level, customer groups and their discounts, purchase totals, and outstanding debt. |
billz_create_client | Creates a new customer record. |
billz_update_client | Updates a customer’s name, phone, date of birth or gender. |
Reference
Section titled “Reference”| Tool | What it does |
|---|---|
billz_list_shops | Lists the company’s shops with their IDs, names, addresses and contact details. |
billz_list_categories | Lists the product category tree with parent links and product counts. |
billz_list_brands | Lists product brands. |
billz_list_payment_types | Lists the company’s configured payment types, such as cash and card. |
billz_get_currencies | Returns the company’s currency configuration and exchange rates. |
Common workflows
Section titled “Common workflows”Here are a few things you can simply ask your agent to do once BILLZ is connected.
Which shops still have the Air Jordan 1 High in size 42, and how many?What was total revenue at the Chilanzar shop yesterday, and how many sales?Pull up receipt 2089635259 and list everything on itFind the customer with phone +998901234567 and tell me their loyalty level and any balance owedGood to know
Section titled “Good to know”- Stock and price are per shop. A product carries one stock figure and one price per shop, not a single company-wide number. Ask about a specific shop when you want a single answer.
- Sales tools are read-only. Your agent can report on sales that already happened, but cannot ring up a sale, take a payment or issue a refund — those stay on the cash register.
- Customers cannot be deleted or merged through AllMCP. Ask your agent to search before it creates, so you don’t end up with duplicates.
- BILLZ limits API traffic to roughly two requests per second, so large catalog or sales sweeps are paged through steadily rather than all at once.