OdooWiki OCA HUB

TicketBAI - API

l10n_es_ticketbai_api folder_open OCA/l10n-spain open_in_new
Accounting & Finance Licencia: AGPL-3

TicketBAI - API

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 16.0

Este módulo añade la base técnica para TicketBAI, el sistema de facturación electrónica del País Vasco, permitiendo a las empresas configurar su certificado, el registro del software y la agencia tributaria para que las facturas puedan firmarse, recibir un código QR y enviarse a la autoridad tributaria vasca.

Este módulo es la capa de API que prepara Odoo para funcionar con TicketBAI, el requisito de facturación electrónica del País Vasco. No crea facturas por sí mismo; almacena los datos necesarios para firmarlas y enviarlas.

En los ajustes de la compañía puedes habilitar TicketBAI, elegir un certificado de firma P12, registrar el software (nombre, versión, clave de licencia y desarrollador), seleccionar la agencia tributaria e introducir un número de serie del dispositivo. El módulo comprueba que hay un certificado y una agencia tributaria configurados cuando TicketBAI está habilitado, y bloquea el cambio de la agencia tributaria una vez que ya se ha enviado una factura TicketBAI.

Añade un menú TicketBAI en Administración con pantallas para certificados e instalaciones. En los contactos añade un tipo de identificación y un número de identificación usados para los clientes, con comprobaciones de longitud.

Entre bastidores construye los registros de factura TicketBAI, calcula el identificador TBAI y el código QR, prepara el XML y los archivos de cancelación, y almacena las respuestas de la agencia tributaria y sus mensajes. Una tarea programada envía automáticamente las facturas pendientes, reintentando cuando el servicio no está disponible y marcando la cadena como error tras rechazos repetidos.

Depende de

basebase_setup

Lo necesitan otros módulos

l10n_es_ticketbail10n_es_ticketbai_api_batuz

Menús que añade

TicketBAITicketBAI CertificatesTicketBAI Installations
Modelos y campos (14)
  • res.company · amplía un modelo existentetbai_enabled (Enable TicketBAI), tbai_license_key (License Key), tbai_developer_id (Developer), tbai_test_enabled (Enable testing), tbai_pro_available (Are Production URLs Available), tbai_software_name (Software Name), tbai_tax_agency_id (TBAI Tax Agency), tbai_certificate_id (Certificate), tbai_test_available (Are Tests URLs Available), tbai_installation_id, tbai_last_invoice_id (Last TicketBAI Invoice sent), tbai_software_version (Software Version), tbai_device_serial_number (Device Serial Number), tbai_vat_regime_simplified (Regime Simplified)
  • res.partner · amplía un modelo existentetbai_enabled, tbai_partner_idtype (TicketBAI Identification Type Code), tbai_partner_identification_number (TicketBAI Partner Identification Number)
  • tbai.invoice · modelo nuevoqr (QR), name, datas, state (Status), number, qr_url (URL), schema, api_url (TicketBAI API URL), file_size, company_id, datas_fname (File Name), description, refund_code (Invoice Refund Reason Code), refund_type, amount_total, tbai_tax_ids (TicketBAI Invoice Taxes), number_prefix, operation_date, vat_regime_key (VAT Regime Key), expedition_date, expedition_hour, signature_value, tbai_identifier (TBAI Identifier), vat_regime_key2 (Second VAT Regime Key), vat_regime_key3 (Third VAT Regime Key), is_invoice_refund, tbai_customer_ids (TicketBAI Invoice Recipients), tbai_response_ids (Responses), simplified_invoice, tbai_invoice_line_ids (TicketBAI Invoice Details)
  • tbai.response · modelo nuevoxml (XML Response), state (Status), xml_fname (File Name), tbai_invoice_id, tbai_response_message_ids
  • tbai.tax.agency · modelo nuevoname (Tax Agency name), version (TicketBAI version), qr_base_url (QR Base URL), sign_file_url (Sign File URL), sign_file_hash (Sign File HASH), rest_url_invoice (REST API URL for Invoices), test_qr_base_url (Test QR Base URL), rest_url_cancellation (REST API URL for Invoice Cancellations), test_rest_url_invoice (Test - REST API URL for Invoices), tax_agency_version_ids, test_rest_url_cancellation (Test - REST API URL for Invoice Cancellations)
  • tbai.certificate · modelo nuevoname, datas (P12 Certificate), password, company_id (Company)
  • tbai.invoice.tax · modelo nuevobase, type, amount (Amount (%)), re_amount (Surcharge Amount (%)), is_exempted, amount_total, is_subject_to (Is Subject to), exempted_cause, re_amount_total (Surcharge Amount Total), tbai_invoice_id, not_exempted_type, not_subject_to_cause (Not Subject to Cause), surcharge_or_simplified_regime (Surcharge or Simplified Regime)
  • tbai.installation · modelo nuevovat (TIN), name (Software Name), version (Software Version), license_key, developer_id (Developer)
  • tbai.invoice.line · modelo nuevoquantity, price_unit, description, amount_total, discount_amount, tbai_invoice_id
  • res.config.settings · amplía un modelo existentetbai_enabled, tbai_device_serial_number (Device Serial Number)
  • tbai.invoice.refund · modelo nuevonumber, number_prefix, expedition_date, tbai_invoice_id
  • tbai.invoice.customer · modelo nuevonif (NIF), zip (ZIP Code), name, idtype (Identification Type Code), address, country_code, tbai_invoice_id, identification_number
  • tbai.response.message · modelo nuevocode, description, tbai_response_id
  • tbai.tax.agency.version · modelo nuevodate_to, version (TicketBAI version), date_from, qr_base_url (QR Base URL), rest_url_invoice (REST API URL for Invoices), test_qr_base_url (Test - QR Base URL), tbai_tax_agency_id, rest_url_cancellation (REST API URL for Invoice Cancellations), test_rest_url_invoice (Test - REST API URL for Invoices), test_rest_url_cancellation (Test - REST API URL for Invoice Cancellations)

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-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

terminal Instalación y uso

Sin información verificada

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.

info

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.