Order: Validate Issues
diagnose_order_issue[Order]
[What it does] Read-only diagnosis of why DSers orders cannot be placed, paid, or fulfilled; reports per-dimension pass/fail results, non-blocking warnings, and resolutions.
[When to use] Use when the user asks why an order is failing, or to check readiness before placing it with the supplier. Call this before place_orders_to_suppliers / placement to understand and resolve blockers.
[When not to use] To actually place an allowed order, use the placement tool; this tool never places orders or edits data.
[How to use] Exact dsers_order_ids mode and search-filter mode are mutually exclusive. Both modes require one concrete status and supplier_platform_id; all is rejected. Search mode evaluates one page of up to 100 orders. Exact IDs are looked up only in that supplier/tab pair, and a miss is per-order NOT_FOUND without retrying another supplier or tab. Other search filters cannot be combined with dsers_order_ids. search_by=dsers_order_id remains search mode. Item validation and platform-function checks use only items matching the selected supplier and tab. Only decision=allowed with complete=true conclusively permits placement — unknown or incomplete remains inconclusive even without a reported blocker. Dimensions whose checks are unavailable are reported in missing_checks, not treated as passing. fulfillable_item_ids contains supplier-orderable item IDs from the selected supplier/tab scope and supports initial placement from awaiting_order plus re-placement from cancelled and failed; seller-platform Fulfill restrictions are excluded from this supplier-ordering result. The supplier order-and-payment disable switch is evaluated per supplier_platform_id. CANNOT_ORDER_WITHOUT_SKU is evaluated for supplier apps that have unquoted items; a confirmed restriction is UNQUOTED_ORDER. AWAITING_ORDER_ITEM_PRODUCT_EMPTY_CANNOT_ORDER is evaluated for supplier apps that have zero-quantity items; a confirmed restriction is ZERO_FULFILLABLE_QUANTITY. MAX_CHAR_LEAVE_A_MESSAGE_TO_SUPPLIER is evaluated for supplier apps that have items with messages over 1000 characters; a confirmed restriction is SUPPLIER_MESSAGE_TOO_LONG. AWAITING_PAYMENT_MAKE_PAYMENT_BTN_DO_NOTHING is evaluated for all relevant supplier apps on awaiting-payment orders with zero cost; a confirmed restriction is AWAITING_PAYMENT_ZERO_COST. SHIPPING_COUNTRY_REQUIRED blocks placement when address.country is missing or blank, including a missing address; the order cannot be placed until a shipping country is configured. SHIPPING_METHOD_UNAVAILABLE is reported when no freight option is available for a mapped supplier product to the current shipping destination; it blocks placement until the supplier, product, or destination changes. SHIPPING_METHOD_REQUIRED is reported when a mapped supplier has available freight options but no shipping method is selected; a confirmed restriction blocks placement. ORDER_COST_EXCEEDS_REVENUE is a non-blocking warning when product cost plus shipping cost is strictly greater than order revenue on one complete, matching currency basis; it is omitted when those amounts cannot be compared safely and never changes decision, complete, or fulfillable_item_ids. Other platform-dependent checks that cannot be evaluated stay in missing_checks.
[Side effects] Read-only; no order data changes.
[Confirmation] Required per current configuration and not skippable.
[Follow-up] If conclusively allowed and placement is the goal, proceed to the placement tool per its own confirmation rules; otherwise report the blocker or missing check and stop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"status": "<status>",
"supplier_platform_id": "<supplier_platform_id>"
},
"name": "diagnose_order_issue"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Optional order search text. | |
| cursor | No | Opaque next_cursor returned by a previous diagnose_order_issue search call. | |
| status | Yes | Required DSers order tab and item-evaluation scope. It limits both lookup and item evaluation to one concrete tab; all and omission are not supported. Copy from list_orders when combining with dsers_order_ids; do not invent another tab after NOT_FOUND. | |
| country | No | Optional destination country code filter. | |
| end_time | No | Optional Unix order creation end timestamp. | |
| page_size | No | Orders evaluated from one search page, up to 100. | |
| search_by | No | How query is interpreted in search_filters mode. Exclusive of dsers_order_ids. search_by=dsers_order_id stays search mode. | |
| sort_order | No | Order creation-time sort order. | desc |
| start_time | No | Optional Unix order creation start timestamp. | |
| dsers_order_ids | No | Optional exact DSers order IDs. Cannot be combined with search filters other than the required status. Paste JSON example: ["2088507008557908224"]. | |
| dsers_store_ids | No | Optional DSers store IDs for search_filters mode. Search mode also requires supplier_platform_id. Paste JSON example: ["1999323491106619392"]. | |
| supplier_platform_id | Yes | Required supplier platform ID in both exact dsers_order_ids and search_filters mode; it limits the selected orders and evaluated items to that supplier. Copy from list_stores supplier_apps[].supplier_platform_id, list_orders, or get_order. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orders | Yes | Per-order validation results | |
| summary | Yes | Decision counts for this response | |
| checked_at | Yes | RFC3339 evaluation timestamp | |
| pagination | Yes | Cursor pagination for search_filters mode | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |