Greenter o una API: cómo integrar la facturación electrónica de SUNAT
Por Ronald Rangel · Publicado el
Para emitir comprobantes electrónicos desde tu sistema hay dos caminos: hablar directamente con los servicios de SUNAT usando una librería como Greenter, o enviar los datos de la venta a una API que hace ese trabajo por ti. Esta guía compara qué resuelve cada opción y qué queda a tu cargo.

Qué hace una librería como Greenter
Greenter es una librería de código abierto para PHP muy usada en Perú. Arma el XML UBL de facturas, boletas, notas y otros comprobantes, lo firma con tu certificado digital y lo envía a los servicios web de SUNAT, de donde recibe la constancia de recepción (CDR).
Es una buena base si tu equipo trabaja en PHP y quiere controlar todo el proceso dentro de su propio servidor, sin un servicio intermedio.
Qué queda a cargo de tu sistema
Una librería resuelve el XML y el envío, pero el resto de la operación la construye y la mantiene tu equipo: guardar el certificado y las credenciales SOL de forma segura, llevar los correlativos de cada serie sin saltos ni duplicados y guardar el XML firmado y el CDR de cada comprobante.
También tienes que manejar lo que pasa cuando SUNAT no responde: reintentar sin emitir dos veces el mismo comprobante, consultar los tickets de los resúmenes diarios y las comunicaciones de baja, que SUNAT procesa de forma asíncrona, y avisar a tu sistema cuando llega la respuesta.
Además están el PDF en A4 o ticket, las guías de remisión, que SUNAT recibe por una API distinta con credenciales propias, y los cambios que SUNAT publica en sus reglas de validación y catálogos.
Qué hace una API de facturación electrónica
Con API SUNAT tu sistema envía la venta en JSON a POST /documents, desde cualquier lenguaje, y la API asigna el siguiente correlativo de la serie, arma el XML, lo firma con tu certificado, lo envía a SUNAT y guarda el XML, el CDR y el PDF en A4, A5 o ticket.
Los reintentos ya están resueltos: el header Idempotency-Key evita comprobantes duplicados y, si SUNAT no responde, la API reenvía el mismo XML hasta 5 veces. Cuando SUNAT responde recibes un webhook firmado con el resultado.
Las anulaciones se piden con POST /voids y la API elige si corresponde comunicación de baja o resumen diario. Las guías de remisión se emiten con POST /guides con el mismo estilo de petición.
Cuándo conviene cada opción
Una librería conviene si tu sistema está en PHP, tu equipo ya conoce el formato UBL y las reglas de SUNAT, y prefieres invertir tiempo de desarrollo y mantenimiento en lugar de pagar por cada comprobante.
Una API conviene si tu sistema está en otro lenguaje, necesitas emitir pronto o no quieres mantener la parte fiscal: certificados, reintentos, tickets, PDF y cambios de SUNAT. También si integras con un agente de IA, que puede conectar la API a tu sistema siguiendo su documentación.
En los dos casos los comprobantes son tuyos: se emiten con tu RUC, tu certificado y tus series.
Pruébalo antes de decidir
Con una clave de prueba asu_test_ emites en SUNAT beta, con numeración propia y sin consumir tu plan. Así puedes comparar el esfuerzo de integración con tu propio código antes de elegir.
Si ya emites con una librería y quieres pasar a la API, tus comprobantes anteriores siguen siendo válidos. Para seguir con las mismas series, usa la numeración manual y envía el número de cada comprobante, o crea series nuevas.
Otras guías
CódigoAPI SUNAT con PHP: emite facturas electrónicas con cURLCómo emitir una factura electrónica en SUNAT desde PHP con cURL y API SUNAT, reintentar sin duplicar y verificar el webhook firmado. Sin SDK ni librerías.Leer
CódigoAPI SUNAT con Laravel: factura electrónica con el cliente HTTP de LaravelIntegra API SUNAT en Laravel: emite facturas electrónicas en SUNAT con el facade Http, guarda la clave en config/services.php y verifica el webhook firmado en un controlador.Leer
CódigoAPI SUNAT con Node.js: emite facturas electrónicas con fetchCómo emitir una factura electrónica en SUNAT desde Node.js con fetch nativo y API SUNAT, reintentar sin duplicar y verificar el webhook firmado con Express.Leer
CódigoAPI SUNAT con Python: factura electrónica con requestsCómo emitir una factura electrónica en SUNAT desde Python con requests y API SUNAT, reintentar sin duplicar y verificar el webhook firmado con Flask.Leer