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.
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.
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.
- 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.
- Crea un módulo propio que herede
account.movey extienda_post: así cubre el botón Publicar, la publicación en lote, la automática y las facturas del TPV. - Llama a
POST /verifactu/create(o a/ticketbai/create, según la compañía) con la API key de la compañía. - Guarda
qr,huellayuuiden campos de la factura y añade el QR al informe PDF. - 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.
# 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
| Caso | Qué hacer | Dónde ampliar |
|---|---|---|
| Numeración | Cada factura necesita una serie con numeración correlativa. Si los números de factura pueden tener huecos, asigna a la factura un número propio | Requisitos de Verifactu |
| Cliente sin NIF | Factura 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 abono | Factura rectificativa: R5 si la original era simplificada; R1–R4 si era completa | Rectificativas |
| Cliente que pide factura completa después | Factura de canje (F3) que sustituye a la simplificada | Factura de canje |
| Canarias, Ceuta y Melilla | IGIC o IPSI en las líneas (campo impuesto), no IVA | IGIC · IPSI |
| Productos sin IVA | Revisa si son exentos (operacion_exenta) o no sujetos (calificacion_operacion): no se envían como tipo 0 | Factura exenta |
| Anulación | Solo para facturas que no debieron emitirse: POST /verifactu/cancel | Anulación |
| Venta a otro país de la UE | Depende de si el cliente es empresa y del umbral de ventas a distancia | Ejemplos intracomunitarios |
| Recargo de equivalencia | tipo_recargo_equivalencia y cuota_recargo_equivalencia en la línea de IVA, no como otra línea | Recargo de equivalencia |
| Retención de IRPF | No se envía: importe_total es base + cuota (+ recargo), sin restar la retención | Suplidos y retención |
| Varias sociedades o tiendas | Un NIF por sociedad, cada uno con su API key | API 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.
| Quién | Fecha | Estado | Norma |
|---|---|---|---|
| Productores y comercializadores de software de facturación El RDL 15/2025 no modificó esta fecha. | Desde 29 jul 2025 | En vigor | RD 1007/2023 · Orden HAC/1177/2024 |
| Contribuyentes del Impuesto sobre Sociedades | 1 ene 2027 | Publicada en el BOE con fecha futura | RDL 15/2025 |
| Resto de obligados, autónomos incluidos | 1 jul 2027 | Publicada en el BOE con fecha futura | RDL 15/2025 |
| Aplazamiento de las obligaciones pendientes La nota no precisa el alcance para quien factura más de 8 M€. | oct 2028 | Anunciada sin norma publicada | Nota de Hacienda, 5 oct 2026 |
| TicketBAI en Álava: obligados forales Escalonado desde el 1 de abril de 2022; el resto de contribuyentes, desde el 1 de diciembre de 2022. | Desde 1 dic 2022 | En vigor | NF 13/2021 y DF 48/2021 · FAQ 1.9 · calendario |
| Batuz en Bizkaia (TicketBAI y LROE): todos los obligados 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. | Desde 1 ene 2026 | En vigor | NF 8/2023 · Batuz |
| TicketBAI en Gipuzkoa: obligados forales Escalonado por actividad desde el 1 de julio de 2022. | Desde 1 jun 2023 | En vigor | NF 3/2020 · DF 32/2020 |
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.
Recursos para desarrolladores
Para tu IA: llms.txt y la especificación OpenAPI.
Preguntas sobre Verifactu y Odoo
Más preguntas sobre Verifactu¿Hay un módulo o app de Verifacti para Odoo?
¿Basta con Odoo para cumplir Verifactu?
¿Sirve también para TicketBAI?
/ticketbai/create), los campos de la factura y la API key.¿Necesito certificado digital?
¿Cuánto cuesta?
Otras integraciones
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.