CJdropshipping

查询CJ账户余额：可用余额、冻结金额、奖励金额（单位：美元）。 适用场景：「我的账户余额」「CJ余额还有多少」。 Query the CJ account balance: available, frozen and bonus amounts in USD.

生成购物车页面链接，查看和管理购物车中的商品 / Generate shopping cart page URL to view and manage cart items in browser.

查询CJ公开目录中某个商品或变体的库存数量，按仓库列出总库存（totalInventoryNum）、CJ仓库存（cjInventoryNum）与工厂库存（factoryInventoryNum）。vid（变体ID）/ sku（变体SKU或SPU）/ pid（商品ID）三选一。 适用场景：「SKU CJXXX 还有多少货」「这个变体CJ有多少库存」。 Get the stock of a product or variant in the public CJ catalog, per warehouse: total, CJ-warehouse and factory inventory. Provide one of vid / sku / pid.

获取CJ商品分类树，用于筛选搜索范围。一级分类如服装、电子、家居等 / Get CJ product category tree for filtering. Top categories: Clothing, Electronics, Home, etc.

获取纠纷详情，包含纠纷状态、退款金额、商品信息等 / Get dispute detail including status, refund amount, and product list.

【开纠纷第二步】查询可用的纠纷原因列表（disputeReasonList）、期望结果类型（expectResultOptionList: 1=退款/Refund, 2=补发/Reissue）和最大退款金额，用于准备纠纷申请参数。本工具是查询操作，不会创建或修改任何数据。 [Step 2 of the dispute flow] Get available dispute reasons, expected-result types and max refund amounts, used to prepare the dispute request. Read-only; creates and modifies nothing.

生成 CJ 商品详情页链接，用户打开后页面自动弹出刊登窗口，可在 CJ 网站上把该商品刊登到自己的店铺。productId 取自商品搜索或私有库存查询的返回结果 / Generate a CJ product page URL that opens with the listing dialog, so the user can list the product to their store on the CJ website. The productId comes from a product search or private-inventory query result.

查询物流时效，获取从发货到目的国的预计送达时间和可用物流方式 / Query logistics timeliness. Get estimated delivery time and available shipping methods to destination country.

查询可合单匹配任务的进度：可合单查询在后台异步匹配，需要轮询直到完成。taskId 取自可合单查询的返回结果。只读，不执行合单。 Check the progress of a mergeable-orders matching task. Matching runs asynchronously and needs polling until it finishes; the taskId comes from the mergeable-orders query response. Read-only; does not merge any orders.

查询可合并的订单分组（自动匹配合单列表），只读，不执行合单。 适用场景：「哪些订单可以合并」「查看可合单的订单」。 Get the groups of orders that can be merged (auto-matched merge list). Read-only; does not merge any orders.

查询订单的采购成本（COGS）基础数据，包含商品金额、运费、税费等明细。适用场景：「这些订单的成本是多少」。参数 orderCodesList 为 CJ 订单号数组（必填，每次可批量查询多个）。 Get cost-of-goods (COGS) data for orders: product amount, shipping and tax details. orderCodesList is an array of CJ order numbers (required; several per call are supported).

查询CJ单个订单的完整详情：订单状态、收货地址、商品清单、物流信息、金额明细等。 适用场景：「这个订单的详情」「这个订单发货了吗」。 返回的 trackNumber 只是快递单号；实时物流轨迹（地点、时间节点、当前状态）需由物流追踪工具查询。 本工具仅获取数据，不渲染界面。 Get full detail of a single CJ order: status, shipping address, items, logistics info and amounts. The trackNumber in the response is only a number; real-time tracking events (location, checkpoints, current status) come from a tracking tool. Data only; no UI rendering.

查询订单列表，返回订单状态、金额、商品与物流等概要信息。 适用场景：「查订单」「我的订单」「最近的订单」等一般性订单查询。 参数映射：最近一笔订单 → sortByLatest=true；按状态筛选 → status（取值 shipped / complete / cancel / processing）。 本工具仅获取数据，不渲染界面。 Query the order list with status, amounts, items and logistics summary. Use for general order queries such as "my orders" or "order history". Data only; no UI rendering.

生成 CJ 网站下单页面链接，用户在浏览器中直接于 CJ 网站完成下单（选择变体、结算）/ Generate a CJ website order page URL; the user completes checkout (select variants, check out) directly on the CJ website in the browser.

查询私有库存SKU明细，查看某个商品的各变体库存数量和仓库分布 / Query private inventory SKU details. View variant stock quantities and warehouse distribution for a product.

通过变体SKU精确查询私有库存的SKU明细信息（入库批次、备注等）。 适用场景：「这个变体我备了多少货」。 Look up private-inventory SKU details (inbound batches, remarks) by exact variant SKU, for questions like "how much of this variant did I stock".

