Verifactu en Odoo: cómo conectar Odoo con la API Verifactu

Verifacti no tiene módulo oficial para Odoo: Odoo se conecta con la API Verifactu desde un módulo propio que, al publicar una factura, envía sus datos en JSON y guarda el QR que devuelve la API. Sin generar el XML, sin calcular la huella y sin certificado digital: Verifacti envía el registro de facturación a la AEAT como colaborador social. El mismo patrón sirve para TicketBAI con la API TicketBAI.

Entorno de test y NIF de prueba incluidos
Lee la documentación

Qué APIs necesitas para Odoo

Tu conector usa dos piezas: la API de envío que corresponde al NIF (API Verifactu en territorio común; API TicketBAI en Álava, Bizkaia y Gipuzkoa) y la API de gestión de NIFs, que integras una vez para dar de alta el NIF, gestionar el modelo de representación y recibir los webhooks. Cada NIF usa una u otra API según dónde tribute.

Entorno de test y NIF de prueba incluidos

Cómo conectar Odoo con la API

Flujo: factura publicada en Odoo (_post de account.move) → tu módulo → API Verifactu o API TicketBAI → AEAT o hacienda foral.

  1. Da de alta el NIF con la API de gestión de NIFs y firma el modelo de representación. Cada NIF tiene su API key.
  2. Crea un módulo propio que herede account.move y extienda _post: así cubre el botón Publicar, la publicación en lote, la automática y las facturas del TPV.
  3. Llama a POST /verifactu/create (o a /ticketbai/create, según la compañía) con la API key de la compañía.
  4. Guarda qr, huella y uuid en campos de la factura y añade el QR al informe PDF.
  5. Las notas de crédito se envían como rectificativas.

¿Fabricas software y quieres ofrecer Verifactu a tus clientes? Lo tienes en fabricantes de ERP.

Ejemplo: de la factura publicada al registro

El modelo hereda account.move. Las bases y cuotas salen de las líneas de impuesto, en la moneda de la compañía: la retención de IRPF no se envía y el recargo de equivalencia va en su línea de IVA. El total es la suma de lo que se envía. Si la API responde con un error, la publicación se deshace y Odoo muestra el mensaje; una factura registrada no puede volver a borrador. Si publicas en lote y falla una factura, las anteriores del lote ya están registradas aunque Odoo deshaga la publicación: publica de una en una o envía en una cola.

models/account_move.py · Odoo 16–18
# verifacti/models/account_move.py · módulo propio para Odoo 16, 17 y 18.
# Envía cada factura de cliente publicada a la API Verifactu y guarda el QR en la factura.
import hashlib
import json

import requests

from odoo import _, fields, models
from odoo.exceptions import UserError

# Recargo de equivalencia → tipo de IVA al que acompaña
RECARGO = {5.2: 21.0, 1.75: 21.0, 1.4: 10.0, 0.62: 5.0, 0.5: 4.0, 0.26: 2.0}


class ResCompany(models.Model):
    _inherit = "res.company"

    verifacti_api_key = fields.Char(groups="base.group_system")


