Compras en 1688

Importe facturable de 1688 MCP

Consulta el importe facturable de un pedido de 1688 antes de solicitar una factura. Los importes se devuelven en céntimos.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Importe facturable 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. Consultar los importes facturables

Prompt: Para mis pedidos de 1688 [ORDER_IDS], consulta el importe facturable de cada pedido devuelto. Conserva amount en céntimos sin interpretarlo como yuanes y no solicites ninguna factura.

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_invoice_amount

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-invoice-amount-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_alibaba1688_invoice_amount",
    "arguments": {
      "orderIds": [
        "3309156590237728779"
      ]
    }
  }
}

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
`orderIds`	`array`	obligatorio	orderIds Cantidad mínima de elementos: 1
`orderIds[]`	`string`	obligatorio	Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$

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.orderInvoiceAmountModelList`	`array`	opcional	Valor de Order invoice amount model list usado por esta operación de API.
`data.orderInvoiceAmountModelList[]`	`object`	obligatorio	Elemento de data orderInvoiceAmountModelList.
`data.orderInvoiceAmountModelList[].amount`	`number`	opcional	Céntimos; copia el valor sin cambios en invoiceApply.
`data.orderInvoiceAmountModelList[].orderId`	`string`	opcional	Identificador entero positivo exacto. Envíalo como cadena JSON. Patrón: ^[1-9][0-9]*$
`data.retCodes`	`array`	opcional	Valor de Ret codes usado por esta operación de API.
`data.retCodes[]`	`any`	obligatorio	Elemento de data retCodes.
`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.

Ilustración del formato

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

Pregunta ilustrativa

Para mis pedidos de 1688 [ORDER_IDS], consulta el importe facturable de cada pedido devuelto. Conserva amount en céntimos sin interpretarlo como yuanes y no solicites ninguna factura.

Explicación ilustrativa de la respuesta

La respuesta contiene los importes facturables de los pedidos solicitados. Los valores amount están en céntimos; consérvalos sin cambios para una solicitud de factura posterior.

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