Facturas Electrónicas (UBL 2.1)
Generación y transmisión asíncrona de Facturas comerciales.
POST/v1/invoices
El endpoint de facturas te permite crear comprobantes tributarios para empresas o personas jurídicas identificadas obligatoriamente con RUC (tipo de documento 6).
Reglas Principales
- Serie: Debe iniciar con la letra F (ej.
F001aF999). - Receptor: Debe contener un RUC válido de 11 dígitos.
- Respuesta:
202 Accepted— el comprobante quedaqueuedpara firma y envío asíncrono; consultálinks.selfpara ver el estado final (accepted/rejected). - Enrutamiento SUNAT: Transmisión asíncrona al servicio
billServicede la SUNAT. - Percepción/Retención en la misma factura: además de los endpoints separados
/v1/perceptionsy/v1/retentions, puedes declarardocument.percepcionodocument.retenciondirectamente al crear la factura (código de Catálogo 20/22, base, tasa, monto) — afecta las leyendas y los totales del comprobante.
Plazo de SUNAT — 3 días calendario: la factura (y su nota vinculada) debe enviarse a SUNAT dentro de los 3 días calendario siguientes a
issue_date (R.S. N°000003-2023/SUNAT). Pasado ese plazo, SUNAT no la reconoce como factura electrónica válida aunque ya se la hayas entregado a tu cliente, y no sustenta costo, gasto ni crédito fiscal. Nuestra API lo valida automáticamente: POST /v1/invoices devuelve un error 422 si issue_date ya está fuera de ese plazo, antes de siquiera consultar a SUNAT.