Skip to navigation

Submit the monthly LROE Capítulo 1.1 batch (ES, Bizkaia)

Aggregates the accepted TicketBAI submissions of the month and files them as one LROE Modelo-240 Capítulo 1.1 batch with BATUZ. Requires a TicketBAI Bizkaia credential with razón social, stored with POST /api/v1/gov-credentials (countryCode ‘ES’, systemKey ‘tbai-bizkaia’).

Authentication

AuthorizationBearer

API Key authentication. Use sk_live_* for production or sk_test_* for testing.

Request

This endpoint expects an object.
yearintegerRequired2022-2099
Fiscal year of the filing period.
monthintegerRequired1-12

Month of the filing period (1–12).

environmentenumOptional

BATUZ environment. Defaults to test.

Allowed values:

Response

The gateway accepted the batch (Correcto).

successboolean

True when the gateway answered Correcto.

tipoRespuestaenum
Gateway verdict for the whole batch.
Allowed values:
altaCountinteger-9007199254740991-9007199254740991

Number of invoice registrations (alta) in the batch.

anulacionCountinteger-9007199254740991-9007199254740991

Number of cancellations (anulación) in the batch.

rawResponsestring
Raw gateway response.
httpStatusinteger-9007199254740991-9007199254740991

HTTP status of the gateway call (0 when no call was needed).

identificativostringOptional
Gateway identifier of the filing.
numeroRegistrostringOptional
Registration number assigned by the gateway.
errorCodestringOptional
Gateway error code when the batch was rejected.
errorMessagestringOptional
Gateway error text when the batch was rejected.

Errors

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
501
Not Implemented Error
503
Service Unavailable Error