Order: Validate Address
validate_order_address[Order]
[What it does] Read-only check of one order's currently saved shipping address against DSers required-field, length, and format rules; never accepts or saves candidate address fields.
[When to use] Use to inspect the saved address or investigate a reported address-rule failure before deciding whether an update is needed.
[When not to use] It cannot validate an unsaved candidate address or confirm real postal deliverability. To change the address, use update_order_information.
[How to use] Copy dsers_order_id from list_orders or get_order. Optional supplier_platform_id selects which supplier's address rules to load; omit, empty, or 0 defaults to AliExpress 159831080. address returns the currently saved shipping address and recipient details using the same fields and values as get_order.order.address, including street address lines, name, phone, email, tax ID, passport numbers, company, and birthday when populated. sales_order_recipient_birthday is returned exactly as stored; AliExpress Brazil rules use DDMMYYYY. Values are returned as stored, without masking; empty fields are omitted. Only supported required, length, and regexp validators with an executable pattern are included; fields and rule types this tool does not apply are omitted. passed_fields lists fields whose effective validators have no failed or unevaluable result. error_fields contains definite validation failures and returns every effective validator applied by this tool to each affected field; inspect those validator statuses because the same field may also contain an unevaluable rule. unevaluated_fields contains fields with no definite failure whose effective validators could not be checked safely. Empty error_fields and unevaluated_fields mean only that the effective rules detected no problem; they do not confirm postal deliverability.
[Side effects] Read-only; no order data changes.
[Confirmation] No confirmation required.
[Follow-up] If error_fields is non-empty, collect the corrected fields, show the proposed change, and call update_order_information after confirmation. If unevaluated_fields is non-empty, report that an effective validator could not be checked safely. Call this Tool again only after the update if the saved address must be checked again.
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": {
"dsers_order_id": "<dsers_order_id>"
},
"name": "validate_order_address"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dsers_order_id | Yes | Copy from list_orders results orders[].dsers_order_id field. Required. | |
| supplier_platform_id | No | Optional supplier platform ID whose address rules should be used. Copy from list_stores supplier_apps[].supplier_platform_id. Omit, empty, or 0 defaults to AliExpress 159831080. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Currently saved shipping address and recipient details, with the same fields and values as get_order order.address | |
| error_fields | Yes | Fields with at least one definite required, length, or regular-expression failure; validators contains every effective validator applied by this tool to each field | |
| passed_fields | Yes | Fields whose effective validators produced no failure or unevaluable result | |
| dsers_order_id | Yes | DSers order ID as a decimal string | |
| unevaluated_fields | Yes | Fields with no definite validation failure but at least one effective validator that could not be evaluated safely | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |