fiscalResponseSpain

After a document has been submitted to the RetailForce Fiscalisation service (createDocument and storeDocument), the service responds with a so-called FiscalResponse. This object is described in general in the article FiscalResponse object.

Depending on which fiscal country is assigned to the respective client (depending on the corresponding configuration of the client), different information can be found in the array "AdditionalFields". This article shows the information that is returned as a response within the framework of fiscalisation in Spain

• TicketBAI system - in the Basque regions: Araba, Bizkaia and Gipuzkoa,
• VERI*FACTU-system - those regions that are assigned to the AEAT (Agencia Estatal de Administración Tributaria) as the tax authority.

FiscalResponseSpain (TicketBAI)

additionalFields in fiscalResponse in TicketBAI regions:

{
  "fiscalCountry": "[18] = Spain",
  "fiscalisationDocumentNumber": 10,
  "fiscalDocumentNumber": "10",
  "fiscalDocumentStartTime": 1683131779,
  "processStartTime": 0,
  "errorDescription": null,
  "cashRegisterId": "0001/002",
  "signature": "xyz",
  "userMessage": "",
  "printMessage": "***Test***",
  "requestTime": "2023-05-04T15:41:53.2924502+02:00",
  "requestCompletionTime": "2023-05-04T15:41:54.0639654+02:00",
  "retailForceReceiptId": "0p4j0001",    /// only for createDocument
  "AdditionalFields": {
    "QrCode": "xyz"
  }
}

The following additional fields are used (transmitted) within the framework of fiscalisation in Spain

FiscalResponseSpaine (VERI*FACTU)

additionalFields in fiscalResponse in VERI*FACTU regions:

{
  "fiscalCountry": "[18] = Spain",
  "fiscalisationDocumentNumber": 0,
  "fiscalDocumentNumber": "0",
  "fiscalDocumentStartTime": 0,
  "processStartTime": 0,
  "errorDescription": null,
  "cashRegisterId": "00181-001",
  "signature": "VERIFACTU-99999910G-120925",
  "userMessage": null,
  "printMessage": "***Test***",
  "requestTime": "2025-09-12T10:22:26.8776469+02:00",
  "requestCompletionTime": "2025-09-12T10:22:31.0166898+02:00",
  "qrCode": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=99999910G&numserie=FS-00002&fecha=12-09-2025&importe=899.90",
  "printingFields": {
    "Np_QrTributario": "QR tributario",
    "Np_QrCode": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=99999910G&numserie=FS-00002&fecha=12-09-2025&importe=899.90",
    "Np_NoteLong": "Factura verificable en la sede electrónica de la AEAT",
    "Np_NoteShort": "VERI*FACTU",
    "Np_TrainingDocument01": "Documento de formación"
  },
  "AdditionalFields": {
    "QrCode": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=99999910G&numserie=FS-00002&fecha=12-09-2025&importe=899.90"
  }
}

The following additional fields are used (transmitted) in the context of fiscalisation in the VERI*FACTU regions: