fiscalResponseSpain - Spanien

Nachdem ein Dokument an das RetailForce Fiskalisierungs-Service übermittelt wurde (createDocument und storeDocument), antwortet das Service mit einer s.g. FiscalResponse. Dieses Objekt wird allgemein im Artikel FiscalResponse-Objekt beschrieben.

Je nachdem, welches Fiskalland dem jeweiligen Client zugeordnet ist (abhängig von der entsprechenden Konfiguration des Clients), finden sich im Array "AdditionalFields" unterschiedliche Informationen. Dieser Artikel zeigt die Informationen, welche im Rahmen der unterschiedlichen Fiskalisierungen in Spanien als Antwort (response) zurückgegeben werden:

• TicketBAI-System - in den Baskenregionen: Araba, Bizkaia und Gipuzkoa,
• VERI*FACTU-System - jenen Regionen, welche der AEAT (Agencia Estatal de Administración Tributaria) als Steuerbehörde zugeordnet sind.

FiscalResponseSpain (TicketBAI)

additionalFields in fiscalResponse in den TicketBAI-Regionen:

{
  "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",    /// nur bei createDocument
  "AdditionalFields": {
    "QrCode": "xyz"
  }
}

Folgende zusätzliche Felder werden im Rahmen der Fiskalisierung in den TicketBAI-Regionen verwendet (übermittelt):

FiscalResponseSpaine (VERI*FACTU)

additionalFields in fiscalResponse in den VERI*FACTU-Regionen:

{
  "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"
  }
}

Folgende zusätzliche Felder werden im Rahmen der Fiskalisierung in den VERI*FACTU-Regionen verwendet (übermittelt):