class AccountMove(models.Model):
    _inherit = "account.move"

    verifactu_uuid = fields.Char(copy=False, readonly=True)
    verifactu_qr = fields.Binary(copy=False, readonly=True)
    verifactu_huella = fields.Char(copy=False, readonly=True)

    # _post cubre el botón, la publicación en lote, la automática y las facturas del TPV
    def _post(self, soft=True):
        posted = super()._post(soft)
        for move in posted.filtered(lambda m: m.move_type == "out_invoice" and not m.verifactu_uuid):
            move._verifactu_enviar()
        return posted

    def button_draft(self):
        if any(self.mapped("verifactu_uuid")):
            raise UserError(_("Esta factura ya está registrada en Verifactu: corrígela con una rectificativa."))
        return super().button_draft()

    def _verifactu_factura(self):
        lineas = {}
        for tax_line in self.line_ids.filtered("tax_line_id"):
            tasa = tax_line.tax_line_id.amount
            if tasa < 0:
                continue  # retención de IRPF: no va en el registro
            tipo = RECARGO.get(tasa, tasa)
            linea = lineas.setdefault(tipo, {"base": 0.0, "cuota": 0.0, "recargo": 0.0, "tipo_recargo": 0.0})
            if tasa in RECARGO:
                linea["recargo"] += -tax_line.balance
                linea["tipo_recargo"] = tasa
            else:
                linea["base"] += tax_line.tax_base_amount
                linea["cuota"] += -tax_line.balance
        serie, _sep, numero = self.name.rpartition("/")
        vat = self.partner_id.vat or ""
        nif = vat[2:] if vat.startswith("ES") else vat
        envio = []
        for tipo, l in lineas.items():
            linea = {
                "base_imponible": f"{l['base']:.2f}",
                "tipo_impositivo": f"{tipo:g}",
                "cuota_repercutida": f"{l['cuota']:.2f}",
            }
            if l["recargo"]:
                linea.update(tipo_recargo_equivalencia=f"{l['tipo_recargo']:g}", cuota_recargo_equivalencia=f"{l['recargo']:.2f}")
            envio.append(linea)
        # Importes en la moneda de la compañía; el total es la suma de lo que se envía (sin la retención)
        total = sum(l["base"] + l["cuota"] + l["recargo"] for l in lineas.values())
        factura = {
            "serie": serie + "/",
            "numero": numero,
            "fecha_expedicion": self.invoice_date.strftime("%d-%m-%Y"),
            "tipo_factura": "F1" if nif else "F2",
            "descripcion": self.ref or self.invoice_line_ids[:1].name or self.name,
            "lineas": envio,
            "importe_total": f"{total:.2f}",
        }
        if nif:
            factura.update(nif=nif, nombre=self.commercial_partner_id.name)
        return factura

    def _verifactu_enviar(self):
        cuerpo = json.dumps(self._verifactu_factura())
        huella_cuerpo = hashlib.sha256(cuerpo.encode()).hexdigest()[:12]
        r = requests.post(
            "https://api.verifacti.com/verifactu/create",
            data=cuerpo,
            headers={
                "Authorization": f"Bearer {self.company_id.sudo().verifacti_api_key}",
                "Content-Type": "application/json",
                "Idempotency-Key": f"odoo-{self.env.cr.dbname}-{self.id}-{huella_cuerpo}",
            },
            timeout=30,
        )
        registro = r.json()
        if r.status_code != 200:
            raise UserError(_("Verifactu: %s", registro.get("error")))
        self.write({
            "verifactu_uuid": registro["uuid"],
            "verifactu_qr": registro["qr"],
            "verifactu_huella": registro["huella"],
        })

El código agrupa las líneas por tipo de IVA y usa F1 si el cliente tiene NIF y F2 si no. Envía la cabecera Idempotency-Key con el identificador de la factura y un resumen del cuerpo: un reintento igual no duplica la factura y, si corriges los datos tras un error, la clave cambia. La respuesta trae el uuid, el estado (Pendiente: el envío a la AEAT queda en cola), la URL de verificación, el QR en Base64 y la huella: guárdalos con la factura.

Más código en el tutorial de Verifactu en Python. Para TicketBAI, la llamada es a POST /ticketbai/create con la API key del NIF foral: los campos, en la documentación de la API TicketBAI.

Casos particulares en Odoo

Casos particulares al facturar desde Odoo
CasoQué hacerDónde ampliar
NumeraciónCada factura necesita una serie con numeración correlativa. Si los números de factura pueden tener huecos, asigna a la factura un número propioRequisitos de Verifactu
Cliente sin NIFFactura simplificada (F2), sin nif ni nombre. La API rechaza una F2 de más de 3.000 € (vf-verifactu-f2_limite_3000)Factura simplificada
Devolución o abonoFactura rectificativa: R5 si la original era simplificada; R1–R4 si era completaRectificativas
Cliente que pide factura completa despuésFactura de canje (F3) que sustituye a la simplificadaFactura de canje
Canarias, Ceuta y MelillaIGIC o IPSI en las líneas (campo impuesto), no IVAIGIC · IPSI
Productos sin IVARevisa si son exentos (operacion_exenta) o no sujetos (calificacion_operacion): no se envían como tipo 0Factura exenta
AnulaciónSolo para facturas que no debieron emitirse: POST /verifactu/cancelAnulación
Venta a otro país de la UEDepende de si el cliente es empresa y del umbral de ventas a distanciaEjemplos intracomunitarios
Recargo de equivalenciatipo_recargo_equivalencia y cuota_recargo_equivalencia en la línea de IVA, no como otra líneaRecargo de equivalencia
Retención de IRPFNo se envía: importe_total es base + cuota (+ recargo), sin restar la retenciónSuplidos y retención
Varias sociedades o tiendasUn NIF por sociedad, cada uno con su API keyAPI de gestión de NIFs

