Blog

Facturación electrónica: integración por API (resumen)

Flujo base, validaciones y tips para integrar sin dolores de cabeza.

Facturación electrónica: integración por API

¿Por qué la Facturación Electrónica integrada es obligatoria en Perú?

En Perú, la facturación electrónica SUNAT es obligatoria para empresas con ingresos mayores a 150 UIT (~$600K USD). Pero no es solo un requisito legal: es una oportunidad para automatizar ventas, mejorar flujo de caja y reducir errores.

El problema: Muchas PYMEs facturan manualmente en Excel o usan software desconectado:

  • Vendedor vende → Operación manual de factura → Envío por email → Cliente valida recepción → Contabilidad registro manual → 2-3 horas por lote.
  • Sin automatización = 25% de facturas con errores (RUC incorrecto, monto mal, descripción incompleta).
  • Sin trazabilidad = Conflictos con clientes ("¿recibiste mi factura?").
  • Sin integración = Datos duplicados en ERP, CRM y SUNAT.

La solución: Integración automática con SUNAT API. Cuando cierras una venta, la factura se genera, valida y transmite a SUNAT en segundos. Cero fricción.

Datos de impacto (2024):

  • 45% de PYMEs peruanas aún facturan manualmente (IPSOS).
  • Multa por facturación inválida: hasta $1,000 USD por error.
  • Automatización reduce tiempo de facturación: 90%.
  • ROI de integración: 3-6 meses recuperas inversión.

¿Qué es Facturación Electrónica SUNAT?

Facturación Electrónica (FE) es generar, firmar y transmitir facturas digitalmente a la SUNAT (Superintendencia Nacional de Aduanas y de Administración Tributaria). La factura es un archivo XML validado con certificado digital y enviado a los servidores de SUNAT.

Diferencia: Factura Tradicional vs Electrónica

Aspecto Tradicional Electrónica
Formato Papel impreso XML firmado digitalmente
Almacenamiento Archivero físico Cloud / Servidor
Envío a cliente Imprime y entrega Email automático con PDF
Validación SUNAT No (costo = archivo DTE papelero) Sí, en tiempo real (CDR)
Seguridad Baja (puede ser falsificada) Alta (certificado digital, hash)
Deducibilidad fiscal Sí (si cumple requisitos) Sí, automática

Flujo de Facturación Electrónica con Integración SUNAT API

Paso 1: Cliente realiza compra en tu sistema

Vendedor ingresa datos en tu app (cliente, RUC, descripción, montos, impuestos).

Paso 2: Sistema genera XML de factura

Tu aplicación crea XML cumpliendo estándar UBL 2.1 (Formato SUNAT):

<?xml version="1.0" encoding="UTF-8"?>
<Invoice>
  <ID>F001-000123</ID>
  <IssueDate>2026-02-03</IssueDate>
  <BillingParty>
    <Name>Mi Empresa S.A.C.</Name>
    <IdentificationCode>20123456789</IdentificationCode>
  </BillingParty>
  <InvoiceLines>
    <Item>
      <Description>Servicio de Desarrollo</Description>
      <Price>5000</Price>
      <Quantity>1</Quantity>
    </Item>
  </InvoiceLines>
  <TaxTotal>900</TaxTotal> <!-- 18% IGV -->
  <Total>5900</Total>
</Invoice>

Paso 3: Firma digital con certificado

El XML se firma con tu certificado digital (proporcionado por SUNAT). Esto garantiza autenticidad e integridad.

Paso 4: Envío a SUNAT

Tu sistema envía XML firmado a SUNAT API (web service seguro).

Paso 5: SUNAT valida y responde con CDR

SUNAT valida en tiempo real:

  • RUC cliente existe y está activo.
  • Serie y número secuencial válidos.
  • Montos y cálculo de impuestos correctos.
  • Certificado digital válido.

Si todo es correcto, devuelve CDR (Comprobante de Recepción) con número de constancia.

Paso 6: Respuesta al cliente

Tu sistema genera PDF visual (representa factura) y envía por email al cliente con el XML y CDR.

Paso 7: Registro contable automático

ERP recibe información: Ingreso registrado, IGV calculado, saldo de cliente actualizado, reportes 8.1 y 8.2 para SUNAT generados automáticamente.

Métodos de Integración con SUNAT

Opción 1: SUNAT SOAP API (Integración Directa)

  • Cómo funciona: Tu servidor llama web service SUNAT directamente.
  • Requiere: Certificado digital, acceso a portal SUNAT, configuración de seguridad compleja.
  • Ventaja: Control total, sin intermediarios, sin costo.
  • Desventaja: Desarrollo y mantenimiento propio, responsabilidad por cumplimiento, debugging difícil.
  • Costo: $0 (inversión en desarrollo).

Opción 2: Proveedores OSE (Operadores de Servicio Electrónico)

Intermediarios certificados por SUNAT que manejan la integración:

  • Proveedores populares: Tife, Compass, Phicus, E-Factura, GrowLine, etc.
  • Cómo funciona: Tu sistema envía XML a proveedor OSE → Él lo envía a SUNAT → Recibe CDR → Te lo devuelve.
  • Ventaja: Desarrollo simple (API bien documentada), soporte técnico, garantía de cumplimiento.
  • Desventaja: Costo por factura, dependencia de tercero.
  • Costo: $0.50-$2 por factura electrónica (según volumen).

