Connect
API REST

Listar pedidos de Shopify

Pedidos de la tienda Shopify, sin datos de clientes. Trae estado, cancelación y montos (subtotal, descuentos, impuestos, envío, total, reembolsado y saldo). Filtra por rango de creación, estado de pago o nombre, y pagina con `siguientePagina`. Excluye pedidos de prueba salvo que pidas incluirlos. Sin el permiso `read_all_orders`, Shopify solo deja ver los últimos 60 días: `historial` lo dice. Connect consulta Shopify en vivo y no guarda nada: cada llamada lee la tienda de la conexión.

POST
/v1/tools/shopify.pedidos.listar/execute

Authorization

AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/shopify.pedidos.listar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "pedidos": [      {        "pedidoId": "string",        "numero": "string",        "nombre": "string",        "creadoEn": "string",        "procesadoEn": "string",        "actualizadoEn": "string",        "canceladoEn": "string",        "motivoCancelacion": "string",        "cerradoEn": "string",        "prueba": true,        "estadoFinanciero": "string",        "estadoDespacho": "string",        "impuestosIncluidos": true,        "canal": "string",        "montos": {          "subtotal": {            "monto": "string",            "moneda": "string"          },          "descuentos": {            "monto": "string",            "moneda": "string"          },          "impuestos": {            "monto": "string",            "moneda": "string"          },          "envio": {            "monto": "string",            "moneda": "string"          },          "total": {            "monto": "string",            "moneda": "string"          },          "reembolsado": {            "monto": "string",            "moneda": "string"          },          "totalActual": {            "monto": "string",            "moneda": "string"          },          "pendiente": {            "monto": "string",            "moneda": "string"          }        },        "totalComprador": {          "monto": "string",          "moneda": "string"        }      }    ],    "siguientePagina": "string",    "historial": {      "completo": true,      "diasDisponibles": -9007199254740991    }  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Leer un pedido de Shopify POST

Un pedido de Shopify con sus líneas. Trae montos, códigos de descuento, impuestos, envíos, líneas con precios y descuentos, transacciones de pago y reembolsos. Las líneas vienen de a 25 (`siguientePaginaLineas`). El total reembolsado de `montos.reembolsado` ya incluye cada reembolso: no lo descuentes dos veces. Sin datos de clientes. Connect consulta Shopify en vivo y no guarda nada: cada llamada lee la tienda de la conexión.

Listar productos de Shopify POST

Productos de Shopify con variantes, SKU y precio. Van del más recientemente actualizado al más antiguo. Filtra por estado o SKU y pagina con `siguientePagina`. Cada variante trae su `inventarioItemId` para `shopify.inventario.leer`. Connect consulta Shopify en vivo y no guarda nada: cada llamada lee la tienda de la conexión.