Fechas

La primera fila solo aplica si construyes el conector para venderlo a otros: entonces vendes software de facturación. Para quien factura, las fechas de Verifactu están publicadas en el BOE y el aplazamiento a octubre de 2028 está anunciado sin norma publicada. En Álava, Bizkaia y Gipuzkoa, TicketBAI está en vigor.

Productores y comercializadores de software de facturaciónDesde 29 jul 2025
El RDL 15/2025 no modificó esta fecha.
En vigor
Contribuyentes del Impuesto sobre Sociedades1 ene 2027
Publicada en el BOE con fecha futura
Resto de obligados, autónomos incluidos1 jul 2027
Publicada en el BOE con fecha futura
Aplazamiento de las obligaciones pendientesoct 2028
La nota no precisa el alcance para quien factura más de 8 M€.
Anunciada sin norma publicada
TicketBAI en Álava: obligados foralesDesde 1 dic 2022
Escalonado desde el 1 de abril de 2022; el resto de contribuyentes, desde el 1 de diciembre de 2022.
En vigor
Batuz en Bizkaia (TicketBAI y LROE): todos los obligadosDesde 1 ene 2026
Sociedades que no son pymes, desde el 1 de enero de 2024; el resto, en ventanas el 1 de julio de 2024, el 1 de enero de 2025, el 1 de julio de 2025 y el 1 de enero de 2026.
En vigor
TicketBAI en Gipuzkoa: obligados foralesDesde 1 jun 2023
Escalonado por actividad desde el 1 de julio de 2022.
En vigor

Esta información no es asesoramiento: cada contribuyente determina lo que le aplica con su asesor.

Más detalle en plazos de Verifactu y TicketBAI.

Precio

Tarifa pública de la API Verifactu y la API TicketBAI: pagas por cada NIF activo en producción, sin IVA. Para volumen hay precio a medida por NIF.

Desde

14,99 €

al mes el primer NIF activo en producción, sin IVA

Ver todos los precios
  • El precio por NIF baja con cada tramo de NIFs.
  • Entorno de test y NIF de prueba gratuitos.
  • Plan anual con un 10 % de descuento, sin costes de instalación.
  • Hasta 3.000 registros de facturación al mes por NIF.
  • Plan Startup para empresas de menos de 12 meses, con menos de 100.000 € de facturación y menos de 200.000 € de financiación.
  • Mismo precio con la API Verifactu y la API TicketBAI: cada NIF usa una u otra según dónde tribute.
  • Firma online del modelo de representación: 2,90 € + IVA por firma.

Preguntas sobre Verifactu y Odoo

Más preguntas sobre Verifactu

¿Hay un módulo o app de Verifacti para Odoo?

No. Verifacti es una API: Odoo se conecta con ella con el código de esta página, en tu propio desarrollo. En la tienda de apps de Odoo hay módulos de terceros.

¿Basta con Odoo para cumplir Verifactu?

Depende de tu versión y de lo que tengas instalado: compruébalo con tu proveedor. Quien factura necesita un sistema que genere los registros de facturación y los envíe a la AEAT. Qué obligación tiene cada negocio depende de su caso: a quién aplica Verifactu.

¿Sirve también para TicketBAI?

Sí. Si el NIF tributa en Álava, Bizkaia o Gipuzkoa, el flujo es el mismo con la API TicketBAI: cambian el endpoint (/ticketbai/create), los campos de la factura y la API key.

¿Necesito certificado digital?

No. Verifacti es colaborador social de la AEAT y envía con su propio certificado, una vez que el contribuyente firma el modelo de representación, el mismo para la AEAT y las haciendas forales. Se puede firmar online, sin certificado.

¿Cuánto cuesta?

Desde 14,99 € al mes el primer NIF activo en producción, sin IVA, con la API Verifactu o con la API TicketBAI. El entorno de test y el NIF de prueba son gratis. Todos los planes, en precios.

Conecta Odoo en el entorno de test

Crea tu cuenta gratuita y prueba la API con un NIF de prueba antes de pasar a producción.

Entorno de test y NIF de prueba incluidosLee la documentación