Integrar Factu API
Emite boletas, facturas y notas de crédito ante SUNAT. No necesitas conocer SUNAT para usarla: ni catálogos, ni UBL, ni XML, ni firma digital. Mandas lo que vendiste y recibes el comprobante con su PDF.
Esta guía cuenta lo que importa al integrar: cuándo reintentar, qué hacer ante cada error y cómo pasar a producción sin romper nada.
Todas las respuestas de este documento son reales, capturadas contra el entorno de pruebas.
Empieza por aquí
Emite tu primera boleta de pruebas →
BoletasCon o sin DNI, y con productos exonerados.FacturasVenta a empresas, con RUC.Notas de créditoAnula o corrige un comprobante ya emitido.AnularDa de baja una factura o una boleta.
Varias empresas, una sola integración
Una misma cuenta puede emitir por muchos RUC. El RUC va en la dirección, y todo lo demás es igual:
POST /v1/emisores/{ruc}/comprobantes
- Cada RUC lleva su propia numeración, por tipo, serie y ambiente. Dos empresas de tu cuenta nunca se pisan los correlativos.
- Puedes preguntar antes de emitir.
GET /v1/emisores/{ruc}dice si ese RUC ya puede emitir en producción (puede_emitir), para que tu sistema no se entere recién con un cliente delante. - El consumo viene separado por RUC.
GET /v1/consumote da cuántos comprobantes aceptó SUNAT en el mes, por empresa y por ambiente. - Cada RUC nuevo se da de alta con nosotros. Desde el primer día emite en pruebas; para producción el cliente autoriza en su Clave SOL (los pasos están en Pasar a producción).