Saltar al contenido principal

Importar facturas y migrar desde otro ERP

Cambia a Frihet en minutos — incluso en mitad de trimestre — sin huecos de numeración, sin duplicar impuestos en el Modelo 303 / 130 / 420 y respetando la integridad de tu cadena VeriFactu.

Planificador interactivo de migración y continuidad de serie​

Selecciona tu programa anterior, tu territorio fiscal (Península y Baleares IVA, Canarias IGIC o País Vasco TicketBAI) y el último número de factura emitido para obtener tu ruta exacta de migración y la plantilla CSV lista para copiar:

Alcance de la validación local (L1–L3 vs. L4): el validador de esta página ejecuta en tu navegador la prevalidación L1–L3 (L1 sintaxis y cabeceras CSV, L2 cuadre aritmético ±0,01 € y fechas, y L3 NIF/NIE/CIF o VIES y continuidad correlativa por serie), sin enviar datos por red. La capa L4 de importabilidad final (pending_erp_dry_run) se comprueba dentro de Frihet al subir el archivo, donde las filas entran como borradores para revisión y las facturas ya expedidas permanecen en tu software de origen.

MIGRATION STUDIO V1 · CONTINUIDAD DE SERIE Y VALIDADOR CSV PRE-VUELO

Planifica el cambio de ERP y valida tu libro registro antes de importar

IVA (AEAT)
Serie de numeración (RD 1619/2012) vs. encadenamiento del SIF (RD 1007/2023)
Importante distinción normativa (RD 1619/2012 vs RD 1007/2023 y Orden HAC/1177/2024): un Sistema Informático de Facturación (SIF) encadena en una única cadena SHA-256 todos sus registros de facturación de todas las series. Al cambiar de programa a Frihet, la cadena de registros de Frihet es independiente porque Frihet es un SIF distinto (su primer registro nace con PrimerRegistro = S), NO por cambiar la serie. Por tanto, puedes continuar correlativamente tu serie actual (Opción A, práctica estándar) o abrir una serie diferenciada si está justificado (Opción B, Art. 6.1.a RD 1619/2012).
OPCIÓN A · CONTINUACIÓN CORRELATIVA (ESTÁNDAR RECOMENDADO)
F2026-0143
Fija el contador inicial en 143 en Ajustes → Facturación → Series de Facturación para continuar la misma serie sin saltos. Frihet abre su propia cadena de registros SIF (PrimerRegistro = S) automáticamente por ser un SIF distinto.
OPCIÓN B · SERIE SEPARADA (ART. 6.1.a RD 1619/2012)
F2026-FRI-0001
Opcional cuando existan razones objetivas que lo justifiquen (distintos canales/puntos de expedición o separación organizativa). Conserva F2026-0001..0142 en tu sistema anterior; no las reemitas.
1. Continuidad de numeración (Art. 6.1.a RD 1619/2012)
Dentro de cada serie la numeración debe ser correlativa (F2026-0143). Se permiten series separadas cuando existan razones objetivas (distintos puntos o canales de expedición).
2. Conservación del histórico (Art. 29.2.e LGT · art. 19 RD 1619/2012)
Exporta y conserva los registros, XML/PDFs y libros del sistema anterior durante el plazo de prescripción fiscal (4 años). Nunca reemitas facturas antiguas como nuevas.
3. Identidad del SIF (RD 1007/2023)
Cada software de facturación se identifica por IDEmisorFactura + IdSistemaInformatico + NumeroInstalacion. Frihet es un SIF distinto al de tu ERP anterior.
4. Encadenamiento del SIF (Orden HAC/1177/2024)
Un SIF encadena todos sus registros en una única cadena (aunque uses varias series). Al estrenar Frihet, su cadena se inicia con PrimerRegistro = S por ser otro SIF.
5. Cuadre trimestral (Modelos 303 / 130 / 420)
Las facturas ya emitidas no se reemiten. Frihet no importa facturas ya expedidas conservando su estado y numeración: en el modelo del trimestre del cambio, suma con tu asesor los importes de tu software anterior y los de Frihet. Las importaciones de Facturas → Importar (IA) y de Ajustes → Importar y migrar (CSV) crean borradores.
Checklist interactivo de migración en 5 pasos1 de 5 completados
Validador interactivo CSV pre-vuelo (4 capas: sintaxis, aritmética, dígito de control NIF/CIF y correlatividad por serie)
Contrato de privacidad (validación 100 % local en tu navegador): Las filas que pegues aquí se procesan exclusivamente en la memoria local de tu navegador. Ningún NIF, nombre ni importe se transmite por red, y la analítica de Docs opera con PostHog autocapture: false y sin grabación de sesión.
L1 · Esquema y Sintaxis CSVPASS
Separador «,», comillas RFC-4180 y columnas obligatorias.
L2 · Aritmética y FechasPASS
Importes numéricos estrictos (sin NaN), fechas reales y cuadre.
L3 · NIF/CIF y SeriesPASS
Dígito de control NIF/NIE/CIF y correlatividad por serie (1 serie).
L4 · Importación en FrihetCOMPROBACIÓN EN LA APP
Esta prevalidación en tu navegador (L1–L3) no certifica nada más allá de esas comprobaciones. La importación real (como borradores) se valida en app.frihet.io: confirma allí el resultado.
✓ Prevalidación local L1–L3 superada (2/2 filas válidas en 1 serie; confirmar importación L4 en app.frihet.io) · Base: 2500.00 € · Impuestos: 525.00 € · Total: 3025.00 €

