Leer un pedido de Shopify
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.
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
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.
^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.pedido.leer/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "pedidoId": "string" } }'{ "data": { "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" }, "codigosDescuento": [ "string" ], "impuestosDetalle": [ { "titulo": "string", "tasa": "string", "monto": { "monto": "string", "moneda": "string" } } ], "envios": [ { "titulo": "string", "codigo": "string", "precioOriginal": { "monto": "string", "moneda": "string" }, "precioConDescuento": { "monto": "string", "moneda": "string" } } ], "enviosIncompletos": true, "lineas": [ { "lineaId": "string", "nombre": "string", "sku": "string", "proveedor": "string", "cantidad": -9007199254740991, "cantidadActual": -9007199254740991, "cantidadReembolsable": -9007199254740991, "gravada": true, "requiereEnvio": true, "esGiftCard": true, "precioUnitarioOriginal": { "monto": "string", "moneda": "string" }, "precioUnitarioFinal": { "monto": "string", "moneda": "string" }, "totalOriginal": { "monto": "string", "moneda": "string" }, "descuentoTotal": { "monto": "string", "moneda": "string" }, "impuestos": [ { "titulo": "string", "tasa": "string", "monto": { "monto": "string", "moneda": "string" } } ], "varianteId": "string", "productoId": "string" } ], "siguientePaginaLineas": "string", "transacciones": [ { "transaccionId": "string", "tipo": "string", "estado": "string", "pasarela": "string", "procesadaEn": "string", "prueba": true, "monto": { "monto": "string", "moneda": "string" }, "transaccionPadreId": "string" } ], "transaccionesIncompletas": true, "reembolsos": [ { "reembolsoId": "string", "creadoEn": "string", "total": { "monto": "string", "moneda": "string" }, "lineas": [ { "lineaId": "string", "cantidad": -9007199254740991, "tipoReposicion": "string", "subtotal": { "monto": "string", "moneda": "string" }, "impuestos": { "monto": "string", "moneda": "string" } } ], "lineasIncompletas": true, "transacciones": [ { "transaccionId": "string", "tipo": "string", "estado": "string", "pasarela": "string", "procesadaEn": "string", "prueba": true, "monto": { "monto": "string", "moneda": "string" }, "transaccionPadreId": "string" } ], "transaccionesIncompletas": true } ], "reembolsosIncompletos": true }, "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 stock por ubicación en Shopify POST
Stock de un ítem de Shopify por ubicación. Trae disponible, en mano, comprometido y entrante. El `inventarioItemId` sale de `shopify.productos.listar`. Connect consulta Shopify en vivo y no guarda nada: cada llamada lee la tienda de la conexión.
Listar pedidos de Shopify POST
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.