fiscalResponseSpain – RetailForce

Una vez que se ha enviado un documento al servicio de fiscalización de RetailForce (createDocument y storeDocument), el servicio responde con lo que se denomina «fiscalResponse». Este objeto se describe de forma general en el artículo «Objeto fiscalResponse».

En función del país fiscal asignado al cliente en cuestión (según la configuración correspondiente del cliente), se puede encontrar información diferente en el array «AdditionalFields». Este artículo muestra la información que se devuelve como respuesta en el marco de la fiscalización en España

TicketBAI system : en las provincias vascas de Araba, Bizkaia y Gipuzkoa,
Sistema VERI*FACTU : aquellas regiones asignadas a la AEAT (Agencia Estatal de Administración Tributaria) como autoridad fiscal.

FiscalResponseSpain (TicketBAI)

«AdditionalFields» en «fiscalResponse» en las regiones de TicketBAI:

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

Se utilizan (transmiten) los siguientes campos adicionales en el marco de la fiscalización en España

Elementos		Tipo	Descripción
AdditionalFields			Información específica del país
	QrCode		Los datos del campo «QrCode» deben transformarse en un código QR y imprimirse en el recibo.

FiscalResponseSpaine (VERI*FACTU)

AdditionalFields en «fiscalResponse» en las regiones de VERI*FACTU:

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

En el contexto de la fiscalización en las regiones de VERI*FACTU se utilizan (se transmiten) los siguientes campos adicionales:

Elemento		Tipo	Descripción
printingFields			Devolución de la información que debe imprimirse en el documento correspondiente. Puede encontrar más información en el artículo «printingFields - España».
AdditionalFields			Información específica de cada país
	QrCode		Los datos del campo «QrCode» deben transformarse en un código QR y imprimirse en el recibo (tal y como se muestra también en «printingFields»).

Este artículo ha sido traducido automáticamente.

FiscalResponseSpain (TicketBAI)

FiscalResponseSpaine (VERI*FACTU)

Artículos relacionados