Las vías de importación en Frihet​

MétodoCuándo usarloCómo funciona
1. Importación con IA (PDF / imagen / CSV)Quieres pasar facturas sueltas a Frihet y revisarlas antes de emitirlas.En Ventas → Facturas → Importar subes los archivos (PDF, JPG, PNG o CSV). La IA extrae cliente, NIF/CIF, fechas, líneas e impuestos y te muestra una revisión que marca posibles duplicados y datos incompletos. Las facturas se crean como borrador: no son histórico cerrado y siguen la emisión normal.
2. Importación CSVTraes datos desde tu software anterior (ContaPlus, A3, Xero, QuickBooks, Quipu, Billin…).En Ajustes → Importar y migrar subes el CSV y mapeas columnas. Las facturas entran como borrador para revisión: no emitas las que ya expediste en tu software anterior. Frihet no importa facturas ya expedidas conservando su estado y numeración de origen.
3. API REST y MCPAutomatizas la migración con un script o con tu agente IA.API REST (POST /v1/invoices, POST /v1/expenses) y @frihet/mcp-server (create_client, create_invoice, create_expense). POST /v1/invoices crea la factura como borrador por defecto; no es la vía de histórico atestiguado.

Cómo cambiar de programa a mitad de trimestre: serie de numeración vs. cadena del SIF​

Al cambiar de ERP es fundamental no confundir dos planos normativos distintos: la serie de numeración de las facturas (Art. 6.1.a RD 1619/2012) y el encadenamiento de registros del Sistema Informático de Facturación — SIF (RD 1007/2023 y Orden HAC/1177/2024):

  1. Encadenamiento del SIF (Art. 29.2.j LGT, RD 1007/2023 y Orden HAC/1177/2024): un mismo SIF (identificado por IDEmisorFactura + IdSistemaInformatico + NumeroInstalacion) encadena en una única secuencia SHA-256 todos sus registros de facturación, con independencia de cuántas series de numeración utilice. Cuando pasas de otro software a Frihet, la cadena de registros de Frihet es independiente porque Frihet es un SIF distinto (su primer registro de facturación nace con el indicador PrimerRegistro = S), no porque cambies el prefijo de tu serie.
  2. Conservación del histórico (Art. 29.2.e LGT y art. 19 RD 1619/2012): nunca vuelvas a «emitir» como nuevas las facturas ya expedidas en tu software anterior. Conserva los registros y ficheros exportados de tu sistema previo durante el plazo de prescripción fiscal. Frihet no importa esas facturas conservando su estado y numeración, así que sus importes no entran en los borradores de los modelos de Frihet: en el Modelo 303, 130 o 420 del trimestre del cambio, súmalos con tu asesor. Las importaciones de Ventas → Facturas → Importar (IA) y de Ajustes → Importar y migrar (CSV) crean borradores que se emitirían como facturas nuevas.
  3. Configuración de la serie para las nuevas facturas en Frihet (Art. 6.1.a RD 1619/2012):
    • Opción A — Continuación correlativa en la serie actual (estándar recomendado): mantén tu serie actual (F2026) y fija el contador inicial en último número + 1 en Ajustes → Facturación (sección Series de Facturación) para continuar sin huecos ni duplicados. Frihet abrirá igualmente su propia cadena SIF con PrimerRegistro = S.
    • Opción B — Serie separada (opcional cuando esté justificado, Art. 6.1.a RD 1619/2012): crea una serie diferenciada (p. ej., F2026-FRI-0001) si existen razones objetivas que lo justifiquen (distintos canales o puntos de expedición, actividades diferenciadas o separación organizativa).

Paso a paso: importación con IA (Subir → Revisar → Confirmar)​

  1. Ve a Ventas → Facturas y pulsa Importar.
  2. Subir: arrastra tus PDF, imágenes (JPG, PNG) o CSV exportados de tu sistema anterior.
  3. Revisar: comprueba y edita los datos detectados. Frihet marca las facturas sin cliente o sin número, las líneas con datos no válidos y los posibles duplicados.
  4. Confirmar: las facturas se crean como borrador. Revísalas antes de emitirlas.

Las facturas que ya expediste en tu software anterior no se importan para emitirlas: consérvalas en ese sistema (ver el punto 2 de la sección anterior).

Automatización vía API REST y Servidor MCP​

Si prefieres migrar mediante script o encargar la migración a tu agente IA (Claude Code, Cursor), utiliza los endpoints oficiales y las herramientas verificadas de @frihet/mcp-server:

# Crear una factura (en borrador por defecto) mediante la API REST v1
curl -X POST "https://api.frihet.io/v1/invoices" \
  -H "X-API-Key: fri_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "clientName": "Acme Studio SL",
    "clientTaxId": "B12345674",
    "issueDate": "2026-10-05",
    "dueDate": "2026-11-04",
    "items": [{ "description": "Consultoría técnica Q4", "quantity": 1, "unitPrice": 1500 }],
    "taxRate": 21
  }'

Referencia​

Última actualización en