Operaciones de bienes en Bizkaia
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.
Requisitos previos
Antes de utilizar este endpoint:
- El intermediario debe estar registrado y habilitado en KubiBAI como Software Garante. Ponte en contacto con KubiBAI para completar esta habilitación.
- 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.
- 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.
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.
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:
- La aplicación cliente construye el XML correspondiente a la operación.
- Codifica el XML completo en Base64 y lo incluye en
xml_contents. - Envía la petición JSON a KubiBAI con el ejercicio fiscal, los datos del contribuyente y los datos del Software Garante.
- KubiBAI decodifica el contenido y valida el XML contra el XSD aplicable.
- 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.
- La respuesta incluye el identificador asignado por KubiBAI y el resultado devuelto por el LROE.
Esquemas y estructuras vigentes
Consulta siempre la documentación técnica de Batuz 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.