Submit invoice to TicketBAI (Bizkaia BATUZ)

Submit a signed TicketBAI XML to the Bizkaia BATUZ tax authority.

Pipeline: fetch BYOC cert → compute hash chain → build TicketBAI XML → sign with XAdES-BES → submit to BATUZ → generate QR code. Result persisted to invoices/{id}/tbai/submission subdoc.

Idempotent: if the invoice was already accepted, returns the prior result with idempotent: true — does not resubmit.

Trust Area: COMPLIANCE — Requires owner role or API key with einvoice:* scope. Requires a TicketBAI BYOC certificate uploaded in Settings > Integrations > TicketBAI.

post/v1/invoices/{invoiceId}/ticketbai/submit

Request

Base URL: https://api.frihet.io
URL: https://api.frihet.io/v1/invoices/{invoiceId}/ticketbai/submit
Auth: API key in header X-API-Key

Path parameters

invoiceIdstring required

Invoice unique identifier

Request body

sandboxboolean

Override to sandbox mode (default from user integration config).

Response

TicketBAI submission accepted

Example response

{
  "data": {
    "accepted": true,
    "csv": "TBAI-48-120226-000001-2H",
    "tbaiIdentifier": "TBAI-B-000001"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.