Gastos y facturas recibidas en Bizkaia
Prepara y envía al LROE de Bizkaia gastos del modelo 140 y facturas recibidas del modelo 240.
KubiBAI permite registrar en el Libro Registro de Operaciones Económicas (LROE) de Bizkaia los gastos de profesionales y las facturas recibidas de personas jurídicas.
Requisitos previos
Antes de utilizar estos endpoints:
- 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.
Qué endpoint utilizar
| Registro | Modelo | Endpoint |
|---|---|---|
| Gasto con factura | 140 | POST /expenses |
| Gasto sin factura | 140 | POST /expenses |
| Factura recibida | 240 | POST /receivedinvoices |
En el modelo 140, el campo expense_type distingue entre gastos con factura
(with_invoice) y sin factura (without_invoice). El modelo 240 no utiliza
este campo.
Preparación y envío del XML
El procesamiento es síncrono y sigue este flujo:
- La aplicación cliente construye el XML correspondiente al modelo y a la operación que quiere realizar.
- Codifica el XML completo en Base64 e incluye el resultado 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 comprime y remite el XML al LROE de Bizkaia, y devuelve el resultado del envío en la respuesta de la petición.
Altas, modificaciones y anulaciones
Los dos endpoints admiten las tres operaciones mediante
lroe_operation_type:
creation: alta de un nuevo registro.modification: modificación de un registro existente.cancellation: anulación de un registro existente.
El XML debe ajustarse al XSD correspondiente tanto al modelo como al tipo de operación seleccionado.
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 las operaciones Enviar un gasto del modelo 140 y Enviar una factura recibida del modelo 240 en la Referencia API.