生成 CJ 商品详情页链接，用户打开后页面自动进入「关联店铺商品」流程，可在 CJ 网站上把该商品与自己店铺的商品连接。productId 取自商品搜索或私有库存查询的返回结果 / Generate a CJ product page URL that opens the connect-to-store flow, so the user can link the product to a product in their store on the CJ website. The productId comes from a product search or private-inventory query result.

查询CJ单个商品的完整详情：商品名称、图片、价格、变体(颜色/尺码)、库存、描述、物流属性等。pid/productSku/variantSku 三选一必传。 适用场景：「这个商品的详情」；「美国仓有多少库存」→ countryCode=US。 仅获取数据，不渲染界面。 Get full detail of one CJ product: name, images, price, variants (color/size), inventory, description and logistics attributes. One of pid / productSku / variantSku is required. Data only; no UI rendering.

按商品ID查询各变体在各国家/各子仓的库存分布，返回每个子仓的库存数量与子仓ID（stockId，UUID格式，可用于查询仓库详情）。 适用场景：「这个商品在哪些仓库有货」；「这个商品在美国仓有多少库存」→ countryCode=US。 Get the inventory distribution of a product by pid: stock per variant per country and sub-warehouse, with the sub-warehouse UUID (stockId, usable for warehouse detail queries).

查询商品的买家评价（评分、评论内容、图片）。适用场景：「这个商品的评价怎么样」。参数 pid 为必填，score 可按评分（1-5）筛选，支持分页。 Get buyer reviews of a product (rating, comment text, images). pid is required; filter by score (1-5), with pagination.

查询商品的所有变体列表（颜色/尺码/规格）及其价格、重量、图片等信息。适用场景：「这个商品有哪些颜色」「列出 pid=XX 的所有 SKU」。参数 pid/productSku/variantSku 三选一，countryCode 可选用于筛选有库存的变体。 Get all variants of a product (color, size, specification) with price, weight and images. One of pid / productSku / variantSku is required; countryCode optionally limits the result to variants in stock in that country.

获取店铺授权链接，用于连接新的电商平台店铺到CJ账户 / Get shop authorization URL for connecting a new e-commerce platform store to CJ account.

按搜品ID查询搜品需求（Sourcing）的处理结果和状态；需提供 sourceIds（提交搜品需求时返回的 cjSourcingId），不支持不带 ID 列出全部需求。 适用场景：「搜品需求 285 处理了吗」。 Get the status and result of sourcing requests by ID (the cjSourcingId returned when each request was submitted). Listing requests without IDs is not supported.

查询快递包裹的实时物流追踪信息：当前状态、位置、预计送达时间。trackNumbers 至少传1个，支持批量。 需要传入快递单号 trackNumber（可从订单详情返回中获取）；订单详情里的 trackNumber 只是单号，本工具返回真实物流事件（地点、时间节点、当前状态）。 适用场景：「我的包裹到哪了」「追踪单号 CJXXX」。 Get real-time shipment tracking for parcels: current status, location and ETA. Accepts one or more tracking numbers (batch supported). Requires the trackNumber, available in the order-detail response; the response contains the actual tracking events.

查询某个具体CJ仓库的详细信息（地址、联系方式、支持的物流品牌、是否支持自提等）。 需要提供 storageId（UUID格式，如 "2991a224-737b-42a3-a1d9-8ccd2936b341"），不是国家代码；storageId 可从订单详情或商品库存分布的返回字段中获取（订单维度 storageId、商品维度 stockId）。 适用场景：「这个仓库的地址」「这个订单从哪个仓库发的」。 Get detailed info of one CJ warehouse (address, contact, supported logistics brands, self-pickup). Requires a storageId in UUID format — not a country code. The storageId comes from the order-detail or product-inventory responses (storageId / stockId fields).

查询仓库处理订单时拍摄的实操照片（打包图、入库图等），可同时查询多个订单。 适用场景：「查看订单的打包照片」「仓库有没有给我拍照」。 Get warehouse processing photos (packing, inbound, etc.) for orders. Supports multiple orders per call.

获取CJ全球仓库区域列表（国家维度：US/CN/DE/GB/PL等），含各区域 warehouseId，用于按仓库维度筛选库存查询。返回的 id 是区域标识，不是仓库UUID。 适用场景：「CJ有哪些仓库」「美国仓的ID是多少」。 Get the list of CJ global warehouse regions (country level: US/CN/DE/GB/PL...) with warehouseId, for filtering inventory queries by warehouse. The returned ids are region identifiers, not warehouse UUIDs.

【开纠纷第一步】查询订单中可以申请纠纷的商品列表，返回每个商品的 lineItemId、价格、数量；后续步骤会用到 lineItemId。 [Step 1 of the dispute flow] List the products of an order that can be disputed, with lineItemId, price and quantity; later steps use the lineItemId.

