Submit TicketBAI (Basque Country)
ticketbai_submitSubmit an invoice to the Basque Country TicketBAI e-invoicing system. Returns a TicketBAI ID and QR code URL for printing on the invoice.
Instructions
Submit an invoice to the Basque Country TicketBAI e-invoicing system. Territory is auto-detected from the workspace address (Bizkaia → BATUZ/LROE, Gipuzkoa → Gipuzkoa TicketBAI, Araba → Araba TicketBAI). Returns the submission TicketBAI ID (TBAI identifier) and QR code URL for printing on the invoice.
Use sandbox=true for test submissions against the hacienda test endpoints. Production submissions require a valid TicketBAI certificate configured in workspace settings.
/ Envía una factura al sistema TicketBAI del País Vasco. El territorio se detecta automáticamente (Bizkaia→BATUZ/LROE, Gipuzkoa, Álava). Devuelve el identificador TBAI y URL del código QR para imprimir en la factura.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sandbox | No | If true, submits to the hacienda test endpoint instead of production. Default: false. / Si true, envía al entorno de pruebas de la hacienda. Por defecto: false. | |
| invoiceId | Yes | Frihet invoice ID to submit / ID de la factura a enviar |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | Yes | CSV (Código Seguro de Verificación) returned by the hacienda foral | |
| qrUrl | Yes | QR code URL to print on the invoice (TBAI compliance) | |
| accepted | Yes | Whether the hacienda foral accepted the submission | |
| idempotent | No | True if this echoes a prior already-accepted submission (no resubmission occurred) | |
| tbaiIdentifier | Yes | TicketBAI identifier (TBAI-XXXXX) returned by the hacienda foral |