{
  "info": {
    "name": "ApiPeruDev — Completa",
    "description": "Colección COMPLETA: incluye todos los endpoints de routes/api.php, incluso los que aún no tienen página propia en la referencia (PSE, OSE, catálogos SUNAT, descarga directa de CPE) y las variantes internas -admin/ingesta (grupo \"Interno / restringido a superadmin\" — requieren un token de usuario superadmin, no funcionan con un token normal). Si solo quieres lo que está en la doc pública, usa la colección \"ApiPeruDev\" en su lugar. Antes de usar: configura las variables de colección URL_BASE y TOKEN (Variables de la colección, arriba a la derecha en Postman). Generado automáticamente desde docs.apiperu.dev.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "URL_BASE",
      "value": "https://api.apiconsulta.xmlapi.pe",
      "type": "string"
    },
    {
      "key": "TOKEN",
      "value": "TU_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Identidad",
      "item": [
        {
          "name": "Consulta DNI",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/dni",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "dni"
              ]
            },
            "description": "Obtén los datos de una persona a partir de su número de DNI (8 dígitos).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"dni\": \"44556677\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc"
              ]
            },
            "description": "Obtén los datos de un contribuyente a partir de su RUC (11 dígitos), desde padrón resumido de SUNAT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20131312955\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC SUNAT",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-sunat",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-sunat"
              ]
            },
            "description": "Igual que Consultar RUC, pero priorizando siempre la fuente oficial de SUNAT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20131312955\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta DNI - RUC",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/dni-ruc",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "dni-ruc"
              ]
            },
            "description": "Deriva el RUC de persona natural (prefijo 10) a partir de un número de DNI.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"dni\": \"44556677\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "RUC · Detalle",
      "item": [
        {
          "name": "Consulta RUC Contacto",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-contacto",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-contacto"
              ]
            },
            "description": "Teléfonos y correos declarados del contribuyente ante SUNAT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC SSCO",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-ssco",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-ssco"
              ]
            },
            "description": "Verifica si un RUC figura en el padrón SUNAT de Sujetos Sin Capacidad Operativa (SSCO).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20613882023\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC Deuda Coactiva",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-deuda-coactiva",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-deuda-coactiva"
              ]
            },
            "description": "Deudas en cobranza coactiva del contribuyente.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC Representantes",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-representantes",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-representantes"
              ]
            },
            "description": "Representantes legales registrados del contribuyente.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC Establecimientos Anexos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-establecimientos-anexos",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-establecimientos-anexos"
              ]
            },
            "description": "Locales y establecimientos anexos declarados del contribuyente.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC Domicilio Fiscal",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-domicilio-fiscal",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-domicilio-fiscal"
              ]
            },
            "description": "Domicilio fiscal declarado del contribuyente.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta RUC Trabajadores",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-trabajadores",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-trabajadores"
              ]
            },
            "description": "Número de trabajadores, pensionistas y prestadores de servicio por periodo.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Finanzas",
      "item": [
        {
          "name": "Consulta Tipo de Cambio",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/tipo-de-cambio",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "tipo-de-cambio"
              ]
            },
            "description": "Consulta el tipo de cambio oficial (compra y venta) para una fecha y moneda (USD / EUR).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"fecha\": \"2026-07-24\",\n  \"moneda\": \"USD\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta Comisiones AFP",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/comisiones-afp",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "comisiones-afp"
              ]
            },
            "description": "Tasas de comisión y prima de seguro de las AFP para un periodo.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"periodo\": \"2026-07\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Comprobantes (CPE)",
      "item": [
        {
          "name": "Consulta CPE",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/cpe",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "cpe"
              ]
            },
            "description": "Valida un comprobante de pago electrónico contra SUNAT.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc_emisor\": \"20601234567\",\n  \"codigo_tipo_documento\": \"01\",\n  \"serie_documento\": \"F001\",\n  \"numero_documento\": \"123\",\n  \"fecha_de_emision\": \"2026-07-10\",\n  \"total\": 118\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta CPE Múltiple",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/validacion-multiple-cpe",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "validacion-multiple-cpe"
              ]
            },
            "description": "Valida en lote hasta 100 comprobantes en una sola llamada.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"comprobantes\": \"...\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Descarga de CPE (PDF/XML)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/cpe-download",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "cpe-download"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc_emisor\": \"20601234567\",\n  \"codigo_tipo_documento\": \"01\",\n  \"serie_documento\": \"F001\",\n  \"numero_documento\": \"123\",\n  \"tipo_descarga\": \"01\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Vehículos y MTC",
      "item": [
        {
          "name": "Consulta Licencia de Conducir",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/licencia-conducir",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "licencia-conducir"
              ]
            },
            "description": "Datos del titular de una licencia de conducir.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"num_licencia\": \"Q12345678\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta Placa",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/placa",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "placa"
              ]
            },
            "description": "Ficha técnica de un vehículo a partir de su placa.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"placa\": \"ABC123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta SOAT",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/soat",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "soat"
              ]
            },
            "description": "Estado y vigencia del SOAT de una placa.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"placa\": \"ABC123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta Partida Registral MTC",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/mtc",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "mtc"
              ]
            },
            "description": "Número de partida registral MTC de un RUC.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta Transporte de Mercancías",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/transporte-mercancias",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "transporte-mercancias"
              ]
            },
            "description": "Datos de una empresa de transporte de mercancías y su flota (Registro MTC).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tipo\": \"ruc\",\n  \"valor\": \"20601234567\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Ubicación",
      "item": [
        {
          "name": "Consulta Ubigeos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ubigeos",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ubigeos"
              ]
            },
            "description": "Catálogo completo de ubigeos SUNAT como árbol departamento → provincia → distrito."
          },
          "response": []
        },
        {
          "name": "Consulta Puertos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/puertos",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "puertos"
              ]
            },
            "description": "Catálogo de puertos del Perú (parámetro SUNAT 1009)."
          },
          "response": []
        },
        {
          "name": "Consulta Aeropuertos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/aeropuertos",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "aeropuertos"
              ]
            },
            "description": "Catálogo de aeropuertos del Perú (parámetro SUNAT 1010)."
          },
          "response": []
        }
      ]
    },
    {
      "name": "CPE · Clave SOL",
      "item": [
        {
          "name": "Consulta XML de CPE",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/cpe/consulta-xml",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "cpe",
                "consulta-xml"
              ]
            },
            "description": "Descarga el XML firmado de un comprobante (factura, boleta, nota de crédito/débito) emitido por el RUC autenticado.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_cpe\": \"01\",\n  \"serie\": \"F001\",\n  \"numero\": 123\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta PDF de CPE",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/cpe/consulta-pdf",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "cpe",
                "consulta-pdf"
              ]
            },
            "description": "Descarga el PDF de un comprobante (factura, boleta, nota de crédito/débito) emitido por el RUC autenticado.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_cpe\": \"01\",\n  \"serie\": \"F001\",\n  \"numero\": 123,\n  \"indicador\": \"1\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta CDR de CPE",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/cpe/consulta-cdr",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "cpe",
                "consulta-cdr"
              ]
            },
            "description": "Descarga el CDR (Constancia de Recepción) de un comprobante emitido por el RUC autenticado.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_cpe\": \"01\",\n  \"serie\": \"F001\",\n  \"numero\": 123,\n  \"indicador\": \"1\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "GRE · Clave SOL",
      "item": [
        {
          "name": "Consulta GRE Lista",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/gre/lista",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "gre",
                "lista"
              ]
            },
            "description": "Lista las Guías de Remisión Electrónicas de un periodo, con filtros y agregación automática de páginas.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"periodo\": \"2026-07\",\n  \"fecha_desde\": \"...\",\n  \"fecha_hasta\": \"...\",\n  \"estado\": \"...\",\n  \"ruc_receptor\": \"...\",\n  \"serie\": \"T001\",\n  \"numero\": 123\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta GRE",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/gre/consulta",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "gre",
                "consulta"
              ]
            },
            "description": "Detalle de una Guía de Remisión específica. Funciona para cualquier RUC emisor, no solo el propio.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": 123,\n  \"ruc_emisor\": \"...\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta GRE Baja",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/gre/baja",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "gre",
                "baja"
              ]
            },
            "description": "Da de baja una Guía de Remisión Electrónica.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": \"123\",\n  \"tipo_baja\": \"01\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta GRE Constancia Baja",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/gre/constancia-baja",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "gre",
                "constancia-baja"
              ]
            },
            "description": "Obtiene la constancia de baja de una Guía de Remisión.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": \"123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Consulta GRE Descarga XML",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/gre/descarga-xml",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "gre",
                "descarga-xml"
              ]
            },
            "description": "Descarga el XML de una Guía de Remisión Electrónica.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": \"123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "PSE / OSE",
      "item": [
        {
          "name": "PSE — Lista",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/pse/lista",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "pse",
                "lista"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "PSE — Buscar",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/pse/buscar",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "pse",
                "buscar"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"ruc_pse\": \"20601234568\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "PSE — Alta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/pse/alta",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "pse",
                "alta"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"ruc_pse\": \"20601234568\",\n  \"fecha_inicio\": \"2026-06-10\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "PSE — Baja",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/pse/baja",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "pse",
                "baja"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"ruc_pse\": \"20601234568\",\n  \"fecha_inicio\": \"2026-06-10\",\n  \"fecha_fin\": \"2026-07-10\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "OSE — Lista",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ose/lista",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ose",
                "lista"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "OSE — Buscar",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ose/buscar",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ose",
                "buscar"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"ruc_ose\": \"20601234568\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "OSE — Alta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ose/alta",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ose",
                "alta"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"ruc_ose\": \"20601234568\",\n  \"fecha_inicio\": \"2026-06-10\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "OSE — Baja",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ose/baja",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ose",
                "baja"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"ruc_ose\": \"20601234568\",\n  \"fecha_inicio\": \"2026-06-10\",\n  \"fecha_fin\": \"2026-07-10\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Catálogos SUNAT",
      "item": [
        {
          "name": "Catálogos — Lista de catálogos",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/parametros",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "parametros"
              ]
            }
          },
          "response": []
        },
        {
          "name": "Catálogos — Consultar catálogo",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/parametros",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "parametros"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"codigos\": \"1002,1003\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Interno / restringido a superadmin",
      "item": [
        {
          "name": "[Admin] Consulta DNI (caché, sin cuota)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/dni-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "dni-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"dni\": \"44556677\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] Consulta RUC (caché, sin cuota)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/ruc-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "ruc-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20131312955\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] Tipo de cambio (fuente SBS — actualmente inactivo, ver /tipo-de-cambio)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/tipo-de-cambio-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "tipo-de-cambio-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"fecha\": \"2026-07-24\",\n  \"moneda\": \"USD\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] GRE Lista",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/lista-gre-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "lista-gre-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"periodo\": \"2026-07\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] GRE Consulta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/consulta-gre-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "consulta-gre-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": 123\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] GRE Baja",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/baja-gre-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "baja-gre-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": 123,\n  \"tipo_baja\": \"01\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] GRE Constancia Baja",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/constancia-baja-gre-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "constancia-baja-gre-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": 123\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] GRE Descarga XML",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/descarga-xml-gre-admin",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "descarga-xml-gre-admin"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ruc\": \"20601234567\",\n  \"usuario\": \"USUARIO\",\n  \"clave\": \"CLAVE\",\n  \"tipo_gre\": \"09\",\n  \"serie\": \"T001\",\n  \"numero\": 123\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "[Admin] Tipo de cambio — Estado del día",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/tipo-de-cambio/estado",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "tipo-de-cambio",
                "estado"
              ]
            }
          },
          "response": []
        },
        {
          "name": "[Admin] Tipo de cambio — Registros del mes",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/tipo-de-cambio/mes",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "tipo-de-cambio",
                "mes"
              ]
            }
          },
          "response": []
        },
        {
          "name": "[Admin] Tipo de cambio — Registrar (ingesta)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{URL_BASE}}/tipo-de-cambio/registrar",
              "host": [
                "{{URL_BASE}}"
              ],
              "path": [
                "tipo-de-cambio",
                "registrar"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"fecha\": \"2026-07-24\",\n  \"moneda\": \"USD\",\n  \"compra\": 3.398,\n  \"venta\": 3.404,\n  \"fecha_sunat\": \"2026-07-22\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    }
  ]
}