Saltar al contenido

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