Compras en 1688
Solicitar factura en 1688 MCP
Solicita facturas para pedidos de 1688 elegibles, tras una confirmación expresa, y revisa los resultados de cada pedido.
Prompts y casos de uso de Solicitar factura 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. Solicitar facturas tras confirmar
Prompt: Muéstrame los pedidos y datos de invoiceApplyModelList [INVOICE_REQUESTS] para revisarlos. Tras mi confirmación expresa, envía confirmApplyInvoice=true e informa por separado de los pedidos aceptados y rechazados.
2. Revisar los errores parciales
Prompt: Después de confirmar la solicitud de factura [INVOICE_REQUESTS], muestra cada pedido de failedList con su errorCode y errorDesc. No supongas que todos los pedidos se procesaron correctamente.
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_invoice_applyhttps://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-invoice-apply-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_alibaba1688_invoice_apply",
"arguments": {
"confirmApplyInvoice": false,
"invoiceApplyModelList": [
{
"amount": 840,
"invoiceType": "VATAX_COMM",
"orderId": "3309156590237728779",
"purchaserInvoiceTitleModel": {
"title": "Example recipient",
"titleType": "PERSONAL"
}
}
]
}
}
}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 |
|---|---|---|---|
confirmApplyInvoice | 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 |
invoiceApplyModelList | array | obligatorio | invoiceApplyModelList Cantidad mínima de elementos: 1 |
invoiceApplyModelList[] | object | obligatorio | invoiceApplyModelList |
invoiceApplyModelList[].amount | integer | obligatorio | Céntimos enteros positivos copiados sin cambios de invoiceAmount (entero de 64 bits). Mínimo: 1 Máximo: 9223372036854776000 |
invoiceApplyModelList[].invoiceType | string | obligatorio | Valor de Invoice type usado por esta operación de API. Permitidos: VATAX_COMM, VATAX_SPEC |
invoiceApplyModelList[].orderId | string | obligatorio | Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$ |
invoiceApplyModelList[].purchaserInvoiceTitleModel | object | obligatorio | COMPANY Requisitos taxpayerIdentify. COMPANY con VATAX_SPEC también requiere bankName, bankAccountId, registerAddress y registerPhone. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.bankAccountId | string | opcional | Necesario para COMPANY títulos con VATAX_SPEC. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.bankName | string | opcional | Necesario para COMPANY títulos con VATAX_SPEC. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.registerAddress | string | opcional | Necesario para COMPANY títulos con VATAX_SPEC. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.registerPhone | string | opcional | Necesario para COMPANY títulos con VATAX_SPEC. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.taxpayerIdentify | string | opcional | Necesario para todos COMPANY títulos. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.title | string | obligatorio | Valor de Title usado por esta operación de API. |
invoiceApplyModelList[].purchaserInvoiceTitleModel.titleType | string | obligatorio | Valor de Title type usado por esta operación de API. Permitidos: PERSONAL, COMPANY |
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.failedList | array | opcional | Valor de Failed list usado por esta operación de API. |
data.failedList[] | object | obligatorio | Elemento de data failedList. |
data.failedList[].errorCode | string | opcional | Valor de Error code usado por esta operación de API. |
data.failedList[].errorDesc | string | opcional | Valor de Error desc usado por esta operación de API. |
data.failedList[].orderId | string | opcional | Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$ |
data.failedList[].outBizId | string | opcional | Valor de Out biz id usado por esta operación de API. |
data.failedList[].result | string | opcional | Valor de Result usado por esta operación de API. |
data.failedList[].tradeOrderCompleted | boolean | opcional | Valor de Trade order completed usado por esta operación de API. |
data.message | string | opcional | Valor de Message usado por esta operación de API. |
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. |
data.successList | array | opcional | Valor de Success list usado por esta operación de API. |
data.successList[] | object | obligatorio | Elemento de data successList. |
data.successList[].errorCode | string | opcional | Valor de Error code usado por esta operación de API. |
data.successList[].errorDesc | string | opcional | Valor de Error desc usado por esta operación de API. |
data.successList[].orderId | string | opcional | Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$ |
data.successList[].outBizId | string | opcional | Valor de Out biz id usado por esta operación de API. |
data.successList[].result | string | opcional | Valor de Result usado por esta operación de API. |
data.successList[].tradeOrderCompleted | boolean | opcional | Valor de Trade order completed usado por esta operación de API. |
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
Muéstrame los pedidos y datos de invoiceApplyModelList [INVOICE_REQUESTS] para revisarlos. Tras mi confirmación expresa, envía confirmApplyInvoice=true e informa por separado de los pedidos aceptados y rechazados.
Pasos sugeridos
Revisa conmigo las solicitudes, obtén mi confirmación expresa y envía confirmApplyInvoice=true. Comprueba cada pedido aceptado o rechazado de la respuesta.
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.