{
  "info": {
    "_postman_id": "e1c2d3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
    "name": "Ecuafact API — Comprobantes Electronicos SRI (v1)",
    "description": {
      "content": "# Ecuafact API (v1) — Coleccion para integradores\n\nAPI REST para **emitir, consultar y dar seguimiento** a comprobantes electronicos. Envias JSON o el XML del SRI y la plataforma valida, firma y transmite al SRI, y genera el RIDE.\n\n## Que incluye\n- **00 · Inicio**: salud, contexto de la credencial y cupo.\n- **01 · Emitir**: validacion sin emitir y emision por tipo: factura, liquidacion de compra, nota de credito, nota de debito, guia de remision y retencion. La ruta fija el tipo; el cuerpo no lleva `infoTributaria.tipoDocumento`.\n- **02 · Seguimiento**: estado de una operacion.\n- **03 · Listado**: comprobantes emitidos por contribuyente y periodo.\n- **04 · Errores**: ejemplos del contrato de error (401, 400, 422, los dos 429 y un XML con `codDoc` incorrecto). Los ejemplos del 422 y de los dos 409 de la emision (3004 y 3005) estan en **01.1**, y el 404 de una operacion que no existe, en **02.1**.\n- **05 · Consultas SRI**: contribuyentes, establecimientos, validacion de identificacion y clave de acceso.\n- **06 · Descargas**: RIDE (PDF) y XML de un comprobante autorizado.\n- **07 · Perfil del emisor**: leer y actualizar el perfil y cambiar el logo.\n- **08 · Webhooks**: crear, listar, pausar, reanudar, rotar el secreto, ver entregas, reintentar y deshabilitar destinos.\n\n## Como empezar\n1. Importa esta coleccion y el environment `Ecuafact API — Plantilla`.\n2. `baseUrl` apunta al ambiente de pruebas (`https://api-sandbox.mynexusapi.com`, sin validez fiscal). Para produccion usa `https://api.mynexusapi.com`.\n3. Pega tu `apiKey` en el environment.\n4. Ajusta `identificacion` (la identificacion completa del contribuyente, el valor `identificacion` de `GET /v1/contexto`), `ruc` (el mismo valor), `estab` y `ptoEmi` de tu ambiente.\n5. Ejecuta **00 · Inicio** y luego **01 · Emitir**. Copia el `idOperacion` de la respuesta para **02 · Seguimiento**.\n\n## Autenticacion\nTodas las rutas `/v1` exigen la cabecera `X-Api-Key` (ya configurada en la coleccion). En produccion, la IP de origen debe estar registrada en tu cuenta; el sandbox acepta cualquier IP. La ruta `/salud` es publica.\n\n## Convenciones\n- Rutas y propiedades en espanol ASCII, sin tildes.\n- Importes: numeros JSON decimales sin comillas, punto decimal.\n- Fechas fiscales: `dd/MM/yyyy`. Periodo: `MM/yyyy`.\n- Ambiente: lo determina la URL (`api-sandbox` = pruebas, `api` = produccion).\n- `Idempotency-Key` es **obligatoria** al emitir: si repites la misma clave con el mismo cuerpo, la API responde el mismo `202` con el mismo `idOperacion`; con otro cuerpo responde `409` (`codEstado` 3005).\n- Emitir responde `202 Accepted` normalmente con `estado` `recibido`, no autorizacion: `codEstado` 1001 (todavia sin `claveAcceso`, que viene en `null`) o 1002 (ya con `claveAcceso`). Si el resultado ya se conoce, el `202` trae el estado final (`autorizado` 2001, `rechazado` 3xxx o `rechazo_configuracion` 4xxx, con `msgError` y `errores`): decide por `estado` y `codEstado`, nunca asumas `recibido`. `urlEstado` es la URL completa del seguimiento, igual a la cabecera `Location`. El resultado final se consulta en **02 · Seguimiento**.\n- `X-Additional-Info` (opcional, deshabilitada en las peticiones de **01 · Emitir**): texto tuyo que la API asocia a tu solicitud para que soporte la encuentre. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos. No cambia la respuesta.\n\n## Respuesta de exito\nTodas las respuestas JSON son planas: el resultado esta en el primer nivel, sin envoltorio.\n\n## Respuesta de error\n`{ \"estado\": \"rechazado\", \"codEstado\": 3013, \"msgError\": \"Recurso no encontrado.\", \"errores\": [] }`. `codEstado` es un numero de 4 digitos y su primer digito es el `estado` (1 `recibido`, 2 `autorizado`, 3 `rechazado`, 4 `rechazo_configuracion`, 5 `error`, 6 `cancelado`); decide con el, no con `msgError`. `errores` viene siempre: trae el detalle (la ruta del campo o el mensaje del SRI) o `[]`. La emision responde sus rechazos con la misma forma de su `202`, con `idOperacion`, `urlEstado`, `claveAcceso` y las fechas en `null`. Catalogo completo: [Errores](https://docs.mynexusapi.com/v1/guias/errores#catalogo-de-codestado). El correlation id va en la cabecera `X-Correlation-Id`. Codigos HTTP: 400 validacion, 401 credencial no valida (3009), 403 IP no autorizada (3010) o contribuyente, tipo de comprobante o servicio no habilitados (3011), 404 no encontrado (3013), 409 conflicto, 413 cuerpo excedido, 422 comprobante invalido, 429 limite de solicitudes (`codEstado` 5005, reintenta tras `Retry-After`) o cupo agotado (`codEstado` 4004, no reintentes), 500 error interno, 501 XML no implementado, 502/503/504 dependencia. Ante 500, 502, 503 o 504 reintenta con la misma `Idempotency-Key`.",
      "type": "text/markdown"
    },
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "X-Api-Key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// Fechas fiscales en horario Ecuador (UTC-5).",
          "const now = new Date(Date.now() - 5 * 60 * 60 * 1000);",
          "const dd = String(now.getUTCDate()).padStart(2, '0');",
          "const mm = String(now.getUTCMonth() + 1).padStart(2, '0');",
          "const yyyy = String(now.getUTCFullYear());",
          "pm.collectionVariables.set('fechaEmision', dd + '/' + mm + '/' + yyyy);",
          "pm.collectionVariables.set('periodoFiscal', mm + '/' + yyyy);",
          "pm.collectionVariables.set('fechaIso', yyyy + '-' + mm + '-' + dd);",
          "// Clave de idempotencia y referencia por defecto (la carpeta de emision las regenera).",
          "pm.collectionVariables.set('idempotencyKey', 'pm-' + pm.variables.replaceIn('{{$guid}}'));",
          "pm.collectionVariables.set('referenciaExterna', ('postman-' + Date.now().toString()).slice(0, 128));"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api-sandbox.mynexusapi.com",
      "type": "string",
      "description": "URL base del API. Pruebas: https://api-sandbox.mynexusapi.com (sin validez fiscal). Produccion: https://api.mynexusapi.com."
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "secret",
      "description": "API Key de la integracion (cabecera X-Api-Key). Obtenla creando un sandbox o en el Portal del Cliente (Cuenta > API Keys). No la compartas."
    },
    {
      "key": "identificacion",
      "value": "0123456789001",
      "type": "string",
      "description": "Identificacion completa del contribuyente emisor (para un RUC, sus 13 digitos): el valor `identificacion` de GET /v1/contexto. Es el mismo valor de `ruc`."
    },
    {
      "key": "ruc",
      "value": "0123456789001",
      "type": "string",
      "description": "RUC del emisor para infoTributaria.ruc. Es el mismo valor de `identificacion`."
    },
    {
      "key": "estab",
      "value": "002",
      "type": "string",
      "description": "Codigo de establecimiento (3 digitos)."
    },
    {
      "key": "ptoEmi",
      "value": "001",
      "type": "string",
      "description": "Punto de emision (3 digitos)."
    },
    {
      "key": "idOperacion",
      "value": "",
      "type": "string",
      "description": "Se llena con la ultima emision (usado por Seguimiento)."
    },
    {
      "key": "idOperacion01",
      "value": "",
      "type": "string",
      "description": "idOperacion de la ultima factura."
    },
    {
      "key": "idOperacion03",
      "value": "",
      "type": "string",
      "description": "idOperacion de la ultima liquidacion de compra."
    },
    {
      "key": "idOperacion04",
      "value": "",
      "type": "string",
      "description": "idOperacion de la ultima nota de credito."
    },
    {
      "key": "idOperacion05",
      "value": "",
      "type": "string",
      "description": "idOperacion de la ultima nota de debito."
    },
    {
      "key": "idOperacion06",
      "value": "",
      "type": "string",
      "description": "idOperacion de la ultima guia de remision."
    },
    {
      "key": "idOperacion07",
      "value": "",
      "type": "string",
      "description": "idOperacion de la ultima retencion."
    },
    {
      "key": "fechaEmision",
      "value": "",
      "type": "string",
      "description": "Calculada por el script: dd/MM/yyyy (Ecuador)."
    },
    {
      "key": "periodoFiscal",
      "value": "",
      "type": "string",
      "description": "Calculada por el script: MM/yyyy."
    },
    {
      "key": "fechaIso",
      "value": "",
      "type": "string",
      "description": "Calculada por el script: yyyy-MM-dd."
    },
    {
      "key": "idempotencyKey",
      "value": "",
      "type": "string",
      "description": "Generada por el script por request. No la reutilices con otro cuerpo."
    },
    {
      "key": "referenciaExterna",
      "value": "",
      "type": "string",
      "description": "Generada por el script por request. Identificador propio e idempotente."
    },
    {
      "key": "claveAccesoEmitida",
      "value": "",
      "type": "string",
      "description": "Se llena en 02.1 cuando la operacion queda autorizada. La usan 06.1 a 06.3."
    },
    {
      "key": "idDestino",
      "value": "",
      "type": "string",
      "description": "Se llena en 08.1 al crear un destino o en 08.2 al listar. La usan las demas peticiones de la carpeta 08."
    },
    {
      "key": "eventoId",
      "value": "",
      "type": "string",
      "description": "Se llena en 08.6 con el eventId de la primera entrega. La usa 08.7 para reintentar."
    },
    {
      "key": "catalogo",
      "value": "tarifas-iva",
      "type": "string",
      "description": "Clave del catalogo que lee 09.2. Usa una clave que devuelva 09.1."
    }
  ],
  "item": [
    {
      "name": "00 · Inicio y diagnostico",
      "description": {
        "content": "Verifica que el servicio responde, que tu credencial es valida y cuanto cupo te queda en el ambiente.",
        "type": "text/markdown"
      },
      "item": [
        {
          "name": "00.1 · Salud del servicio (publico)",
          "auth": {
            "type": "noauth"
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('Servicio activo (200)', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.json().estado).to.eql('activo');",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/salud",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "salud"
              ]
            },
            "description": {
              "content": "Comprueba disponibilidad del API. **No requiere credencial.**\n\n- `GET /salud`\n- Respuesta `200`: `{ \"servicio\": \"EcuafactSRIApi\", \"estado\": \"activo\" }`",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Servicio activo",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/salud"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"servicio\": \"EcuafactSRIApi\",\n  \"estado\": \"activo\"\n}"
            }
          ]
        },
        {
          "name": "00.2 · Contexto de la credencial",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con contribuyentes', function () {",
                  "  pm.response.to.have.status(200);",
                  "  const json = pm.response.json();",
                  "  pm.expect(json.contribuyentes).to.be.an('array');",
                  "  json.contribuyentes.forEach(function (c) {",
                  "    pm.expect(c.identificacion).to.be.a('string');",
                  "    pm.expect(c.marcaBlanca).to.be.a('boolean');",
                  "  });",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contexto",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contexto"
              ]
            },
            "description": {
              "content": "Devuelve los **RUC/servicios autorizados** de tu credencial y los servicios habilitados en el ambiente de la URL.\n\n- `GET /v1/contexto`\n- Cabecera: `X-Api-Key`.\n- `contribuyentes[].identificacion` = identificacion completa del contribuyente (para un RUC, sus 13 digitos); va en la ruta y en `infoTributaria.ruc`.\n- `puedeEmitir`, `puedeRecibir` y `tiposComprobante` del ambiente de la URL.\n- `marcaBlanca`: `true` si el contribuyente es de marca blanca; sus comprobantes se emiten y autorizan igual, pero no tienen RIDE ni correo del comprobante (descarga el XML autorizado).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Contexto",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contexto"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"idCliente\": \"8f2b6c1a-0d3e-4a5b-9c7d-1e2f3a4b5c6d\",\n  \"nombre\": \"MI EMPRESA S.A.\",\n  \"contribuyentes\": [\n    {\n      \"identificacion\": \"0123456789001\",\n      \"puedeEmitir\": true,\n      \"puedeRecibir\": false,\n      \"tiposComprobante\": [\n        \"01\",\n        \"03\",\n        \"04\",\n        \"05\",\n        \"06\",\n        \"07\"\n      ],\n      \"marcaBlanca\": false\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "00.3 · Cupo de tu cuenta",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con cuerpo', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.json().limiteDocumentos).to.be.ok;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/consumo",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "consumo"
              ],
              "query": []
            },
            "description": {
              "content": "Cupo de documentos de tu cuenta en el ambiente de la URL: **suma el plan y los paquetes**.\n\n- `GET /v1/consumo`\n- `limiteDocumentos`, `reservados`, `consumidos`, `disponibles` = total (plan + paquete).\n- `limiteExtra`, `reservadosExtra`, `consumidosExtra`, `disponiblesExtra` = solo el paquete.\n- `vigenteHasta` = vigencia del plan; sin plan (solo paquete) informa `9999-12-31`.\n\nCuando el cupo se agota, emitir responde `429` con `codEstado` 4004.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Cupo",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/consumo"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"limiteDocumentos\": 20,\n  \"reservados\": 0,\n  \"consumidos\": 0,\n  \"disponibles\": 20,\n  \"vigenteHasta\": \"2026-12-31T23:59:59\",\n  \"limiteExtra\": 0,\n  \"reservadosExtra\": 0,\n  \"consumidosExtra\": 0,\n  \"disponiblesExtra\": 0\n}"
            }
          ]
        },
        {
          "name": "00.4 · Estado del servicio (publico)",
          "auth": {
            "type": "noauth"
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con estado', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(['operativo','degradado','caido','sin_datos']).to.include(pm.response.json().estado);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/estado",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "estado"
              ]
            },
            "description": {
              "content": "Estado publico del servicio: estado general, disponibilidad de los ultimos 90 dias e incidentes. **No requiere credencial.**\n\n- `GET /estado`\n- `estado` es `operativo`, `degradado`, `caido` o `sin_datos`.\n- Cada IP puede consultarlo hasta 60 veces por minuto; para alertas propias basta una consulta por minuto.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Operativo",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/estado"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"operativo\",\n  \"medidoEn\": \"2026-11-16T14:32:10Z\",\n  \"componentes\": [\n    {\n      \"nombre\": \"Ecuafact API\",\n      \"estado\": \"operativo\"\n    }\n  ],\n  \"disponibilidad90Dias\": 99.97,\n  \"incidentes\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "01 · Emitir comprobantes",
      "description": {
        "content": "Emision por tipo de comprobante. La ruta fija el tipo y el cuerpo no lleva `infoTributaria.tipoDocumento`.\n\n- `POST /v1/contribuyentes/{identificacion}/facturas` (`01`)\n- `POST /v1/contribuyentes/{identificacion}/liquidaciones-compra` (`03`)\n- `POST /v1/contribuyentes/{identificacion}/notas-credito` (`04`)\n- `POST /v1/contribuyentes/{identificacion}/notas-debito` (`05`)\n- `POST /v1/contribuyentes/{identificacion}/guias-remision` (`06`)\n- `POST /v1/contribuyentes/{identificacion}/retenciones` (`07`)\n- Cabeceras: `Content-Type: application/json`, `X-Api-Key`, **`Idempotency-Key`** (obligatoria).\n- Respuesta `202 Accepted` (plana): `estado` `recibido` con `codEstado` 1001 o 1002 o, si el resultado ya se conoce, el estado final (2001, 3xxx o 4xxx con `msgError`), `errores`, `idOperacion`, `urlEstado` (URL completa, igual a `Location`), `ambiente`, `tipoDocumento`, `numeroDocumento`, `referenciaExterna`, `claveAcceso` (`null` con 1001), `fhRecibido` y `fhAutorizacion`. Un reintento idempotente responde igual, con el mismo `idOperacion`.\n- Un rechazo (4xx o 5xx) trae la misma forma, con su `codEstado`, `msgError` y `errores`, e `idOperacion`, `urlEstado`, `numeroDocumento`, `claveAcceso` y las fechas en `null`.\n- El resultado final se obtiene en **02 · Seguimiento**.\n\nPara validar sin emitir, agrega `/validar` a la ruta del tipo (`.../facturas/validar`, `.../liquidaciones-compra/validar`, etc.), sin `Idempotency-Key`: responde `200` con `{ \"valido\": true, \"errores\": [] }` si el comprobante es valido, y no emite nada ni consume cupo.\n\nSi envias `infoTributaria.tipoDocumento`, la API responde `422` (`codEstado` 3002) con `$.infoTributaria.tipoDocumento: Campo no soportado en este contrato.`\n\nLa coleccion genera automaticamente `Idempotency-Key` y `referenciaExterna` por request.",
        "type": "text/markdown"
      },
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "// Clave de idempotencia y referencia unicas por request.",
              "pm.collectionVariables.set('idempotencyKey', 'pm-' + pm.variables.replaceIn('{{$guid}}'));",
              "const stamp = Date.now().toString();",
              "// referenciaExterna admite solo letras y digitos ASCII y los signos - _ . : /",
              "const name = String(pm.info.requestName || 'doc').replace(/[^A-Za-z0-9._:\\/-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40) || 'doc';",
              "pm.collectionVariables.set('referenciaExterna', ('postman-' + stamp + '-' + name).slice(0, 128));"
            ]
          }
        }
      ],
      "item": [
        {
          "name": "01.0 · Validar factura (sin emitir)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 Comprobante valido', function () { pm.response.to.have.status(200); });",
                  "const json = pm.response.json();",
                  "pm.test('valido y sin errores', function () {",
                  "  pm.expect(json.valido).to.eql(true);",
                  "  pm.expect(json.errores).to.be.an('array').that.is.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"detalles\": [\n    {\n      \"codigoPrincipal\": \"API-TEST-01\",\n      \"descripcion\": \"DOCUMENTO DE PRUEBA INTEGRACION\",\n      \"cantidad\": 1,\n      \"precioUnitario\": 1,\n      \"descuento\": 0,\n      \"precioTotalSinImpuesto\": 1,\n      \"impuestos\": [\n        { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionComprador\": \"05\",\n    \"identificacionComprador\": \"0123456789\",\n    \"razonSocialComprador\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionComprador\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"totalDescuento\": 0,\n    \"totalConImpuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"importeTotal\": 1,\n    \"propina\": 0,\n    \"pagos\": [\n      { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas/validar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "facturas",
                "validar"
              ]
            },
            "description": {
              "content": "**Validar una factura sin emitirla.**\n\n- `POST /v1/contribuyentes/{identificacion}/facturas/validar`\n- La ruta fija el tipo `01`; el cuerpo no lleva `infoTributaria.tipoDocumento`.\n- Mismo cuerpo que **01.1 · Factura (01)**. Cabeceras: `Content-Type: application/json` y `X-Api-Key`; no lleva `Idempotency-Key`.\n- Aplica las mismas reglas que la emision. No emite nada, no consume cupo ni usa un numero de la serie; si cuenta para el limite de solicitudes por minuto.\n\n**Respuestas tipicas:** `200` (`valido` en `true`, `errores` vacio) si el comprobante es valido; `422` (`codEstado` 3002) con el primer problema en `errores`; `403` (`codEstado` 3011) si el contribuyente, su RUC o el tipo de comprobante no estan habilitados para tu API Key.\n\nUn `200` no es una autorizacion del SRI ni comprueba tu cupo: al emitir todavia puedes recibir `429`. Guia: [Validar sin emitir](https://docs.mynexusapi.com/v1/guias/emision#validar-sin-emitir).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Comprobante valido",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas/validar"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"valido\": true,\n  \"errores\": []\n}"
            },
            {
              "name": "422 · Comprobante invalido (3002)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas/validar"
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3002,\n  \"msgError\": \"El comprobante no cumple las validaciones.\",\n  \"errores\": [\n    \"$.info.pagos[0].unidadTiempo: Obligatoria cuando hay plazo.\"\n  ]\n}"
            }
          ]
        },
        {
          "name": "01.1 · Factura (01)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion01', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              },
              {
                "key": "X-Additional-Info",
                "value": "MiERP/4.2 sucursal=001",
                "disabled": true,
                "description": "Opcional. Texto tuyo que la API asocia a tu solicitud para soporte. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos."
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"detalles\": [\n    {\n      \"codigoPrincipal\": \"API-TEST-01\",\n      \"descripcion\": \"DOCUMENTO DE PRUEBA INTEGRACION\",\n      \"cantidad\": 1,\n      \"precioUnitario\": 1,\n      \"descuento\": 0,\n      \"precioTotalSinImpuesto\": 1,\n      \"impuestos\": [\n        { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionComprador\": \"05\",\n    \"identificacionComprador\": \"0123456789\",\n    \"razonSocialComprador\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionComprador\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"totalDescuento\": 0,\n    \"totalConImpuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"importeTotal\": 1,\n    \"propina\": 0,\n    \"pagos\": [\n      { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "facturas"
              ]
            },
            "description": {
              "content": "**Factura electronica (01).**\n\n- `POST /v1/contribuyentes/{identificacion}/facturas`\n- La ruta fija el tipo `01`; no envies `infoTributaria.tipoDocumento`.\n- `info` (solo 01): `fechaEmision`, datos del comprador (`tipoIdentificacionComprador`, `identificacionComprador`, `razonSocialComprador`), totales (`totalSinImpuestos`, `totalDescuento`, `totalConImpuestos`, `importeTotal`, `moneda`), `propina` y `pagos`.\n- `detalles[]`: `codigoPrincipal`, `descripcion`, `cantidad`, `precioUnitario`, `descuento`, `precioTotalSinImpuesto`, `impuestos[]`.\n- Los totales deben cuadrar (base + impuestos = total).\n\n**Respuestas tipicas:** `202` con `estado` `recibido` y `codEstado` 1001 o 1002; `400` (`codEstado` 3003) sin `Idempotency-Key` o formato invalido; `409` (`codEstado` 3005) misma clave con otro cuerpo; `409` (`codEstado` 3004) si el numero ya esta emitido; `422` (`codEstado` 3002) regla fiscal; `429` (`codEstado` 4004) cupo agotado.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Recibido (1001)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0001"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-01-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "202 · autorizado inmediato (2001)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/5c9a1d7e-2b4f-4e3a-8d61-0f7a3b9c2e14"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0001"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"autorizado\",\n  \"codEstado\": 2001,\n  \"errores\": [],\n  \"idOperacion\": \"5c9a1d7e-2b4f-4e3a-8d61-0f7a3b9c2e14\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/5c9a1d7e-2b4f-4e3a-8d61-0f7a3b9c2e14\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-01-4581\",\n  \"claveAcceso\": \"1011202601179999999900110010010000001231234567814\",\n  \"fhRecibido\": \"2026-11-06T10:21:43-05:00\",\n  \"fhAutorizacion\": \"2026-11-06T10:21:44-05:00\"\n}"
            },
            {
              "name": "422 · rechazado por el SRI (3001)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/8e1b4c6a-7d2f-4a95-b3e8-2c5d9f0a1b73"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0001"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3001,\n  \"msgError\": \"El SRI rechazó el comprobante.\",\n  \"errores\": [\n    \"ERROR SECUENCIAL REGISTRADO\"\n  ],\n  \"idOperacion\": \"8e1b4c6a-7d2f-4a95-b3e8-2c5d9f0a1b73\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/8e1b4c6a-7d2f-4a95-b3e8-2c5d9f0a1b73\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-01-4581\",\n  \"claveAcceso\": \"1011202601179999999900110010010000001231234567814\",\n  \"fhRecibido\": \"2026-11-06T10:21:43-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "422 · rechazo de configuración (4002)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/a47d2e90-3c1b-4f58-9e6a-7b0c8d1f2a35"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0001"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazo_configuracion\",\n  \"codEstado\": 4002,\n  \"msgError\": \"La firma electrónica no es válida.\",\n  \"errores\": [],\n  \"idOperacion\": \"a47d2e90-3c1b-4f58-9e6a-7b0c8d1f2a35\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/a47d2e90-3c1b-4f58-9e6a-7b0c8d1f2a35\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-01-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-06T10:21:43-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "422 · Comprobante invalido (3002)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3002,\n  \"msgError\": \"El comprobante no cumple las validaciones.\",\n  \"errores\": [\n    \"$.info.importeTotal: No cuadra con la suma de los totales.\"\n  ],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "409 · Comprobante duplicado (3004)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Conflict",
              "code": 409,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3004,\n  \"msgError\": \"Ya existe un comprobante con ese número.\",\n  \"errores\": [],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "409 · Conflicto de idempotencia (3005)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "<misma clave, cuerpo distinto>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Conflict",
              "code": 409,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3005,\n  \"msgError\": \"La Idempotency-Key ya se usó con otro contenido.\",\n  \"errores\": [],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "01.2 · Liquidacion de compra (03)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion03', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              },
              {
                "key": "X-Additional-Info",
                "value": "MiERP/4.2 sucursal=001",
                "disabled": true,
                "description": "Opcional. Texto tuyo que la API asocia a tu solicitud para soporte. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos."
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"detalles\": [\n    {\n      \"codigoPrincipal\": \"API-TEST-01\",\n      \"descripcion\": \"DOCUMENTO DE PRUEBA INTEGRACION\",\n      \"cantidad\": 1,\n      \"precioUnitario\": 1,\n      \"descuento\": 0,\n      \"precioTotalSinImpuesto\": 1,\n      \"impuestos\": [\n        { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionProveedor\": \"05\",\n    \"identificacionProveedor\": \"0123456789\",\n    \"razonSocialProveedor\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionProveedor\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"totalDescuento\": 0,\n    \"totalConImpuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"importeTotal\": 1,\n    \"pagos\": [\n      { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/liquidaciones-compra",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "liquidaciones-compra"
              ]
            },
            "description": {
              "content": "**Liquidacion de compra de bienes y prestacion de servicios (03).**\n\n- `POST /v1/contribuyentes/{identificacion}/liquidaciones-compra`\n- La ruta fija el tipo `03`; no envies `infoTributaria.tipoDocumento`.\n- `info` (solo 03): datos del **proveedor** (`tipoIdentificacionProveedor`, `identificacionProveedor`, `razonSocialProveedor`), totales, `moneda` y `pagos`.\n- Usa `detalles[]` igual que la factura.\n\n**Errores tipicos:** `422` por descuadre de totales o campo no modelado.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Recibido (1001)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/liquidaciones-compra"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/5a1e7c90-2b4d-4e6f-8a1c-3d5e7f9a0b12"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0002"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"5a1e7c90-2b4d-4e6f-8a1c-3d5e7f9a0b12\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/5a1e7c90-2b4d-4e6f-8a1c-3d5e7f9a0b12\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"03\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-03-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "01.3 · Nota de credito (04)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion04', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              },
              {
                "key": "X-Additional-Info",
                "value": "MiERP/4.2 sucursal=001",
                "disabled": true,
                "description": "Opcional. Texto tuyo que la API asocia a tu solicitud para soporte. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos."
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"detalles\": [\n    {\n      \"codigoInterno\": \"API-TEST-01\",\n      \"descripcion\": \"DOCUMENTO DE PRUEBA INTEGRACION\",\n      \"cantidad\": 1,\n      \"precioUnitario\": 1,\n      \"descuento\": 0,\n      \"precioTotalSinImpuesto\": 1,\n      \"impuestos\": [\n        { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionComprador\": \"05\",\n    \"identificacionComprador\": \"0123456789\",\n    \"razonSocialComprador\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionComprador\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"codDocModificado\": \"01\",\n    \"numDocModificado\": \"002-001-000000002\",\n    \"fechaEmisionDocSustento\": \"{{fechaEmision}}\",\n    \"totalConImpuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"valorModificacion\": 1,\n    \"motivo\": \"DEVOLUCION DE PRUEBAS\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-credito",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "notas-credito"
              ]
            },
            "description": {
              "content": "**Nota de credito (04).**\n\n- `POST /v1/contribuyentes/{identificacion}/notas-credito`\n- La ruta fija el tipo `04`; no envies `infoTributaria.tipoDocumento`.\n- `info` (solo 04): datos del comprador, `codDocModificado`, `numDocModificado` (`ddd-ddd-ddddddddd`), `fechaEmisionDocSustento`, totales, `valorModificacion` y `motivo`.\n- `detalles[]` usa `codigoInterno`. Documenta el sustento que modifica.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Recibido (1001)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-credito"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/6b2f8da1-3c5e-4f70-9b2d-4e6f8a0b1c23"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0002"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"6b2f8da1-3c5e-4f70-9b2d-4e6f8a0b1c23\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/6b2f8da1-3c5e-4f70-9b2d-4e6f8a0b1c23\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"04\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-04-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "01.4 · Nota de debito (05)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion05', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              },
              {
                "key": "X-Additional-Info",
                "value": "MiERP/4.2 sucursal=001",
                "disabled": true,
                "description": "Opcional. Texto tuyo que la API asocia a tu solicitud para soporte. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos."
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"motivos\": [\n    { \"razon\": \"AJUSTE DE PRUEBAS\", \"valor\": 1 }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionComprador\": \"05\",\n    \"identificacionComprador\": \"0123456789\",\n    \"razonSocialComprador\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionComprador\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"codDocModificado\": \"01\",\n    \"numDocModificado\": \"002-001-000000002\",\n    \"fechaEmisionDocSustento\": \"{{fechaEmision}}\",\n    \"valorTotal\": 1,\n    \"impuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"pagos\": [\n      { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-debito",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "notas-debito"
              ]
            },
            "description": {
              "content": "**Nota de debito (05).**\n\n- `POST /v1/contribuyentes/{identificacion}/notas-debito`\n- La ruta fija el tipo `05`; no envies `infoTributaria.tipoDocumento`.\n- `motivos[]` con `{ razon, valor }` (coleccion propia del 05).\n- `info` (solo 05): comprador, `codDocModificado`, `numDocModificado`, `fechaEmisionDocSustento`, `valorTotal`, `impuestos[]` y `pagos[]`.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Recibido (1001)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-debito"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/7c309eb2-4d6f-4081-8c3e-5f7a9b1c2d34"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0002"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"7c309eb2-4d6f-4081-8c3e-5f7a9b1c2d34\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/7c309eb2-4d6f-4081-8c3e-5f7a9b1c2d34\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"05\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-05-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "01.5 · Guia de remision (06)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion06', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              },
              {
                "key": "X-Additional-Info",
                "value": "MiERP/4.2 sucursal=001",
                "disabled": true,
                "description": "Opcional. Texto tuyo que la API asocia a tu solicitud para soporte. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos."
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"destinatarios\": [\n    {\n      \"identificacionDestinatario\": \"0123456789\",\n      \"razonSocialDestinatario\": \"CONTRIBUYENTE DE PRUEBAS\",\n      \"dirDestinatario\": \"DESTINO PRUEBAS\",\n      \"motivoTraslado\": \"TRASLADO DE PRUEBAS\",\n      \"codEstabDestino\": \"001\",\n      \"ruta\": \"RUTA DE PRUEBAS\",\n      \"detalles\": [\n        { \"codigoInterno\": \"API-TEST-01\", \"descripcion\": \"TRASLADO DE PRUEBA\", \"cantidad\": 1 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"dirPartida\": \"ORIGEN PRUEBAS\",\n    \"razonSocialTransportista\": \"CONDUCTOR DE PRUEBAS\",\n    \"tipoIdentificacionTransportista\": \"05\",\n    \"rucTransportista\": \"0123456789\",\n    \"fechaIniTransporte\": \"{{fechaEmision}}\",\n    \"fechaFinTransporte\": \"{{fechaEmision}}\",\n    \"placa\": \"PBA0001\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/guias-remision",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "guias-remision"
              ]
            },
            "description": {
              "content": "**Guia de remision (06).**\n\n- `POST /v1/contribuyentes/{identificacion}/guias-remision`\n- La ruta fija el tipo `06`; no envies `infoTributaria.tipoDocumento`.\n- `info` (solo 06): `dirPartida`, transportista (`razonSocialTransportista`, `tipoIdentificacionTransportista`, `rucTransportista`), `fechaIniTransporte`, `fechaFinTransporte`, `placa`.\n- `destinatarios[]`: receptor, motivo de traslado y `detalles[]` (sin importes).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Recibido (1001)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/guias-remision"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/8d41afc3-5e70-4192-9d4f-6a8b0c2d3e45"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0002"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"8d41afc3-5e70-4192-9d4f-6a8b0c2d3e45\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/8d41afc3-5e70-4192-9d4f-6a8b0c2d3e45\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"06\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-06-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "01.6 · Comprobante de retencion (07)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion07', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              },
              {
                "key": "X-Additional-Info",
                "value": "MiERP/4.2 sucursal=001",
                "disabled": true,
                "description": "Opcional. Texto tuyo que la API asocia a tu solicitud para soporte. ASCII imprimible, maximo 256 caracteres, sin datos personales ni secretos."
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"docsSustento\": [\n    {\n      \"codSustento\": \"01\",\n      \"codDocSustento\": \"01\",\n      \"numDocSustento\": \"002001000000002\",\n      \"fechaEmisionDocSustento\": \"07/09/2026\",\n      \"fechaRegistroContable\": \"{{fechaEmision}}\",\n      \"numAutDocSustento\": \"0709202601012345678900110020010000000029846951114\",\n      \"pagoLocExt\": \"01\",\n      \"totalSinImpuestos\": 1,\n      \"importeTotal\": 1,\n      \"impuestosDocSustento\": [\n        { \"codImpuestoDocSustento\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"tarifa\": 0, \"valorImpuesto\": 0 }\n      ],\n      \"retenciones\": [\n        { \"codigo\": \"1\", \"codigoRetencion\": \"303\", \"baseImponible\": 1, \"porcentajeRetener\": 10, \"valorRetenido\": 0.10 }\n      ],\n      \"pagos\": [\n        { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionSujetoRetenido\": \"05\",\n    \"razonSocialSujetoRetenido\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"identificacionSujetoRetenido\": \"0123456789\",\n    \"parteRel\": \"NO\",\n    \"periodoFiscal\": \"{{periodoFiscal}}\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/retenciones",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "retenciones"
              ]
            },
            "description": {
              "content": "**Comprobante de retencion (07).**\n\n- `POST /v1/contribuyentes/{identificacion}/retenciones`\n- La ruta fija el tipo `07`; no envies `infoTributaria.tipoDocumento`.\n- `info` (solo 07): sujeto retenido (`tipoIdentificacionSujetoRetenido`, `identificacionSujetoRetenido`, `razonSocialSujetoRetenido`), `periodoFiscal` (`MM/yyyy`) y `parteRel`.\n- `docsSustento[]`: sustento electronico, impuestos del sustento y `retenciones[]` (`codigo` 1=IR, 2=IVA).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Recibido (1001)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/retenciones"
                }
              },
              "status": "Accepted",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Location",
                  "value": "https://api-sandbox.mynexusapi.com/v1/operaciones/9e52b0d4-6f81-42a3-8e50-7b9c1d3e4f56"
                },
                {
                  "key": "X-Correlation-Id",
                  "value": "0HN7EXAMPLE0002"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"9e52b0d4-6f81-42a3-8e50-7b9c1d3e4f56\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/9e52b0d4-6f81-42a3-8e50-7b9c1d3e4f56\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"07\",\n  \"numeroDocumento\": \"001-001-000000123\",\n  \"referenciaExterna\": \"ERP-07-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "01.7 · Validar liquidacion de compra (sin emitir)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 Comprobante valido', function () { pm.response.to.have.status(200); });",
                  "const json = pm.response.json();",
                  "pm.test('valido y sin errores', function () {",
                  "  pm.expect(json.valido).to.eql(true);",
                  "  pm.expect(json.errores).to.be.an('array').that.is.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"detalles\": [\n    {\n      \"codigoPrincipal\": \"API-TEST-01\",\n      \"descripcion\": \"DOCUMENTO DE PRUEBA INTEGRACION\",\n      \"cantidad\": 1,\n      \"precioUnitario\": 1,\n      \"descuento\": 0,\n      \"precioTotalSinImpuesto\": 1,\n      \"impuestos\": [\n        { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionProveedor\": \"05\",\n    \"identificacionProveedor\": \"0123456789\",\n    \"razonSocialProveedor\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionProveedor\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"totalDescuento\": 0,\n    \"totalConImpuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"importeTotal\": 1,\n    \"pagos\": [\n      { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/liquidaciones-compra/validar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "liquidaciones-compra",
                "validar"
              ]
            },
            "description": {
              "content": "**Validar una liquidacion de compra sin emitirla.**\n\n- `POST /v1/contribuyentes/{identificacion}/liquidaciones-compra/validar`\n- Mismo cuerpo que **01.2 · Liquidacion de compra (03)**. Cabeceras: `Content-Type: application/json` y `X-Api-Key`; no lleva `Idempotency-Key`.\n- Aplica las mismas reglas que la emision. No emite nada, no consume cupo ni usa un numero de la serie; si cuenta para el limite de solicitudes por minuto.\n\n**Respuestas tipicas:** `200` (`valido` en `true`, `errores` vacio) si el comprobante es valido; `422` (`codEstado` 3002) con el primer problema en `errores`; `403` (`codEstado` 3011) si el contribuyente, su RUC o el tipo de comprobante no estan habilitados para tu API Key.\n\nUn `200` no es una autorizacion del SRI ni comprueba tu cupo: al emitir todavia puedes recibir `429`. Guia: [Validar sin emitir](https://docs.mynexusapi.com/v1/guias/emision#validar-sin-emitir).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Comprobante valido",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/liquidaciones-compra/validar"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"valido\": true,\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "01.8 · Validar nota de credito (sin emitir)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 Comprobante valido', function () { pm.response.to.have.status(200); });",
                  "const json = pm.response.json();",
                  "pm.test('valido y sin errores', function () {",
                  "  pm.expect(json.valido).to.eql(true);",
                  "  pm.expect(json.errores).to.be.an('array').that.is.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"detalles\": [\n    {\n      \"codigoInterno\": \"API-TEST-01\",\n      \"descripcion\": \"DOCUMENTO DE PRUEBA INTEGRACION\",\n      \"cantidad\": 1,\n      \"precioUnitario\": 1,\n      \"descuento\": 0,\n      \"precioTotalSinImpuesto\": 1,\n      \"impuestos\": [\n        { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionComprador\": \"05\",\n    \"identificacionComprador\": \"0123456789\",\n    \"razonSocialComprador\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionComprador\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"codDocModificado\": \"01\",\n    \"numDocModificado\": \"002-001-000000002\",\n    \"fechaEmisionDocSustento\": \"{{fechaEmision}}\",\n    \"totalConImpuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"valorModificacion\": 1,\n    \"motivo\": \"DEVOLUCION DE PRUEBAS\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-credito/validar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "notas-credito",
                "validar"
              ]
            },
            "description": {
              "content": "**Validar una nota de credito sin emitirla.**\n\n- `POST /v1/contribuyentes/{identificacion}/notas-credito/validar`\n- Mismo cuerpo que **01.3 · Nota de credito (04)**. Cabeceras: `Content-Type: application/json` y `X-Api-Key`; no lleva `Idempotency-Key`.\n- Aplica las mismas reglas que la emision. No emite nada, no consume cupo ni usa un numero de la serie; si cuenta para el limite de solicitudes por minuto.\n\n**Respuestas tipicas:** `200` (`valido` en `true`, `errores` vacio) si el comprobante es valido; `422` (`codEstado` 3002) con el primer problema en `errores`; `403` (`codEstado` 3011) si el contribuyente, su RUC o el tipo de comprobante no estan habilitados para tu API Key.\n\nUn `200` no es una autorizacion del SRI ni comprueba tu cupo: al emitir todavia puedes recibir `429`. Guia: [Validar sin emitir](https://docs.mynexusapi.com/v1/guias/emision#validar-sin-emitir).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Comprobante valido",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-credito/validar"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"valido\": true,\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "01.9 · Validar nota de debito (sin emitir)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 Comprobante valido', function () { pm.response.to.have.status(200); });",
                  "const json = pm.response.json();",
                  "pm.test('valido y sin errores', function () {",
                  "  pm.expect(json.valido).to.eql(true);",
                  "  pm.expect(json.errores).to.be.an('array').that.is.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"motivos\": [\n    { \"razon\": \"AJUSTE DE PRUEBAS\", \"valor\": 1 }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionComprador\": \"05\",\n    \"identificacionComprador\": \"0123456789\",\n    \"razonSocialComprador\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"direccionComprador\": \"DIRECCION DE PRUEBAS\",\n    \"totalSinImpuestos\": 1,\n    \"moneda\": \"DOLAR\",\n    \"codDocModificado\": \"01\",\n    \"numDocModificado\": \"002-001-000000002\",\n    \"fechaEmisionDocSustento\": \"{{fechaEmision}}\",\n    \"valorTotal\": 1,\n    \"impuestos\": [\n      { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 }\n    ],\n    \"pagos\": [\n      { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-debito/validar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "notas-debito",
                "validar"
              ]
            },
            "description": {
              "content": "**Validar una nota de debito sin emitirla.**\n\n- `POST /v1/contribuyentes/{identificacion}/notas-debito/validar`\n- Mismo cuerpo que **01.4 · Nota de debito (05)**. Cabeceras: `Content-Type: application/json` y `X-Api-Key`; no lleva `Idempotency-Key`.\n- Aplica las mismas reglas que la emision. No emite nada, no consume cupo ni usa un numero de la serie; si cuenta para el limite de solicitudes por minuto.\n\n**Respuestas tipicas:** `200` (`valido` en `true`, `errores` vacio) si el comprobante es valido; `422` (`codEstado` 3002) con el primer problema en `errores`; `403` (`codEstado` 3011) si el contribuyente, su RUC o el tipo de comprobante no estan habilitados para tu API Key.\n\nUn `200` no es una autorizacion del SRI ni comprueba tu cupo: al emitir todavia puedes recibir `429`. Guia: [Validar sin emitir](https://docs.mynexusapi.com/v1/guias/emision#validar-sin-emitir).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Comprobante valido",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/notas-debito/validar"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"valido\": true,\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "01.10 · Validar guia de remision (sin emitir)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 Comprobante valido', function () { pm.response.to.have.status(200); });",
                  "const json = pm.response.json();",
                  "pm.test('valido y sin errores', function () {",
                  "  pm.expect(json.valido).to.eql(true);",
                  "  pm.expect(json.errores).to.be.an('array').that.is.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"destinatarios\": [\n    {\n      \"identificacionDestinatario\": \"0123456789\",\n      \"razonSocialDestinatario\": \"CONTRIBUYENTE DE PRUEBAS\",\n      \"dirDestinatario\": \"DESTINO PRUEBAS\",\n      \"motivoTraslado\": \"TRASLADO DE PRUEBAS\",\n      \"codEstabDestino\": \"001\",\n      \"ruta\": \"RUTA DE PRUEBAS\",\n      \"detalles\": [\n        { \"codigoInterno\": \"API-TEST-01\", \"descripcion\": \"TRASLADO DE PRUEBA\", \"cantidad\": 1 }\n      ]\n    }\n  ],\n  \"info\": {\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"dirPartida\": \"ORIGEN PRUEBAS\",\n    \"razonSocialTransportista\": \"CONDUCTOR DE PRUEBAS\",\n    \"tipoIdentificacionTransportista\": \"05\",\n    \"rucTransportista\": \"0123456789\",\n    \"fechaIniTransporte\": \"{{fechaEmision}}\",\n    \"fechaFinTransporte\": \"{{fechaEmision}}\",\n    \"placa\": \"PBA0001\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/guias-remision/validar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "guias-remision",
                "validar"
              ]
            },
            "description": {
              "content": "**Validar una guia de remision sin emitirla.**\n\n- `POST /v1/contribuyentes/{identificacion}/guias-remision/validar`\n- Mismo cuerpo que **01.5 · Guia de remision (06)**. Cabeceras: `Content-Type: application/json` y `X-Api-Key`; no lleva `Idempotency-Key`.\n- Aplica las mismas reglas que la emision. No emite nada, no consume cupo ni usa un numero de la serie; si cuenta para el limite de solicitudes por minuto.\n\n**Respuestas tipicas:** `200` (`valido` en `true`, `errores` vacio) si el comprobante es valido; `422` (`codEstado` 3002) con el primer problema en `errores`; `403` (`codEstado` 3011) si el contribuyente, su RUC o el tipo de comprobante no estan habilitados para tu API Key.\n\nUn `200` no es una autorizacion del SRI ni comprueba tu cupo: al emitir todavia puedes recibir `429`. Guia: [Validar sin emitir](https://docs.mynexusapi.com/v1/guias/emision#validar-sin-emitir).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Comprobante valido",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/guias-remision/validar"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"valido\": true,\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "01.11 · Validar comprobante de retencion (sin emitir)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 Comprobante valido', function () { pm.response.to.have.status(200); });",
                  "const json = pm.response.json();",
                  "pm.test('valido y sin errores', function () {",
                  "  pm.expect(json.valido).to.eql(true);",
                  "  pm.expect(json.errores).to.be.an('array').that.is.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"{{referenciaExterna}}\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  },\n  \"infoAdicional\": [\n    { \"nombre\": \"Prueba\", \"valor\": \"POSTMAN - AMBIENTE DE PRUEBAS\" }\n  ],\n  \"docsSustento\": [\n    {\n      \"codSustento\": \"01\",\n      \"codDocSustento\": \"01\",\n      \"numDocSustento\": \"002001000000002\",\n      \"fechaEmisionDocSustento\": \"07/09/2026\",\n      \"fechaRegistroContable\": \"{{fechaEmision}}\",\n      \"numAutDocSustento\": \"0709202601012345678900110020010000000029846951114\",\n      \"pagoLocExt\": \"01\",\n      \"totalSinImpuestos\": 1,\n      \"importeTotal\": 1,\n      \"impuestosDocSustento\": [\n        { \"codImpuestoDocSustento\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"tarifa\": 0, \"valorImpuesto\": 0 }\n      ],\n      \"retenciones\": [\n        { \"codigo\": \"1\", \"codigoRetencion\": \"303\", \"baseImponible\": 1, \"porcentajeRetener\": 10, \"valorRetenido\": 0.10 }\n      ],\n      \"pagos\": [\n        { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" }\n      ]\n    }\n  ],\n  \"info\": {\n    \"fechaEmision\": \"{{fechaEmision}}\",\n    \"dirEstablecimiento\": \"DIRECCION DE PRUEBAS\",\n    \"tipoIdentificacionSujetoRetenido\": \"05\",\n    \"razonSocialSujetoRetenido\": \"CONTRIBUYENTE DE PRUEBAS\",\n    \"identificacionSujetoRetenido\": \"0123456789\",\n    \"parteRel\": \"NO\",\n    \"periodoFiscal\": \"{{periodoFiscal}}\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/retenciones/validar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "retenciones",
                "validar"
              ]
            },
            "description": {
              "content": "**Validar un comprobante de retencion sin emitirlo.**\n\n- `POST /v1/contribuyentes/{identificacion}/retenciones/validar`\n- Mismo cuerpo que **01.6 · Comprobante de retencion (07)**. Cabeceras: `Content-Type: application/json` y `X-Api-Key`; no lleva `Idempotency-Key`.\n- Aplica las mismas reglas que la emision. No emite nada, no consume cupo ni usa un numero de la serie; si cuenta para el limite de solicitudes por minuto.\n\n**Respuestas tipicas:** `200` (`valido` en `true`, `errores` vacio) si el comprobante es valido; `422` (`codEstado` 3002) con el primer problema en `errores`; `403` (`codEstado` 3011) si el contribuyente, su RUC o el tipo de comprobante no estan habilitados para tu API Key.\n\nUn `200` no es una autorizacion del SRI ni comprueba tu cupo: al emitir todavia puedes recibir `429`. Guia: [Validar sin emitir](https://docs.mynexusapi.com/v1/guias/emision#validar-sin-emitir).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Comprobante valido",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/retenciones/validar"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"valido\": true,\n  \"errores\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "02 · Seguimiento de operacion",
      "description": {
        "content": "Emitir responde `202` (aceptado), no autorizado. Aqui consultas el estado de la operacion.\n\nValores de `estado`: `recibido` (sin resultado final todavia), `autorizado`, `rechazado`, `rechazo_configuracion`, `error` y `cancelado`. El primer digito de `codEstado` es el `estado`.\nMientras sea `recibido`, `codEstado` es 1001 (sin `claveAcceso`) o 1002 (ya con `claveAcceso`): sigue esperando. Todos salvo `recibido` son finales; salvo `autorizado` (2001), traen `msgError` con la causa general y el detalle en `errores` (en un rechazo del SRI, 3001, el mensaje del SRI). Ante 5007 o 5001 no reemitas. Catalogo: [Errores](https://docs.mynexusapi.com/v1/guias/errores#catalogo-de-codestado).",
        "type": "text/markdown"
      },
      "item": [
        {
          "name": "02.1 · Ver operacion",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "pm.test('200 con estado y codEstado', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "  pm.expect(json.codEstado).to.be.a('number');",
                  "  pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "  pm.expect(json.errores).to.be.an('array');",
                  "  if (json.estado === 'autorizado') { pm.expect(json.fhAutorizacion).to.be.a('string'); }",
                  "  if (json.estado === 'recibido' || json.estado === 'autorizado') {",
                  "    pm.expect(json).to.not.have.property('msgError');",
                  "  } else {",
                  "    pm.expect(json.msgError).to.be.a('string');",
                  "  }",
                  "});",
                  "if (json.estado === 'recibido') {",
                  "  console.log('codEstado ' + json.codEstado + ': sigue esperando el resultado; no reemitas.');",
                  "} else if (json.codEstado === 5007 || json.codEstado === 5001) {",
                  "  console.log('codEstado ' + json.codEstado + ': no reemitas; revisa el idOperacion y escribe a soporte.');",
                  "} else if (json.estado !== 'autorizado') {",
                  "  console.log('codEstado ' + json.codEstado + ': ' + json.msgError + ' ' + json.errores.join(' | '));",
                  "}",
                  "if (json.estado === 'autorizado' && json.claveAcceso) {",
                  "  pm.environment.set('claveAccesoEmitida', json.claveAcceso);",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "operaciones",
                "{{idOperacion}}"
              ]
            },
            "description": {
              "content": "Consulta el estado de la operacion.\n\n- `GET /v1/operaciones/{idOperacion}`\n- Misma forma que el `202` de la emision, con el estado actual: `estado`, `codEstado`, `msgError` (solo si no se autorizo), `errores`, `idOperacion`, `urlEstado`, `ambiente`, `tipoDocumento`, `numeroDocumento`, `referenciaExterna`, `claveAcceso`, `fhRecibido` y `fhAutorizacion`.\n- `claveAcceso` aparece cuando el comprobante ya tiene clave (1002 en adelante).\n- Una operacion que no existe, o es de otra integracion o de otro ambiente, responde `404` con `codEstado` 3013.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Recibido sin clave (1001)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1001,\n  \"errores\": [],\n  \"idOperacion\": \"3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"002-001-000000456\",\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "200 · Recibido con clave (1002)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"recibido\",\n  \"codEstado\": 1002,\n  \"errores\": [],\n  \"idOperacion\": \"3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"002-001-000000456\",\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": \"0911202601179999999900110020010000004561234567817\",\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "200 · Autorizado (2001)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"autorizado\",\n  \"codEstado\": 2001,\n  \"errores\": [],\n  \"idOperacion\": \"3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/3f1c8f2e-9d4a-4f6b-9c2e-1a2b3c4d5e6f\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"002-001-000000456\",\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": \"0911202601179999999900110020010000004561234567817\",\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": \"2026-11-09T10:15:04-05:00\"\n}"
            },
            {
              "name": "200 · Rechazado por el SRI (3001)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3001,\n  \"msgError\": \"El SRI rechazó el comprobante.\",\n  \"errores\": [\n    \"CLAVE ACCESO REGISTRADA\"\n  ],\n  \"idOperacion\": \"7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"002-001-000000456\",\n  \"referenciaExterna\": \"FAC-ERP-4590\",\n  \"claveAcceso\": \"0911202601179999999900110020010000004561234567817\",\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "200 · Firma no valida (4002)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazo_configuracion\",\n  \"codEstado\": 4002,\n  \"msgError\": \"La firma electrónica no es válida.\",\n  \"errores\": [],\n  \"idOperacion\": \"7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"002-001-000000456\",\n  \"referenciaExterna\": \"FAC-ERP-4590\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "200 · Resultado no confirmado (5007)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"error\",\n  \"codEstado\": 5007,\n  \"msgError\": \"No se pudo confirmar el resultado.\",\n  \"errores\": [],\n  \"idOperacion\": \"7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n  \"urlEstado\": \"https://api-sandbox.mynexusapi.com/v1/operaciones/7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": \"002-001-000000456\",\n  \"referenciaExterna\": \"FAC-ERP-4590\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": \"2026-11-09T10:15:00-05:00\",\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "404 · Operacion no encontrada (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones/{{idOperacion}}"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "03 · Listado de operaciones",
      "description": {
        "content": "Listado paginado de comprobantes emitidos por un contribuyente y un periodo. Exige la `identificacion` y usa un rango de fechas acotado.\n\n- `GET /v1/operaciones?identificacion=...&desde=yyyy-MM-dd&hasta=yyyy-MM-dd&tipoDocumento=01&buscar=...&pagina=1&tamanoPagina=20`.\n- `identificacion` es obligatoria y debe ser la misma de `GET /v1/contexto`.\n- `desde` y `hasta` son opcionales; sin ellas se usan los ultimos 30 dias. El rango maximo es de 366 dias.\n- `tipoDocumento` acepta `01`, `03`, `04`, `05`, `06` o `07`. `buscar` admite hasta 100 caracteres. `pagina` empieza en 1 y `tamanoPagina` va de 1 a 100.\n- La respuesta trae `comprobantes`, `pagina`, `tamanoPagina` y `hayMas`. Para seguir paginando, repite con `pagina` incrementado mientras `hayMas` sea `true`.\n- La llave necesita el scope `comprobantes:leer` y acceso al RUC consultado. Si la llave esta limitada a otro RUC, responde `403` con `codEstado` 3011; un filtro fuera de rango responde `400` con `codEstado` 3012.",
        "type": "text/markdown"
      },
      "item": [
        {
          "name": "03.1 · Listar operaciones",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "pm.test('200 con comprobantes y paginacion', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(json.comprobantes).to.be.an('array');",
                  "  pm.expect(json.pagina).to.be.a('number');",
                  "  pm.expect(json.tamanoPagina).to.be.a('number');",
                  "  pm.expect(json.hayMas).to.be.a('boolean');",
                  "  if (json.comprobantes.length > 0) {",
                  "    pm.expect(json.comprobantes[0].numeroDocumento).to.be.a('string');",
                  "    pm.expect(json.comprobantes[0].codEstado).to.be.a('number');",
                  "  }",
                  "});",
                  "if (json.hayMas) {",
                  "  console.log('Hay mas comprobantes: repite con pagina=' + (json.pagina + 1) + '.');",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/operaciones?identificacion={{identificacion}}&desde={{fechaIso}}&hasta={{fechaIso}}&tipoDocumento=01&pagina=1&tamanoPagina=20",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "operaciones"
              ],
              "query": [
                {
                  "key": "identificacion",
                  "value": "{{identificacion}}",
                  "description": "Identificacion completa del contribuyente, la de GET /v1/contexto."
                },
                {
                  "key": "desde",
                  "value": "{{fechaIso}}",
                  "description": "Fecha inicial yyyy-MM-dd. Ajustala al periodo que quieras conciliar."
                },
                {
                  "key": "hasta",
                  "value": "{{fechaIso}}",
                  "description": "Fecha final yyyy-MM-dd. El rango maximo es de 366 dias."
                },
                {
                  "key": "tipoDocumento",
                  "value": "01",
                  "description": "Opcional: 01, 03, 04, 05, 06 o 07."
                },
                {
                  "key": "pagina",
                  "value": "1",
                  "description": "Pagina desde 1."
                },
                {
                  "key": "tamanoPagina",
                  "value": "20",
                  "description": "Comprobantes por pagina, de 1 a 100."
                }
              ]
            },
            "description": {
              "content": "Lista los comprobantes del contribuyente en el periodo indicado.\n\n- La `identificacion` es obligatoria y debe tener acceso con tu API Key.\n- Sin `desde` ni `hasta` la API usa los ultimos 30 dias.\n- La respuesta trae `comprobantes`, `pagina`, `tamanoPagina` y `hayMas`.\n- Cada comprobante trae `claveAcceso`, `numeroDocumento`, `tipoDocumento`, `fechaEmision`, `identificacionContraparte`, `razonSocialContraparte`, `total`, `estado`, `codEstado`, `errores` y `fhAutorizacion`.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Pagina de comprobantes",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones?identificacion={{identificacion}}&desde={{fechaIso}}&hasta={{fechaIso}}&tipoDocumento=01&pagina=1&tamanoPagina=20"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"comprobantes\": [\n    {\n      \"claveAcceso\": \"1011202601099215640600110010010000000025469774111\",\n      \"numeroDocumento\": \"001-001-000000002\",\n      \"tipoDocumento\": \"01\",\n      \"fechaEmision\": \"10/11/2026\",\n      \"identificacionContraparte\": \"0123456789\",\n      \"razonSocialContraparte\": \"CONTRIBUYENTE DE PRUEBAS\",\n      \"total\": 1.00,\n      \"estado\": \"recibido\",\n      \"codEstado\": 1002,\n      \"errores\": [],\n      \"fhAutorizacion\": null\n    }\n  ],\n  \"pagina\": 1,\n  \"tamanoPagina\": 20,\n  \"hayMas\": false\n}"
            },
            {
              "name": "403 · Contribuyente no autorizado (3011)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones?identificacion={{identificacion}}&desde={{fechaIso}}&hasta={{fechaIso}}"
                }
              },
              "status": "Forbidden",
              "code": 403,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3011,\n  \"msgError\": \"Contribuyente o servicio no autorizado.\",\n  \"errores\": []\n}"
            },
            {
              "name": "400 · Filtros invalidos (3012)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/operaciones?identificacion={{identificacion}}&desde=2020-01-01&hasta=2026-11-10"
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3012,\n  \"msgError\": \"Filtros inválidos.\",\n  \"errores\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "04 · Errores y casos limite",
      "description": {
        "content": "Ejemplos para conocer el contrato de error. No son flujos de exito: al ejecutarlos veras el JSON de error real del API.\n\nFormato comun: `{ estado, codEstado, msgError, errores[] }` (`errores` siempre presente; vacio si no hay detalle). La emision (04.2 a 04.5) responde con la misma forma de su `202`, con `idOperacion`, `urlEstado`, `numeroDocumento`, `claveAcceso` y las fechas en `null`. Conserva el `X-Correlation-Id` de la cabecera para soporte.",
        "type": "text/markdown"
      },
      "item": [
        {
          "name": "04.1 · 401 sin credencial",
          "auth": {
            "type": "noauth"
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contexto",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contexto"
              ]
            },
            "description": {
              "content": "Peticion **sin** `X-Api-Key`. Respuesta `401` con `codEstado` 3009. Ademas, tras varios intentos fallidos, el API aplica un bloqueo temporal por IP (`429` con `codEstado` 5005 y `Retry-After`).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "401 · Credencial invalida (3009)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contexto"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3009,\n  \"msgError\": \"Credenciales inválidas.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "04.2 · 400 falta Idempotency-Key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"error-idempotency\",\n  \"infoTributaria\": { \"ruc\": \"{{ruc}}\", \"estab\": \"{{estab}}\", \"ptoEmi\": \"{{ptoEmi}}\" },\n  \"detalles\": [ { \"codigoPrincipal\": \"X\", \"descripcion\": \"X\", \"cantidad\": 1, \"precioUnitario\": 1, \"descuento\": 0, \"precioTotalSinImpuesto\": 1, \"impuestos\": [ { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 } ] } ],\n  \"info\": { \"fechaEmision\": \"{{fechaEmision}}\", \"tipoIdentificacionComprador\": \"05\", \"identificacionComprador\": \"0123456789\", \"razonSocialComprador\": \"X\", \"totalSinImpuestos\": 1, \"moneda\": \"DOLAR\", \"totalDescuento\": 0, \"totalConImpuestos\": [ { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 } ], \"importeTotal\": 1, \"pagos\": [ { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" } ] }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "facturas"
              ]
            },
            "description": {
              "content": "`Idempotency-Key` es **obligatoria** al emitir. Sin ella (o invalida) la API responde `400` (`codEstado` 3003) con `errores` indicando `Idempotency-Key`.\n\nFormato esperado: ASCII estable, maximo 128 caracteres.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "400 · Solicitud invalida (3003)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3003,\n  \"msgError\": \"La solicitud no es válida.\",\n  \"errores\": [\n    \"Idempotency-Key: La cabecera Idempotency-Key es obligatoria.\"\n  ],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "04.3 · 422 campo no soportado",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"version\": \"1\",\n  \"formato\": \"json\",\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"error-campo\",\n  \"infoTributaria\": { \"ruc\": \"{{ruc}}\", \"estab\": \"{{estab}}\", \"ptoEmi\": \"{{ptoEmi}}\" },\n  \"detalles\": [],\n  \"info\": { \"fechaEmision\": \"{{fechaEmision}}\", \"tipoIdentificacionComprador\": \"05\", \"identificacionComprador\": \"0123456789\", \"razonSocialComprador\": \"X\", \"totalSinImpuestos\": 1, \"moneda\": \"DOLAR\", \"totalDescuento\": 0, \"totalConImpuestos\": [], \"importeTotal\": 1, \"pagos\": [] }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "facturas"
              ]
            },
            "description": {
              "content": "La Estructura del comprobante **no** admite `version` ni `formato`: la plataforma asume la version 1 y el formato JSON. Esta solicitud los envia a proposito y la API responde `422` con `codEstado` 3002. En `errores` viene la ruta del primer campo no soportado, aqui `$.version`.\n\nLo mismo ocurre con `ambiente` y `tipoEmision`, en la raiz o en `infoTributaria`, porque el ambiente lo define la URL que llamas (ver los ejemplos guardados). Cualquier otro campo desconocido se rechaza igual, con su ruta.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "422 · version no soportada (3002)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3002,\n  \"msgError\": \"El comprobante no cumple las validaciones.\",\n  \"errores\": [\n    \"$.version: Campo no soportado en este contrato.\"\n  ],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "422 · ambiente en la raiz (3002)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"ambiente\": 1,\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"error-ambiente\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3002,\n  \"msgError\": \"El comprobante no cumple las validaciones.\",\n  \"errores\": [\n    \"$.ambiente: Campo no soportado en este contrato.\"\n  ],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "422 · tipoEmision en infoTributaria (3002)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                },
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"error-tipo-emision\",\n  \"infoTributaria\": {\n    \"ruc\": \"{{ruc}}\",\n    \"tipoEmision\": 1,\n    \"estab\": \"{{estab}}\",\n    \"ptoEmi\": \"{{ptoEmi}}\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3002,\n  \"msgError\": \"El comprobante no cumple las validaciones.\",\n  \"errores\": [\n    \"$.infoTributaria.tipoEmision: Campo no soportado en este contrato.\"\n  ],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            }
          ]
        },
        {
          "name": "04.4 · 429 cupo agotado",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"origenReferencia\": \"Postman\",\n  \"referenciaExterna\": \"error-cupo\",\n  \"infoTributaria\": { \"ruc\": \"{{ruc}}\", \"estab\": \"{{estab}}\", \"ptoEmi\": \"{{ptoEmi}}\" },\n  \"detalles\": [ { \"codigoPrincipal\": \"X\", \"descripcion\": \"X\", \"cantidad\": 1, \"precioUnitario\": 1, \"descuento\": 0, \"precioTotalSinImpuesto\": 1, \"impuestos\": [ { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"tarifa\": 0, \"baseImponible\": 1, \"valor\": 0 } ] } ],\n  \"info\": { \"fechaEmision\": \"{{fechaEmision}}\", \"tipoIdentificacionComprador\": \"05\", \"identificacionComprador\": \"0123456789\", \"razonSocialComprador\": \"X\", \"totalSinImpuestos\": 1, \"moneda\": \"DOLAR\", \"totalDescuento\": 0, \"totalConImpuestos\": [ { \"codigo\": \"2\", \"codigoPorcentaje\": \"0\", \"baseImponible\": 1, \"valor\": 0 } ], \"importeTotal\": 1, \"pagos\": [ { \"formaPago\": \"01\", \"total\": 1, \"plazo\": 0, \"unidadTiempo\": \"dias\" } ] }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "facturas"
              ]
            },
            "description": {
              "content": "El mismo HTTP `429` tiene dos causas y las distingues por `codEstado`:\n\n- **4004 (`cupo_agotado`)**: no te quedan documentos. No reintentes la misma peticion, porque esperar no repone el cupo: consulta **00.3 · Cupo de tu cuenta** para ver `disponibles` y amplia tu plan antes de volver a emitir.\n- **5005 (`limite_solicitudes`)**: superaste las solicitudes por minuto. Reintenta la misma peticion, con la misma `Idempotency-Key`, despues de los segundos que indica la cabecera `Retry-After`.\n\nLa prueba de esta peticion revisa cual de los dos llego.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "429 · Cupo agotado (4004)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazo_configuracion\",\n  \"codEstado\": 4004,\n  \"msgError\": \"Cupo agotado.\",\n  \"errores\": [],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            },
            {
              "name": "429 · Limite de solicitudes (5005)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                },
                {
                  "key": "Retry-After",
                  "value": "12"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"error\",\n  \"codEstado\": 5005,\n  \"msgError\": \"Límite de solicitudes excedido.\",\n  \"errores\": [],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"FAC-ERP-4581\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "const primerDigito = { recibido: '1', autorizado: '2', rechazado: '3', rechazo_configuracion: '4', error: '5', cancelado: '6' };",
                  "if (pm.response.code === 429) {",
                  "  // 5005: limite de solicitudes, reintenta tras Retry-After. 4004: cupo agotado, no reintentes.",
                  "  pm.test('429 con codEstado 5005 o 4004', function () {",
                  "    pm.expect([5005, 4004]).to.include(json.codEstado);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    if (json.codEstado === 5005) { pm.expect(pm.response.headers.get('Retry-After')).to.be.ok; }",
                  "  });",
                  "  console.log(json.codEstado === 5005",
                  "    ? 'Limite de solicitudes: reintenta con la misma Idempotency-Key despues de ' + pm.response.headers.get('Retry-After') + ' s.'",
                  "    : 'Cupo agotado: no reintentes; revisa 00.3 · Cupo de tu cuenta y amplia tu plan.');",
                  "} else {",
                  "  // El 202 normalmente es recibido (1001 o 1002) y, si la autorizacion ya se conoce, trae autorizado (2001).",
                  "  // Un rechazo definitivo ya conocido (3xxx o 4xxx) responde 422 con el mismo cuerpo y su idOperacion.",
                  "  // Decide siempre por estado y codEstado, nunca asumas recibido.",
                  "  pm.test('202 Aceptado, o 422 con rechazo definitivo', function () {",
                  "    if (json.idOperacion && (json.estado === 'rechazado' || json.estado === 'rechazo_configuracion')) { pm.response.to.have.status(422); } else { pm.response.to.have.status(202); }",
                  "  });",
                  "  pm.test('estado y codEstado coherentes (recibido o estado final)', function () {",
                  "    pm.expect(Object.keys(primerDigito)).to.include(json.estado);",
                  "    pm.expect(json.codEstado).to.be.a('number');",
                  "    pm.expect(String(json.codEstado).charAt(0)).to.eql(primerDigito[json.estado]);",
                  "    pm.expect(json.errores).to.be.an('array');",
                  "    pm.expect(json.urlEstado).to.match(/^https?:\\/\\//);",
                  "    pm.expect(json.fhRecibido).to.be.a('string');",
                  "    if (json.estado === 'recibido') {",
                  "      pm.expect([1001, 1002]).to.include(json.codEstado);",
                  "      // 1001 todavia no trae claveAcceso (null); 1002 ya la trae.",
                  "      if (json.codEstado === 1002) { pm.expect(json.claveAcceso).to.have.lengthOf(49); } else { pm.expect(json.claveAcceso).to.eql(null); }",
                  "    }",
                  "    if (json.estado === 'autorizado') {",
                  "      pm.expect(json.codEstado).to.eql(2001);",
                  "      pm.expect(json).to.not.have.property('msgError');",
                  "      pm.expect(json.claveAcceso).to.have.lengthOf(49);",
                  "      pm.expect(json.fhAutorizacion).to.be.a('string');",
                  "    } else if (json.estado !== 'recibido') {",
                  "      pm.expect(json.msgError).to.be.a('string');",
                  "    }",
                  "  });",
                  "  pm.test('Location igual a urlEstado', function () {",
                  "    pm.expect(pm.response.headers.get('Location')).to.eql(json.urlEstado);",
                  "  });",
                  "  if (json.estado === 'recibido') {",
                  "    console.log('codEstado ' + json.codEstado + ': el resultado llegara despues; consultalo en 02.1 · Ver operacion o por webhook.');",
                  "  } else {",
                  "    console.log('Resultado final en el 202: ' + json.estado + ' (' + json.codEstado + '). No hace falta seguimiento.'",
                  "      + (json.msgError ? ' ' + json.msgError + ' ' + json.errores.join(' | ') : ''));",
                  "  }",
                  "}",
                  "if (json && json.idOperacion) {",
                  "  pm.environment.set('idOperacion', json.idOperacion);",
                  "  pm.environment.set('idOperacion01', json.idOperacion);",
                  "}",
                  "if (json && json.claveAcceso) {",
                  "  pm.environment.set('claveAcceso', json.claveAcceso);",
                  "  if (json.estado === 'autorizado') { pm.environment.set('claveAccesoEmitida', json.claveAcceso); }",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "04.5 · XML con codDoc incorrecto",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/xml"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotencyKey}}"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<factura id=\"comprobante\" version=\"1.1.0\">\n  <infoTributaria>\n    <ruc>{{ruc}}</ruc>\n    <codDoc>04</codDoc>\n    <estab>{{estab}}</estab>\n    <ptoEmi>{{ptoEmi}}</ptoEmi>\n    <secuencial>000000001</secuencial>\n  </infoTributaria>\n  <infoFactura>\n    <fechaEmision>01/01/2026</fechaEmision>\n  </infoFactura>\n</factura>"
            },
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "facturas"
              ]
            },
            "description": {
              "content": "La emision acepta XML del SRI con `Content-Type: application/xml` o `text/xml`. Este ejemplo envia una factura con `codDoc` 04: la raiz y `codDoc` deben coincidir con la ruta, asi que responde `422` con `codEstado` 3002 y no consume cupo. Para una emision valida usa la raiz `factura` y `codDoc` 01.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "422 · codDoc no corresponde a la ruta (3002)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/facturas"
                }
              },
              "status": "Unprocessable Entity",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3002,\n  \"msgError\": \"El comprobante no cumple las validaciones.\",\n  \"errores\": [\n    \"$.infoTributaria.codDoc: El codDoc del XML no corresponde al tipo de la ruta.\"\n  ],\n  \"idOperacion\": null,\n  \"urlEstado\": null,\n  \"ambiente\": 1,\n  \"tipoDocumento\": \"01\",\n  \"numeroDocumento\": null,\n  \"referenciaExterna\": \"01-001-001-000000001\",\n  \"claveAcceso\": null,\n  \"fhRecibido\": null,\n  \"fhAutorizacion\": null\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "05 · Consultas SRI",
      "item": [
        {
          "name": "Contribuyente por identificacion",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/consultas/contribuyentes/{{ruc}}?fusionar=true",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "consultas",
                "contribuyentes",
                "{{ruc}}"
              ],
              "query": [
                {
                  "key": "fusionar",
                  "value": "true"
                }
              ]
            },
            "description": {
              "content": "Datos del contribuyente por cedula, RUC o pasaporte. Respuesta plana (sin `datos`).",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Contribuyente",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/consultas/contribuyentes/{{ruc}}?fusionar=true"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"identificacion\": \"1799999999001\",\n  \"tipoIdentificacion\": \"RucSociedadPrivada\",\n  \"nombreCompleto\": \"DISTRIBUIDORA DEMO S.A.\",\n  \"razonSocial\": \"DISTRIBUIDORA DEMO S.A.\",\n  \"nombreComercial\": \"DISTRIBUIDORA DEMO\",\n  \"clase\": \"Sociedad\",\n  \"estado\": \"ACTIVO\",\n  \"regimen\": \"GENERAL\",\n  \"actividadEconomicaPrincipal\": \"VENTA AL POR MAYOR DE ARTICULOS DE OFICINA\",\n  \"obligadoLlevarContabilidad\": true,\n  \"agenteRetencion\": false,\n  \"contribuyenteEspecial\": false,\n  \"fechaInicioActividades\": \"2018-05-14T00:00:00\",\n  \"fechaCese\": null,\n  \"fechaReinicioActividades\": null,\n  \"fechaActualizacion\": \"2026-10-01T00:00:00\",\n  \"representantesLegales\": [\n    {\n      \"identificacion\": \"1799999998\",\n      \"nombre\": \"TORRES MARIA\"\n    }\n  ],\n  \"establecimientos\": [\n    {\n      \"numero\": \"001\",\n      \"nombreComercial\": \"DISTRIBUIDORA DEMO\",\n      \"tipo\": \"MATRIZ\",\n      \"direccionCompleta\": \"AV. AMAZONAS N10-20 Y PATRIA\",\n      \"estado\": \"ABIERTO\",\n      \"esMatriz\": true\n    }\n  ],\n  \"estadoTributario\": {\n    \"tieneDeuda\": false,\n    \"tieneImpugnacion\": false,\n    \"tieneRemision\": false,\n    \"resumenDeuda\": null,\n    \"resumenImpugnacion\": null,\n    \"resumenRemision\": null,\n    \"consultadoEn\": \"2026-11-09T08:00:00\"\n  },\n  \"fuenteOrigen\": \"SriCatastro\",\n  \"consultadoEn\": \"2026-11-09T08:00:00\"\n}"
            }
          ]
        },
        {
          "name": "Contribuyentes por nombre",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/consultas/contribuyentes?apellidos=PEREZ%20LOPEZ&nombres=JUAN&clase=PersonaNatural&max=10",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "consultas",
                "contribuyentes"
              ],
              "query": [
                {
                  "key": "apellidos",
                  "value": "PEREZ LOPEZ"
                },
                {
                  "key": "nombres",
                  "value": "JUAN"
                },
                {
                  "key": "clase",
                  "value": "PersonaNatural"
                },
                {
                  "key": "max",
                  "value": "10"
                }
              ]
            },
            "description": {
              "content": "`apellidos` es obligatorio. Devuelve un arreglo plano.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Coincidencias",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/consultas/contribuyentes?apellidos=TORRES&nombres=MARIA&clase=PersonaNatural&max=10"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "[\n  {\n    \"identificacion\": \"1799999998\",\n    \"tipoIdentificacion\": \"Cedula\",\n    \"nombreCompleto\": \"TORRES MARIA\",\n    \"clase\": \"PersonaNatural\",\n    \"estado\": \"ACTIVO\",\n    \"fuenteOrigen\": \"SriCatastro\"\n  }\n]"
            }
          ]
        },
        {
          "name": "Establecimientos de un RUC",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/consultas/establecimientos/{{ruc}}?filtro=Todos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "consultas",
                "establecimientos",
                "{{ruc}}"
              ],
              "query": [
                {
                  "key": "filtro",
                  "value": "Todos"
                }
              ]
            }
          },
          "response": [
            {
              "name": "200 · Establecimientos",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/consultas/establecimientos/{{ruc}}?filtro=Todos"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"ruc\": \"1799999999001\",\n  \"filtro\": \"Todos\",\n  \"cantidad\": 2,\n  \"establecimientos\": [\n    {\n      \"numero\": \"001\",\n      \"nombreComercial\": \"DISTRIBUIDORA DEMO\",\n      \"tipo\": \"MATRIZ\",\n      \"direccionCompleta\": \"AV. AMAZONAS N10-20 Y PATRIA\",\n      \"estado\": \"ABIERTO\",\n      \"esMatriz\": true\n    },\n    {\n      \"numero\": \"002\",\n      \"nombreComercial\": \"DISTRIBUIDORA DEMO NORTE\",\n      \"tipo\": \"LOCAL COMERCIAL\",\n      \"direccionCompleta\": \"AV. DE LA PRENSA N45-10\",\n      \"estado\": \"ABIERTO\",\n      \"esMatriz\": false\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Validar identificacion",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/consultas/identificacion/validar/{{ruc}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "consultas",
                "identificacion",
                "validar",
                "{{ruc}}"
              ]
            },
            "description": {
              "content": "Valida el formato sin red. Responde `200` tambien cuando no es valido: revise `valido`.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Identificacion valida",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/consultas/identificacion/validar/{{ruc}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"entrada\": \"1799999999001\",\n  \"normalizado\": \"1799999999001\",\n  \"valido\": true,\n  \"tipo\": \"RucSociedadPrivada\",\n  \"longitud\": 13,\n  \"esSoloDigitos\": true,\n  \"cedulaBaseDelRuc\": null,\n  \"mensaje\": \"Formato de RUC de sociedad privada aceptado; confirme su registro en el SRI.\"\n}"
            }
          ]
        },
        {
          "name": "Decodificar clave de acceso",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/consultas/comprobantes/decodificar/{{claveAcceso}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "consultas",
                "comprobantes",
                "decodificar",
                "{{claveAcceso}}"
              ]
            },
            "description": {
              "content": "Descompone una clave de 49 digitos. No prueba la autorizacion fiscal.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Clave decodificada",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/consultas/comprobantes/decodificar/{{claveAcceso}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"entrada\": \"0911202601179999999900110020010000004561234567817\",\n  \"normalizada\": \"0911202601179999999900110020010000004561234567817\",\n  \"valido\": true,\n  \"longitud\": 49,\n  \"fechaEmision\": \"2026-11-09\",\n  \"tipo\": \"Factura\",\n  \"rucEmisor\": \"1799999999001\",\n  \"ambiente\": \"Pruebas\",\n  \"establecimiento\": \"002\",\n  \"puntoEmision\": \"001\",\n  \"secuencial\": \"000000456\",\n  \"codigoNumerico\": \"12345678\",\n  \"tipoEmision\": \"1\",\n  \"tipoEmisionDescripcion\": \"Normal\",\n  \"digitoVerificador\": \"7\",\n  \"mensaje\": \"Clave de acceso decodificada correctamente.\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "06 · Descargas",
      "description": "RIDE y XML de un comprobante emitido. Usan claveAccesoEmitida, que **02.1** guarda cuando la operacion queda \u0007utorizado; tambien puedes pegar una clave del seguimiento (**02.1**).",
      "item": [
        {
          "name": "06.1 · Descargar RIDE (PDF)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con PDF', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.headers.get('Content-Type')).to.include('application/pdf');",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/pdf"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/comprobantes/{{claveAccesoEmitida}}/ride",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "comprobantes",
                "{{claveAccesoEmitida}}",
                "ride"
              ]
            },
            "description": {
              "content": "Descarga el RIDE en PDF de un comprobante emitido.\n\n- `GET /v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/ride`\n- `claveAccesoEmitida` se llena sola en **02.1** cuando la operacion queda `autorizado`.\n- Responde `application/pdf`. En Postman, usa **Save Response > Save to a file**.\n- Si acabas de emitir y responde `404` con `codEstado` 3013, espera a que la operacion tenga `claveAcceso` y reintenta.\n- Un contribuyente de marca blanca (`marcaBlanca` en `true` en **00.2 · Contexto de la credencial**) no tiene RIDE: responde siempre `404` con `codEstado` 3013. No reintentes; descarga el XML con **06.2**.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "404 · Aun no disponible (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            },
            {
              "name": "404 · Contribuyente de marca blanca (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/comprobantes/{{claveAccesoEmitida}}/ride"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "06.2 · Descargar XML",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con XML', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.headers.get('Content-Type')).to.include('xml');",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/xml"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/comprobantes/{{claveAccesoEmitida}}/xml",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "comprobantes",
                "{{claveAccesoEmitida}}",
                "xml"
              ]
            },
            "description": {
              "content": "Descarga el XML autorizado de un comprobante emitido.\n\n- `GET /v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/xml`\n- Responde `application/xml`. Solo esta disponible cuando el comprobante esta autorizado; si no, responde 404 con el `codEstado` 3013.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "404 · Aun no disponible (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "07 · Perfil del emisor",
      "description": "Datos del emisor que salen en el RIDE. **07.2** y **07.3** cambian el perfil real del ambiente donde las ejecutes.",
      "item": [
        {
          "name": "07.1 · Leer perfil",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con cuerpo', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.json()).to.be.ok;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/perfil",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "perfil"
              ]
            },
            "description": {
              "content": "Datos del emisor que aparecen en el RIDE y en el correo.\n\n- `GET /v1/contribuyentes/{identificacion}/perfil`",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Perfil",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"identificacion\": \"0123456789001\",\n  \"razonSocial\": \"EMPRESA DE PRUEBA S.A.\",\n  \"nombreComercial\": \"Prueba\",\n  \"direccionMatriz\": \"Av. Principal 123\",\n  \"direccionEstablecimiento\": \"Av. Principal 123\",\n  \"codigoEstablecimiento\": \"001\",\n  \"codigoPuntoEmision\": \"001\",\n  \"moneda\": \"DOLAR\",\n  \"obligadoContabilidad\": true,\n  \"correo\": \"contacto@ejemplo.com\",\n  \"telefono\": \"042345678\",\n  \"ciudad\": \"GUAYAQUIL\",\n  \"provincia\": \"GUAYAS\",\n  \"pais\": \"ECUADOR\",\n  \"logo\": \"0123456789001_Logo.jpg\"\n}"
            }
          ]
        },
        {
          "name": "07.2 · Actualizar perfil",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con cuerpo', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.json()).to.be.ok;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/perfil",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "perfil"
              ]
            },
            "description": {
              "content": "Cambia los datos editables del emisor.\n\n- `PUT /v1/contribuyentes/{identificacion}/perfil`\n- Solo se aceptan `nombreComercial`, `direccionMatriz`, `correo`, `telefono`, `ciudad` y `provincia`. Otro campo responde `400` con `codEstado` 3003 y no cambia nada.\n- Un campo omitido o en `null` conserva su valor; un texto vacio se guarda como valor nuevo.\n- **Cambia datos reales del emisor en el ambiente donde la ejecutes.** Ajusta el cuerpo antes de enviarla.",
              "type": "text/markdown"
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"nombreComercial\": \"Prueba\",\n  \"correo\": \"contacto@ejemplo.com\",\n  \"telefono\": \"042345678\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 · Perfil actualizado",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"identificacion\": \"0123456789001\",\n  \"razonSocial\": \"EMPRESA DE PRUEBA S.A.\",\n  \"nombreComercial\": \"Prueba\",\n  \"direccionMatriz\": \"Av. Principal 123\",\n  \"direccionEstablecimiento\": \"Av. Principal 123\",\n  \"codigoEstablecimiento\": \"001\",\n  \"codigoPuntoEmision\": \"001\",\n  \"moneda\": \"DOLAR\",\n  \"obligadoContabilidad\": true,\n  \"correo\": \"contacto@ejemplo.com\",\n  \"telefono\": \"042345678\",\n  \"ciudad\": \"GUAYAQUIL\",\n  \"provincia\": \"GUAYAS\",\n  \"pais\": \"ECUADOR\",\n  \"logo\": \"0123456789001_Logo.jpg\"\n}"
            }
          ]
        },
        {
          "name": "07.3 · Cambiar logo",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con cuerpo', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.json()).to.be.ok;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/contribuyentes/{{identificacion}}/perfil/logo",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "contribuyentes",
                "{{identificacion}}",
                "perfil",
                "logo"
              ]
            },
            "description": {
              "content": "Reemplaza el logo del RIDE.\n\n- `POST /v1/contribuyentes/{identificacion}/perfil/logo`\n- Formulario `multipart/form-data` con un unico campo `logo`: PNG o JPEG, hasta 512 KB.\n- En **Body > form-data**, elige el archivo en el campo `logo` antes de enviar.\n- **Cambia el logo real del emisor en el ambiente donde la ejecutes.**",
              "type": "text/markdown"
            },
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "logo",
                  "type": "file",
                  "src": []
                }
              ]
            }
          },
          "response": [
            {
              "name": "200 · Logo actualizado",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"identificacion\": \"0123456789001\",\n  \"razonSocial\": \"EMPRESA DE PRUEBA S.A.\",\n  \"nombreComercial\": \"Prueba\",\n  \"direccionMatriz\": \"Av. Principal 123\",\n  \"direccionEstablecimiento\": \"Av. Principal 123\",\n  \"codigoEstablecimiento\": \"001\",\n  \"codigoPuntoEmision\": \"001\",\n  \"moneda\": \"DOLAR\",\n  \"obligadoContabilidad\": true,\n  \"correo\": \"contacto@ejemplo.com\",\n  \"telefono\": \"042345678\",\n  \"ciudad\": \"GUAYAQUIL\",\n  \"provincia\": \"GUAYAS\",\n  \"pais\": \"ECUADOR\",\n  \"logo\": \"0123456789001_Logo.jpg\"\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "08 · Webhooks",
      "description": {
        "content": "Administra los destinos de webhooks con la API Key y el mismo contrato del portal del cliente.\n\n- `GET /v1/webhooks/destinos` y `GET /v1/webhooks/destinos/{id}`: `webhooks:leer`.\n- `POST /v1/webhooks/destinos`: crea el destino y devuelve `secretoUnaVez` una sola vez (`webhooks:gestionar`).\n- `PUT /v1/webhooks/destinos/{id}/eventos`: reemplaza los eventos suscritos.\n- `POST /v1/webhooks/destinos/{id}/rotar-secreto`: rota el secreto y lo devuelve una sola vez.\n- `POST /v1/webhooks/destinos/{id}/probar`, `/pausar`, `/reanudar` y `/deshabilitar`: prueba, pausa, reactiva o da de baja el destino.\n- `GET /v1/webhooks/destinos/{id}/entregas` y `GET .../entregas/{entregaId}/intentos`: ultimas 50 entregas y el historial de intentos.\n- `POST /v1/webhooks/destinos/{id}/entregas/{eventoId}/reintentar`: reenvia un evento ahora (`webhooks:reintentar`).\n\nEl secreto de un destino se muestra una sola vez, al crearlo o al rotarlo. La coleccion no lo guarda en variables ni lo imprime en la consola: copialo desde la respuesta y guardalo en tu servidor. `08.1` guarda `idDestino`; `08.2` tambien lo toma de la lista; `08.6` guarda `eventoId` para `08.7`.",
        "type": "text/markdown"
      },
      "item": [
        {
          "name": "08.1 · Crear destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "pm.test('201 con publicId y secreto', function () {",
                  "  pm.response.to.have.status(201);",
                  "  pm.expect(json.publicId).to.be.a('string');",
                  "  pm.expect(json.url).to.be.a('string');",
                  "  pm.expect(json.secretoUnaVez).to.be.a('string');",
                  "});",
                  "if (json.publicId) {",
                  "  pm.collectionVariables.set('idDestino', json.publicId);",
                  "  pm.environment.set('idDestino', json.publicId);",
                  "  console.log('Destino creado. Copia secretoUnaVez desde la respuesta y guardalo en tu servidor; no se vuelve a mostrar.');",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://erp.ejemplo.com/webhooks/ecuafact\",\n  \"eventos\": [\n    \"document.authorized\",\n    \"document.rejected\",\n    \"document.failed\",\n    \"operation.requires_attention\"\n  ],\n  \"ruc\": \"{{identificacion}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos"
              ]
            },
            "description": {
              "content": "Crea un destino de webhooks.\n\n- `url`: HTTPS publica en el puerto 443, sin credenciales ni fragmento.\n- `eventos`: uno o varios de `document.authorized`, `document.rejected`, `document.failed` y `operation.requires_attention`.\n- `ruc`: opcional. Si lo omites, el destino recibe los eventos de todos los RUC. Con `{{identificacion}}` queda limitado a ese contribuyente.\n- La respuesta `201` trae `publicId`, `url`, `secretoUnaVez` y `ruc`. Guarda el secreto en tu servidor: no se vuelve a mostrar.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "201 · Destino creado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos"
                }
              },
              "status": "Created",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"publicId\": \"9b2e4f60-1c3d-4e5f-8a7b-6c5d4e3f2a1b\",\n  \"url\": \"https://erp.ejemplo.com/webhooks/ecuafact\",\n  \"secretoUnaVez\": \"whsec_ejemplo_solo_para_documentacion\",\n  \"ruc\": \"0123456789001\"\n}"
            },
            {
              "name": "403 · RUC no autorizado (3011)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos"
                }
              },
              "status": "Forbidden",
              "code": 403,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3011,\n  \"msgError\": \"Contribuyente o servicio no autorizado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.2 · Listar destinos",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "pm.test('200 con la lista de destinos', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(json).to.be.an('array');",
                  "});",
                  "if (json.length > 0) {",
                  "  pm.expect(json[0].publicId).to.be.a('string');",
                  "  pm.expect(json[0].state).to.be.a('string');",
                  "  if (!pm.environment.get('idDestino')) {",
                  "    pm.collectionVariables.set('idDestino', json[0].publicId);",
                  "    pm.environment.set('idDestino', json[0].publicId);",
                  "  }",
                  "} else {",
                  "  console.log('No hay destinos: ejecuta 08.1 para crear uno.');",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos"
              ]
            },
            "description": {
              "content": "Lista los destinos que puede ver la API Key.\n\n- `GET /v1/webhooks/destinos`\n- Cada destino trae `publicId`, `url`, `state`, `fallosConsecutivos`, `ultimoFallo`, `creado`, `eventos` y `ruc`.\n- Una llave limitada a ciertos RUC solo ve los destinos de esos RUC y los destinos para todos los RUC requieren alcance completo.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Destinos",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "[\n  {\n    \"publicId\": \"9b2e4f60-1c3d-4e5f-8a7b-6c5d4e3f2a1b\",\n    \"url\": \"https://erp.ejemplo.com/webhooks/ecuafact\",\n    \"state\": \"activo\",\n    \"fallosConsecutivos\": 0,\n    \"ultimoFallo\": null,\n    \"creado\": \"2026-11-09T10:15:00-05:00\",\n    \"eventos\": [\n      \"document.authorized\",\n      \"document.rejected\",\n      \"document.failed\"\n    ],\n    \"ruc\": null\n  }\n]"
            },
            {
              "name": "401 · Credenciales invalidas (3009)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3009,\n  \"msgError\": \"Credenciales inválidas.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.3 · Pausar destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('204 sin cuerpo', function () {",
                  "  pm.response.to.have.status(204);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/pausar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "pausar"
              ]
            },
            "description": {
              "content": "Pausa las entregas nuevas del destino.\n\n- `POST /v1/webhooks/destinos/{id}/pausar`\n- Responde `204 No Content`.\n- Los eventos nuevos no se entregan ni quedan en espera mientras el destino esta pausado. Revisa el seguimiento de las operaciones que quedaron sin resultado.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "204 · Destino pausado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/pausar"
                }
              },
              "status": "No Content",
              "code": 204,
              "header": [],
              "cookie": [],
              "body": ""
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/pausar"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.4 · Reanudar destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('204 sin cuerpo', function () {",
                  "  pm.response.to.have.status(204);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/reanudar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "reanudar"
              ]
            },
            "description": {
              "content": "Reactiva un destino pausado.\n\n- `POST /v1/webhooks/destinos/{id}/reanudar`\n- Responde `204 No Content`.\n- Al reanudarlo solo recibes los eventos que ocurran desde ese momento.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "204 · Destino reanudado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/reanudar"
                }
              },
              "status": "No Content",
              "code": 204,
              "header": [],
              "cookie": [],
              "body": ""
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/reanudar"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.5 · Rotar secreto",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "pm.test('200 con secreto nuevo', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(json.publicId).to.be.a('string');",
                  "  pm.expect(json.secretoUnaVez).to.be.a('string');",
                  "});",
                  "console.log('Secreto rotado. Copia secretoUnaVez desde la respuesta y actualiza tu servidor; no se vuelve a mostrar.');"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/rotar-secreto",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "rotar-secreto"
              ]
            },
            "description": {
              "content": "Genera un secreto nuevo para el destino.\n\n- `POST /v1/webhooks/destinos/{id}/rotar-secreto`\n- Responde `200` con `publicId`, `url`, `secretoUnaVez` y `ruc`.\n- Las entregas siguientes se firman con el secreto nuevo. Copialo desde la respuesta y actualiza tu servidor: no se vuelve a mostrar.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Secreto rotado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/rotar-secreto"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"publicId\": \"9b2e4f60-1c3d-4e5f-8a7b-6c5d4e3f2a1b\",\n  \"url\": \"https://erp.ejemplo.com/webhooks/ecuafact\",\n  \"secretoUnaVez\": \"whsec_ejemplo_solo_para_documentacion\",\n  \"ruc\": \"0123456789001\"\n}"
            },
            {
              "name": "403 · RUC no autorizado (3011)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/rotar-secreto"
                }
              },
              "status": "Forbidden",
              "code": 403,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3011,\n  \"msgError\": \"Contribuyente o servicio no autorizado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.6 · Entregas",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const json = pm.response.json();",
                  "pm.test('200 con la lista de entregas', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(json).to.be.an('array');",
                  "});",
                  "if (json.length > 0) {",
                  "  pm.expect(json[0].eventId).to.be.a('string');",
                  "  pm.collectionVariables.set('eventoId', json[0].eventId);",
                  "  pm.environment.set('eventoId', json[0].eventId);",
                  "} else {",
                  "  console.log('Sin entregas: emite un comprobante o usa Probar en el portal.');",
                  "}"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "entregas"
              ]
            },
            "description": {
              "content": "Lista las ultimas 50 entregas del destino.\n\n- `GET /v1/webhooks/destinos/{id}/entregas`\n- Cada entrega trae `publicId`, `eventId`, `intento`, `estado`, `programado`, `enviado`, `httpStatus`, `codigoError` y `tipoEvento`.\n- La prueba guarda el `eventId` de la primera entrega en `eventoId` para `08.7`.\n- Para el historial de intentos de una entrega, usa `GET /v1/webhooks/destinos/{id}/entregas/{entregaId}/intentos`.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Entregas",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "[\n  {\n    \"publicId\": \"0f6e5d4c-3b2a-4198-8776-655443322110\",\n    \"eventId\": \"7b2d9e4a-1c3f-4a8b-9e6d-5f0a1b2c3d4e\",\n    \"intento\": 1,\n    \"estado\": \"entregado\",\n    \"programado\": \"2026-11-09T10:15:05-05:00\",\n    \"enviado\": \"2026-11-09T10:15:06-05:00\",\n    \"httpStatus\": 200,\n    \"codigoError\": null,\n    \"tipoEvento\": \"document.authorized\"\n  }\n]"
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.7 · Reintentar entrega",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('202 aceptado', function () {",
                  "  pm.response.to.have.status(202);",
                  "});",
                  "console.log('Evento programado para un nuevo intento. Revisa 08.6 para ver el resultado.');"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas/{{eventoId}}/reintentar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "entregas",
                "{{eventoId}}",
                "reintentar"
              ]
            },
            "description": {
              "content": "Reenvia un evento ahora.\n\n- `POST /v1/webhooks/destinos/{id}/entregas/{eventoId}/reintentar`\n- `eventoId` es el `eventId` de la entrega, que `08.6` guarda en la variable `eventoId`.\n- Responde `202 Accepted`. Revisa `08.6` para ver el nuevo intento.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Reintento aceptado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas/{{eventoId}}/reintentar"
                }
              },
              "status": "Accepted",
              "code": 202,
              "header": [],
              "cookie": [],
              "body": ""
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas/{{eventoId}}/reintentar"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.8 · Deshabilitar destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('204 sin cuerpo', function () {",
                  "  pm.response.to.have.status(204);",
                  "});",
                  "console.log('Destino deshabilitado. No se puede reactivar: crea uno nuevo si lo necesitas.');"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/deshabilitar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "deshabilitar"
              ]
            },
            "description": {
              "content": "Da de baja el destino.\n\n- `POST /v1/webhooks/destinos/{id}/deshabilitar`\n- Responde `204 No Content`.\n- Un destino deshabilitado no se puede reactivar. Para volver a recibir eventos, crea uno nuevo.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "204 · Destino deshabilitado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/deshabilitar"
                }
              },
              "status": "No Content",
              "code": 204,
              "header": [],
              "cookie": [],
              "body": ""
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/deshabilitar"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.9 · Consultar destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con el destino', function () {",
                  "  pm.response.to.have.status(200);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}"
              ]
            },
            "description": {
              "content": "Consulta la configuracion y el estado de un destino.\n\n- `GET /v1/webhooks/destinos/{id}`\n- Responde `200 OK` con el estado (`activo` o `pausado`), los fallos consecutivos, el ultimo fallo y los eventos que recibe.\n- Usa el `publicId` que devolvio la creacion o el listado.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Destino",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}"
                }
              },
              "status": "OK",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"publicId\": \"9b2e4f60-1c3d-4e5f-8a7b-6c5d4e3f2a1b\",\n  \"url\": \"https://erp.ejemplo.com/webhooks/ecuafact\",\n  \"state\": \"activo\",\n  \"fallosConsecutivos\": 0,\n  \"ultimoFallo\": null,\n  \"creado\": \"2026-11-09T10:15:00-05:00\",\n  \"eventos\": [\n    \"document.authorized\",\n    \"document.rejected\",\n    \"document.failed\"\n  ],\n  \"ruc\": null\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.10 · Cambiar eventos del destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('204 sin cuerpo', function () {",
                  "  pm.response.to.have.status(204);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/eventos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "eventos"
              ]
            },
            "description": {
              "content": "Reemplaza la lista completa de eventos que recibe un destino.\n\n- `PUT /v1/webhooks/destinos/{id}/eventos`\n- Responde `204 No Content`.\n- Envia la lista completa: los eventos que no incluyas dejan de entregarse a este destino.",
              "type": "text/markdown"
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"eventos\": [\n    \"document.authorized\",\n    \"document.rejected\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "204 · Eventos actualizados",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/eventos"
                }
              },
              "status": "No Content",
              "code": 204,
              "header": [],
              "cookie": [],
              "body": ""
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "PUT",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/eventos"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.11 · Probar destino",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('202 sin cuerpo', function () {",
                  "  pm.response.to.have.status(202);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/probar",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "probar"
              ]
            },
            "description": {
              "content": "Envia un evento de prueba al destino.\n\n- `POST /v1/webhooks/destinos/{id}/probar`\n- Responde `202 Accepted` sin cuerpo.\n- El evento de prueba es informativo y no representa un comprobante real. Revisa su resultado en **08.6 Entregas**.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "202 · Evento de prueba aceptado",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/probar"
                }
              },
              "status": "Accepted",
              "code": 202,
              "header": [],
              "cookie": [],
              "body": ""
            },
            {
              "name": "404 · Destino no encontrado (3013)",
              "originalRequest": {
                "method": "POST",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/probar"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        },
        {
          "name": "08.12 · Intentos de una entrega",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con los intentos', function () {",
                  "  pm.response.to.have.status(200);",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas/{{eventoId}}/intentos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "webhooks",
                "destinos",
                "{{idDestino}}",
                "entregas",
                "{{eventoId}}",
                "intentos"
              ]
            },
            "description": {
              "content": "Lista los intentos de una entrega, con el codigo HTTP y el error de cada uno.\n\n- `GET /v1/webhooks/destinos/{id}/entregas/{entregaId}/intentos`\n- Responde `200 OK`.\n- Obten el identificador de la entrega en **08.6 Entregas**.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Intentos",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas/{{eventoId}}/intentos"
                }
              },
              "status": "OK",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "[\n  {\n    \"intento\": 1,\n    \"fecha\": \"2026-11-09T10:15:06-05:00\",\n    \"httpStatus\": 503,\n    \"codigoError\": null,\n    \"duracionMs\": 412,\n    \"resultado\": \"retry\"\n  },\n  {\n    \"intento\": 2,\n    \"fecha\": \"2026-11-09T10:16:07-05:00\",\n    \"httpStatus\": 200,\n    \"codigoError\": null,\n    \"duracionMs\": 138,\n    \"resultado\": \"delivered\"\n  }\n]",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "404 · Entrega no encontrada (3013)",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/webhooks/destinos/{{idDestino}}/entregas/{{eventoId}}/intentos"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        }
      ]
    },
    {
      "name": "09 · Catalogos",
      "description": {
        "content": "Catalogos del SRI que usa la Estructura del comprobante: tipos de comprobante y de identificacion, impuestos, tarifas de IVA, formas de pago, retenciones y restricciones de campos.",
        "type": "text/markdown"
      },
      "item": [
        {
          "name": "09.1 · Listar catalogos",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con catalogos', function () {",
                  "  pm.response.to.have.status(200);",
                  "  var c = pm.response.json().catalogos;",
                  "  pm.expect(c).to.be.an('array').that.is.not.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/catalogos",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "catalogos"
              ]
            },
            "description": {
              "content": "Lista los catalogos del SRI con su clave y una descripcion breve. No consume cupo.\n\n- `GET /v1/catalogos`\n- Usa la `nombre` de cada catalogo en `09.2`.\n- La respuesta puede guardarse hasta una hora.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · Catalogos",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/catalogos"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"catalogos\": [\n    {\n      \"nombre\": \"tipos-comprobante\",\n      \"descripcion\": \"Tipos de comprobante electrónico y su código codDoc.\"\n    },\n    {\n      \"nombre\": \"tarifas-iva\",\n      \"descripcion\": \"Valores de codigoPorcentaje para el IVA y su tarifa en porcentaje.\"\n    }\n  ]\n}"
            }
          ]
        },
        {
          "name": "09.2 · Leer un catalogo",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "pm.test('200 con items', function () {",
                  "  pm.response.to.have.status(200);",
                  "  pm.expect(pm.response.json().items).to.be.an('array').that.is.not.empty;",
                  "});"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/v1/catalogos/{{catalogo}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "v1",
                "catalogos",
                "{{catalogo}}"
              ]
            },
            "description": {
              "content": "Devuelve las filas de un catalogo con su codigo, descripcion y, segun el catalogo, el valor, la vigencia y atributos propios. No consume cupo.\n\n- `GET /v1/catalogos/{nombre}`; la variable `catalogo` vale `tarifas-iva` por defecto.\n- Un nombre que no existe responde `404` con `codEstado` 3013.\n- La respuesta puede guardarse hasta una hora.",
              "type": "text/markdown"
            }
          },
          "response": [
            {
              "name": "200 · tarifas-iva",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/catalogos/{{catalogo}}"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"nombre\": \"tarifas-iva\",\n  \"descripcion\": \"Valores de codigoPorcentaje para el IVA y su tarifa en porcentaje.\",\n  \"fuente\": \"Ficha técnica SRI 2.34, Tabla 17\",\n  \"items\": [\n    {\n      \"codigo\": \"0\",\n      \"descripcion\": \"0 %\",\n      \"valor\": 0\n    },\n    {\n      \"codigo\": \"4\",\n      \"descripcion\": \"15 %\",\n      \"valor\": 15\n    }\n  ]\n}"
            },
            {
              "name": "404 · Catalogo inexistente",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/catalogos/no-existe"
                }
              },
              "status": "Not Found",
              "code": 404,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "cookie": [],
              "body": "{\n  \"estado\": \"rechazado\",\n  \"codEstado\": 3013,\n  \"msgError\": \"Recurso no encontrado.\",\n  \"errores\": []\n}"
            }
          ]
        }
      ]
    }
  ]
}
