List orders with filters. Returns paginated results.

IMPORTANT for AI:

• Use 'q' to search by order code, transaction number, or tracking number.

• Use date range filters to narrow results.

• Response 'meta.pagination' has total, total_pages, current_page for pagination.

Fetch full order detail by transactionNo.

Create a new order.

WORKFLOW: First verify product stock with sku_quantity_available. See WORKFLOW GUIDE in module docstring for full creation flow.

Update order fields by transactionNo.

WORKFLOW: Call get_order first to see current state.

Update order status. Call get_sys_helpers() for valid status values.

Cancel an order. Only works before shipping stage.

Send order to warehouse (Gobox) for packing.

WORKFLOW: Call this AFTER create_order, BEFORE send_order_to_goship. This triggers the warehouse to start picking and packing the order.

Send order to carrier (Goship) for delivery.

WORKFLOW: Call this AFTER send_order_to_gobox (order must be packed first). This triggers carrier pickup/delivery scheduling.

Fetch ALL orders across all pages in parallel.

Use for reporting/counting, e.g. 'all orders from last week'. ALWAYS use filters to narrow results.

List products with filters. Returns paginated results.

IMPORTANT for AI:

• ALWAYS use 'q' to search by name/SKU first instead of browsing all pages.

• Use 'include' to get relations: skus,variants,images,attributes,brand,shops,combos

• Response 'meta.pagination' has total, total_pages, current_page for pagination.

• Platform codes: 1=shopee, 2=lazada, 3=tiktokshop, 4=tiki, 5=pancake, 6=pos

Fetch FULL product detail by SKU with all relations.

Create a new product.

WORKFLOW: First call list_categories + list_brands to get valid IDs.

Required body fields: category_id (int): Category ID (from list_categories) Optional fields: name (str), sku (str), description (str), brand_id (int), weight (int, grams), length/width/height (int), is_combo (bool), total_price (number, required if is_combo=1), product_combos: [{sku_name, quantity}] (if combo), variants: [{name, value}], skus: [{sku, price, supplier_price, variants}], images: [{image, variant_name, variant_value}], attributes: [{attribute_id, value, platform, values[], unit}]

Update product by SKU.

WORKFLOW: Call get_product(sku) first to see current state before updating. Body fields same as create_product.

Delete product by SKU. WARNING: This is irreversible.

Fetch ALL products across all pages in parallel.

Use when you need a complete list, e.g. 'show all products of brand X'. ALWAYS use q/category/brand filters to narrow results when possible.

List all product categories. Use to get category_id for product creation.

WORKFLOW: Call this FIRST, then use category_id for list_brands and list_attributes.

List brands for a category. category_id is REQUIRED.

WORKFLOW: Call list_categories first to get category_id.

List product attributes for a category. category_id is REQUIRED.

WORKFLOW: Call list_categories first to get category_id.

List all product SKU variants.

Fetch ALL product SKU variants across all pages in parallel.

Get AVAILABLE (sellable) quantity. This is what can be sold NOW.

Get total quantity physically IN warehouse (includes held stock).

Get quantity reserved for outgoing order picks (not available for sale).

Get quantity waiting for QC inspection (not yet sellable).

Get quantity expected from incoming consignments (not yet in warehouse).

Composite: fetch ALL 5 quantity states for a single SKU in parallel.

PREFERRED tool for answering 'How much of SKU X do we have?' Returns all states in one call instead of 5 sequential calls.

List all warehouses.

List inventory check (kiểm kho) documents. Paginated.

IMPORTANT for AI:

• Status: 1=pending, 10=awaiting confirmation, 200=completed

• Done status: 1=matched, 2=discrepancy, 3=excess, 4=shortage

• Use date filters + warehouse_id to narrow results.

• Include: location,confirmer,creator,processer,sku

List warehouse picking documents (nhập/xuất/chuyển kho). Paginated.

IMPORTANT for AI:

• Type: 1=shelf transfer, 2=import, 3=export, 4=warehouse transfer

• Use 'q' to search by code, order number, or shipping code.

• Include: moves.sku,order,processer,doner,handoverer,handover,assigner,waiting_revoker,revoker

Fetch ALL warehouses across all pages in parallel.

Fetch ALL inventory checks across all pages in parallel.

ALWAYS use filters to narrow results.

Fetch ALL warehouse pickings across all pages in parallel.

ALWAYS use filters to narrow results.

Warehouse import (stock-in) report.

Import report for refund/returned stock.

Warehouse export report grouped by order.

Warehouse export report grouped by SKU.

Inventory check (kiểm kho) report.

Warehouse storage snapshot — what's currently stored.

Current stock balance per warehouse/SKU. warehouse_id is REQUIRED.

Materials (packaging, supplies) usage report.

List all connected e-commerce shops.

Fetch ALL shops across all pages in parallel.

List all Vietnamese provinces/cities.

List districts for a city. city_id is REQUIRED.

WORKFLOW: Call list_cities first to get city_id.

List wards for a district. district_id is REQUIRED.

WORKFLOW: Call list_cities → list_districts(city_id) → list_wards(district_id).

List all countries supported by Gobox.

Fetch system enum/status reference (order statuses, types, etc.).

Call this once to let AI understand what status codes mean when interpreting order/inventory responses.

List consignment documents. Returns paginated results.

IMPORTANT for AI:

• Use 'q' to search by consignment code.

• Use 'include' for relations: warehouse,skus,attachments

• Status: 0=draft, 2=confirmed, 3=received, 4=partially imported, 5=imported, 49=cancelled

Fetch full consignment detail by code.

Create a new consignment (nhập hàng vào kho).

WORKFLOW: First call list_warehouses to get warehouse_id, then get_product to verify SKUs.

Cancel a consignment. Only works for draft/confirmed status.

Add attachment files to a consignment.

Fetch ALL consignments across all pages in parallel.

ALWAYS use filters to narrow results.

Fetch Goship carrier rates for a delivery route.

List all registered webhook subscriptions.

Register a new webhook endpoint.

Update webhook configuration.

Delete a webhook subscription.

Enable/disable a webhook.