Compras en 1688

Vista previa de pedido de 1688 MCP

Previsualiza los artículos, el envío y los importes de un pedido de 1688 antes de enviarlo.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Vista previa de pedido de 1688

Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.

¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.

1. Revisar artículos e importe antes de comprar

Prompt: Previsualiza un pedido de 1688 con cargoParamList [CARGO_ITEMS] y addressId [ADDRESS_ID]. Muestra los artículos, datos de envío e importes devueltos antes de que yo decida si creo el pedido.

2. Previsualizar con una dirección proporcionada

Prompt: Previsualiza cargoParamList [CARGO_ITEMS] con addressParam [ADDRESS]. Explica los precios y datos de entrega devueltos sin enviar el pedido.

3. Previsualizar un pedido con datos de factura

Prompt: Previsualiza mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID] e invoiceParam [INVOICE_DETAILS]. Muestra los importes y datos de factura devueltos, si existen; no envíes un pedido ni una solicitud de factura.

4. Previsualizar un envío transfronterizo

Prompt: Previsualiza un pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID], flow [FLOW], isvBizType [BUSINESS_TYPE], useBorderLogisticsSolution=true y crossBorderLogisticsSolutionId [SOLUTION_ID]. Revisa únicamente el envío y los importes devueltos antes de decidir si creas el pedido.

Qué debes proporcionar

Sustituye los valores entre corchetes por tus propios identificadores y datos. Usa solo una autorización de tienda de 1688 propia, ACTIVE y vigente.

Comprueba el estado y el mensaje de negocio devueltos. Un HTTP correcto o un código de transporte correcto no demuestran que el pedido o la escritura se hayan completado.

Paso 1 · Conectar

Conecta tu asistente de IA

Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.

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

Autenticación

Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.

Llamar a esta herramienta MCP

Nombre de la herramienta MCP

nexscope_data_alibaba1688_order_preview

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa 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

La respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`addressId`	`string`	opcional	Elige un valor devuelto por receiveAddressList.
`addressParam`	`object`	opcional	addressParam
`addressParam.address`	`string`	obligatorio	Dirección callejera.
`addressParam.areaText`	`string`	opcional	Valor de Area text usado por esta operación de API.
`addressParam.cityText`	`string`	opcional	Valor de City text usado por esta operación de API.
`addressParam.fullName`	`string`	obligatorio	Nombre del destinatario.
`addressParam.mobile`	`string`	obligatorio	Teléfono del destinatario; no lo compartas fuera de la solicitud.
`addressParam.phone`	`string`	opcional	Número de teléfono fijo.
`addressParam.postCode`	`string`	opcional	Código postal.
`addressParam.provinceText`	`string`	opcional	Valor de Province text usado por esta operación de API.
`cargoParamList`	`array`	obligatorio	cargoParamList Cantidad mínima de elementos: 1
`cargoParamList[]`	`object`	obligatorio	cargoParamList
`cargoParamList[].offerId`	`string`	obligatorio	Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$
`cargoParamList[].quantity`	`integer`	obligatorio	Cantidad en la unidad de venta. Mínimo: 1
`cargoParamList[].specId`	`string`	opcional	SKU identificador de especificación.
`crossBorderLogisticsSolutionId`	`string`	opcional	sourceId de la opción logística transfronteriza.
`flow`	`string`	opcional	Flujo del pedido; si se omite, se usa general. Permitidos: general, fenxiao, boutiquefenxiao Predeterminado: general
`invoiceParam`	`object`	opcional	Datos opcionales de factura para la vista previa del pedido.
`invoiceParam.address`	`string`	opcional	Dirección registrada.
`invoiceParam.bankAccount`	`string`	opcional	Cuenta bancaria.
`invoiceParam.bankName`	`string`	opcional	Nombre bancario.
`invoiceParam.invoiceType`	`integer`	opcional	0: factura ordinaria; 1: especial VAT factura.
`invoiceParam.phone`	`string`	opcional	Número de teléfono registrado.
`invoiceParam.taxpayerNumber`	`string`	opcional	Número de contribuyente.
`invoiceParam.title`	`string`	opcional	Título de facturación.
`invoiceParam.titleType`	`integer`	opcional	1: personal; 2: compañía.
`isvBizType`	`string`	opcional	Tipo de negocio transfronterizo. Permitidos: cross, cross_daigou, cross_distribution Predeterminado: cross
`useBorderLogisticsSolution`	`boolean`	opcional	Indica si se usa una opción logística transfronteriza.

Opción 1 de cualquier alternativa — requiere addressId

Opción 2 de cualquier alternativa — requiere addressParam

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	opcional	Nexscope transport/business código sobre; 0 significa que la solicitud fue procesada. Inspeccione datos para los resultados de la operación.
`cost`	`string`	opcional	Tiempo de procesamiento en milisegundos, no créditos.
`data`	`object`	opcional	Valor de Data usado por esta operación de API.
`data.cargoList`	`array`	opcional	Valor de Cargo list usado por esta operación de API.
`data.cargoList[]`	`object`	obligatorio	Elemento de data cargoList.
`data.cargoList[].amount`	`number`	opcional	CNY Yuan.
`data.cargoList[].finalUnitPrice`	`number`	opcional	CNY Yuan.
`data.cargoList[].offerId`	`string`	opcional	Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$
`data.cargoList[].quantity`	`integer`	opcional	Valor de Quantity usado por esta operación de API.
`data.cargoList[].specId`	`string`	opcional	Valor de Spec id usado por esta operación de API.
`data.discountFee`	`number`	opcional	Céntimos.
`data.message`	`string`	opcional	Valor de Message usado por esta operación de API.
`data.payChannelInfos`	`array`	opcional	Valor de Pay channel infos usado por esta operación de API.
`data.payChannelInfos[]`	`object`	obligatorio	Elemento de data payChannelInfos.
`data.shopPromotionList`	`array`	opcional	Valor de Shop promotion list usado por esta operación de API.
`data.shopPromotionList[]`	`object`	obligatorio	Elemento de data shopPromotionList.
`data.status`	`boolean`	opcional	falsos medios no crean un orden.
`data.sumCarriage`	`number`	opcional	Céntimos.
`data.sumPayment`	`number`	opcional	Céntimos.
`data.tradeModelList`	`array`	opcional	Valor de Trade model list usado por esta operación de API.
`data.tradeModelList[]`	`object`	obligatorio	Elemento de data tradeModelList.
`msg`	`string \| null`	opcional	Mensaje de respuesta seguro.
`time`	`string`	opcional	Tiempo de respuesta del servidor.
`traceId`	`string \| null`	opcional	Solicito identificador.
`ts`	`string`	opcional	Timetamp del servidor.

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Previsualiza un pedido de 1688 con cargoParamList [CARGO_ITEMS] y addressId [ADDRESS_ID]. Muestra los artículos, datos de envío e importes devueltos antes de que yo decida si creo el pedido.

Explicación ilustrativa de la respuesta

Envía los artículos y datos de entrega elegidos para obtener una vista previa. Revisa los importes y el envío antes de decidir si creas el pedido.

Sobre esta muestra: Es un ejemplo ilustrativo de la documentación, no una respuesta en directo de tu cuenta. Comprueba los campos y el estado realmente devueltos.

No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.

Ver el formato de solicitud y respuesta MCP

Ejemplos