Dukon AI — Documentation

Talk to your BILLZ store through an AI assistant · Dukon AI

Русская версия ниже · Ruscha versiya quyida

What it does

Dukon AI is a remote MCP server that connects a retail store on the BILLZ platform to an AI assistant (Claude, ChatGPT and other MCP-capable clients). Ask questions in plain language — "What was revenue this week?", "What's running out of stock?", "Top 10 products by profit" — and get answers from your own store data.

Read-only. The server can retrieve data but cannot create, modify or delete anything in your BILLZ account.

Setup

Step 1 — Get your BILLZ integration key

Log in to your store's BILLZ admin panel. Each store has its own subdomain, for example yourstore.billz.io.
Go to Settings → Integrations → API and create a secret integration key.
If you don't see the API section, request API access from BILLZ support — they enable it per account on request.

Step 2 — Create a Dukon AI account

Go to the main page, enter your name, email, a password, and paste the BILLZ key. We verify the key with BILLZ immediately and show which store it belongs to.

Step 3 — Connect your AI assistant

Claude (works on Free, Pro, Max, Team and Enterprise plans, including mobile apps):

Open Settings → Connectors → Add custom connector.
Enter the server URL: https://mcp.dukonai.com/mcp
A Dukon AI login page opens — sign in with the email and password from Step 2.
Start asking questions.

Other MCP clients (ChatGPT developer mode, Gemini, Cursor, VS Code): use the same URL. Authentication is standard OAuth 2.1 with PKCE and Dynamic Client Registration, so no manual client setup is needed.

Example questions

What was my revenue and profit this week compared to last week?
Which products are almost out of stock?
Show me the top 10 products by profit this month.
Which items haven't sold at all in the last 30 days?
Who are my top customers by purchase amount?
How much money is tied up in inventory right now?
Compare sales between my shops.
Which sellers performed best last month?
How much did I write off last month and why?
What discounts did I give this week, and how did they affect margin?

Available tools

Tool	What it returns
`billz_sales_summary`	Revenue, net revenue, gross profit, average check, transaction counts, discounts, returns — by period and shop
`billz_product_sales_report`	Sales per product: quantity sold, returns, revenue, profit, margin, discount
`billz_stock_report`	Stock levels per product per shop on any date, with supply/retail price and estimated margin
`billz_finance_report`	Profit & loss statement; cash-flow journal (income, expenses, collections, shift closings)
`billz_report`	Ten more reports: transactions, sellers, customer purchases, new vs returning customers, product performance, imports, sales by supplier, supplier returns, write-offs, transfers
`billz_list_sales` / `billz_get_sale`	Receipts with filters; full receipt detail with line items and payments
`billz_list_draft_sales`	Unfinished sales: drafts and parked orders
`billz_list_products` / `billz_filter_products`	Catalogue with stock and prices; advanced filtering by shop, category, brand, supplier, price range
`billz_list_customers` / `billz_get_customer`	Customer search; full customer card with purchase totals and averages
`billz_get_debts`	Customer debts and aggregate debt statistics
`billz_get_loyalty_program`	Loyalty program configuration and levels
`billz_list_promos` / `billz_get_promo`	Promotions, their rules and included products
`billz_get_company` / `billz_list_reference`	Company info; reference lists: shops, sellers, categories, brands, suppliers, cash boxes, payment types, currencies
`billz_get_currency_rates`	Currency exchange rate history

Plans and limits

After the 20-day free trial you need a subscription. Without one the service stays available in a demo mode of just a few store queries per day — enough to check it works, not enough for daily use. One question from you usually costs 2–5 queries, because the assistant may look up reference data first. The counter resets at midnight Tashkent time.

Security

Your BILLZ key is encrypted at rest (AES-256-GCM) and used only to serve your own requests.
We never store your store's business data or your conversations.
Authentication is OAuth 2.1 with PKCE; tokens are stored as hashes only.
You can revoke access instantly by deleting the integration key inside BILLZ.

Full details: Privacy Policy · Terms of Service

Support

Email support@dukonai.com. We reply in Russian, Uzbek or English.

По-русски

Что это

Dukon AI подключает ваш магазин на платформе BILLZ к ИИ-ассистенту (Claude, ChatGPT и другие). Спрашивайте обычными словами: «какая выручка за неделю», «что заканчивается на складе», «топ-10 товаров по прибыли» — и получайте ответ по данным своего магазина. Сервис работает только на чтение и не может ничего изменить в вашем BILLZ.

Подключение

Ключ BILLZ. Войдите в кабинет своего магазина (у каждого магазина свой субдомен, например вашмагазин.billz.io) → Настройки → Интеграции → API → создайте секретный ключ. Если раздела API нет — запросите доступ в поддержке BILLZ, они открывают его по обращению.
Регистрация. На главной странице укажите имя, email, пароль и вставьте ключ. Мы сразу проверим ключ и покажем, какой магазин подключён.
Подключение в Claude. Settings → Connectors → Add custom connector → адрес https://mcp.dukonai.com/mcp → войдите по email и паролю.

Работает на всех тарифах Claude, включая бесплатный, и в мобильном приложении.

Лимиты

После 20-дневного пробного периода нужна подписка. Без неё остаётся демо-режим — несколько обращений в сутки: убедиться, что сервис работает, можно, а пользоваться каждый день — нет. Один ваш вопрос — обычно 2–5 обращений. Счётчик обнуляется в полночь по Ташкенту.

Поддержка

support@dukonai.com — отвечаем на русском, узбекском и английском.

O'zbekcha

Bu nima

Dukon AI — BILLZ platformasidagi do'koningizni AI-yordamchiga (Claude, ChatGPT) ulaydigan servis. Oddiy so'zlar bilan so'rang: «bu hafta tushum qancha», «omborda nima tugayapti», «foyda bo'yicha top-10 tovar» — va o'z do'koningiz ma'lumotlari asosida javob oling. Servis faqat o'qiydi — BILLZ da hech narsani o'zgartira olmaydi.

Ulanish

BILLZ kaliti. Do'koningiz kabinetiga kiring (har bir do'konning o'z subdomeni bor, masalan dokoningiz.billz.io) → Sozlamalar → Integratsiyalar → API → maxfiy kalit yarating. API bo'limi bo'lmasa — BILLZ qo'llab-quvvatlashidan so'rang.
Ro'yxatdan o'tish. Bosh sahifada ism, email, parol kiriting va kalitni joylashtiring. Kalitni darhol tekshiramiz va qaysi do'kon ulanganini ko'rsatamiz.
Claude'ga ulash. Settings → Connectors → Add custom connector → manzil: https://mcp.dukonai.com/mcp → email va parol bilan kiring.

Claude'ning barcha tariflarida, jumladan bepul tarifda va mobil ilovada ishlaydi.

Limitlar

20 kunlik bepul sinov davridan keyin obuna kerak. Obunasiz demo-rejim qoladi — kuniga bir necha so'rov: servis ishlashini tekshirish mumkin, lekin har kuni ishlash uchun yetarli emas.

Qo'llab-quvvatlash

support@dukonai.com — rus, o'zbek va ingliz tillarida javob beramiz.

← На главную