Compras en 1688
Crear pedido en 1688 MCP
Crea un pedido de compra en 1688 con artículos, SKU y datos de entrega seleccionados, tras una confirmación expresa.
Prompts y casos de uso de Crear pedido en 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. Enviar un pedido confirmado
Prompt: Usa cargoParamList [CARGO_ITEMS] y la dirección de entrega [ADDRESS_ID] que he elegido para preparar un pedido de 1688. Muéstrame los artículos y la dirección. Solo después de mi confirmación expresa, envía confirmCreateOrder=true y comunica el orderId real o el error devuelto.
2. Enviar un pedido con una dirección proporcionada
Prompt: Usa cargoParamList [CARGO_ITEMS] y addressParam [ADDRESS] para preparar un pedido de 1688. Revisa conmigo los datos de entrega y espera mi confirmación expresa antes de enviar confirmCreateOrder=true. Comunica code, message y orderId tal como se devuelvan.
3. Crear un pedido con flujo de distribución
Prompt: Prepara mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID], el flujo de distribución documentado [FLOW] y fenxiaoChannel [CHANNEL]. Muéstrame la configuración y espera mi confirmación expresa antes de enviar confirmCreateOrder=true. Comunica el orderId o error real.
4. Crear un pedido con logística transfronteriza
Prompt: Prepara mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID], isvBizType [BUSINESS_TYPE], crossBorderLogisticsSolutionId [SOLUTION_ID] y useBorderLogisticsSolution=true. Revisa conmigo la opción logística y espera mi confirmación expresa antes de enviar confirmCreateOrder=true. Comunica el resultado real.
5. Elegir una modalidad de transacción documentada
Prompt: Prepara mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID] y tradeType [TRADE_TYPE] admitido. Explica la modalidad elegida sin suponer que se pagó. Tras mi confirmación expresa, envía confirmCreateOrder=true y comunica el orderId o error devuelto.
6. Usar una promoción documentada
Prompt: Prepara mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID], shopPromotionId [PROMOTION_ID] y useRedEnvelope [Y_OR_N]. Muestra la configuración sin prometer un descuento. Tras mi confirmación expresa, envía confirmCreateOrder=true y comunica el resultado real.
7. Incluir referencia y mensaje del pedido
Prompt: Prepara mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID], outOrderId [CLIENT_ORDER_ID] y message [ORDER_MESSAGE]. Conserva mis valores sin deducir idempotencia de outOrderId. Tras mi confirmación expresa, envía confirmCreateOrder=true y comunica el orderId devuelto.
8. Establecer la opción de comprador anónimo
Prompt: Prepara mi pedido de 1688 con cargoParamList [CARGO_ITEMS], addressId [ADDRESS_ID] y la opción documentada anonymousBuyer [ANONYMOUS_BUYER]. Muestra el valor elegido sin prometer efectos de privacidad no documentados. Tras mi confirmación expresa, envía confirmCreateOrder=true y comunica el resultado real.
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.
Obtén una confirmación expresa e independiente antes de establecer el campo confirm documentado en el valor JSON true. Nunca reintentes automáticamente una escritura.
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/jsonAutenticació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
nexscope_data_alibaba1688_create_orderhttps://api.nexscope.ai/mcptools/callInicializa 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-create-order-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_create_order",
"arguments": {
"addressId": "987654321012345678",
"cargoParamList": [
{
"offerId": "1234567890123456789",
"quantity": 2,
"specId": "example-spec"
}
],
"confirmCreateOrder": false,
"flow": "general"
}
}
}MCP 2025-11-25 · Streamable HTTPLa 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. |
anonymousBuyer | boolean | opcional | Valor de Anonymous buyer 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. |
confirmCreateOrder | boolean | obligatorio | Debe ser el valor JSON true después de una confirmación expresa e independiente del usuario. Los ejemplos usan false por defecto y no autorizan esta acción. Predeterminado: false |
crossBorderLogisticsSolutionId | string | opcional | sourceId de la opción logística transfronteriza. |
fenxiaoChannel | string | opcional | Plataforma de distribución. Permitidos: douyin, kuajing, pinduoduo, taote |
flow | string | opcional | Flujo del pedido; si se omite, se usa general. Permitidos: general, fenxiao, boutiquefenxiao Predeterminado: general |
isvBizType | string | opcional | Tipo de negocio transfronterizo. Permitidos: cross, cross_daigou, cross_distribution Predeterminado: cross |
message | string | opcional | Valor de Message usado por esta operación de API. |
outOrderId | string | opcional | Valor de Out order id usado por esta operación de API. |
shopPromotionId | string | opcional | Valor de Shop promotion id usado por esta operación de API. |
tradeType | string | opcional | Modalidad de transacción: assureTrade, alipay, period, assure, creditBuy, bank, 631staged o 37staged. |
useBorderLogisticsSolution | boolean | opcional | Indica si se usa una opción logística transfronteriza. |
useRedEnvelope | string | opcional | Valor de Use red envelope usado por esta operación de API. Permitidos: y, n Predeterminado: n |
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.code | string | opcional | Código de negocios. |
data.message | string | opcional | Valor de Message usado por esta operación de API. |
data.orderId | string | opcional | Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$ |
data.subCode | string | opcional | Valor de Sub code usado por esta operación de API. |
data.subMessage | string | opcional | Valor de Sub message usado por esta operación de API. |
data.success | boolean | opcional | Inspeccione este resultado de negocio incluso cuando HTTP el estado es de 200. |
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. |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
Usa cargoParamList [CARGO_ITEMS] y la dirección de entrega [ADDRESS_ID] que he elegido para preparar un pedido de 1688. Muéstrame los artículos y la dirección. Solo después de mi confirmación expresa, envía confirmCreateOrder=true y comunica el orderId real o el error devuelto.
Pasos sugeridos
Revisa conmigo los artículos y la dirección. Envía el pedido solo después de mi confirmación expresa con confirmCreateOrder=true; comprueba el orderId o el error real devuelto.
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
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
No hay un ejemplo verificado de solicitud MCP. Consulta Integración y los requisitos documentados antes de preparar una llamada.
Formato de respuesta MCP
Este flujo de trabajo no afirma haber obtenido un resultado de la API. No hay un ejemplo de respuesta verificado; consulta Parámetros y respuesta para ver la estructura documentada.