{
    "info": {
        "name": "FactosPerú API · api.factosperu.com",
        "description": "# FactosPerú API (https://api.factosperu.com)\n\nColección generada desde el contrato de la API (`php artisan api:docs`, versión 1.1.0). Incluye todas las rutas, con cuerpo de ejemplo, respuestas de ejemplo guardadas y pruebas automáticas.\n\n## Cómo usarla\n1. **Importe** esta colección y el entorno `api_consulta.postman_environment.json` (Postman → Import → arrastre los dos archivos).\n2. Elija el entorno **FactosPerú API · Producción** (arriba a la derecha).\n3. En el entorno escriba su **api_token** en *Current value* (no en *Initial value*: así no se sincroniza ni se comparte).\n4. Ajuste **ruc** y **dni**. Para CPE, buzón, SUNAFIL y credenciales API complete también **usuario_sol** y **clave_sol**.\n5. Abra cualquier request y pulse **Send**. En *Examples* verá la respuesta esperada y los errores posibles; en *Test Results*, las comprobaciones automáticas.\n\n## Variables\n- `base_url`: URL base de producción: https://api.factosperu.com (sin / final).\n- `api_token`: Token Bearer de su cuenta (Panel → Token API). Se muestra una sola vez al generarlo.\n- `ruc`: RUC de 11 dígitos para las consultas.\n- `dni`: DNI de 8 dígitos.\n- `usuario_sol`: Usuario SOL del RUC (solo para CPE, buzón, SUNAFIL y credenciales API).\n- `clave_sol`: Clave SOL del RUC. No la guarde en colecciones compartidas.\n\n## Formato de respuesta\nTodas responden JSON: `success`, `code`, `retryable`, `data` (éxito) o `message` (error) y `time`. `retryable: true` indica que puede reintentar más tarde.\n\n## Consumo\nCada request consume las unidades indicadas en su descripción. Ejecutar la colección completa con el *Runner* consume unidades de su plan.\n\nManual completo: {{base_url}}/docs/postman · Referencia interactiva: {{base_url}}/docs/referencia",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "variable": [
        {
            "key": "base_url",
            "value": "https://api.factosperu.com",
            "type": "string",
            "description": "URL base de producción: https://api.factosperu.com (sin / final)."
        },
        {
            "key": "api_token",
            "value": "",
            "type": "string",
            "description": "Token Bearer de su cuenta (Panel → Token API). Se muestra una sola vez al generarlo."
        },
        {
            "key": "ruc",
            "value": "RUC_AUTORIZADO_11_DIGITOS",
            "type": "string",
            "description": "RUC de 11 dígitos para las consultas."
        },
        {
            "key": "dni",
            "value": "DNI_8_DIGITOS",
            "type": "string",
            "description": "DNI de 8 dígitos."
        },
        {
            "key": "usuario_sol",
            "value": "",
            "type": "string",
            "description": "Usuario SOL del RUC (solo para CPE, buzón, SUNAFIL y credenciales API)."
        },
        {
            "key": "clave_sol",
            "value": "",
            "type": "string",
            "description": "Clave SOL del RUC. No la guarde en colecciones compartidas."
        }
    ],
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "token",
                "value": "{{api_token}}",
                "type": "string"
            }
        ]
    },
    "item": [
        {
            "name": "1. Identidad",
            "item": [
                {
                    "name": "Consulta RUC",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/ruc",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "ruc"
                            ]
                        },
                        "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"ruc\": \"20123456789\",\n        \"nombre_o_razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\",\n        \"estado\": \"ACTIVO\",\n        \"condicion\": \"HABIDO\",\n        \"direccion\": \"AV. EJEMPLO 123 LIMA - LIMA - LIMA\",\n        \"departamento\": \"LIMA\",\n        \"tipo_contribuyente\": \"SOCIEDAD ANONIMA CERRADA\",\n        \"fecha_inscripcion\": \"01/01/2020\",\n        \"fecha_inicio_actividades\": \"01/01/2020\",\n        \"actividades_economicas\": [\n            \"Principal - 6201 - ACTIVIDADES DE PROGRAMACION INFORMATICA\"\n        ],\n        \"sistema_emision\": \"MANUAL/COMPUTARIZADO\",\n        \"sistema_contabilidad\": \"COMPUTARIZADO\",\n        \"es_agente_de_retencion\": \"NO\",\n        \"es_buen_contribuyente\": \"NO\"\n    },\n    \"source\": \"padron_reducido\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"El RUC no existe en SUNAT o SUNAT no respondió . Distinga ambos casos con `code` y `retryable`.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_ruc\",\n    \"retryable\": false,\n    \"message\": \"RUC inválido o campos faltantes.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc"
                                    ]
                                },
                                "description": "Consulta un RUC por un solo filtro: primero el Padrón Reducido oficial (`source: padron_reducido`, instantáneo; trae razón social, estado, condición y domicilio) y, si el RUC no está ahí o el padrón no está disponible, el portal público de SUNAT en línea (`source: sunat_en_linea`, ficha completa). Si la consulta en línea está desactivada, solo responde el padrón.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`) o SUNAT no respondió (`retryable: true`). Distinga ambos casos con `code` y `retryable`. · 422 RUC inválido (`invalid_ruc`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta RUC (ficha SUNAT)",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/ruc-sunat",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "ruc-sunat"
                            ]
                        },
                        "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc-sunat",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc-sunat"
                                    ]
                                },
                                "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"ruc\": \"20123456789\",\n        \"nombre_o_razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\",\n        \"estado\": \"ACTIVO\",\n        \"condicion\": \"HABIDO\",\n        \"direccion_completa\": \"AV. EJEMPLO 123 LIMA - LIMA - LIMA\",\n        \"tipo_contribuyente\": \"SOCIEDAD ANONIMA CERRADA\",\n        \"fecha_inscripcion\": \"01/01/2020\",\n        \"actividades_economicas\": [\n            \"Principal - 6201 - ACTIVIDADES DE PROGRAMACION INFORMATICA\"\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 400",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc-sunat",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc-sunat"
                                    ]
                                },
                                "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_input\",\n    \"retryable\": false,\n    \"message\": \"RUC inválido .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc-sunat",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc-sunat"
                                    ]
                                },
                                "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"document_not_found\",\n    \"retryable\": false,\n    \"message\": \"El RUC no existe .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc-sunat",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc-sunat"
                                    ]
                                },
                                "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"upstream_unavailable\",\n    \"retryable\": true,\n    \"message\": \"Servicio de consulta no disponible . Reintentar en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc-sunat",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc-sunat"
                                    ]
                                },
                                "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc-sunat",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc-sunat"
                                    ]
                                },
                                "description": "Consulta un RUC y devuelve la ficha con la dirección completa, tipo de contribuyente, fecha de inscripción y actividades económicas. Mismos datos que `/api/v1/ruc`, con el formato de respuesta publicado para integraciones tipo FactosPerú.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 400 RUC inválido (`invalid_input`, `retryable: false`). · 404 El RUC no existe (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta RUC por DNI",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/dni-ruc",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "dni-ruc"
                            ]
                        },
                        "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni-ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni-ruc"
                                    ]
                                },
                                "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"ruc\": \"10445566778\"\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 400",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni-ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni-ruc"
                                    ]
                                },
                                "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_input\",\n    \"retryable\": false,\n    \"message\": \"DNI inválido .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni-ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni-ruc"
                                    ]
                                },
                                "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"document_not_found\",\n    \"retryable\": false,\n    \"message\": \"El DNI no cuenta con RUC .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni-ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni-ruc"
                                    ]
                                },
                                "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"upstream_unavailable\",\n    \"retryable\": true,\n    \"message\": \"Servicio de consulta no disponible . Reintentar en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni-ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni-ruc"
                                    ]
                                },
                                "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni-ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni-ruc"
                                    ]
                                },
                                "description": "Devuelve el RUC asociado a un DNI. Si el DNI no tiene RUC, responde 404 `document_not_found`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 400 DNI inválido (`invalid_input`, `retryable: false`). · 404 El DNI no cuenta con RUC (`document_not_found`, `retryable: false`). · 503 Servicio de consulta no disponible (`upstream_unavailable`, `retryable: true`). Reintentar en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta DNI",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/dni",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "dni"
                            ]
                        },
                        "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"numero\": \"12345678\",\n        \"nombre_completo\": \"PEREZ LOPEZ ANA MARIA\",\n        \"nombres\": \"ANA MARIA\",\n        \"apellido_paterno\": \"PEREZ\",\n        \"apellido_materno\": \"LOPEZ\",\n        \"codigo_verificacion\": 0\n    },\n    \"source\": \"padron_reducido\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"No hay un contribuyente con ese DNI o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`).\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_dni\",\n    \"retryable\": false,\n    \"message\": \"DNI inválido o campos faltantes.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/dni",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "dni"
                                    ]
                                },
                                "description": "Consulta el nombre asociado a un DNI por un solo filtro: primero el Padrón Reducido por el RUC 10 de la persona (`source: padron_reducido`) y, si no está, el portal público de SUNAT en línea (`source: sunat_en_linea`). Solo se encuentran personas registradas como contribuyentes en SUNAT. La respuesta trae apellidos y nombres por separado.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 404 No hay un contribuyente con ese DNI (`not_found`, `retryable: false`) o el proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 422 DNI inválido (`invalid_dni`) o campos faltantes. · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"dni\": \"{{dni}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta por Carnet de Extranjería",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "carnet-extranjeria"
                            ]
                        },
                        "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"numero\": \"001234567\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"tipo_documento\": \"carnet-extranjeria\",\n        \"numero\": \"001234567\",\n        \"nombre_completo\": \"PEREZ LOPEZ ANA MARIA\",\n        \"nombres\": \"ANA MARIA\",\n        \"apellido_paterno\": \"PEREZ\",\n        \"apellido_materno\": \"LOPEZ\",\n        \"ruc\": \"15600000001\",\n        \"estado\": \"ACTIVO\",\n        \"ubicacion\": \"LIMA - LIMA - MIRAFLORES\"\n    },\n    \"source\": \"sunat_en_linea\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"No hay un contribuyente con ese documento .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_documento\",\n    \"retryable\": false,\n    \"message\": \"Número inválido o campo faltante.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"fuente_desactivada\",\n    \"retryable\": true,\n    \"message\": \"Consulta en línea desactivada o servicio no disponible ; reintentable.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/carnet-extranjeria",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "carnet-extranjeria"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"001234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta por Pasaporte",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/pasaporte",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "pasaporte"
                            ]
                        },
                        "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"numero\": \"X1234567\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"tipo_documento\": \"pasaporte\",\n        \"numero\": \"X1234567\",\n        \"nombre_completo\": \"PEREZ LOPEZ ANA MARIA\",\n        \"nombres\": \"ANA MARIA\",\n        \"apellido_paterno\": \"PEREZ\",\n        \"apellido_materno\": \"LOPEZ\",\n        \"ruc\": \"15600000001\",\n        \"estado\": \"ACTIVO\",\n        \"ubicacion\": \"LIMA - LIMA - MIRAFLORES\"\n    },\n    \"source\": \"sunat_en_linea\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"No hay un contribuyente con ese documento .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_documento\",\n    \"retryable\": false,\n    \"message\": \"Número inválido o campo faltante.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"fuente_desactivada\",\n    \"retryable\": true,\n    \"message\": \"Consulta en línea desactivada o servicio no disponible ; reintentable.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/pasaporte",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "pasaporte"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"X1234567\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta por Cédula Diplomática de Identidad",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "cedula-diplomatica"
                            ]
                        },
                        "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"numero\": \"123456\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"tipo_documento\": \"cedula-diplomatica\",\n        \"numero\": \"123456\",\n        \"nombre_completo\": \"PEREZ LOPEZ ANA MARIA\",\n        \"nombres\": \"ANA MARIA\",\n        \"apellido_paterno\": \"PEREZ\",\n        \"apellido_materno\": \"LOPEZ\",\n        \"ruc\": \"15600000001\",\n        \"estado\": \"ACTIVO\",\n        \"ubicacion\": \"LIMA - LIMA - MIRAFLORES\"\n    },\n    \"source\": \"sunat_en_linea\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"No hay un contribuyente con ese documento .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_documento\",\n    \"retryable\": false,\n    \"message\": \"Número inválido o campo faltante.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"fuente_desactivada\",\n    \"retryable\": true,\n    \"message\": \"Consulta en línea desactivada o servicio no disponible ; reintentable.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cedula-diplomatica",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cedula-diplomatica"
                                    ]
                                },
                                "description": "Busca en el portal público de SUNAT al contribuyente registrado con ese documento: nombre, RUC, estado y ubicación. Solo se encuentran personas inscritas en SUNAT. Si la consulta en línea está desactivada responde 503 `fuente_desactivada`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `numero`.\n\n**Errores:** 404 No hay un contribuyente con ese documento (`not_found`, `retryable: false`). · 422 Número inválido (`invalid_documento`) o campo faltante. · 502 Error del proveedor (`proveedor_error`, reintentable). · 503 Consulta en línea desactivada (`fuente_desactivada`) o servicio no disponible (`no_disponible`, `servicio_no_disponible`); reintentable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"numero\": \"123456\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Búsqueda por razón social en línea",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/razon-social",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "razon-social"
                            ]
                        },
                        "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"resultados\": [\n            {\n                \"ruc\": \"20123456789\",\n                \"razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\"\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"Sin coincidencias .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo razon_social es obligatorio.\",\n    \"errors\": {\n        \"razon_social\": [\n            \"El campo razon_social es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`).\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/razon-social",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "razon-social"
                                    ]
                                },
                                "description": "Busca contribuyentes por nombre o razón social en el portal público de SUNAT. Para una búsqueda sin navegador, usar `/api/v1/padron/buscar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `razon_social`.\n\n**Errores:** 404 Sin coincidencias (`not_found`). · 422 Texto ausente, menor de 3 caracteres o mayor de 120. · 502 El proveedor no pudo completar la consulta (código del proveedor, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"razon_social\": \"EMPRESA DEMOSTRACION\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "2. Consultas por GET",
            "item": [
                {
                    "name": "Consulta DNI por GET",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/dni/{dni}",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "dni",
                                "{dni}"
                            ]
                        },
                        "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/dni/{dni}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "dni",
                                        "{dni}"
                                    ]
                                },
                                "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"numero\": \"44556677\",\n        \"nombre_completo\": \"PEREZ GARCIA JUAN CARLOS\",\n        \"nombres\": \"JUAN CARLOS\",\n        \"apellido_paterno\": \"PEREZ\",\n        \"apellido_materno\": \"GARCIA\",\n        \"codigo_verificacion\": 3\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/dni/{dni}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "dni",
                                        "{dni}"
                                    ]
                                },
                                "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"No hay un contribuyente registrado en SUNAT con ese DNI .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/dni/{dni}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "dni",
                                        "{dni}"
                                    ]
                                },
                                "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_dni\",\n    \"retryable\": false,\n    \"message\": \"DNI inválido: debe tener 8 dígitos .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/dni/{dni}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "dni",
                                        "{dni}"
                                    ]
                                },
                                "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"Servicio no disponible . Reintentar en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/dni/{dni}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "dni",
                                        "{dni}"
                                    ]
                                },
                                "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/dni/{dni}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "dni",
                                        "{dni}"
                                    ]
                                },
                                "description": "Consulta los datos de una persona por su DNI. Es la misma consulta que `POST /api/v1/dni`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `numero`, `nombre_completo`, `nombres`, `apellido_paterno`, `apellido_materno` y `codigo_verificacion`.\n\n**Campos adicionales:** `direccion` (texto vacío `\"\"` si el proveedor no la entrega) y `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato).\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `dni`.\n\n**Errores:** 422 DNI inválido: debe tener 8 dígitos (`invalid_dni`, `retryable: false`). · 404 No hay un contribuyente registrado en SUNAT con ese DNI (`not_found`, `retryable: false`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta RUC por GET",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/ruc/{{ruc}}",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "ruc",
                                "{{ruc}}"
                            ]
                        },
                        "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"ruc\": \"20123456789\",\n        \"nombre_o_razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\",\n        \"estado\": \"ACTIVO\",\n        \"condicion\": \"HABIDO\",\n        \"direccion\": \"AV. EJEMPLO 123 LIMA - LIMA - LIMA\",\n        \"departamento\": \"LIMA\",\n        \"es_agente_de_retencion\": \"NO\"\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"El RUC no existe en SUNAT .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"invalid_ruc\",\n    \"retryable\": false,\n    \"message\": \"RUC inválido: debe tener 11 dígitos .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"Servicio no disponible . Reintentar en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/ruc/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "ruc",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Consulta la ficha de un RUC. Es la misma consulta que `POST /api/v1/ruc`, pero por GET y con un formato de respuesta alterno.\n\n**Campos que devuelve en `data`:** `ruc`, `nombre_o_razon_social`, `estado`, `condicion`, `direccion`, `departamento`, `tipo_contribuyente`, `fecha_inscripcion`, `fecha_inicio_actividades`, `actividades_economicas`, `sistema_emision`, `sistema_contabilidad`, `es_agente_de_retencion` (`SI`/`NO`) y `es_buen_contribuyente`.\n\n**Campos adicionales:** `ubigeo` (`[departamento, provincia, distrito]` como códigos, o `null` si no hay dato). `direccion` vale `\"\"` si no hay dato. El campo `source` va en el nivel superior de la respuesta, junto a `success`.\n\n**Consumo:** 1 unidad por solicitud.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 422 RUC inválido: debe tener 11 dígitos (`invalid_ruc`, `retryable: false`). · 404 El RUC no existe en SUNAT (`not_found`, `retryable: false`). · 502 Error del proveedor (`proveedor_error`, `retryable: true`). · 503 Servicio no disponible (`servicio_no_disponible`, `retryable: true`). Reintentar en unos segundos."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "3. Comprobantes",
            "item": [
                {
                    "name": "Consulta y descarga de CPE",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/cpe",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "cpe"
                            ]
                        },
                        "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"total\": 1,\n        \"exitosos\": 1,\n        \"fallidos\": 0,\n        \"comprobantes\": [\n            {\n                \"id\": \"1\",\n                \"estado\": \"ok\",\n                \"tipo\": \"01\",\n                \"serie\": \"F001\",\n                \"numero\": \"123\",\n                \"fecha_emision\": \"FECHA_DE_EMISION\",\n                \"total\": \"MONTO\",\n                \"moneda\": \"PEN\",\n                \"estado_cpe\": \"CODIGO_PROVEEDOR\",\n                \"emisor\": {\n                    \"ruc\": \"20123456789\",\n                    \"razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\",\n                    \"direccion\": \"AV. EJEMPLO 123\"\n                },\n                \"receptor\": {\n                    \"documento\": \"20987654321\",\n                    \"razon_social\": \"CLIENTE DEMOSTRACION S.A.\"\n                },\n                \"items\": [],\n                \"archivos\": {\n                    \"pdf\": {\n                        \"ok\": true,\n                        \"nombre\": \"F001-123.pdf\",\n                        \"es_zip\": false,\n                        \"contenido_base64\": \"BASE64\",\n                        \"tamano_kb\": 12.5\n                    },\n                    \"xml\": {\n                        \"ok\": false,\n                        \"error\": \"No disponible\"\n                    },\n                    \"cdr\": {\n                        \"ok\": false,\n                        \"error\": \"No disponible\"\n                    }\n                }\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 500",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"cpe_error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor informó un error global .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "cpe"
                                    ]
                                },
                                "description": "Consulta comprobantes electrónicos con la Clave SOL del RUC y devuelve sus archivos PDF, XML y CDR en Base64.\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos (RUC no numérico, lote vacío o mayor a 100). · 500 El proveedor informó un error global (`cpe_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo_consulta\": \"emitido\",\n            \"ruc_emisor\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Consulta CPE de un RUC excluido",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/ruc/excluido",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "ruc",
                                "excluido"
                            ]
                        },
                        "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"provider\": \"bcp_sovos\",\n        \"datos\": {\n            \"ruc\": \"20123456789\",\n            \"tipo\": \"01\",\n            \"folio\": \"FA02-0000000\",\n            \"fecha\": \"2026-10-08\",\n            \"total\": \"0.00\"\n        },\n        \"archivos\": {\n            \"pdf\": {\n                \"base64\": \"BASE64_PDF\",\n                \"mime\": \"application/pdf\",\n                \"size\": 12345\n            },\n            \"xml\": {\n                \"base64\": \"BASE64_XML\",\n                \"mime\": \"application/xml\",\n                \"size\": 6789\n            },\n            \"cdr\": null\n        },\n        \"documento\": {\n            \"estado\": \"document.authorized\",\n            \"estado_descripcion\": \"Authorized\",\n            \"emisor\": \"BANCO DE CREDITO DEL PERU\",\n            \"receptor\": \"EMPRESA DEMO SAC\"\n        },\n        \"fuente\": \"en_linea\"\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"El comprobante no existe en el proveedor : revise RUC, tipo, serie-número, fecha y total.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor alternativo no pudo completar la consulta o excedió el tiempo de espera ; ambos reintentables.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El proveedor alternativo no está habilitado .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/excluido",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "excluido"
                                    ]
                                },
                                "description": "Consulta un comprobante en el proveedor alternativo configurado para RUC excluidos (portal público de Sovos, p. ej. BCP). Entrega PDF y XML; el CDR se devuelve como null porque la fuente no lo proporciona. `documento` trae el estado en el proveedor, emisor y receptor; `fuente` indica `en_linea` o `cache` (un comprobante ya consultado se responde desde la caché sin volver al proveedor).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `tipo`, `folio`, `fecha`, `total`.\n\n**Errores:** 404 El comprobante no existe en el proveedor (`not_found`, `retryable: false`): revise RUC, tipo, serie-número, fecha y total. · 422 Campos inválidos. · 502 El proveedor alternativo no pudo completar la consulta (`proveedor_error`) o excedió el tiempo de espera (`timeout`); ambos reintentables. · 503 El proveedor alternativo no está habilitado (`proveedor_no_disponible`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"tipo\": \"01\",\n    \"folio\": \"FA02-0000000\",\n    \"fecha\": \"2026-10-08\",\n    \"total\": \"0.00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Validación múltiple de CPE",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "validacion-multiple-cpe"
                            ]
                        },
                        "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"total\": 1,\n        \"exitosos\": 1,\n        \"fallidos\": 0,\n        \"comprobantes\": [\n            {\n                \"tipo\": \"01\",\n                \"serie\": \"F001\",\n                \"numero\": \"123\",\n                \"fecha\": \"FECHA_DE_EMISION\",\n                \"monto\": \"MONTO_DEL_COMPROBANTE\",\n                \"exito\": true,\n                \"estado_comprobante\": \"ESTADO_INFORMADO_POR_SUNAT\",\n                \"estado_contribuyente\": \"ACTIVO\",\n                \"condicion_domicilio\": \"HABIDO\",\n                \"observaciones\": \"\",\n                \"error\": null,\n                \"intentos\": 1\n            }\n        ],\n        \"tiempo_ms\": 1500\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 500",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"validacion_error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor informó un error global .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/validacion-multiple-cpe",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "validacion-multiple-cpe"
                                    ]
                                },
                                "description": "Consulta el estado de varios comprobantes en SUNAT con la Clave SOL del RUC (estado del comprobante, del contribuyente y condición de domicilio).\n\n**Consumo:** 1 por comprobante del lote (máximo 100).\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `comprobantes`.\n\n**Errores:** 422 Campos superiores inválidos. · 500 El proveedor informó un error global (`validacion_error`, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"comprobantes\": [\n        {\n            \"tipo\": \"01\",\n            \"serie\": \"F001\",\n            \"numero\": \"123\",\n            \"fecha\": \"FECHA_DE_EMISION\",\n            \"monto\": \"MONTO_DEL_COMPROBANTE\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "4. Buzón SOL",
            "item": [
                {
                    "name": "Consulta del buzón electrónico",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/buzon",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "buzon"
                            ]
                        },
                        "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"timestamp\": \"2026-10-10T12:00:00-05:00\",\n        \"buzon_notificaciones\": {\n            \"nombre\": \"\",\n            \"contador\": 0,\n            \"mensajes\": []\n        },\n        \"buzon_mensajes\": {\n            \"nombre\": \"\",\n            \"contador\": 0,\n            \"mensajes\": []\n        },\n        \"mis_carpetas\": [],\n        \"mis_etiquetas\": [],\n        \"todos_los_mensajes\": [],\n        \"detalles_mensajes\": [],\n        \"ajax_notificaciones\": [],\n        \"ajax_mensajes\": [],\n        \"resumen\": {\n            \"total_mensajes\": 0,\n            \"total_detalles\": 0,\n            \"total_carpetas\": 0,\n            \"total_etiquetas\": 0,\n            \"ajax_noti\": 0,\n            \"ajax_msj\": 0\n        }\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 500",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"buzon_error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor informó un error .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/buzon",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "buzon"
                                    ]
                                },
                                "description": "Extrae notificaciones y mensajes del buzón SOL del RUC, con sus detalles y adjuntos.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`buzon_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"omitir_detalle\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "5. Casilla SUNAFIL",
            "item": [
                {
                    "name": "Consulta de la casilla electrónica SUNAFIL",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/sunafil/casilla",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "sunafil",
                                "casilla"
                            ]
                        },
                        "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"total\": 0,\n        \"categorias\": [\n            {\n                \"nombre\": \"Orientación\",\n                \"total\": 0,\n                \"registros\": []\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 500",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"sunafil_error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor informó un error .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/casilla",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "casilla"
                                    ]
                                },
                                "description": "Lee las categorías de la casilla electrónica SUNAFIL del RUC (notificaciones, acciones previas, orientación) con las credenciales SOL.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Descarga de documento SUNAFIL (en memoria)",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/sunafil/documento",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "sunafil",
                                "documento"
                            ]
                        },
                        "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"documentos\": [\n            {\n                \"nombre\": \"CONSTANCIA_DEPOSITO_EJEMPLO.pdf\",\n                \"bytes\": 25580,\n                \"sha256\": \"0000000000000000000000000000000000000000000000000000000000000000\",\n                \"pdf_base64\": \"JVBERi0x\"\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"documento_no_disponible\",\n    \"retryable\": false,\n    \"message\": \"No existe documento en esa posición .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 500",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"sunafil_error\",\n    \"retryable\": true,\n    \"message\": \"El proveedor informó un error .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_error\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no pudo completar la solicitud .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El servicio de consultas no está disponible . Reintente en unos segundos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sunafil/documento",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sunafil",
                                        "documento"
                                    ]
                                },
                                "description": "Devuelve en base64 los PDF de una fila de Acciones Previas (constancia de depósito y acuse). Cada uno trae su nombre y su huella SHA-256; el servicio no los almacena.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `indice`.\n\n**Errores:** 404 No existe documento en esa posición (`documento_no_disponible`). · 422 Campos inválidos. · 500 El proveedor informó un error (`sunafil_error` u otro código, reintentable). · 502 El servicio de consultas no pudo completar la solicitud (`servicio_error`, `retryable: true`). · 503 El servicio de consultas no está disponible (`servicio_no_disponible`, `retryable: true`). Reintente en unos segundos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"indice\": 0\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "6. Credenciales API SUNAT",
            "item": [
                {
                    "name": "Extraer credenciales de API SUNAT",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/credenciales-api",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "credenciales-api"
                            ]
                        },
                        "description": "Abre «Gestión Credenciales de API SUNAT» del menú SOL y devuelve la aplicación registrada (ID y clave de la aplicación, alcance y APIs habilitadas) y el catálogo de APIs que se pueden elegir. Si el RUC no tiene aplicación, `tiene_aplicacion` es false: use `/credenciales-api/crear`. No cambia nada en SUNAT. Guarde la clave cifrada; esta API no la registra.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api"
                                    ]
                                },
                                "description": "Abre «Gestión Credenciales de API SUNAT» del menú SOL y devuelve la aplicación registrada (ID y clave de la aplicación, alcance y APIs habilitadas) y el catálogo de APIs que se pueden elegir. Si el RUC no tiene aplicación, `tiene_aplicacion` es false: use `/credenciales-api/crear`. No cambia nada en SUNAT. Guarde la clave cifrada; esta API no la registra.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"tiene_aplicacion\": true,\n        \"aplicacion\": {\n            \"id\": \"ID_INTERNO_SUNAT\",\n            \"codigo_aplicacion\": \"2020000000\",\n            \"nombre\": \"mi-sistema\",\n            \"url\": \"https://mi-sistema.pe\",\n            \"alcance\": \"desktop\",\n            \"client_id\": \"CLIENT_ID_EJEMPLO\",\n            \"client_secret\": \"CLIENT_SECRET_EJEMPLO\",\n            \"recursos\": [\n                {\n                    \"recurso\": \"/v1/contribuyente/gem\",\n                    \"nombre\": \"GRE Emision de Comprobantes\"\n                }\n            ]\n        },\n        \"catalogo\": [\n            {\n                \"codigo\": \"2\",\n                \"nombre\": \"MIGE RCE y RVIE - SIRE\",\n                \"recurso\": \"/v1/contribuyente/migeigv\",\n                \"url_api\": \"https://api-sire.sunat.gob.pe\"\n            },\n            {\n                \"codigo\": \"3\",\n                \"nombre\": \"GRE Emision de Comprobantes\",\n                \"recurso\": \"/v1/contribuyente/gem\",\n                \"url_api\": \"https://api-cpe.sunat.gob.pe\"\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api"
                                    ]
                                },
                                "description": "Abre «Gestión Credenciales de API SUNAT» del menú SOL y devuelve la aplicación registrada (ID y clave de la aplicación, alcance y APIs habilitadas) y el catálogo de APIs que se pueden elegir. Si el RUC no tiene aplicación, `tiene_aplicacion` es false: use `/credenciales-api/crear`. No cambia nada en SUNAT. Guarde la clave cifrada; esta API no la registra.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api"
                                    ]
                                },
                                "description": "Abre «Gestión Credenciales de API SUNAT» del menú SOL y devuelve la aplicación registrada (ID y clave de la aplicación, alcance y APIs habilitadas) y el catálogo de APIs que se pueden elegir. Si el RUC no tiene aplicación, `tiene_aplicacion` es false: use `/credenciales-api/crear`. No cambia nada en SUNAT. Guarde la clave cifrada; esta API no la registra.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"No se pudo iniciar sesión o abrir la gestión de credenciales .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api"
                                    ]
                                },
                                "description": "Abre «Gestión Credenciales de API SUNAT» del menú SOL y devuelve la aplicación registrada (ID y clave de la aplicación, alcance y APIs habilitadas) y el catálogo de APIs que se pueden elegir. Si el RUC no tiene aplicación, `tiene_aplicacion` es false: use `/credenciales-api/crear`. No cambia nada en SUNAT. Guarde la clave cifrada; esta API no la registra.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api"
                                    ]
                                },
                                "description": "Abre «Gestión Credenciales de API SUNAT» del menú SOL y devuelve la aplicación registrada (ID y clave de la aplicación, alcance y APIs habilitadas) y el catálogo de APIs que se pueden elegir. Si el RUC no tiene aplicación, `tiene_aplicacion` es false: use `/credenciales-api/crear`. No cambia nada en SUNAT. Guarde la clave cifrada; esta API no la registra.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`.\n\n**Errores:** 422 Campos inválidos. · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Crear aplicación y generar credenciales de API SUNAT",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 201', function () { pm.response.to.have.status(201); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "credenciales-api",
                                "crear"
                            ]
                        },
                        "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Created",
                            "code": 201,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"created\",\n    \"retryable\": false,\n    \"data\": {\n        \"tiene_aplicacion\": true,\n        \"aplicacion\": {\n            \"id\": \"ID_INTERNO_SUNAT\",\n            \"codigo_aplicacion\": \"2020000000\",\n            \"nombre\": \"mi-sistema\",\n            \"url\": \"https://mi-sistema.pe\",\n            \"alcance\": \"desktop\",\n            \"client_id\": \"CLIENT_ID_EJEMPLO\",\n            \"client_secret\": \"CLIENT_SECRET_EJEMPLO\",\n            \"recursos\": [\n                {\n                    \"recurso\": \"/v1/contribuyente/gem\",\n                    \"nombre\": \"GRE Emision de Comprobantes\"\n                }\n            ]\n        },\n        \"catalogo\": [\n            {\n                \"codigo\": \"2\",\n                \"nombre\": \"MIGE RCE y RVIE - SIRE\",\n                \"recurso\": \"/v1/contribuyente/migeigv\",\n                \"url_api\": \"https://api-sire.sunat.gob.pe\"\n            },\n            {\n                \"codigo\": \"3\",\n                \"nombre\": \"GRE Emision de Comprobantes\",\n                \"recurso\": \"/v1/contribuyente/gem\",\n                \"url_api\": \"https://api-cpe.sunat.gob.pe\"\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 409",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Conflict",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"aplicacion_existente\",\n    \"retryable\": false,\n    \"message\": \"El RUC ya tiene una aplicación registrada .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"datos_invalidos\",\n    \"retryable\": false,\n    \"message\": \"Campos inválidos o APIs fuera del catálogo .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"sunat_rechazo\",\n    \"retryable\": true,\n    \"message\": \"SUNAT no aceptó los datos .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"No se pudo iniciar sesión o abrir la gestión de credenciales .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/crear",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "crear"
                                    ]
                                },
                                "description": "Registra la aplicación del RUC en «Gestión Credenciales de API SUNAT». Por defecto marca todas las APIs del catálogo y alcance `desktop` (como en la pantalla); envíe `recursos` solo para limitar la selección. SUNAT genera el ID y la clave, que se devuelven en la respuesta. Cambia la cuenta SOL: SUNAT permite una aplicación por RUC; si ya existe responde 409 y se usa `/credenciales-api/editar`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`.\n\n**Errores:** 409 El RUC ya tiene una aplicación registrada (`aplicacion_existente`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Editar aplicación de API SUNAT",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "credenciales-api",
                                "editar"
                            ]
                        },
                        "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"updated\",\n    \"retryable\": false,\n    \"data\": {\n        \"tiene_aplicacion\": true,\n        \"aplicacion\": {\n            \"id\": \"ID_INTERNO_SUNAT\",\n            \"codigo_aplicacion\": \"2020000000\",\n            \"nombre\": \"mi-sistema\",\n            \"url\": \"https://mi-sistema.pe\",\n            \"alcance\": \"desktop\",\n            \"client_id\": \"CLIENT_ID_EJEMPLO\",\n            \"client_secret\": \"CLIENT_SECRET_EJEMPLO\",\n            \"recursos\": [\n                {\n                    \"recurso\": \"/v1/contribuyente/gem\",\n                    \"nombre\": \"GRE Emision de Comprobantes\"\n                }\n            ]\n        },\n        \"catalogo\": [\n            {\n                \"codigo\": \"2\",\n                \"nombre\": \"MIGE RCE y RVIE - SIRE\",\n                \"recurso\": \"/v1/contribuyente/migeigv\",\n                \"url_api\": \"https://api-sire.sunat.gob.pe\"\n            },\n            {\n                \"codigo\": \"3\",\n                \"nombre\": \"GRE Emision de Comprobantes\",\n                \"recurso\": \"/v1/contribuyente/gem\",\n                \"url_api\": \"https://api-cpe.sunat.gob.pe\"\n            }\n        ]\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"sin_aplicacion\",\n    \"retryable\": false,\n    \"message\": \"El RUC no tiene aplicación registrada .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"datos_invalidos\",\n    \"retryable\": false,\n    \"message\": \"Campos inválidos o APIs fuera del catálogo .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"sunat_rechazo\",\n    \"retryable\": true,\n    \"message\": \"SUNAT no aceptó los datos .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"servicio_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"No se pudo iniciar sesión o abrir la gestión de credenciales .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/credenciales-api/editar",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "credenciales-api",
                                        "editar"
                                    ]
                                },
                                "description": "Cambia nombre, URL, alcance o APIs habilitadas de la aplicación ya registrada. Envíe la lista completa de `recursos` que deben quedar. Cambia la cuenta SOL; si el RUC no tiene aplicación responde 404.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `nombre`, `url`, `recursos`.\n\n**Errores:** 404 El RUC no tiene aplicación registrada (`sin_aplicacion`). · 422 Campos inválidos o APIs fuera del catálogo (`datos_invalidos`). · 502 SUNAT no aceptó los datos (`sunat_rechazo`). · 503 No se pudo iniciar sesión o abrir la gestión de credenciales (`servicio_no_disponible`, reintentable).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"nombre\": \"mi-sistema\",\n    \"url\": \"https://mi-sistema.pe\",\n    \"alcance\": \"desktop\",\n    \"recursos\": [\n        []\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "7. SIRE",
            "item": [
                {
                    "name": "Obtener token de pantalla SIRE",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/sire/token",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "sire",
                                "token"
                            ]
                        },
                        "description": "Obtiene el token de Ventas o Compras mediante SOL. No presenta libros. No se garantiza equivalencia con el token OAuth de la API pública SIRE. La respuesta no debe almacenarse ni registrarse.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `libro`.\n\n**Errores:** 422 Campos inválidos. · 503 Token no disponible; error genérico sin secretos.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"libro\": \"ventas\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sire/token",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sire",
                                        "token"
                                    ]
                                },
                                "description": "Obtiene el token de Ventas o Compras mediante SOL. No presenta libros. No se garantiza equivalencia con el token OAuth de la API pública SIRE. La respuesta no debe almacenarse ni registrarse.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `libro`.\n\n**Errores:** 422 Campos inválidos. · 503 Token no disponible; error genérico sin secretos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"libro\": \"ventas\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"access_token\": \"TOKEN_FICTICIO\",\n        \"token_type\": \"Bearer\",\n        \"libro\": \"ventas\",\n        \"menu\": \"60.2.1.1.1\",\n        \"origen\": \"menu_sol\"\n    },\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sire/token",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sire",
                                        "token"
                                    ]
                                },
                                "description": "Obtiene el token de Ventas o Compras mediante SOL. No presenta libros. No se garantiza equivalencia con el token OAuth de la API pública SIRE. La respuesta no debe almacenarse ni registrarse.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `libro`.\n\n**Errores:** 422 Campos inválidos. · 503 Token no disponible; error genérico sin secretos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"libro\": \"ventas\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sire/token",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sire",
                                        "token"
                                    ]
                                },
                                "description": "Obtiene el token de Ventas o Compras mediante SOL. No presenta libros. No se garantiza equivalencia con el token OAuth de la API pública SIRE. La respuesta no debe almacenarse ni registrarse.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `libro`.\n\n**Errores:** 422 Campos inválidos. · 503 Token no disponible; error genérico sin secretos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"libro\": \"ventas\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"error\",\n    \"retryable\": true,\n    \"message\": \"Token no disponible; error genérico sin secretos.\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sire/token",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sire",
                                        "token"
                                    ]
                                },
                                "description": "Obtiene el token de Ventas o Compras mediante SOL. No presenta libros. No se garantiza equivalencia con el token OAuth de la API pública SIRE. La respuesta no debe almacenarse ni registrarse.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `libro`.\n\n**Errores:** 422 Campos inválidos. · 503 Token no disponible; error genérico sin secretos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"libro\": \"ventas\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/sire/token",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "sire",
                                        "token"
                                    ]
                                },
                                "description": "Obtiene el token de Ventas o Compras mediante SOL. No presenta libros. No se garantiza equivalencia con el token OAuth de la API pública SIRE. La respuesta no debe almacenarse ni registrarse.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`, `usuario_sol`, `clave_sol`, `libro`.\n\n**Errores:** 422 Campos inválidos. · 503 Token no disponible; error genérico sin secretos.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\",\n    \"usuario_sol\": \"{{usuario_sol}}\",\n    \"clave_sol\": \"{{clave_sol}}\",\n    \"libro\": \"ventas\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "8. Padrón y datos públicos",
            "item": [
                {
                    "name": "Consulta RUC en el Padrón Reducido",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/padron/ruc",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "padron",
                                "ruc"
                            ]
                        },
                        "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"ruc\": \"20123456789\",\n        \"nombre_razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\",\n        \"estado\": \"ACTIVO\",\n        \"condicion\": \"HABIDO\",\n        \"ubigeo\": \"150101\",\n        \"domicilio_fiscal\": \"AV. EJEMPLO 123\",\n        \"updated_at\": \"2026-10-01T00:00:00+00:00\"\n    },\n    \"source\": \"sunat_padron_reducido\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"Registro no encontrado en la fuente local .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/ruc",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "ruc"
                                    ]
                                },
                                "description": "Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"ruc\": \"{{ruc}}\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Búsqueda por razón social",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "padron",
                                "buscar"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "DEMOSTRACION",
                                    "disabled": false,
                                    "description": "Texto de la razón social."
                                },
                                {
                                    "key": "limit",
                                    "value": "20",
                                    "disabled": true,
                                    "description": "Máximo de resultados."
                                }
                            ]
                        },
                        "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "buscar"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "DEMOSTRACION",
                                            "disabled": false,
                                            "description": "Texto de la razón social."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "20",
                                            "disabled": true,
                                            "description": "Máximo de resultados."
                                        }
                                    ]
                                },
                                "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": [\n        {\n            \"ruc\": \"20123456789\",\n            \"nombre_razon_social\": \"EMPRESA DEMOSTRACION S.A.C.\",\n            \"estado\": \"ACTIVO\",\n            \"condicion\": \"HABIDO\",\n            \"ubigeo\": \"150101\",\n            \"domicilio_fiscal\": \"AV. EJEMPLO 123\",\n            \"updated_at\": \"2026-10-01T00:00:00+00:00\"\n        }\n    ],\n    \"source\": \"sunat_padron_reducido\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "buscar"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "DEMOSTRACION",
                                            "disabled": false,
                                            "description": "Texto de la razón social."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "20",
                                            "disabled": true,
                                            "description": "Máximo de resultados."
                                        }
                                    ]
                                },
                                "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo q es obligatorio.\",\n    \"errors\": {\n        \"q\": [\n            \"El campo q es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "buscar"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "DEMOSTRACION",
                                            "disabled": false,
                                            "description": "Texto de la razón social."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "20",
                                            "disabled": true,
                                            "description": "Máximo de resultados."
                                        }
                                    ]
                                },
                                "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "buscar"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "DEMOSTRACION",
                                            "disabled": false,
                                            "description": "Texto de la razón social."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "20",
                                            "disabled": true,
                                            "description": "Máximo de resultados."
                                        }
                                    ]
                                },
                                "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "buscar"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "DEMOSTRACION",
                                            "disabled": false,
                                            "description": "Texto de la razón social."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "20",
                                            "disabled": true,
                                            "description": "Máximo de resultados."
                                        }
                                    ]
                                },
                                "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/padron/buscar?q=DEMOSTRACION",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "padron",
                                        "buscar"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "DEMOSTRACION",
                                            "disabled": false,
                                            "description": "Texto de la razón social."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "20",
                                            "disabled": true,
                                            "description": "Máximo de resultados."
                                        }
                                    ]
                                },
                                "description": "Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `q`.\n\n**Errores:** 422 Texto de búsqueda ausente o fuera de rango. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Establecimientos anexos de un RUC",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "ruc",
                                "{{ruc}}",
                                "establecimientos"
                            ]
                        },
                        "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": [\n        {\n            \"ruc\": \"20123456789\",\n            \"codigo\": \"0001\",\n            \"tipo\": \"SUCURSAL\",\n            \"direccion\": \"AV. EJEMPLO 456\"\n        }\n    ],\n    \"source\": \"sunat_establecimientos\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"Registro no encontrado en la fuente local .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ruc/{{ruc}}/establecimientos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ruc",
                                        "{{ruc}}",
                                        "establecimientos"
                                    ]
                                },
                                "description": "Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Sujeto sin capacidad operativa (SSCO)",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "ssco",
                                "{{ruc}}"
                            ]
                        },
                        "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"RUC\": \"20123456789\",\n        \"RAZON SOCIAL\": \"EMPRESA DEMOSTRACION S.A.C.\"\n    },\n    \"source\": \"ssco\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"Registro no encontrado en la fuente local .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo ruc es obligatorio.\",\n    \"errors\": {\n        \"ruc\": [\n            \"El campo ruc es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ssco/{{ruc}}",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ssco",
                                        "{{ruc}}"
                                    ]
                                },
                                "description": "Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `ruc`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 RUC inválido."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Ubigeos (INEI)",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/ubigeos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "ubigeos"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "LIMA",
                                    "disabled": true,
                                    "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                },
                                {
                                    "key": "limit",
                                    "value": "50",
                                    "disabled": true,
                                    "description": "Máximo de registros."
                                }
                            ]
                        },
                        "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ubigeos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ubigeos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": [\n        {\n            \"ubigeo\": \"150101\",\n            \"departamento\": \"LIMA\",\n            \"provincia\": \"LIMA\",\n            \"distrito\": \"LIMA\"\n        }\n    ],\n    \"source\": \"ubigeos\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ubigeos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ubigeos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo campo es obligatorio.\",\n    \"errors\": {\n        \"campo\": [\n            \"El campo campo es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ubigeos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ubigeos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ubigeos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ubigeos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ubigeos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ubigeos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/ubigeos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "ubigeos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca códigos de ubigeo en el dataset oficial importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Puertos (MTC)",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/puertos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "puertos"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "LIMA",
                                    "disabled": true,
                                    "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                },
                                {
                                    "key": "limit",
                                    "value": "50",
                                    "disabled": true,
                                    "description": "Máximo de registros."
                                }
                            ]
                        },
                        "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/puertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "puertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": [\n        {\n            \"codigo\": \"PECLL\",\n            \"nombre\": \"CALLAO\"\n        }\n    ],\n    \"source\": \"puertos\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/puertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "puertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo campo es obligatorio.\",\n    \"errors\": {\n        \"campo\": [\n            \"El campo campo es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/puertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "puertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/puertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "puertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/puertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "puertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/puertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "puertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca puertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Aeropuertos (MTC)",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/aeropuertos",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "aeropuertos"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "LIMA",
                                    "disabled": true,
                                    "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                },
                                {
                                    "key": "limit",
                                    "value": "50",
                                    "disabled": true,
                                    "description": "Máximo de registros."
                                }
                            ]
                        },
                        "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/aeropuertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "aeropuertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": [\n        {\n            \"iata\": \"LIM\",\n            \"nombre\": \"JORGE CHAVEZ\"\n        }\n    ],\n    \"source\": \"aeropuertos\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/aeropuertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "aeropuertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo campo es obligatorio.\",\n    \"errors\": {\n        \"campo\": [\n            \"El campo campo es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/aeropuertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "aeropuertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/aeropuertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "aeropuertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/aeropuertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "aeropuertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/aeropuertos",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "aeropuertos"
                                    ],
                                    "query": [
                                        {
                                            "key": "q",
                                            "value": "LIMA",
                                            "disabled": true,
                                            "description": "Texto a buscar en el registro. Vacío devuelve los primeros registros."
                                        },
                                        {
                                            "key": "limit",
                                            "value": "50",
                                            "disabled": true,
                                            "description": "Máximo de registros."
                                        }
                                    ]
                                },
                                "description": "Busca aeropuertos en el dataset oficial del MTC importado en el servicio.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 422 Parámetros inválidos. · 502 Error del proveedor (`proveedor_error`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`)."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Tipo de cambio",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "tipo-cambio"
                            ],
                            "query": [
                                {
                                    "key": "fecha",
                                    "value": "2026-10-09",
                                    "disabled": false,
                                    "description": "Fecha en formato AAAA-MM-DD."
                                },
                                {
                                    "key": "moneda",
                                    "value": "USD",
                                    "disabled": true,
                                    "description": "Código ISO de la moneda."
                                }
                            ]
                        },
                        "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"fecha\": \"2026-10-09\",\n        \"moneda\": \"USD\",\n        \"compra\": \"VALOR\",\n        \"venta\": \"VALOR\"\n    },\n    \"source\": \"tipo_cambio\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"Registro no encontrado en la fuente local .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo fecha es obligatorio.\",\n    \"errors\": {\n        \"fecha\": [\n            \"El campo fecha es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio?fecha=2026-10-09",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio"
                                    ],
                                    "query": [
                                        {
                                            "key": "fecha",
                                            "value": "2026-10-09",
                                            "disabled": false,
                                            "description": "Fecha en formato AAAA-MM-DD."
                                        },
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** `fecha`.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Fecha o moneda inválida."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                },
                {
                    "name": "Tipo de cambio actual",
                    "event": [
                        {
                            "listen": "test",
                            "script": {
                                "type": "text/javascript",
                                "exec": [
                                    "pm.test('HTTP 200', function () { pm.response.to.have.status(200); });",
                                    "pm.test('Respuesta JSON con success', function () {",
                                    "    const json = pm.response.json();",
                                    "    pm.expect(json).to.have.property('success');",
                                    "    if (json.success) {",
                                    "        pm.expect(json).to.have.property('data');",
                                    "    }",
                                    "});",
                                    "if (pm.response.code >= 400) {",
                                    "    const json = pm.response.json();",
                                    "    console.log('FactosPerú API:', pm.response.code, json.code || (json.error && json.error.tipo), json.message || (json.error && json.error.mensaje));",
                                    "}"
                                ]
                            }
                        }
                    ],
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            },
                            {
                                "key": "Authorization",
                                "value": "Bearer {{api_token}}",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                            "host": [
                                "{{base_url}}"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "tipo-cambio",
                                "actual"
                            ],
                            "query": [
                                {
                                    "key": "moneda",
                                    "value": "USD",
                                    "disabled": true,
                                    "description": "Código ISO de la moneda."
                                }
                            ]
                        },
                        "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                    },
                    "response": [
                        {
                            "name": "Éxito",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": true,\n    \"code\": \"found\",\n    \"retryable\": false,\n    \"data\": {\n        \"fecha\": \"2026-10-09\",\n        \"moneda\": \"USD\",\n        \"compra\": \"VALOR\",\n        \"venta\": \"VALOR\"\n    },\n    \"source\": \"tipo_cambio\",\n    \"time\": 0.42\n}"
                        },
                        {
                            "name": "Error 404",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"not_found\",\n    \"retryable\": false,\n    \"message\": \"Registro no encontrado en la fuente local .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 422",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "Unprocessable Content",
                            "code": 422,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"message\": \"El campo campo es obligatorio.\",\n    \"errors\": {\n        \"campo\": [\n            \"El campo campo es obligatorio.\"\n        ]\n    }\n}"
                        },
                        {
                            "name": "Error 502",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "Bad Gateway",
                            "code": 502,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"proveedor_error\",\n    \"retryable\": true,\n    \"message\": \"Error del proveedor .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 503",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"code\": \"dataset_no_disponible\",\n    \"retryable\": true,\n    \"message\": \"El dataset no está importado o el servicio no responde .\",\n    \"time\": 0.12\n}"
                        },
                        {
                            "name": "Error 401 · token inválido",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"token_invalido\",\n        \"mensaje\": \"Token inválido\"\n    }\n}"
                        },
                        {
                            "name": "Error 429 · límite del plan",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Authorization",
                                        "value": "Bearer {{api_token}}",
                                        "type": "text"
                                    }
                                ],
                                "url": {
                                    "raw": "{{base_url}}/api/v1/tipo-cambio/actual",
                                    "host": [
                                        "{{base_url}}"
                                    ],
                                    "path": [
                                        "api",
                                        "v1",
                                        "tipo-cambio",
                                        "actual"
                                    ],
                                    "query": [
                                        {
                                            "key": "moneda",
                                            "value": "USD",
                                            "disabled": true,
                                            "description": "Código ISO de la moneda."
                                        }
                                    ]
                                },
                                "description": "Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.\n\n**Consumo:** 1 por solicitud.\n\n**Campos obligatorios:** ninguno.\n\n**Errores:** 404 Registro no encontrado en la fuente local (`not_found`). · 503 El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`). · 502 Error del proveedor (`proveedor_error`). · 422 Moneda inválida."
                            },
                            "status": "Too Many Requests",
                            "code": 429,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\": false,\n    \"error\": {\n        \"tipo\": \"limite_alcanzado\",\n        \"mensaje\": \"Has alcanzado el límite de consultas de tu plan\"\n    },\n    \"consumo\": 1500,\n    \"limite\": 1500\n}"
                        }
                    ]
                }
            ]
        }
    ]
}
