batch_create_products
ChatGPTCreate up to 10 products in one call, each with the same fields as create_product. Options are looked up and created once for the whole batch, before any product; if that fails, nothing is created. Each product then succeeds or fails on its own (an image that can't be used fails only its product), reported by index in results. An item whose error is TIME_BUDGET_EXCEEDED ran out of time and was not done: retry it in a new call. If that error has details.applied, those changes were already made: retry only the rest.
batch_update_products
ChatGPTApply the same changes to up to 10 products, such as a status, tags, or the price of products with one variant each. It cannot change images or single variants: use update_product for those, one product at a time. An active product cannot go straight to draft: set it to unlisted first, then draft. Each product succeeds or fails on its own (a product with several variants given a price fails with VARIANT_REQUIRED), reported by index in results. An item whose error is TIME_BUDGET_EXCEEDED ran out of time and was not done: retry it in a new call. If that error has details.applied, those changes were already made: retry only the rest.
create_product
ChatGPTCreate one product, as a draft unless status says otherwise. Prices are in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). A product without options takes price (and optionally inventory and sku). A product with options (such as Size or Màu) takes options with their values and one variant per combination to sell, each naming a value for every option, e.g. {"Size": "M"}. Existing store options are reused. images are public image URLs, downloaded into the store, or asset_ids; if one can't be used, the product is not created. collection_ids adds it to collections from list_categories; a collection that fails is reported in warnings. For several products use batch_create_products.
create_promotion
ChatGPTCreate a promotion. It is active from start_at (default now). Money is in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). A DISCOUNT_CODE promotion needs code; a condition_type of PRODUCT or VARIANT needs target_ids.
delete_products
ChatGPTPermanently deletes products. This cannot be undone. Takes 1 to 10 product ids. Each is deleted on its own and reported by index in results, so some can fail (for example a product with open orders) while others are deleted. An item whose error is TIME_BUDGET_EXCEEDED ran out of time and was not done: retry it in a new call. If that error has details.applied, those changes were already made: retry only the rest.
delete_promotion
ChatGPTDelete one promotion. This cannot be undone from here; to stop a promotion temporarily use update_promotion with status DISABLED.
get_bug_reports
ChatGPTShows the status of the merchant's bug reports and the staff reply: one report by its number, or up to 20 of the reports they can see, newest first, optionally for one store or status.
get_order
ChatGPTGet one order with its items, totals, payment, fulfillment and shipping status. Give exactly one of order_id (from list_orders) or order_number (the number customers quote, such as 1042). Read-only: refunding, cancelling, fulfilling or editing an order isn't possible here; that is done in the ecomweb dashboard.
get_product
ChatGPTGet one product with its description, tags, images (asset ids and URLs) and every variant with its options, SKU, price (in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99)) and stock.
get_promotion
ChatGPTGet one promotion by promotion_id or by its code. Give exactly one of them.
get_store
ChatGPTGet a store's name, description, status, handle, custom domain, currency and logo.
list_categories
ChatGPTList the store's collections and, with taxonomy_query, search the global category taxonomy. Products have one taxonomy category_code and can be in many collections. Collections are paged 100 at a time: use collections_next_offset when it is not null.
list_orders
ChatGPTList the store's orders, newest first, with status, customer and total. Read-only: refunding, cancelling, fulfilling or editing an order isn't possible here; that is done in the ecomweb dashboard. created_after and created_before take dates, which are whole days in the store's timezone, inclusive, or ISO times with offset. Results are paged: when next_offset is not null, call again with that offset for more. Use get_order for the items of one order.
list_promotions
ChatGPTList the store's promotions (discount codes and automatic discounts), newest first. Results are paged: when next_offset is not null, call again with that offset for more.
list_stores
ChatGPTList the merchant's stores with their ref, name, handle, status, currency, the merchant's role, plan and whether the plan includes the AI connector.
promotion_stats
ChatGPTStore-wide promotion numbers: how many promotions are active, draft, expired or disabled, how many times promotions were used and the total discount given, and the five most used promotions. Uses count orders that are not cancelled. Owners and admins only.
report_bug
ChatGPTFiles a bug report with ecomweb staff when the merchant asks to report a problem with ecomweb or this connector. Sends only the fields given here: a title, a description, optional steps to reproduce, whether the problem stops the merchant selling or running their store, the store it is about, and the name and error code of a tool that failed. Nothing else from the conversation is sent. Returns a report number the merchant can quote to check on it.
sales_summary
ChatGPTRevenue, orders, customers and average order value for a period, with growth. Growth compares with the equal-length period just before. Give period (day, week, month or year; default day) or both start_date and end_date. customer_activity_rate is the share of the store's customers who ordered in the period; it is not a website conversion rate. Owners and admins only.
search_products
ChatGPTSearch and filter the store's products, newest first unless sorted. Prices are in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). category_code is a taxonomy code from list_categories. Each item's inventory_total is its stock across variants; use it (not a status) to judge stock. collection_id is a manual collection's id from list_categories; a smart collection (products chosen by rules) can't be used and answers an error. Results are paged: when next_offset is not null, call again with that offset for more.
top_products
ChatGPTBest-selling products in a date range, ranked by revenue or by units sold. Without dates it covers the last 30 days including today (Asia/Ho_Chi_Minh). truncated true means more products matched than were returned. Owners and admins only.
update_product
ChatGPTChange one product: only the fields given change. Prices are in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). images replaces the whole image list: keep an image by passing its asset_id from get_product (or its url when it has no asset_id, which copies it into the store); new URLs are downloaded, and if one can't be used nothing changes. price, inventory and sku change a product with exactly one variant. On a product with several variants they fail with VARIANT_REQUIRED, listing the variants; to change one variant, pass variants with its variant_id. Changes apply in order (fields, then variants) and stop at the first failure; that error's details.applied lists what had already changed. An active product cannot go straight to draft: set it to unlisted first, then draft. Returns the product as get_product does.
update_promotion
ChatGPTPause (status DISABLED) or resume (status ACTIVE) a promotion. A promotion's terms (discount, dates, products, code, limits) can't be changed once it is created; to change them, pause it and create a new promotion with create_promotion.
batch_create_products
Claudebatch_update_products
Claudecreate_product
Claudecreate_promotion
Claudedelete_products
Claudedelete_promotion
Claudeget_order
Claudeget_product
Claudeget_promotion
Claudeget_store
Claudelist_categories
Claudelist_orders
Claudelist_promotions
Claudelist_stores
Claudepromotion_stats
Claudesales_summary
Claudesearch_products
Claudetop_products
Claudeupdate_product
Claudeupdate_promotion
Claude