OdooWiki OCA HUB

TicketBAI (API) - Batuz - declaración de todas las operaciones de venta realizadas por las personas y entidades que desarrollan actividades económicas en Bizkaia

l10n_es_ticketbai_api_batuz folder_open OCA/l10n-spain open_in_new
Accounting & Finance License: AGPL-3

Módulo base (API) para la declaración de todas las operaciones de venta realizadas por las personas y entidades que desarrollan actividades económicas en Bizkaia https://www.batuz.eus/fitxategiak/batuz/lroe/Batuz_LROE_Especificaciones_Env%C3%ADo_Masivo_V1_0_8.pdf

Alcance de operaciones LROE:

  • Operaciones realizadas ALTA (A00) y ANULACIÓN (AN0) de facturas
  • Modelos soportados: PF 140 (Libro Registro de Operaciones Económicas (personas físicas) y PJ 240 Libro Registro de Operaciones Económicas (personas jurídicas)
  • Anotaciones de subcapitulo 1.1 - Ingresos con factura con Software garante (LROE PF 140)
  • Anotaciones de subcapitulo 2.1 - Gastos con factura (LROE PF 140)
  • Anotaciones de subcapitulo 1.1 - Facturas emitidas con Software garante (LROE PJ 240)
  • Anotaciones de capitulo 2 - Facturas recibidas (LROE PJ 240)

El resto de operaciones y anotaciones del LROE quedan fuera del alcance de este módulo.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

This module connects Odoo to the Basque tax authority Batuz LROE system for Bizkaia, letting companies send their issued and received invoice records (models PF 140 and PJ 240) electronically and track the authority's responses.

This module adds the Batuz LROE reporting channel for businesses in Bizkaia. It works together with the TicketBAI API module and is used when the company's tax agency is set to Bizkaia.

On the company settings, you can choose the LROE model (PF 140 for individuals or PJ 240 for legal entities) and enter the main IAE activity code. These values are used in every submission.

A new LROE menu appears under the TicketBAI configuration, with two sections: - Operations: lists the LROE submissions, showing their type (create, cancel, update, query), model, chapter/subchapter, state (draft, error, recorded, recorded with warning, cancel), the generated XML and GZIP files, and the linked customer invoices. - Chapters: the official LROE chapter and subchapter catalogue for both models.

When a TicketBAI invoice is sent and the company uses the Bizkaia tax agency, the module automatically creates an LROE operation, builds the XML file for the right chapter (for example issued invoices with software garante, or received invoices), compresses it, sends it to Batuz, and stores the response. The operation state is updated based on the response: recorded, recorded with warning, or error. Each response line shows the authority's code and message, and the related TicketBAI invoice is updated accordingly.

The module touches res.company, tbai.invoice, and adds lroe.operation, lroe.operation.response, lroe.operation.response.line, and lroe.chapter.

Required by other modules

Menus it adds

LROEOperationsChapters
Models and fields (6)
  • res.company · extends an existing modellroe_model (LROE Model), main_activity_iae (Epígrafe I.A.E. actividad principal)
  • lroe.chapter · new modelcode, name, model (LROE Model), lroe_chapter_id (Parent chapter)
  • tbai.invoice · extends an existing modellroe_operation_id (TicketBAI-Batuz LROE Operation)
  • lroe.operation · new modelname, type, model, state, xml_datas, company_id, response_ids (Operation global responses), trx_gzip_file, xml_file_size (XML File Size), trx_gzip_fname (GZIP File Name), trx_gzip_fsize (GZIP File Size), lroe_chapter_id (Chapter), xml_datas_fname (XML File Name), tbai_invoice_ids (TBai Customer Invoices), lroe_subchapter_id (Subchapter)
  • lroe.operation.response · new modelxml (XML Response), code, state, xml_fname (XML File Name), description, lroe_record_id, lroe_record_date, lroe_operation_id, response_line_ids (Response Line), lroe_record_number
  • lroe.operation.response.line · new modelcode, state, description, tbai_invoice_id, lroe_response_id, response_message (LROE Response Message), tbai_response_id, lroe_operation_id

Text generated by AI (DeepSeek) from reading the Odoo 16.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/l10n-spain.

terminal Installation and usage

OCA documentation · Odoo 16.0

Para instalar esté módulo necesita:

  • El módulo l10n_es_ticketbai_api

No verified information in OCA: Configuration, Usage.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.