查询纠纷列表，查看所有进行中和已结束的纠纷记录。 【意图映射】 - 用户说「我有哪些纠纷」「查下纠纷」→ 直接调用，不需要参数 - 用户说「还在处理中的纠纷」→ status="processing" - 用户说「已解决的纠纷」「纠纷历史」→ status="finished" List disputes. View all ongoing and resolved dispute records. [Intent mapping] "my disputes" → no params; "pending disputes" → status="processing"; "resolved" → status="finished"

分页查询您自己采购并存放在CJ仓库中的私有备货商品（SPU列表），仅返回您账户下的私有库存，不含CJ平台公开目录商品。 适用场景：「我的备货」「我的私有库存」；按仓库筛选时 warehouseId 取自仓库区域列表的返回结果。 List your own stocked products stored in CJ warehouses (private inventory, SPU list) with pagination. Returns only your account's private stock, not the public CJ catalog.

分页查询私有库存的SKU明细列表，可按关键词筛选。 适用场景：「列出我备货的所有SKU」「查我私有库存里含 XX 的SKU」。 List private-inventory SKU details with pagination and an optional keyword filter.

查询店铺商品连接记录列表（CJ商品与平台商品的对应关系）。适用场景：「查看我的商品连接」「这个商品连接了哪些店铺」。可按 shopId/platformProductId/platformVariantId 筛选，支持分页。 List product connection records, i.e. which CJ products are linked to which products in your stores. Filter by shopId / platformProductId / platformVariantId, with pagination.

查询我的选品列表（用户主动添加到「我的商品」的商品），支持关键词、品类、添加时间、是否已刊登等筛选。 适用场景：「我保存的商品」「我的选品列表」。 List the products the user has saved to My Products, with keyword, category, date-added and listing-status filters.

获取已授权店铺列表，包含Shopify/WooCommerce/eBay等平台的店铺信息 / Get authorized shop list including Shopify/WooCommerce/eBay platform stores.

查询待支付（未付款）状态的订单列表。 适用场景：「我有哪些待支付的订单」「未付款的订单」。 List orders that are pending payment, for questions such as "which of my orders are unpaid".

搜索CJ平台上已有的商品目录，支持关键词、分类、价格、国家、仓库类型等多维度筛选。 意图映射：「全球仓/美国仓商品」→ isWarehouse=true, countryCode=US；「中国仓商品」→ isWarehouse=true, countryCode=CN；「找手机壳」→ keyword=手机壳；「50美元以内的XX」→ keyword=XX, maxPrice=50；「包邮」→ addMarkStatus=1；「按价格从低到高」→ orderBy=2, sort=asc；「下一页」→ pageNum 递增；「前N条」→ pageSize=N。 本工具只覆盖 CJ 现有目录内的商品，仅获取数据、不渲染界面。 Search existing products in the CJ catalog with keyword, category, price, country and warehouse-type filters. [Intent mapping] "US warehouse products" → isWarehouse=true, countryCode=US; "China warehouse products" → isWarehouse=true, countryCode=CN; "find XX" → keyword=XX; "XX under $50" → keyword=XX, maxPrice=50; "free shipping" → addMarkStatus=1; "price low to high" → orderBy=2, sort=asc; "next page" → increase pageNum; "top N" → pageSize=N. Covers only products already listed in the CJ catalog; returns data only, no UI rendering.

【界面工具】以可视化方式展示单个订单详情：状态、收货地址、商品清单、物流信息、金额明细。本工具自己按 orderId 取数并渲染，只读不改数据。 适用场景：用户要求「展示订单详情」「以界面看这个订单」时调用并传入 orderId。 [UI tool, read-only] Show one order's detail (status, shipping address, items, logistics, amounts) visually. Fetches by orderId itself; read-only, no data modification.

【界面工具】以可视化卡片形式展示订单列表，本工具自己取数并渲染。 适用场景：用户要求「以卡片形式看订单」「打开订单列表界面」时调用。 [UI tool] Show the order list as visual cards. Fetches and renders the data itself; use when the user asks to see orders as visual cards.

【界面工具】以可视化方式展示单个商品详情，含图片、规格变体、价格、库存。本工具自己按 pid 取数并渲染。 适用场景：用户要求「展示商品详情」「查看商品图片」时调用并传入 pid。 [UI tool] Show single product detail with images, variants, price and stock visually. Fetches by pid itself; pid is required.

【界面工具】以可视化卡片形式展示商品列表，本工具自己按 keyword 取数并渲染。界面支持搜索、分页、点击商品跳转详情。 适用场景：用户要求「以卡片形式显示商品」「打开商品列表界面」时调用并传入 keyword。 [UI tool] Show the product list as visual cards. Fetches by keyword and renders itself; use when the user asks to see products as visual cards.