Registro de cambios de /v1

Los cambios de /v1, del más reciente al más antiguo. La referencia siempre describe la versión que está en servicio.

Noviembre de 2026

Primera versión publicada de /v1, en https://api.boletura.com:

• emitir boletas y facturas, con detracción y al crédito en cuotas;
• emitir notas de crédito y de débito sobre un comprobante aceptado;
• pedir la baja o la anulación de un comprobante aceptado;
• enviar un comprobante al correo del cliente;
• consultar comprobantes y empresas, y descargar el XML, el PDF y el CDR;
• recibir avisos firmados por webhook.

Qué cambios son compatibles

El contrato de /v1 es su OpenAPI publicado. Dentro de /v1 solo entran cambios compatibles; uno incompatible abre /v2, y /v1 sigue en servicio mientras lo usen integradores.

Son compatibles, y el integrador no tiene que cambiar nada:

• una operación nueva, un parámetro de consulta opcional nuevo o un campo opcional nuevo en el cuerpo de una solicitud;
• un campo nuevo en una respuesta, también dentro de un objeto anidado;
• un valor nuevo en un enum de respuesta (type, status, sunat_status, delivery_status) o un código de error nuevo;
• aceptar un valor de entrada más;
• una cabecera de respuesta nueva o un código HTTP de error nuevo en una operación.

Son incompatibles:

• quitar o renombrar una operación, un parámetro, un campo de la solicitud o de la respuesta, o una cabecera de respuesta;
• agregar un parámetro o un campo obligatorio, o volver obligatorio uno que no lo era, o el cuerpo;
• dejar de aceptar un valor de entrada, cambiar un tipo o un formato, bajar un largo máximo o cambiar un patrón;
• que un campo de respuesta pueda faltar o llegar nulo cuando antes no;
• cambiar el significado de un campo o de un código de error que conserva su nombre.

Del lado del integrador, un cliente robusto ignora los campos que no conoce, trata un valor de enum desconocido como un caso más en lugar de fallar, y programa contra error.code, nunca contra message. El OpenAPI declara los campos obligatorios y los valores admitidos de cada cuerpo y filtro; los largos y las reglas fiscales van en la descripción de cada campo, como texto.