Opción 3: Software Contable Integrado

  • Ejemplos: Xubio, Siigo, Fase, OnVio.
  • Cómo funciona: Software contable ya tiene FE integrada. Tu sistema envía datos, ellos emiten factura.
  • Ventaja: Más simple, actualización automática de regulaciones SUNAT.
  • Desventaja: Menos control, cambio de proveedor = migración difícil.
  • Costo: $30-200/mes según empresa.

Guía Paso a Paso: Integrar SUNAT API

Paso 1: Obtén Certificado Digital (Semana 1)

  • Solicita en SUNAT (www.sunat.gob.pe) o a AC (Autoridad de Certificación) autorizada.
  • Costo: ~$50 USD/año.
  • Tiempo: 1-2 semanas.
  • Formato: .pfx (contiene clave privada y certificado).

Paso 2: Elige OSE o Desarrollo Directo (Día 1)

  • Si tiempo es crítico: Elige OSE (Tife, Compass). Integración en 2-3 semanas.
  • Si presupuesto es limitado: Desarrollo directo. Integración en 4-6 semanas.

Paso 3: Configura Ambiente de Prueba

  • SUNAT proporciona servidor de pruebas (no es producción).
  • Sube factura de prueba, verifica respuesta CDR.
  • Prueba casos de error (RUC inválido, montos incorrectos, etc).

Paso 4: Implementación Técnica (3-4 semanas)

  • Genera XML desde tu BD cada vez que se crea factura.
  • Firma XML con certificado digital.
  • Envía a SUNAT (directo o OSE).
  • Recibe y procesa CDR.
  • Genera PDF visual para cliente.
  • Envía por email automáticamente.

Paso 5: Testing Exhaustivo (2 semanas)

  • Casos válidos: Facturas normales, con descripción larga, múltiples items, descuentos.
  • Casos de error: RUC no válido, montos negativos, formato incorrecto.
  • Validación: Verifica que CDR se reciba correctamente.
  • Performance: ¿Cuánto tarda de punta a punta? (Meta: < 5 segundos).

Paso 6: Go-Live (Semana 13+)

  • Activa certificado en producción.
  • Cambia URL SUNAT de prueba a producción.
  • Monitoreo constante primeras 48 horas.
  • Soporte técnico disponible.

Errores Comunes en Facturación Electrónica

  • ❌ RUC cliente incorrecto: SUNAT rechaza si RUC no existe. Valida antes de enviar.
  • ❌ Serie y número no secuencial: SUNAT rechaza si ya enviaste F001-000124.
  • ❌ IGV mal calculado: 18% debe aplicarse sobre subtotal, no total. Error = multa.
  • ❌ Certificado expirado: Firma falla. Renueva anualmente.
  • ❌ XML mal formado: Una etiqueta cerrada incorrectamente = rechazo total.
  • ❌ Sin resguardo de CDR: Si SUNAT rechaza, ¿tienes copia? Archiva todo.

Herramientas Recomendadas

Para Desarrollo Directo:

  • XMLSec (PHP): Librería para firmar XML.
  • phpmailer: Enviar facturas por email.
  • DOMPDF o mPDF: Generar PDF desde HTML.
  • PHPUnit: Testing de integración.

OSEs recomendadas:

  • Tife (A4 Group): Más popular en Perú. API clara, buen soporte.
  • Compass Group: Opción con buen precio para volumen alto.
  • Phicus: Buena opción si necesitas también retenciones.

Caso de Estudio: Importadora de Electrónica

Antes:

  • Facturaba manualmente en Excel.
  • Encargado de contabilidad imprimía, cliente recibía papel.
  • 30% de facturas con errores (RUC, montos, descripciones).
  • Multas SUNAT acumuladas: $5,000/año.
  • Tiempo de facturación: 3 horas por lote de 50 facturas.

Implementación: Integración con OSE Tife en 3 semanas.

Después:

  • Facturación automática al cerrar venta (< 1 segundo).
  • Errores: 0.1% (casi cero).
  • Multas SUNAT: $0 (cumplimiento automático).
  • Tiempo ahorrado: 2.5 horas/día = 5 horas/semana.
  • ROI: Pagó inversión en 4 meses.

Requisitos Finales para SUNAT

  • ✅ Certificado digital válido (AC certificada).
  • ✅ Usuarios SUNAT con acceso al módulo FE.
  • ✅ RUC activo y habido.
  • ✅ Comprobantes con serie registrada ante SUNAT.
  • ✅ Conectividad 24/7 (servidores SUNAT).
  • ✅ Archivos de respuesta CDR guardados 5+ años (auditoria).

La facturación electrónica no es opcional en Perú: es ley. Pero implementarla bien es una oportunidad para automatizar, mejorar cumplimiento, reducir errores y escalar ventas sin fricción administrativa. Comienza hoy.

Implementar Facturación Electrónica Volver al blog