Uzum Market

This connector uses the Uzum Market seller OpenAPI (https://api-seller.uzum.uz/api/seller-openapi).

Setup:

1. Sign in to the Uzum Market seller cabinet (https://seller.uzum.uz) with the account that owns the shops.
2. Open the settings and create an API token in the API section.
3. Copy the token into UZUM_API_TOKEN.

Authentication: the token goes into the Authorization header as is, without a Bearer prefix (Uzum documents it this way). A 401 or 403 means the token is wrong, revoked, or belongs to another seller; Uzum answers a malformed token with a 500.

Network: Uzum's API gateway answers 400 to every request from AnythingMCP Cloud's servers, so the tools are routed through AnythingMCP's outbound proxy. Self-hosted instances call Uzum directly unless CONNECTOR_PROXY_URL is set; if your server gets a 400 HTML page for every call, set it.

Where to start: uzum_market_list_shops returns the shops the token can see. Almost every other tool needs a shop_id (or shop_ids) from it. uzum_market_list_shops can also list shops the token is not allowed to read: for such a shop every call answers HTTP 500 with a "Whitelabel Error Page", and so does any call with several shop_ids that include it. When that happens, try the shops one at a time, keep working with the ones that answer and tell the user which shop failed: the seller cabinet user that created the token needs access to that shop (or a new token from an account that has it). Then:

• products and SKUs with their stock and statuses: uzum_market_list_products;
• new orders to process: uzum_market_list_orders with status CREATED (default), then uzum_market_confirm_order or uzum_market_cancel_order;
• stock for FBS and DBS: uzum_market_list_stocks, then uzum_market_update_stocks;
• money: uzum_market_list_sales (sold items with commission and seller profit) and uzum_market_list_expenses (fees and services charged).

Dates in filters (date_from, date_to) are Unix timestamps in milliseconds, for example 1727427283895. Dates in answers are ISO strings or millisecond timestamps.

Pagination: page numbers start at 0. Orders and returns allow at most 50 per page, FBS invoices 20, stock 100. uzum_market_list_stocks also has a cursor mode: pass sku_id_from = 0, then the skuId of the last item, until the list is empty; it is the stable way to read a whole catalogue.

Order statuses: CREATED (new, to confirm), PACKING, PENDING_DELIVERY, DELIVERING, DELIVERED, ACCEPTED_AT_DP, DELIVERED_TO_CUSTOMER_DELIVERY_POINT, COMPLETED, CANCELED, PENDING_CANCELLATION, RETURNED. Orders have to be confirmed before their acceptUntil time, otherwise Uzum cancels them.

Personal data: DBS orders carry the buyer's name, phone and address in deliveryInfo. Only pass them on where the task needs them.

Rate limits: Uzum enforces a per-second and a per-day request budget per token and reports it in the response headers X-RateLimit-Remaining, X-RateLimit-Burst-Capacity, X-RateLimit-Limit-Per-Day and X-RateLimit-Remaining-Per-Day. Read pages one at a time and back off on HTTP 429.

Writes: uzum_market_update_stocks sets absolute FBS/DBS stock per SKU (identified by its barcode), uzum_market_update_prices changes full and sale prices of a product's SKUs, uzum_market_confirm_order and uzum_market_cancel_order change an order. All act on the live shop.