API de facturación electrónica SUNAT

Una llamada por venta.
SUNAT, de nuestro lado.

Para webs a medida, ERPs y apps. Envías la venta en JSON y recibes el comprobante con su número y su estado ante SUNAT. El IGV, las gratuitas, el tipo de cambio, los reintentos y el correo al cliente los resuelve BillerPro.

REST + webhooks firmados Certificado digital incluido S/49 al mes sobre tu plan
Baja
01 · Lo que tendrías que construir sin una API

Emitir ante SUNAT
no es un POST.

Integrar la facturación electrónica directo con SUNAT parece un endpoint. Termina siendo un proyecto.

Firma
El XML firmado con certificado

Cada comprobante es un XML en el formato UBL de SUNAT, firmado con un certificado digital que hay que comprar, renovar y guardar bien.

Envío
El servicio de SUNAT y la constancia

Hay que enviarlo, leer la constancia de recepción (CDR) y entender por qué lo rechazaron cuando lo rechazan.

Boletas
El resumen diario y las bajas

Las boletas se informan en resúmenes diarios y las anulaciones van por comunicación de baja, cada una con su plazo.

Catálogos
Afectación del IGV, unidades, documentos

Gravado, exonerado, inafecto, gratuitas, ICBPER, tipos de documento: cada uno con su código y sus reglas de cálculo.

Fallas
SUNAT no responde

Cuando el servicio se cae, alguien tiene que reintentar sin duplicar el comprobante, y avisar si se acerca el plazo.

Archivo
Guardar XML, CDR y PDF

Lo emitido se guarda y se entrega: al cliente, al contador y a SUNAT si lo pide.

02 · Cómo lo resuelve

Tú mandas la venta.
Lo demás es nuestro.

BillerPro emite a través de un proveedor autorizado por SUNAT, con el certificado digital incluido. Tu sistema solo habla JSON.

01

Idempotente por diseño

Tu ID de venta identifica el comprobante. Si tu sistema reintenta por un corte de red, recibe el mismo comprobante con ya_existia: true: nunca sale uno duplicado.

Montos con IGV incluido, como string decimal para no perder céntimos. Con RUC sale factura; con DNI o sin documento, boleta.

Reintento
POST · PED-10021201 · F001-42
POST · PED-10021 reintento200 · F001-42
ya_existiatrue
Webhooks
B001-00000107 eventoaceptado
F001-00000043 eventorechazado
X-BillerPro-Firmaverificada
02

Te avisamos, no consultas

Registras una URL y recibes un webhook firmado cada vez que un comprobante cambia de estado: aceptado, rechazado o anulado. La firma se verifica con tu secreto.

Si SUNAT o el proveedor no responden, reintentamos solos y el comprobante queda en estado reintentando, con las horas que le quedan hasta el plazo legal.

03

XML, CDR y PDF desde nuestro respaldo

Descargas los tres documentos de cada comprobante con una llamada, servidos desde nuestro respaldo aunque el proveedor ya no los tenga. Anulas, reenvías por correo y consultas los pendientes con su plazo.

Y todo lo que emites por API aparece en el mismo panel que tu equipo usa para vender en mostrador o por WhatsApp, con el Registro de Ventas y el SIRE del mes.

GET /v1/emisiones/{id}/documentos
xml✓
cdr✓
pdf_base64✓
POST /v1/emisiones
curl -X POST https://api.billerpro.store/v1/emisiones \
  -H "X-API-Key: bp_…" -d '{
  "origen": "miweb", "origen_id": "PED-10021",
  "receptor": { "numero_documento": "20601234567",
                "razon_social": "Cliente SAC" },
  "lineas": [{ "codigo": "ZAP-42", "descripcion": "Zapatillas",
               "cantidad": 1, "precio_unitario": "189.90" }]
}'

201 { "numero": "F001-00000042", "estado": "aceptado",
       "aceptado": true, "total": "189.90", "ya_existia": false }
04

Así se ve una venta

Una llamada con tu ID de venta, el cliente y las líneas con IGV incluido. La respuesta trae el número y el estado ante SUNAT. Si repites la llamada con el mismo origen_id, recibes el mismo comprobante, nunca uno nuevo.

La referencia completa, con todos los campos, errores y límites, está en la documentación de la API.

¿Buscabas las APIs propias de SUNAT? SUNAT publica servicios para tareas puntuales, como validar comprobantes o trabajar el SIRE, y piden credenciales que generas con tu Clave SOL. Si solo necesitas saber si un comprobante es válido, usa la consulta de validez de SUNAT. Para emitir boletas y facturas desde tu sistema hay que armar y firmar cada comprobante con un certificado digital y enviarlo, que es lo que esta API hace por ti.
03 · Empezar a integrar

De la clave
a la primera factura.

El módulo «API y webhooks» se activa en un clic sobre cualquier plan. Para WooCommerce, Shopify o VTEX no hace falta: esos conectores ya vienen en el plan.

Paso 1

Activa el módulo

En tu panel, Mi cuenta → Módulos → API y webhooks. Se suma S/49 al mes a tu plan.

Tú, 1 minuto
Paso 2

Copia tu clave

En Conectar canal → API ves tu clave de acceso. Va en la cabecera X-API-Key, y la puedes rotar cuando quieras.

Tú, 1 minuto
Paso 3

Emite y escucha

Llama a POST /v1/emisiones con tu primera venta y registra tu webhook con PUT /v1/webhook.

