Leer un pedido de Shopify
Un pedido de Shopify con sus líneas.
| 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-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
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
| 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
{
"$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
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"}}'{
"tool": "shopify.pedido.leer",
"params": {
"pedidoId": "gid://shopify/Order/5612345678901"
},
"connectionId": "conn_9tKfR2mQx4Vb"
}Salida esperada (200):
{
"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
| 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í |
nombre | string | null | sí |
creadoEn | string | sí | Cuándo se creó el pedido. Instante ISO 8601 en UTC (Z). |
procesadoEn | string | null | sí |
actualizadoEn | string | null | sí |
canceladoEn | string | null | sí |
motivoCancelacion | string | null | sí |
cerradoEn | string | null | sí |
prueba | booleano | sí | true si es un pedido de prueba. |
estadoFinanciero | string | null | sí |
estadoDespacho | string | null | sí |
impuestosIncluidos | booleano | null | sí |
canal | string | null | sí |
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í |
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í |
impuestosDetalle[].tasa | string | null | sí |
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í |
envios[].codigo | string | null | sí |
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í |
lineas[].sku | string | null | sí |
lineas[].proveedor | string | null | sí |
lineas[].cantidad | entero | sí | Cantidad pedida originalmente. |
lineas[].cantidadActual | entero | null | sí |
lineas[].cantidadReembolsable | entero | null | sí |
lineas[].gravada | booleano | null | sí |
lineas[].requiereEnvio | booleano | null | sí |
lineas[].esGiftCard | booleano | null | sí |
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í |
lineas[].impuestos[].tasa | string | null | sí |
lineas[].impuestos[].monto | objeto | sí | Monto del impuesto. |
lineas[].varianteId | string ^gid:\/\/shopify\/ | null | sí |
lineas[].productoId | string ^gid:\/\/shopify\/ | null | sí |
siguientePaginaLineas | string | null | 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í |
transacciones[].estado | string | null | sí |
transacciones[].pasarela | string | null | sí |
transacciones[].procesadaEn | string | null | sí |
transacciones[].prueba | booleano | null | sí |
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í |
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í |
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í |
reembolsos[].lineas[].cantidad | entero | sí | Cantidad reembolsada. |
reembolsos[].lineas[].tipoReposicion | string | null | sí |
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í |
reembolsos[].transacciones[].estado | string | null | sí |
reembolsos[].transacciones[].pasarela | string | null | sí |
reembolsos[].transacciones[].procesadaEn | string | null | sí |
reembolsos[].transacciones[].prueba | booleano | null | sí |
reembolsos[].transacciones[].monto | objeto | sí | Monto de la transacción. |
reembolsos[].transacciones[].transaccionPadreId | string ^gid:\/\/shopify\/ | null | sí |
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
{
"$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
| 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.