Saltar al contenido
KubiBAI Web Services
Esc
navegarabrir⌘Jvista previa
En esta página

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:

  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.

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:

  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.

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.