Módulo para la declaración de todas las operaciones de venta realizadas por las personas y entidades que desarrollan actividades económicas y tributan en alguno de los territorios históricos del País Vasco/Euskadi.
TicketBAI es un proyecto común de las Haciendas Forales Vascas y del Gobierno Vasco. https://www.euskadi.eus/contenidos/informacion/ticketbai/es_14815/adjuntos/TicketBAI_Especificaciones_v_1_1.pdf
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 16.0Envía facturas de venta y abonos a la agencia tributaria vasca (TicketBAI) directamente desde Odoo, con generación automática de XML, firma y cancelación, y configura las posiciones fiscales, impuestos y datos de la empresa requeridos por las autoridades vascas.
Este módulo conecta la facturación de Odoo con el sistema TicketBAI del País Vasco. Cuando una empresa activa TicketBAI, cada factura de cliente o abono publicado desde un diario de ventas marcado para el envío se convierte automáticamente en un registro TicketBAI, que se construye y se envía a la agencia tributaria. El formulario de la factura muestra la factura TicketBAI, sus respuestas y los registros de anulación, además de campos para las claves de régimen de IVA, el motivo del abono y la fecha de la operación.
- Las empresas configuran TicketBAI en sus ajustes: lo activan, eligen el certificado, el método de descripción (fijo, manual o automático a partir de las líneas de factura), el texto de datos protegidos y la agencia tributaria.
- Las posiciones fiscales llevan hasta tres claves de régimen de IVA y una lista de exenciones fiscales; estos se copian a las facturas cuando se selecciona la posición fiscal.
- Los impuestos se asignan a las categorías de TicketBAI (bienes, servicios, recargos, exenciones, IRPF) mediante un mapa de impuestos, de modo que el XML informa del tipo de impuesto y los importes correctos.
- Las facturas de abono requieren los datos de la factura original o una factura rectificada vinculada; el módulo bloquea la publicación si falta la factura TicketBAI original o si ya está anulada.
- Una vez enviada una factura, no se puede restablecer a borrador, y las facturas de cliente no se pueden renumerar mientras TicketBAI esté activado.
- La anulación de una factura crea un registro de anulación de TicketBAI; los abonos deben anularse primero.
- Los diarios tienen una opción «Enviar facturas TicketBAI» que no se puede desactivar si ya se han enviado facturas.
- El módulo añade menús y pantallas para las facturas TicketBAI, los mapas de impuestos, las claves de régimen de IVA y las claves de exención, y un asistente de información para desarrolladores.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (20)
- tbai.info · modelo nuevoname (Developer name), software, company_id (Company), developer_id (Developer), tbai_enabled, device_serial_number
- account.tax · amplía un modelo existente
- res.company · amplía un modelo existentetbai_description (TicketBAI Description), tbai_protected_data (Protected Data), tbai_description_method (TicketBAI Description Method), tbai_protected_data_txt (Substitution Text), tbai_aeat_certificate_id (AEAT Certificate)
- account.move · amplía un modelo existentetbai_enabled, tbai_invoice_id (TicketBAI Invoice), tbai_refund_key, tbai_invoice_ids (TicketBAI Invoices), tbai_refund_type, tbai_response_ids (Responses), tbai_send_invoice, tbai_date_operation (Operation Date), tbai_vat_regime_key (VAT Regime Key), tbai_cancellation_id (TicketBAI Cancellation), tbai_vat_regime_key2 (VAT Regime 2nd Key), tbai_vat_regime_key3 (VAT Regime 3rd Key), tbai_cancellation_ids (TicketBAI Cancellations), tbai_datetime_invoice, tbai_refund_origin_ids (TicketBAI Refund Origin References), tbai_description_operation (Operation Description), tbai_substitution_invoice_id, tbai_substitute_simplified_invoice (Substitute Simplified Invoice)
- tbai.invoice · amplía un modelo existenteinvoice_id, cancelled_invoice_id
- tbai.tax.map · modelo nuevocode, name, tax_template_ids (Taxes)
- account.journal · amplía un modelo existentetbai_enabled, tbai_send_invoice (Send TicketBAI invoices to tax agency)
- account.move.line · amplía un modelo existente
- account.fp.tbai.tax · modelo nuevotax_id (Tax), position_id (Fiscal Position), tbai_vat_exemption_key (VAT Exemption Key)
- tbai.vat.regime.key · modelo nuevocode, name
- account.move.reversal · amplía un modelo existente
- account.chart.template · amplía un modelo existente
- tbai.vat.exemption.key · modelo nuevocode, name
- account.fiscal.position · amplía un modelo existentetbai_vat_regime_key (VAT Regime Key), tbai_vat_regime_key2 (VAT Regime 2nd Key), tbai_vat_regime_key3 (VAT Regime 3rd Key), tbai_vat_exemption_ids
- l10n.es.aeat.certificate · amplía un modelo existentetbai_p12, tbai_p12_friendlyname (Alias)
- account.resequence.wizard · amplía un modelo existente
- tbai.invoice.refund.origin · modelo nuevonumber, number_prefix, expedition_date, account_refund_invoice_id
- account.fp.tbai.tax_template · modelo nuevotax_id (Tax), position_id (Fiscal Position), tbai_vat_exemption_key (VAT Exemption Key)
- account.fiscal.position.template · amplía un modelo existentetbai_vat_regime_key (VAT Regime Key), tbai_vat_regime_key2 (VAT Regime 2nd Key), tbai_vat_regime_key3 (VAT Regime 3rd Key), tbai_vat_exemption_ids
- l10n.es.aeat.certificate.password · amplía un modelo existente
Texto generado por IA (DeepSeek) al leer el código de la versión 16.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.
Fuentes · Odoo 15.0
Confirmado el 2026-11-03 en la rama 15.0 de OCA/l10n-spain.
terminal Instalación y uso
Documentación de OCA · Odoo 16.0Configuración
Fuente · Odoo 16.0Para configurar este módulo es necesario:
En la compañía:
- Ver descripción módulo l10n_es_ticketbai_api
- Certificado AEAT, dar de alta en la configuración de certificados AEAT en facturación
Posición fiscal:
- Claves de regímenes de IVA (se pueden configurar hasta tres)
- Código de exención de IVA para un IVA en particular
Diario
- Permitir cancelación de asientos (habilita el envío del fichero de anulación al cancelar una factura)
- Habilitar/deshabilitar envio de facturas TicketBAI por diarios de ventas
- En caso de que se tengan varias series de facturación, si una de ellas se envía a TicketBAI a través de otro software, en el diario de ventas en el cual se contabilizan estas facturas en Odoo deberá estar desactivado el envío de facturas TicketBAI para evitar duplicar la información en hacienda.
Clientes
- Tipo de identificación fiscal (e.g.: NIF-IVA)
- Factura de cliente
- Se genera el fichero y se firma al validar la factura.
- Factura de cliente rectificativa
- Diferencias (total o parcial)
- Parcial: se genera el fichero y se firma al validar la factura rectificativa. La factura se ha tenido que generar desde el asistente de emitir rectificativa
- Total: se genera el fichero y se firma al crear la rectificativa desde el asistente de emitir rectificativa, escogiendo la opción
cancelar - Anulación de factura
- Se genera un nuevo fichero de anulación y se firma al cancelar una factura validada. La factura se queda en estado cancelado y no puede ser pasada a borrador para volver a validarse.
- Secuencias de diarios (aplicado cuando la compañía habilita TicketBAI)
- Por limitaciones de TicketBAI, se eliminan los sufijos de las secuencias de los diarios de ventas.
- Por legalidad, se obliga a especificar una secuencia dedicada para las facturas rectificativas.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.