Colección de Postman

La colección tiene todas las operaciones de /v1, en carpetas por recurso y con los ejemplos de la referencia. Se genera del mismo contrato, así que siempre coincide con la versión en servicio.

Descargar la colección (JSON)

1. En Postman, Import y elige el archivo descargado.
2. En la colección, pestaña Variables, pon tu API key test (bol_test_…) en bearerToken. baseUrl ya es https://api.boletura.com, la misma para test y live: la clave elige el ambiente.
3. En Lista las empresas del tenant…, envía la solicitud y copia el id de tu empresa al company_id de los cuerpos que vas a probar.

Cada solicitud que lleva Idempotency-Key genera una clave nueva en cada envío ({{$guid}}): en Postman, cada clic es otra operación, no un reintento. Para ensayar un reintento, reemplaza ese valor por una clave fija y envía dos veces el mismo cuerpo.

Usa solo una clave test mientras pruebas: con una clave live, cada emisión es un comprobante real ante SUNAT.

El contrato también se descarga sin API key, en formato OpenAPI, desde api.boletura.com/openapi/v1.json, para generar un cliente o importarlo en otra herramienta.