1688 Procurement

1688 Order Preview MCP

Preview a 1688 order to review items, shipping details, and payable amounts before submission. Requires an active 1688 authorization and your Nexscope API key.

Cost10 credits / callOnline Test

1688 Order Preview AI Prompts & Use Cases

After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.

New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.

1. Preview Items And Payable Amount

Prompt: Preview a 1688 order with my cargoParamList [CARGO_ITEMS] and selected addressId [ADDRESS_ID]. Show the returned items, shipping details and payable amounts before I decide whether to create an order.

2. Preview An Order With Supplied Address

Prompt: Preview the selected 1688 cargoParamList [CARGO_ITEMS] using my addressParam [ADDRESS]. Explain any returned pricing or delivery information without submitting the order.

3. Preview An Order With Invoice Details

Prompt: Preview my 1688 order using cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID] and invoiceParam [INVOICE_DETAILS]. Show the returned payable amounts and invoice-related information if present; do not submit an order or invoice application.

4. Preview Cross-Border Shipping

Prompt: Preview a 1688 order using cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID], documented flow [FLOW], isvBizType [BUSINESS_TYPE], useBorderLogisticsSolution=true and crossBorderLogisticsSolutionId [SOLUTION_ID]. Review only the returned shipping and payable amounts before deciding whether to create an order.

What You Need to Provide

Replace bracketed values with your own identifiers and inputs. Use only your own ACTIVE, unexpired 1688 store authorization.

Read the returned business status and message. An HTTP or envelope success does not prove that an order or write operation succeeded.

Step 1 · Connect

Connect Your AI Assistant

Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_data_alibaba1688_order_preview

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "1688-order-preview-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_alibaba1688_order_preview",
    "arguments": {
      "addressId": "987654321012345678",
      "cargoParamList": [
        {
          "offerId": "1234567890123456789",
          "quantity": 2,
          "specId": "example-spec"
        }
      ],
      "flow": "general"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`addressId`	`string`	optional	Select from receiveAddressList.
`addressParam`	`object`	optional	addressParam
`addressParam.address`	`string`	required	Street address.
`addressParam.areaText`	`string`	optional	Area text value used by this API operation.
`addressParam.cityText`	`string`	optional	City text value used by this API operation.
`addressParam.fullName`	`string`	required	Recipient name.
`addressParam.mobile`	`string`	required	Recipient phone; avoid sharing outside the request.
`addressParam.phone`	`string`	optional	Landline phone number.
`addressParam.postCode`	`string`	optional	Postal code.
`addressParam.provinceText`	`string`	optional	Province text value used by this API operation.
`cargoParamList`	`array`	required	cargoParamList Minimum items: 1
`cargoParamList[]`	`object`	required	cargoParamList
`cargoParamList[].offerId`	`string`	required	Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$
`cargoParamList[].quantity`	`integer`	required	Quantity in the selling unit. Minimum: 1
`cargoParamList[].specId`	`string`	optional	SKU specification identifier.
`crossBorderLogisticsSolutionId`	`string`	optional	Cross-border logistics solution sourceId.
`flow`	`string`	optional	Order flow; defaults to general when omitted. Allowed: general, fenxiao, boutiquefenxiao Default: general
`invoiceParam`	`object`	optional	Optional invoice details for order preview.
`invoiceParam.address`	`string`	optional	Registered address.
`invoiceParam.bankAccount`	`string`	optional	Bank account.
`invoiceParam.bankName`	`string`	optional	Bank name.
`invoiceParam.invoiceType`	`integer`	optional	0: ordinary invoice; 1: special VAT invoice.
`invoiceParam.phone`	`string`	optional	Registered phone number.
`invoiceParam.taxpayerNumber`	`string`	optional	Taxpayer number.
`invoiceParam.title`	`string`	optional	Invoice title.
`invoiceParam.titleType`	`integer`	optional	1: personal; 2: company.
`isvBizType`	`string`	optional	Cross-border business type. Allowed: cross, cross_daigou, cross_distribution Default: cross
`useBorderLogisticsSolution`	`boolean`	optional	Whether to use a cross-border logistics solution.

Any of option 1 — requires addressId

Any of option 2 — requires addressParam

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`integer`	optional	Nexscope transport/business envelope code; 0 means the request was processed. Inspect data for operation outcomes.
`cost`	`string`	optional	Processing time in milliseconds, not credits.
`data`	`object`	optional	Data value used by this API operation.
`data.cargoList`	`array`	optional	Cargo list value used by this API operation.
`data.cargoList[]`	`object`	required	Item in data cargoList.
`data.cargoList[].amount`	`number`	optional	CNY yuan.
`data.cargoList[].finalUnitPrice`	`number`	optional	CNY yuan.
`data.cargoList[].offerId`	`string`	optional	Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$
`data.cargoList[].quantity`	`integer`	optional	Quantity value used by this API operation.
`data.cargoList[].specId`	`string`	optional	Spec id value used by this API operation.
`data.discountFee`	`number`	optional	Cents.
`data.message`	`string`	optional	Message value used by this API operation.
`data.payChannelInfos`	`array`	optional	Pay channel infos value used by this API operation.
`data.payChannelInfos[]`	`object`	required	Item in data payChannelInfos.
`data.shopPromotionList`	`array`	optional	Shop promotion list value used by this API operation.
`data.shopPromotionList[]`	`object`	required	Item in data shopPromotionList.
`data.status`	`boolean`	optional	false means do not create an order.
`data.sumCarriage`	`number`	optional	Cents.
`data.sumPayment`	`number`	optional	Cents.
`data.tradeModelList`	`array`	optional	Trade model list value used by this API operation.
`data.tradeModelList[]`	`object`	required	Item in data tradeModelList.
`msg`	`string \| null`	optional	Safe response message.
`time`	`string`	optional	Server response time.
`traceId`	`string \| null`	optional	Request trace identifier.
`ts`	`string`	optional	Server timestamp.

Format Illustration

Illustrative example with fictional data, not a live tool call.

Illustrative Question

Preview a 1688 order with my cargoParamList [CARGO_ITEMS] and selected addressId [ADDRESS_ID]. Show the returned items, shipping details and payable amounts before I decide whether to create an order.

Illustrative Response Explanation

Send the selected cargo and delivery details to preview the order. Review the returned cargo, shipping information and amounts before deciding whether to create an order.

About this sample: This is an illustrative documentation example, not a live response from your account. Check the actual returned fields and status.

Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.

View the MCP Request & Response Format

Examples