---
title: Operaciones de bienes en Bizkaia
description: Prepara y envía al LROE de Bizkaia operaciones de bienes de los modelos 140 y 240.
---

KubiBAI permite registrar en el Libro Registro de Operaciones Económicas
(LROE) de Bizkaia las operaciones relacionadas con bienes afectos a una
actividad económica o bienes de inversión.

:::note
Este servicio está disponible exclusivamente para contribuyentes de
**Bizkaia**.
:::

## Requisitos previos

Antes de utilizar este endpoint:

1. El intermediario debe estar registrado y habilitado en KubiBAI como
   **Software Garante**. Ponte en contacto con KubiBAI para completar esta
   habilitación.
2. El intermediario debe tener configurado en KubiBAI su propio certificado
   digital válido. La petición incluye los datos del Software Garante y la
   clave de cifrado necesaria para acceder al certificado.
3. La aplicación cliente debe generar el XML del LROE conforme a los esquemas
   vigentes publicados por Batuz.

## Modelos y tipos de operación

El campo `is_individual` de `sender_data` determina el modelo utilizado:

| Contribuyente | Modelo | `is_individual` | Valores de `operation` |
| --- | --- | --- | --- |
| Persona física | 140 | `true` | Alta, mejora, baja o regularización anual de bienes |
| Persona jurídica | 240 | `false` | Bienes de inversión |

Para el modelo 140, `operation` admite estos valores:

- `ALTA_DE_BIENES_AFECTOS_O_DE_INVERSION`: alta de bienes afectos o de
  inversión, correspondiente al capítulo 3.1.
- `MEJORA_DE_BIENES_AFECTOS_O_DE_INVERSION`: mejora de bienes afectos o de
  inversión, correspondiente al capítulo 3.2.
- `BAJA_DE_BIENES_AFECTOS_O_DE_INVERSION`: baja de bienes afectos o de
  inversión, correspondiente al capítulo 3.3.
- `REGULARIZACION_ANUAL_DE_BIENES_DE_INVERSION`: regularización anual de
  bienes de inversión, correspondiente al capítulo 3.4.

Para el modelo 240 debe utilizarse `BIENES_DE_INVERSION`, correspondiente al
capítulo 3 de bienes de inversión.

:::warning
Mantén coherentes `is_individual` y `operation`. Una operación propia del
modelo 140 no debe combinarse con una persona jurídica, ni
`BIENES_DE_INVERSION` con una persona física.
:::

## Datos del contribuyente

`sender_data` identifica al contribuyente que presenta la operación. Incluye
su territorio TicketBAI, NIF o CIF y nombre completo.

En el modelo 140 también se utilizan `first_name`, `last_name_1` y
`last_name_2` para componer los datos de la persona física.

:::note
El contrato actual de la API requiere enviar `first_name`, `last_name_1` y
`last_name_2` también en las peticiones del modelo 240, aunque esos campos solo
se utilizan para formar los datos del modelo 140.
:::

## Altas, modificaciones y anulaciones

El endpoint admite tres acciones mediante `lroe_operation_type`:

- `creation`: alta de un nuevo registro.
- `modification`: modificación de un registro previamente presentado.
- `cancellation`: anulación de un registro previamente presentado.

El XML debe ajustarse al XSD correspondiente al modelo, al tipo de bien y a la
acción seleccionada.

## Preparación y envío del XML

El procesamiento es síncrono y sigue este flujo:

1. La aplicación cliente construye el XML correspondiente a la operación.
2. Codifica el XML completo en Base64 y lo incluye en `xml_contents`.
3. Envía la petición JSON a KubiBAI con el ejercicio fiscal, los datos del
   contribuyente y los datos del Software Garante.
4. KubiBAI decodifica el contenido y valida el XML contra el XSD aplicable.
5. Si la validación es correcta, KubiBAI almacena el registro, comprime el XML
   y lo remite al LROE de Bizkaia utilizando el certificado del intermediario.
6. La respuesta incluye el identificador asignado por KubiBAI y el resultado
   devuelto por el LROE.

:::warning
Base64 solo permite transportar el XML dentro del cuerpo JSON: no cifra ni
protege su contenido.
:::

## Esquemas y estructuras vigentes

Consulta siempre la [documentación técnica de
Batuz](https://www.batuz.eus/es/documentacion-tecnica) para obtener las
versiones actuales de los esquemas XSD y de las estructuras del LROE. Los
enlaces directos a archivos de descarga pueden cambiar entre versiones.

Para conocer todos los campos, restricciones, ejemplos y respuestas, abre
**Enviar una operación de bienes** en la [Referencia
API](/api#tag/bienes/POST/assetoperations).