Manual de Postman
Pruebe toda la API sin escribir código. La colección trae las 29 rutas con cuerpo de ejemplo, respuestas de ejemplo (éxito y errores) y pruebas automáticas. Se genera desde el mismo contrato que la API, así que siempre coincide con lo publicado.
1. Descargue los dos archivos
El entorno ya apunta a https://api.factosperu.com. Los archivos no contienen tokens ni claves: las variables sensibles van vacías.
2. Impórtelos
- En Postman pulse Import (arriba a la izquierda) y arrastre los dos archivos.
- Arriba a la derecha elija el entorno FactosPerú API · Producción.
- Abra el entorno (ícono del ojo) y escriba su token en api_token, columna Current value. Así el token queda solo en su equipo: no se sincroniza ni se comparte con su equipo de Postman.
3. Complete las variables
| Variable | Para qué | Tipo |
|---|---|---|
| base_url | URL base de producción: https://api.factosperu.com (sin / final). | Normal |
| api_token | Token Bearer de su cuenta (Panel → Token API). Se muestra una sola vez al generarlo. | Secreta (oculta) |
| ruc | RUC de 11 dígitos para las consultas. | Normal |
| dni | DNI de 8 dígitos. | Normal |
| usuario_sol | Usuario SOL del RUC (solo para CPE, buzón, SUNAFIL y credenciales API). | Secreta (oculta) |
| clave_sol | Clave SOL del RUC. No la guarde en colecciones compartidas. | Secreta (oculta) |
usuario_sol y clave_sol solo hacen falta en CPE, validación múltiple, buzón, SUNAFIL y credenciales API. No las guarde en colecciones que comparta.
4. Envíe y revise
- Abra una carpeta (una por tema), elija la ruta y pulse Send.
- Examples (a la derecha del nombre) muestra la respuesta esperada y cada error posible con su código.
- Test Results confirma el código HTTP de éxito y que la respuesta tenga el formato de la API.
- La descripción de cada ruta indica las unidades que consume, los campos obligatorios y los errores.
Ejecutar la colección completa con el Collection Runner envía todas las rutas y consume unidades de su plan. Úselo con la carpeta que necesite, no con toda la colección.
5. Desde la línea de comandos (opcional)
Con Newman puede ejecutar una carpeta en integración continua. Pase el token por variable de entorno del sistema, nunca escrito en el comando:
npx newman run api_consulta.postman_collection.json \ -e api_consulta.postman_environment.json \ --env-var "api_token=$API_TOKEN" \ --folder "1. Identidad"
Qué trae la colección
1. Identidad
- POST /api/v1/ruc · Consulta RUC · ejemplos
- POST /api/v1/ruc-sunat · Consulta RUC (ficha SUNAT) · ejemplos
- POST /api/v1/dni-ruc · Consulta RUC por DNI · ejemplos
- POST /api/v1/dni · Consulta DNI · ejemplos
- POST /api/v1/carnet-extranjeria · Consulta por Carnet de Extranjería · ejemplos
- POST /api/v1/pasaporte · Consulta por Pasaporte · ejemplos
- POST /api/v1/cedula-diplomatica · Consulta por Cédula Diplomática de Identidad · ejemplos
- POST /api/v1/razon-social · Búsqueda por razón social en línea · ejemplos
2. Consultas por GET
- GET /api/dni/{dni} · Consulta DNI por GET · ejemplos
- GET /api/ruc/{ruc} · Consulta RUC por GET · ejemplos
3. Comprobantes
- POST /api/v1/cpe · Consulta y descarga de CPE · ejemplos
- POST /api/v1/ruc/excluido · Consulta CPE de un RUC excluido · ejemplos
- POST /api/v1/validacion-multiple-cpe · Validación múltiple de CPE · ejemplos
4. Buzón SOL
- POST /api/v1/buzon · Consulta del buzón electrónico · ejemplos
5. Casilla SUNAFIL
- POST /api/v1/sunafil/casilla · Consulta de la casilla electrónica SUNAFIL · ejemplos
- POST /api/v1/sunafil/documento · Descarga de documento SUNAFIL (en memoria) · ejemplos
6. Credenciales API SUNAT
- POST /api/v1/credenciales-api · Extraer credenciales de API SUNAT · ejemplos
- POST /api/v1/credenciales-api/crear · Crear aplicación y generar credenciales de API SUNAT · ejemplos
- POST /api/v1/credenciales-api/editar · Editar aplicación de API SUNAT · ejemplos
7. SIRE
- POST /api/v1/sire/token · Obtener token de pantalla SIRE · ejemplos
8. Padrón y datos públicos
- POST /api/v1/padron/ruc · Consulta RUC en el Padrón Reducido · ejemplos
- GET /api/v1/padron/buscar · Búsqueda por razón social · ejemplos
- GET /api/v1/ruc/{ruc}/establecimientos · Establecimientos anexos de un RUC · ejemplos
- GET /api/v1/ssco/{ruc} · Sujeto sin capacidad operativa (SSCO) · ejemplos
- GET /api/v1/ubigeos · Ubigeos (INEI) · ejemplos
- GET /api/v1/puertos · Puertos (MTC) · ejemplos
- GET /api/v1/aeropuertos · Aeropuertos (MTC) · ejemplos
- GET /api/v1/tipo-cambio · Tipo de cambio · ejemplos
- GET /api/v1/tipo-cambio/actual · Tipo de cambio actual · ejemplos