Integrar tu ERP con VeriFactu: cuándo usar API y cuándo CSV (con ejemplos prácticos)

Si tu empresa ya trabaja con un ERP, el reto no es “hacer facturas”, sino conseguir que el flujo completo (emisión, correcciones y control del histórico) quede estable y trazable. Con Vericloud para integrar tu ERP con VeriFactu puedes plantear la adaptación de forma ordenada, sin romper tu operativa diaria y sin depender de apaños de última hora.

Integrar un ERP con VeriFactu: lo que cambia en tu flujo (más allá del envío)

Antes de elegir API o CSV, conviene entender qué exige realmente una integración bien hecha. En un entorno VeriFactu, lo importante es que el sistema pueda reconstruir el “qué pasó” y el “cuándo pasó”, especialmente cuando hay correcciones.

Tres cambios prácticos que suelen impactar en ERP:

• Correcciones con trazabilidad: rectificativas, abonos y anulaciones no deberían convertirse en “ediciones” que reescriben el pasado. El ERP (o el flujo que lo rodea) debe registrar la relación entre la factura original y su corrección, manteniendo trazabilidad del histórico.

• Identificadores y coherencia: necesitas un identificador estable por factura (y por corrección) que se conserve en todo el circuito: ERP → integración → registro → consulta de estado.

• Estados y reintentos controlados: una integración real debe poder responder a “¿se envió?”, “¿falló?”, “¿por qué?” y “¿cómo reintento sin duplicar?”.

Si quieres tener la base conceptual clara (sin tecnicismos), aquí tienes la guía principal: qué es VeriFactu y cómo funciona.

API vs CSV para VeriFactu: cuándo elegir cada uno (criterios reales)

La decisión no va de “qué suena más moderno”, sino de qué encaja mejor con tu ERP, tu volumen de emisión y tu necesidad de control.

Cuándo usar API

Elige API cuando necesitas una integración robusta y automatizada:

• Volumen medio/alto o facturación continua durante el día.

• Necesitas estado en tiempo real (enviada, pendiente, fallida) y respuesta inmediata para actuar.

• Te preocupa el control de reintentos y evitar duplicados (con lógica de idempotencia).

• Tienes varios orígenes de facturas (ERP + eCommerce + TPV) y quieres unificar el flujo.

API suele ser la opción correcta cuando tu prioridad es minimizar intervención manual y tener trazabilidad completa de cada evento.

Cuándo usar CSV

Elige CSV cuando lo que manda es arrancar rápido o el ERP es más rígido:

• ERP “legacy” o on-premise que exporta listados pero no expone una API útil.

• Volumen bajo/moderado y puedes operar por lotes (diario, por ejemplo).

• Necesitas un “MVP” de integración para cumplir y luego evolucionar.

• Tienes recursos limitados de desarrollo y quieres evitar un proyecto largo.

CSV funciona bien si lo diseñas con cabeza: formato estable, validación previa y un sistema de control de errores que te diga exactamente qué ha fallado.

Regla rápida para decidir (sin complicarte)

• Si tu preocupación principal es control y estabilidad → API.

• Si tu preocupación principal es rapidez de implantación → CSV.

• Si necesitas las dos cosas → empieza con CSV, estabiliza el flujo y después evoluciona a API.

Para ampliar con una referencia oficial, aquí tienes las preguntas frecuentes de la AEAT sobre sistemas VERI*FACTU.

Y, si estás planificando por tiempos, te ayuda tener a mano el calendario: Entrada en vigor de VeriFactu: fechas, calendario y qué hacer antes de la obligación.

Ejemplos prácticos: 3 escenarios típicos y la solución que suele funcionar

Escenario 1: ERP cloud + facturación diaria intensa → API

Situación típica: se emiten facturas durante todo el día y necesitas que el ERP “sepa” en qué estado está cada una.

Solución recomendada: API con control de estados y reintentos.

Flujo práctico:

1. El ERP emite la factura y genera id_factura_erp.

2. Se dispara un evento (cola / webhook / tarea programada).

3. La integración envía por API, recibe respuesta y guarda el estado.

4. El ERP muestra “Enviada” o “Fallida” con motivo y acciones.

Dónde se gana el partido: en la gestión de correcciones. Si el ERP genera una rectificativa, la integración debe enviar el evento como corrección vinculada, sin “pisar” el registro anterior.

Escenario 2: ERP antiguo (sin API útil) → CSV por lotes

Situación típica: el ERP exporta listados, nadie quiere tocarlo y se busca cumplimiento sin proyecto largo.

Solución recomendada: CSV diario con validación previa + informe de resultado.

Flujo práctico:

1. Exportas un CSV con las facturas nuevas (y, si aplica, correcciones).

2. Validación automática: campos obligatorios, formato, totales e impuestos coherentes.

3. Importación y envío del lote.

4. Informe: enviadas / fallidas / motivo.

5. Reintento solo de las fallidas, sin duplicar las correctas.

Qué no puede faltar en el CSV:

• id_factura_erp (estable)

• serie + número

• fecha de emisión

• NIF del cliente

• base/IVA/total

• tipo (normal / rectificativa / anulación)

• id_relacionada si es corrección

Si no defines bien esto, el CSV se convierte en “otro Excel más” y pierdes lo más importante: trazabilidad del histórico.

Escenario 3: Empresa en transición → CSV primero, API después

Situación típica: hay urgencia por cumplir, pero sabes que a medio plazo necesitas automatizar de verdad.

Solución recomendada: estrategia por fases.

• Fase 1 (CSV): formato estable + reglas de corrección + disciplina operativa.

• Fase 2 (API): automatización, estados en tiempo real y menos intervención humana.

Este enfoque suele ser el más rentable porque evita un error clásico: automatizar un proceso que todavía está desordenado.

Si quieres reducir riesgos desde el principio, te recomiendo leer Errores comunes al implementar VeriFactu y cómo evitarlos (te ahorra retrabajo en integraciones) y Beneficios de VeriFactu para la contabilidad en tiempo real (te ayuda a alinear a administración/contabilidad con el equipo técnico).

Y si en tu caso no tiene sentido integrar (por ejemplo, porque no quieres depender del ERP para emitir/corregir), valora un flujo ya preparado con el Programa de facturación VeriFactu.

Cierre: API o CSV es una decisión importante, pero no es la primera. Lo primero es definir el flujo real de tu negocio (especialmente correcciones) y asegurar identificadores, estados y trazabilidad. Cuando eso está claro, la tecnología encaja sola: CSV para arrancar rápido y compatibilizar con ERPs cerrados; API para control fino, automatización y estabilidad a largo plazo.