Boletas (UBL 2.1)

Generación y firma de Boletas de venta electrónica.

POST/v1/boletas

El endpoint de boletas te permite crear comprobantes de venta electrónica para personas naturales identificadas con DNI (tipo de documento 1), pasaporte o sin documento formal (operaciones menores a S/ 700).

Dos Modos de Emisión (Agrupación vs Envío Inmediato)

1. Agrupación en Resumen Diario (Por defecto)

Por defecto (sin enviar summary_flow, o enviándolo como true), la boleta se valida y firma digitalmente al instante, y el motor automático nocturno de YoEmito la agrupa en el Resumen Diario (RC), solicita el Ticket y procesa el CDR consolidado ante SUNAT de forma 100% autónoma. Es el modo recomendado para negocios de alto volumen.

2. Envío Inmediato con CDR en segundos ("summary_flow": false)

Si necesitas confirmación al instante (POS, comercio electrónico donde el comprador espera su comprobante ya aceptado), incluye "summary_flow": false dentro de document. YoEmito transmite la boleta directo a SUNAT vía sendBill, igual que una factura, sin esperar al paquete nocturno.

Plazo de SUNAT: vía Resumen Diario (modo por defecto) tienes 7 días calendario desde issue_date para enviar; con envío individual (summary_flow: false) el plazo es 5 días calendario (R.S. N°114-2019/SUNAT Art. 12). Pasado ese plazo, SUNAT no reconoce el documento como comprobante válido. Nuestra API lo valida automáticamente: POST /v1/boletas devuelve un error 422 si issue_date ya está fuera del plazo que corresponda, antes de siquiera consultar a SUNAT.

Consideraciones Principales

Serie: Debe iniciar con la letra B (ej. B001).
Formato PDF: Generación instantánea en formatos A4, Ticket 80mm o Ticket 58mm con código QR homologado.
Anulación: Una vez aceptada por SUNAT, se anula mediante Nota de Crédito con motivo 01 (Anulación de la operación).