Tu equipo de desarrollo
04 · Con las cartas sobre la mesa

Lo que no hace.

Para que no lo descubras en la segunda semana.

Alcance

No es la API de SUNAT

No consulta RUC ni reemplaza los servicios propios de SUNAT. Emite, consulta, anula y entrega tus comprobantes a través de un proveedor autorizado.

Contabilidad

Es facturación, no un sistema contable

Dejamos listo el Registro de Ventas, el PLE 14.1 y la conciliación del SIRE. El asiento contable y el balance no los hacemos.

Límites

Hay límites por minuto

60 emisiones, 120 consultas, 10 descargas de documentos y 5 reenvíos de correo por minuto. Si los pasas, recibes 429 con el tiempo de espera.

Lo que sí, sin asteriscos

El certificado y la emisión vienen incluidos

No compras certificado ni contratas un proveedor aparte. Pagas tu plan más S/49 del módulo, sin costo por llamada dentro de tu cupo de comprobantes.

05 · Precio

Sin activación
ni permanencia.

No cobramos por instalar, ni por sucursal, ni por cada bloque de productos. El precio que ves es el que pagas.

Inicio

S/149/mes
Hasta 250 comprobantes al mes
  • Boletas, facturas y notas de crédito
  • Certificado digital incluido
  • Todos los conectores de tienda
  • Catálogo y stock básico
  • Punto de venta y notas de venta
  • Registro de Ventas, PLE y SIRE
Empezar con Inicio
El de tienda

Negocio

S/249/mes
Hasta 500 comprobantes al mes
  • Todo lo de Inicio
  • Guías de remisión electrónicas (GRE)
  • Stock sincronizado con tu web
  • Ventas en dólares con TC de SUNAT
  • Cobranzas, vencimientos y recordatorios
  • Inteligencia comercial semanal
  • Facturar por WhatsApp y asistente de IA
Empezar ahora →

Volumen

S/399/mes
Hasta 2.000 comprobantes al mes
  • Todo lo de Negocio
  • Varias tiendas o marcas
  • Respaldo en tu propia nube (Drive, S3)
  • Soporte prioritario
Empezar con Volumen

¿Tu web es a medida? El módulo de API y webhooks se suma por S/49 al mes, con documentación OpenAPI, ambiente de pruebas y clave rotable.

06 · Preguntas

Lo que nos
preguntan.

Si falta la tuya, escríbenos por WhatsApp al 913 527 489.

La referencia técnica completa está en la documentación de la API y webhooks.

¿Qué es una API de facturación electrónica SUNAT?

Un servicio al que tu sistema le envía cada venta y que se encarga de armar el comprobante, firmarlo, enviarlo a SUNAT y devolverte el resultado. Tu sistema no tiene que manejar el certificado ni el formato de SUNAT.

¿Cuánto cuesta?

El módulo API y webhooks cuesta S/49 al mes y se suma a cualquier plan. Los planes van desde S/149 al mes, con el certificado digital incluido.

¿Qué pasa si mi sistema envía dos veces la misma venta?

Recibe el mismo comprobante con ya_existia en true. El ID de venta que envías es la clave de idempotencia.

¿Cómo sé si SUNAT aceptó el comprobante?

La respuesta trae el estado y el campo aceptado. Si SUNAT tarda, queda en reintentando y te avisamos por webhook cuando cambia.

¿Puedo emitir en dólares?

Sí. Si no envías el tipo de cambio, se toma el oficial de SUNAT del día.

¿Necesito la API para WooCommerce, Shopify o VTEX?

No. Esos conectores, el panel, el punto de venta y la carga por CSV vienen en el plan. La API es para webs y sistemas hechos a medida.

Cómo empezamos

Te decimos ahora lo que casi nadie te dice después.

Emitir ante SUNAT no se enciende con un botón: hay un trámite de por medio. Es corto, lo hacemos juntos, y preferimos que lo sepas antes de pagar y no cuando ya pagaste.

Hoy

Contratas y entras

Tu panel queda listo al instante. Cargas tus productos, pones tu logo e invitas a tu equipo mientras tanto.

Lo haces tú, en 10 minutos
1 a 2 días

El alta ante SUNAT

Una videollamada de 30 minutos donde lo hacemos en tu pantalla. Es el único paso que no podemos hacer por ti: SUNAT exige que entres con tu Clave SOL.

Tú con tu Clave SOL, nosotros guiando
3 a 5 días

Emitiendo de verdad

Numeración configurada, certificado instalado y tu primera boleta real con su CDR de SUNAT. De ahí en adelante es solo usarlo.

Lo hacemos nosotros

Lo que más demora, y casi nadie lo menciona

Que la Clave SOL la tenga tu contador y haya que coordinarla. Es la causa número uno de que una puesta en marcha de dos días se vuelva de dos semanas. Por eso lo preguntamos en el primer contacto y no cuando ya te vendimos: si es tu caso, invitamos a tu contador a la misma llamada y se resuelve igual de rápido.

Corre por nuestra cuenta

  • El certificado digital
  • El alta con el proveedor autorizado
  • Configurar series y numeración
  • Importar tu catálogo o tu carta
  • Dejar tu logo en los comprobantes

Todo incluido en el plan. No cobramos implementación.

Tu primera factura
en una llamada.

Crea tu cuenta, activa el módulo y emite desde tu sistema hoy mismo. Sin implementación y sin permanencia.

¿Prefieres mirar primero? Entra a la demo, sin registrarte.