# Leer un pedido de Shopify > Un pedido de Shopify con sus líneas. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ----------------------------------------------------------------- | | **Tool ID** | `shopify.pedido.leer` | | **Nombre MCP** | `shopify__pedido__leer` | | **Conector** | `shopify` | | **Plano** | `action` | | **Scope (permiso)** | `shopify:pedidos` | | **Auth** | `connection_credentials` | | **Versión** | `1` | | **Sensible** | no | | **Deprecado** | no | | **Comportamiento** | readOnly=true, destructive=false, idempotent=true, openWorld=true | > **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST y campo `connectionId` en el `execute` de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](/docs/referencia/conexiones/estado-consultar). ## Qué hace [#qué-hace] 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. ## Entrada [#entrada] | Campo | Tipo | Requerido | Descripción | | -------------- | -------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------- | | `pedidoId` | string `^(?:gid:\/\/shopify\/Order\/)?[1-9][0-9]{0,19}$` | sí | `pedidoId` (`gid://shopify/Order/…`) o `numero` del pedido. | | `paginaLineas` | string | no | El valor `siguientePaginaLineas` de una respuesta anterior, para las líneas siguientes. |
JSON Schema de entrada ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pedidoId": { "type": "string", "pattern": "^(?:gid:\\/\\/shopify\\/Order\\/)?[1-9][0-9]{0,19}$", "description": "`pedidoId` (`gid://shopify/Order/…`) o `numero` del pedido." }, "paginaLineas": { "description": "El valor `siguientePaginaLineas` de una respuesta anterior, para las líneas siguientes.", "type": "string", "minLength": 1, "maxLength": 4096 } }, "required": [ "pedidoId" ], "additionalProperties": false } ```
## Ejemplo [#ejemplo] ```bash title="curl" curl -X POST https://connect.emisso.ai/api/v1/tools/shopify.pedido.leer/execute \ -H "Authorization: Bearer connect_sk_…" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{"input":{"pedidoId":"gid://shopify/Order/5612345678901"}}' ``` ```json title="MCP · meta-tool execute" { "tool": "shopify.pedido.leer", "params": { "pedidoId": "gid://shopify/Order/5612345678901" }, "connectionId": "conn_9tKfR2mQx4Vb" } ``` **Salida esperada (200):** ```json { "data": { "pedidoId": "gid://shopify/Order/5612345678901", "numero": "5612345678901", "nombre": "#1042", "creadoEn": "2026-10-14T15:20:11.000Z", "procesadoEn": "2026-10-14T15:20:10.000Z", "actualizadoEn": "2026-10-15T12:02:45.000Z", "canceladoEn": null, "motivoCancelacion": null, "cerradoEn": null, "prueba": false, "estadoFinanciero": "PARTIALLY_REFUNDED", "estadoDespacho": "FULFILLED", "impuestosIncluidos": true, "canal": "web", "montos": { "subtotal": { "monto": "23980.0", "moneda": "CLP" }, "descuentos": { "monto": "2000.0", "moneda": "CLP" }, "impuestos": { "monto": "4466.0", "moneda": "CLP" }, "envio": { "monto": "3990.0", "moneda": "CLP" }, "total": { "monto": "27970.0", "moneda": "CLP" }, "reembolsado": { "monto": "11990.0", "moneda": "CLP" }, "totalActual": { "monto": "15980.0", "moneda": "CLP" }, "pendiente": { "monto": "0.0", "moneda": "CLP" } }, "totalComprador": { "monto": "27970.0", "moneda": "CLP" }, "codigosDescuento": [ "OCTUBRE2000" ], "impuestosDetalle": [ { "titulo": "IVA", "tasa": "0.19", "monto": { "monto": "4466.0", "moneda": "CLP" } } ], "envios": [ { "titulo": "Despacho a domicilio", "codigo": "domicilio", "precioOriginal": { "monto": "3990.0", "moneda": "CLP" }, "precioConDescuento": { "monto": "3990.0", "moneda": "CLP" } } ], "enviosIncompletos": false, "lineas": [ { "lineaId": "gid://shopify/LineItem/14011111111111", "nombre": "Café de grano 1 kg - Tostado medio", "sku": "CAFE-1KG-M", "proveedor": "Andes Café", "cantidad": 2, "cantidadActual": 1, "cantidadReembolsable": 1, "gravada": true, "requiereEnvio": true, "esGiftCard": false, "precioUnitarioOriginal": { "monto": "12990.0", "moneda": "CLP" }, "precioUnitarioFinal": { "monto": "11990.0", "moneda": "CLP" }, "totalOriginal": { "monto": "25980.0", "moneda": "CLP" }, "descuentoTotal": { "monto": "2000.0", "moneda": "CLP" }, "impuestos": [ { "titulo": "IVA", "tasa": "0.19", "monto": { "monto": "3829.0", "moneda": "CLP" } } ], "varianteId": "gid://shopify/ProductVariant/44000000000001", "productoId": "gid://shopify/Product/8000000000001" } ], "siguientePaginaLineas": null, "transacciones": [ { "transaccionId": "gid://shopify/OrderTransaction/7000000000001", "tipo": "SALE", "estado": "SUCCESS", "pasarela": "shopify_payments", "procesadaEn": "2026-10-14T15:20:10.000Z", "prueba": false, "monto": { "monto": "27970.0", "moneda": "CLP" }, "transaccionPadreId": null } ], "transaccionesIncompletas": false, "reembolsos": [ { "reembolsoId": "gid://shopify/Refund/9000000000001", "creadoEn": "2026-10-15T12:02:45.000Z", "total": { "monto": "11990.0", "moneda": "CLP" }, "lineas": [ { "lineaId": "gid://shopify/LineItem/14011111111111", "cantidad": 1, "tipoReposicion": "RETURN", "subtotal": { "monto": "11990.0", "moneda": "CLP" }, "impuestos": { "monto": "1914.0", "moneda": "CLP" } } ], "lineasIncompletas": false, "transacciones": [ { "transaccionId": "gid://shopify/OrderTransaction/7000000000002", "tipo": "REFUND", "estado": "SUCCESS", "pasarela": "shopify_payments", "procesadaEn": "2026-10-15T12:02:45.000Z", "prueba": null, "monto": { "monto": "11990.0", "moneda": "CLP" }, "transaccionPadreId": null } ], "transaccionesIncompletas": false } ], "reembolsosIncompletos": false }, "meta": { "request_id": "req_…", "tool_id": "shopify.pedido.leer", "plane": "action", "latency_ms": 7410, "audit_status": "recorded" } } ``` > Un pedido de otra tienda o fuera del historial visible responde `external_resource_not_found`. ## Salida [#salida] | Campo | Tipo | Requerido | Descripción | | | ------------------------------------------------- | ----------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `pedidoId` | string `^gid:\/\/shopify\/` | sí | Identificador del pedido. Identificador global de Shopify (`gid://shopify/Order/…`), texto. | | | `numero` | string `^[0-9]{1,20}$` | null | sí | Identificador numérico del pedido (legacyResourceId), texto. | | `nombre` | string | null | sí | Nombre visible del pedido, por ejemplo `#1001`. | | `creadoEn` | string | sí | Cuándo se creó el pedido. Instante ISO 8601 en UTC (Z). | | | `procesadoEn` | string | null | sí | Cuándo se procesó el pedido. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `actualizadoEn` | string | null | sí | Última actualización del pedido. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `canceladoEn` | string | null | sí | Cuándo se canceló; null si no está cancelado. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `motivoCancelacion` | string | null | sí | Motivo de cancelación de Shopify (`CUSTOMER`, `FRAUD`, `INVENTORY`, `DECLINED`, `STAFF`, `OTHER`); null si no aplica. | | `cerradoEn` | string | null | sí | Cuándo se cerró (archivó) el pedido. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `prueba` | booleano | sí | true si es un pedido de prueba. | | | `estadoFinanciero` | string | null | sí | Estado de pago según Shopify, por ejemplo `PAID`, `PENDING`, `PARTIALLY_REFUNDED`, `REFUNDED`. | | `estadoDespacho` | string | null | sí | Estado de despacho según Shopify, por ejemplo `FULFILLED` o `UNFULFILLED`. | | `impuestosIncluidos` | booleano | null | sí | true si los precios del pedido incluyen impuestos. | | `canal` | string | null | sí | Origen del pedido según Shopify (`web`, `pos`, …). | | `montos` | objeto | sí | Montos en la moneda de la tienda. | | | `montos.subtotal` | objeto | sí | Suma de las líneas después de descuentos y antes de devoluciones (`subtotalPriceSet`). | | | `montos.subtotal.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.subtotal.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.descuentos` | objeto | sí | Total descontado antes de devoluciones. Informativo: ya está restado del subtotal y del total. | | | `montos.descuentos.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.descuentos.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.impuestos` | objeto | sí | Total de impuestos antes de devoluciones. | | | `montos.impuestos.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.impuestos.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.envio` | objeto | sí | Total de envío según Shopify (`totalShippingPriceSet`). | | | `montos.envio.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.envio.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.total` | objeto | sí | Total del pedido antes de devoluciones (`totalPriceSet`), con descuentos ya aplicados. Refleja ediciones posteriores. | | | `montos.total.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.total.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.reembolsado` | objeto | sí | Total reembolsado hasta ahora. | | | `montos.reembolsado.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.reembolsado.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.totalActual` | objeto | sí | Total después de devoluciones (`currentTotalPriceSet`). Ya descuenta lo devuelto: no le restes `reembolsado`. | | | `montos.totalActual.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.totalActual.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `montos.pendiente` | objeto | sí | Monto todavía no transado del pedido (`totalOutstandingSet`). | | | `montos.pendiente.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `montos.pendiente.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `totalComprador` | objeto | null | sí | Total en la moneda en que pagó el comprador; null si Shopify no lo informa. | | `totalComprador.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `totalComprador.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `codigosDescuento` | lista de string | sí | Códigos de descuento usados. | | | `impuestosDetalle` | lista de objeto | sí | Impuestos del pedido, por tipo. | | | `impuestosDetalle[].titulo` | string | null | sí | Nombre del impuesto, por ejemplo `IVA`. | | `impuestosDetalle[].tasa` | string | null | sí | Tasa como decimal en texto, por ejemplo `0.19`. | | `impuestosDetalle[].monto` | objeto | sí | Monto del impuesto. | | | `impuestosDetalle[].monto.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `impuestosDetalle[].monto.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `envios` | lista de objeto | sí | Líneas de envío. | | | `envios[].titulo` | string | null | sí | Nombre del método de envío. | | `envios[].codigo` | string | null | sí | Código del método de envío. | | `envios[].precioOriginal` | objeto | sí | Precio del envío antes de descuentos. | | | `envios[].precioOriginal.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `envios[].precioOriginal.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `envios[].precioConDescuento` | objeto | sí | Precio del envío después de descuentos. | | | `envios[].precioConDescuento.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `envios[].precioConDescuento.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `enviosIncompletos` | booleano | sí | true si el pedido tiene más de 5 líneas de envío y no vinieron todas. | | | `lineas` | lista de objeto | sí | Líneas del pedido, hasta 25 por página. | | | `lineas[].lineaId` | string `^gid:\/\/shopify\/` | sí | Identificador de la línea. Identificador global de Shopify (`gid://shopify/LineItem/…`), texto. | | | `lineas[].nombre` | string | null | sí | Nombre del producto y variante. | | `lineas[].sku` | string | null | sí | SKU de la variante. | | `lineas[].proveedor` | string | null | sí | Proveedor (vendor) del producto. | | `lineas[].cantidad` | entero | sí | Cantidad pedida originalmente. | | | `lineas[].cantidadActual` | entero | null | sí | Cantidad vigente tras ediciones y reembolsos. | | `lineas[].cantidadReembolsable` | entero | null | sí | Cantidad que todavía se puede reembolsar. | | `lineas[].gravada` | booleano | null | sí | true si la línea paga impuestos. | | `lineas[].requiereEnvio` | booleano | null | sí | true si requiere despacho físico. | | `lineas[].esGiftCard` | booleano | null | sí | true si es una tarjeta de regalo. | | `lineas[].precioUnitarioOriginal` | objeto | sí | Precio unitario antes de descuentos. | | | `lineas[].precioUnitarioOriginal.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `lineas[].precioUnitarioOriginal.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `lineas[].precioUnitarioFinal` | objeto | sí | Precio unitario después de todos los descuentos. | | | `lineas[].precioUnitarioFinal.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `lineas[].precioUnitarioFinal.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `lineas[].totalOriginal` | objeto | sí | Precio unitario original por la cantidad original. | | | `lineas[].totalOriginal.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `lineas[].totalOriginal.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `lineas[].descuentoTotal` | objeto | sí | Descuento total asignado a la línea. | | | `lineas[].descuentoTotal.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `lineas[].descuentoTotal.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `lineas[].impuestos` | lista de objeto | sí | Impuestos de la línea. | | | `lineas[].impuestos[].titulo` | string | null | sí | Nombre del impuesto, por ejemplo `IVA`. | | `lineas[].impuestos[].tasa` | string | null | sí | Tasa como decimal en texto, por ejemplo `0.19`. | | `lineas[].impuestos[].monto` | objeto | sí | Monto del impuesto. | | | `lineas[].varianteId` | string `^gid:\/\/shopify\/` | null | sí | Variante vendida. `gid://shopify/ProductVariant/…`; null si no aplica. | | `lineas[].productoId` | string `^gid:\/\/shopify\/` | null | sí | Producto vendido. `gid://shopify/Product/…`; null si no aplica. | | `siguientePaginaLineas` | string | null | sí | Pásalo en `paginaLineas` para las líneas siguientes; null si no hay más. | | `transacciones` | lista de objeto | sí | Transacciones de pago del pedido (cobros, autorizaciones, capturas, reembolsos). | | | `transacciones[].transaccionId` | string `^gid:\/\/shopify\/` | sí | Identificador de la transacción. Identificador global de Shopify (`gid://shopify/OrderTransaction/…`), texto. | | | `transacciones[].tipo` | string | null | sí | Tipo de transacción: `SALE`, `AUTHORIZATION`, `CAPTURE`, `REFUND`, `VOID`, … | | `transacciones[].estado` | string | null | sí | Estado: `SUCCESS`, `PENDING`, `FAILURE`, `ERROR`, … | | `transacciones[].pasarela` | string | null | sí | Pasarela que procesó la transacción, por ejemplo `shopify_payments` o `manual`. | | `transacciones[].procesadaEn` | string | null | sí | Cuándo se procesó. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `transacciones[].prueba` | booleano | null | sí | true si es una transacción de prueba; null si no se informa. | | `transacciones[].monto` | objeto | sí | Monto de la transacción. | | | `transacciones[].monto.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `transacciones[].monto.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `transacciones[].transaccionPadreId` | string `^gid:\/\/shopify\/` | null | sí | Transacción de la que depende (una captura de su autorización). `gid://shopify/OrderTransaction/…`; null si no aplica. | | `transaccionesIncompletas` | booleano | sí | true si llegaron 20 transacciones: puede haber más. | | | `reembolsos` | lista de objeto | sí | Reembolsos del pedido, con detalle. | | | `reembolsos[].reembolsoId` | string `^gid:\/\/shopify\/` | sí | Identificador del reembolso. Identificador global de Shopify (`gid://shopify/Refund/…`), texto. | | | `reembolsos[].creadoEn` | string | null | sí | Cuándo se creó el reembolso. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `reembolsos[].total` | objeto | sí | Total del reembolso. Ya está sumado en `montos.reembolsado` del pedido: no lo restes dos veces. | | | `reembolsos[].total.monto` | string `^-?[0-9]{1,19}(?:\.[0-9]{1,9})?$` | sí | Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea. | | | `reembolsos[].total.moneda` | string `^[A-Z]{3}$` | sí | Código ISO 4217 de la moneda, por ejemplo `CLP`. | | | `reembolsos[].lineas` | lista de objeto | sí | Líneas reembolsadas. | | | `reembolsos[].lineas[].lineaId` | string `^gid:\/\/shopify\/` | null | sí | Línea reembolsada. `gid://shopify/LineItem/…`; null si no aplica. | | `reembolsos[].lineas[].cantidad` | entero | sí | Cantidad reembolsada. | | | `reembolsos[].lineas[].tipoReposicion` | string | null | sí | Si se repuso stock: `NO_RESTOCK`, `CANCEL`, `RETURN`, … | | `reembolsos[].lineas[].subtotal` | objeto | sí | Subtotal reembolsado de la línea. | | | `reembolsos[].lineas[].impuestos` | objeto | sí | Impuestos reembolsados de la línea. | | | `reembolsos[].lineasIncompletas` | booleano | sí | true si el reembolso tiene más de 10 líneas y no vinieron todas. | | | `reembolsos[].transacciones` | lista de objeto | sí | Transacciones del reembolso. | | | `reembolsos[].transacciones[].transaccionId` | string `^gid:\/\/shopify\/` | sí | Identificador de la transacción. Identificador global de Shopify (`gid://shopify/OrderTransaction/…`), texto. | | | `reembolsos[].transacciones[].tipo` | string | null | sí | Tipo de transacción: `SALE`, `AUTHORIZATION`, `CAPTURE`, `REFUND`, `VOID`, … | | `reembolsos[].transacciones[].estado` | string | null | sí | Estado: `SUCCESS`, `PENDING`, `FAILURE`, `ERROR`, … | | `reembolsos[].transacciones[].pasarela` | string | null | sí | Pasarela que procesó la transacción, por ejemplo `shopify_payments` o `manual`. | | `reembolsos[].transacciones[].procesadaEn` | string | null | sí | Cuándo se procesó. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa. | | `reembolsos[].transacciones[].prueba` | booleano | null | sí | true si es una transacción de prueba; null si no se informa. | | `reembolsos[].transacciones[].monto` | objeto | sí | Monto de la transacción. | | | `reembolsos[].transacciones[].transaccionPadreId` | string `^gid:\/\/shopify\/` | null | sí | Transacción de la que depende (una captura de su autorización). `gid://shopify/OrderTransaction/…`; null si no aplica. | | `reembolsos[].transaccionesIncompletas` | booleano | sí | true si el reembolso tiene más de 3 transacciones y no vinieron todas. | | | `reembolsosIncompletos` | booleano | sí | true si llegaron 4 reembolsos: puede haber más. El total reembolsado de `montos` es exacto igual. | |
JSON Schema de salida ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pedidoId": { "type": "string", "pattern": "^gid:\\/\\/shopify\\/", "description": "Identificador del pedido. Identificador global de Shopify (`gid://shopify/Order/…`), texto." }, "numero": { "anyOf": [ { "type": "string", "pattern": "^[0-9]{1,20}$" }, { "type": "null" } ], "description": "Identificador numérico del pedido (legacyResourceId), texto." }, "nombre": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Nombre visible del pedido, por ejemplo `#1001`." }, "creadoEn": { "type": "string", "description": "Cuándo se creó el pedido. Instante ISO 8601 en UTC (Z)." }, "procesadoEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cuándo se procesó el pedido. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "actualizadoEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Última actualización del pedido. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "canceladoEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cuándo se canceló; null si no está cancelado. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "motivoCancelacion": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Motivo de cancelación de Shopify (`CUSTOMER`, `FRAUD`, `INVENTORY`, `DECLINED`, `STAFF`, `OTHER`); null si no aplica." }, "cerradoEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cuándo se cerró (archivó) el pedido. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "prueba": { "type": "boolean", "description": "true si es un pedido de prueba." }, "estadoFinanciero": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Estado de pago según Shopify, por ejemplo `PAID`, `PENDING`, `PARTIALLY_REFUNDED`, `REFUNDED`." }, "estadoDespacho": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Estado de despacho según Shopify, por ejemplo `FULFILLED` o `UNFULFILLED`." }, "impuestosIncluidos": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si los precios del pedido incluyen impuestos." }, "canal": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ], "description": "Origen del pedido según Shopify (`web`, `pos`, …)." }, "montos": { "type": "object", "properties": { "subtotal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Suma de las líneas después de descuentos y antes de devoluciones (`subtotalPriceSet`)." }, "descuentos": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total descontado antes de devoluciones. Informativo: ya está restado del subtotal y del total." }, "impuestos": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total de impuestos antes de devoluciones." }, "envio": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total de envío según Shopify (`totalShippingPriceSet`)." }, "total": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total del pedido antes de devoluciones (`totalPriceSet`), con descuentos ya aplicados. Refleja ediciones posteriores." }, "reembolsado": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total reembolsado hasta ahora." }, "totalActual": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total después de devoluciones (`currentTotalPriceSet`). Ya descuenta lo devuelto: no le restes `reembolsado`." }, "pendiente": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Monto todavía no transado del pedido (`totalOutstandingSet`)." } }, "required": [ "subtotal", "descuentos", "impuestos", "envio", "total", "reembolsado", "totalActual", "pendiente" ], "additionalProperties": false, "description": "Montos en la moneda de la tienda." }, "totalComprador": { "anyOf": [ { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total en la moneda en que pagó el comprador; null si Shopify no lo informa." }, { "type": "null" } ], "description": "Total en la moneda en que pagó el comprador; null si Shopify no lo informa." }, "codigosDescuento": { "maxItems": 50, "type": "array", "items": { "type": "string", "maxLength": 255 }, "description": "Códigos de descuento usados." }, "impuestosDetalle": { "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "titulo": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Nombre del impuesto, por ejemplo `IVA`." }, "tasa": { "anyOf": [ { "type": "string", "maxLength": 32 }, { "type": "null" } ], "description": "Tasa como decimal en texto, por ejemplo `0.19`." }, "monto": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Monto del impuesto." } }, "required": [ "titulo", "tasa", "monto" ], "additionalProperties": false, "description": "Un impuesto del pedido." }, "description": "Impuestos del pedido, por tipo." }, "envios": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "titulo": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Nombre del método de envío." }, "codigo": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Código del método de envío." }, "precioOriginal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Precio del envío antes de descuentos." }, "precioConDescuento": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Precio del envío después de descuentos." } }, "required": [ "titulo", "codigo", "precioOriginal", "precioConDescuento" ], "additionalProperties": false, "description": "Una línea de envío." }, "description": "Líneas de envío." }, "enviosIncompletos": { "type": "boolean", "description": "true si el pedido tiene más de 5 líneas de envío y no vinieron todas." }, "lineas": { "maxItems": 25, "type": "array", "items": { "type": "object", "properties": { "lineaId": { "type": "string", "pattern": "^gid:\\/\\/shopify\\/", "description": "Identificador de la línea. Identificador global de Shopify (`gid://shopify/LineItem/…`), texto." }, "nombre": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ], "description": "Nombre del producto y variante." }, "sku": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "SKU de la variante." }, "proveedor": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Proveedor (vendor) del producto." }, "cantidad": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Cantidad pedida originalmente." }, "cantidadActual": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ], "description": "Cantidad vigente tras ediciones y reembolsos." }, "cantidadReembolsable": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ], "description": "Cantidad que todavía se puede reembolsar." }, "gravada": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si la línea paga impuestos." }, "requiereEnvio": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si requiere despacho físico." }, "esGiftCard": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si es una tarjeta de regalo." }, "precioUnitarioOriginal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Precio unitario antes de descuentos." }, "precioUnitarioFinal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Precio unitario después de todos los descuentos." }, "totalOriginal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Precio unitario original por la cantidad original." }, "descuentoTotal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Descuento total asignado a la línea." }, "impuestos": { "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "titulo": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Nombre del impuesto, por ejemplo `IVA`." }, "tasa": { "anyOf": [ { "type": "string", "maxLength": 32 }, { "type": "null" } ], "description": "Tasa como decimal en texto, por ejemplo `0.19`." }, "monto": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Monto del impuesto." } }, "required": [ "titulo", "tasa", "monto" ], "additionalProperties": false, "description": "Un impuesto de la línea." }, "description": "Impuestos de la línea." }, "varianteId": { "anyOf": [ { "type": "string", "pattern": "^gid:\\/\\/shopify\\/" }, { "type": "null" } ], "description": "Variante vendida. `gid://shopify/ProductVariant/…`; null si no aplica." }, "productoId": { "anyOf": [ { "type": "string", "pattern": "^gid:\\/\\/shopify\\/" }, { "type": "null" } ], "description": "Producto vendido. `gid://shopify/Product/…`; null si no aplica." } }, "required": [ "lineaId", "nombre", "sku", "proveedor", "cantidad", "cantidadActual", "cantidadReembolsable", "gravada", "requiereEnvio", "esGiftCard", "precioUnitarioOriginal", "precioUnitarioFinal", "totalOriginal", "descuentoTotal", "impuestos", "varianteId", "productoId" ], "additionalProperties": false, "description": "Una línea del pedido." }, "description": "Líneas del pedido, hasta 25 por página." }, "siguientePaginaLineas": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "null" } ], "description": "Pásalo en `paginaLineas` para las líneas siguientes; null si no hay más." }, "transacciones": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "transaccionId": { "type": "string", "pattern": "^gid:\\/\\/shopify\\/", "description": "Identificador de la transacción. Identificador global de Shopify (`gid://shopify/OrderTransaction/…`), texto." }, "tipo": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Tipo de transacción: `SALE`, `AUTHORIZATION`, `CAPTURE`, `REFUND`, `VOID`, …" }, "estado": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Estado: `SUCCESS`, `PENDING`, `FAILURE`, `ERROR`, …" }, "pasarela": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ], "description": "Pasarela que procesó la transacción, por ejemplo `shopify_payments` o `manual`." }, "procesadaEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cuándo se procesó. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "prueba": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si es una transacción de prueba; null si no se informa." }, "monto": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Monto de la transacción." }, "transaccionPadreId": { "anyOf": [ { "type": "string", "pattern": "^gid:\\/\\/shopify\\/" }, { "type": "null" } ], "description": "Transacción de la que depende (una captura de su autorización). `gid://shopify/OrderTransaction/…`; null si no aplica." } }, "required": [ "transaccionId", "tipo", "estado", "pasarela", "procesadaEn", "prueba", "monto", "transaccionPadreId" ], "additionalProperties": false, "description": "Una transacción de pago." }, "description": "Transacciones de pago del pedido (cobros, autorizaciones, capturas, reembolsos)." }, "transaccionesIncompletas": { "type": "boolean", "description": "true si llegaron 20 transacciones: puede haber más." }, "reembolsos": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "reembolsoId": { "type": "string", "pattern": "^gid:\\/\\/shopify\\/", "description": "Identificador del reembolso. Identificador global de Shopify (`gid://shopify/Refund/…`), texto." }, "creadoEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cuándo se creó el reembolso. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "total": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Total del reembolso. Ya está sumado en `montos.reembolsado` del pedido: no lo restes dos veces." }, "lineas": { "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "lineaId": { "anyOf": [ { "type": "string", "pattern": "^gid:\\/\\/shopify\\/" }, { "type": "null" } ], "description": "Línea reembolsada. `gid://shopify/LineItem/…`; null si no aplica." }, "cantidad": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Cantidad reembolsada." }, "tipoReposicion": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Si se repuso stock: `NO_RESTOCK`, `CANCEL`, `RETURN`, …" }, "subtotal": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Subtotal reembolsado de la línea." }, "impuestos": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Impuestos reembolsados de la línea." } }, "required": [ "lineaId", "cantidad", "tipoReposicion", "subtotal", "impuestos" ], "additionalProperties": false, "description": "Una línea reembolsada." }, "description": "Líneas reembolsadas." }, "lineasIncompletas": { "type": "boolean", "description": "true si el reembolso tiene más de 10 líneas y no vinieron todas." }, "transacciones": { "maxItems": 3, "type": "array", "items": { "type": "object", "properties": { "transaccionId": { "type": "string", "pattern": "^gid:\\/\\/shopify\\/", "description": "Identificador de la transacción. Identificador global de Shopify (`gid://shopify/OrderTransaction/…`), texto." }, "tipo": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Tipo de transacción: `SALE`, `AUTHORIZATION`, `CAPTURE`, `REFUND`, `VOID`, …" }, "estado": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Estado: `SUCCESS`, `PENDING`, `FAILURE`, `ERROR`, …" }, "pasarela": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ], "description": "Pasarela que procesó la transacción, por ejemplo `shopify_payments` o `manual`." }, "procesadaEn": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Cuándo se procesó. Instante ISO 8601 en UTC (Z); null si Shopify no lo informa." }, "prueba": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si es una transacción de prueba; null si no se informa." }, "monto": { "type": "object", "properties": { "monto": { "type": "string", "pattern": "^-?[0-9]{1,19}(?:\\.[0-9]{1,9})?$", "description": "Monto decimal exacto como texto, tal como lo entrega Shopify (`12990.0`). Nunca se redondea." }, "moneda": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "Código ISO 4217 de la moneda, por ejemplo `CLP`." } }, "required": [ "monto", "moneda" ], "additionalProperties": false, "description": "Monto de la transacción." }, "transaccionPadreId": { "anyOf": [ { "type": "string", "pattern": "^gid:\\/\\/shopify\\/" }, { "type": "null" } ], "description": "Transacción de la que depende (una captura de su autorización). `gid://shopify/OrderTransaction/…`; null si no aplica." } }, "required": [ "transaccionId", "tipo", "estado", "pasarela", "procesadaEn", "prueba", "monto", "transaccionPadreId" ], "additionalProperties": false, "description": "Una transacción del reembolso." }, "description": "Transacciones del reembolso." }, "transaccionesIncompletas": { "type": "boolean", "description": "true si el reembolso tiene más de 3 transacciones y no vinieron todas." } }, "required": [ "reembolsoId", "creadoEn", "total", "lineas", "lineasIncompletas", "transacciones", "transaccionesIncompletas" ], "additionalProperties": false, "description": "Un reembolso del pedido." }, "description": "Reembolsos del pedido, con detalle." }, "reembolsosIncompletos": { "type": "boolean", "description": "true si llegaron 4 reembolsos: puede haber más. El total reembolsado de `montos` es exacto igual." } }, "required": [ "pedidoId", "numero", "nombre", "creadoEn", "procesadoEn", "actualizadoEn", "canceladoEn", "motivoCancelacion", "cerradoEn", "prueba", "estadoFinanciero", "estadoDespacho", "impuestosIncluidos", "canal", "montos", "totalComprador", "codigosDescuento", "impuestosDetalle", "envios", "enviosIncompletos", "lineas", "siguientePaginaLineas", "transacciones", "transaccionesIncompletas", "reembolsos", "reembolsosIncompletos" ], "additionalProperties": false } ```
## Errores de esta tool [#errores-de-esta-tool] | Código | HTTP | Reintentable | Qué hacer | | -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `connection_disabled` | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. | | `connection_not_found` | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. | | `connection_credential_required` | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. | | `connection_busy` | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. | | `upstream_error` | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. | | `timeout` | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. | | `connector_onboarding_required` | 428 | no | Lee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Connect, y después la llamada funciona sin cambios. | | `connection_scope_not_enabled` | 403 | no | Pide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error. | | `rate_limited` | 429 | sí | Espera y reintenta con backoff exponencial. | | `upstream_unexpected_response` | 502 | no | No reintentes: la respuesta es determinista. Repórtalo con el request\_id para que actualicemos el conector. | | `external_resource_not_found` | 404 | no | Verifica el identificador con la tool de búsqueda del mismo sistema. Reintentar con el mismo identificador da el mismo resultado. | Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](/docs/referencia/errores).