Objeto «fiscalResponse» «fiscalResponse» – RetailForce

Este artículo describe el objeto fiscalResponse («posiciones») dentro del objeto Document (
objeto Document).

En la sección de descargas del sitio web de RetailForce (Documentación del modelo de objetos.pdf), dentro del directorio de la versión correspondiente, se puede encontrar una descripción completa del RetailForce DOM, así como una descripción de los elementos individuales.

El objeto «fiscalResponse» se devuelve al sistema anterior (caja registradora, sistema de registro electrónico) como respuesta a una transmisión de documento realizada con éxito (createDocument y storeDocument).

El objeto «fiscalResponse» consta de:

Información estándar: información independiente del país (fiscal) en cuestión (la misma para todos los países)
Información específica del país: datos que deben imprimirse en un recibo en el país correspondiente o almacenarse en el libro de contabilidad. Esta información se devuelve en la matriz «AdditionalFields» del objeto fiscalResponse.

Objeto fiscalResponse

El siguiente objeto contiene datos de ejemplo.

{
   "fiscalCountry": "[0] = Germany",
   "fiscalisationDocumentNumber": 52,
   "fiscalDocumentNumber": "52",
   "fiscalDocumentStartTime": 1674819139,
   "processStartTime": 0,
   "errorDescription": null,
   "cashRegisterId": "00345-00345",
   "signature": "pCeGi98gNNhshcGJkbw0DwtSzuJkaawON8l5QwsFDEaDHOyYK2aNVO4ZAlpkYYnub7oxM/2R1/KB36UzmOQwew==",
   "userMessage": null,
   "printMessage": "***Test***",
   "requestTime": "2023-01-27T12:34:21.3088836+01:00",
   "requestCompletionTime": "2023-01-27T12:34:22.4379009+01:00",
   "retailForceReceiptId": "0p4j0001",    /// only for createDocument
   "AdditionalFields": {
      "QrCodeDataString": "V0;00345-00345;Kassenbeleg-V1;Beleg^13.90_0.00_0.00_0.00_0.00^13.90:Unbar;52;197;2023-01-27T11:32:19.000Z;2023-01-27T11:34:20.000Z;ecdsa-plain-SHA256;unixTime;pCeGi98gNNhshcGJkbw0DwtSzuJkaawON8l5QwsFDEaDHOyYK2aNVO4ZAlpkYYnub7oxM/2R1/KB36UzmOQwew==;BNHckCuXF2fEktIp8qwtnMLLgvpJDX6wEOqFENlHXZpekBHxHniQh9gbigjWS9UbCwZSrOTJTMK7WiV5owAfXkk=",
      "TransactionStartTime": 1674819139,
      "TransactionEndTime": 1674819260,
      "ProcessData": "Beleg^13.90_0.00_0.00_0.00_0.00^13.90:Unbar",
      "ProcessType": "Kassenbeleg-V1",
      "TseSerial": "e5f5836a57c50c526d4bed37f18823608f2f44e2c98cab73278a7676c5ea0885",
      "TseTimeFormat": "unixTime",
      "TseHashAlgorithm": "ecdsa-plain-SHA256",
      "TsePublicKey": "BNHckCuXF2fEktIp8qwtnMLLgvpJDX6wEOqFENlHXZpekBHxHniQh9gbigjWS9UbCwZSrOTJTMK7WiV5owAfXkk=",
      "TseSignatureCounter": 197,
      "TseCertificate": "MIIB0jCCAVmgAwIBAgIhAOX1g2pXxQxSbUvtN/GII2CPL0TiyYyrcyeKdnbF6giFMAoGCCqGSM49BAMDMDExFTATBgNVBAoTDGZpc2thbHkgR21iSDEYMBYGA1UEAxMPZmlza2FseSBUZXN0IENBMB4XDTIyMTAzMDEyMjgzMloXDTIzMTAzMDEyMjgzMlowMjEVMBMGA1UEChMMZmlza2FseSBHbWJIMRkwFwYDVQQDExBmaXNrYWx5IFRlc3QgVFNFMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE0dyQK5cXZ8SS0inyrC2cwsuC+kkNfrAQ6oUQ2Uddml6QEfEeeJCH2BuKCNZL1RsLBlKs5MlMwrtaJXmjAB9eSaNBMD8wDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUlllBymQBup6ldKGojZVpZtWG5tQwCgYIKoZIzj0EAwMDZwAwZAIwEFsoSON9cIBqA5d9vsGI2jSjDlZxHokDvJ4yBmayvigrDbdhMYe3hw3HyQbO2B/FAjBXSVNbYR6Wg2TVzL9BhCla+tewRDGcs6vnetJ4i3VRtya1+ejt+vRjWnb/RUyo0Uw=",
      "fiscalDocumentRevision": 2
   }
}

El objeto fiscalResponse contiene la siguiente información.

Información de la columna «Type»:

M ... obligatorio / requerido
M* ... obligatorio / requerido en determinados países o bajo determinadas condiciones
R ... recomendado
O... opcional

Elementos		Tipo	Descripción
fiscalCountry			Indicador del país fiscal correspondiente. Enum: [0] = Alemania [1] = Austria [2] = Francia [3] = Bulgaria [4] = Dinamarca [5] = Suecia [6] = Eslovenia [7] = Polonia [8] = Serbia [9] = Italia [10] = Croacia [12] = Rumanía [15] = Lituania [16] = Hungría [18] = España [99999] = Sin fiscalización
fiscalisationDocumentNumber			Número de documento fiscal (asignado por el sistema fiscal correspondiente; p. ej., TSE en Alemania). Valor entero Nota: Obsoleto; será sustituido por la propiedad de tipo string «fiscalDocumentNumber» en futuras versiones.
fiscalDocumentNumber			Número de documento fiscal (asignado por el sistema fiscal correspondiente; p. ej., TSE en Alemania). Detalles por país: Alemania: la propiedad fiscalDocumentNumber (y su valor) de la fiscalResponse tras llamar a createDocument debe incluirse en el documento JSON que se va a enviar a storeDocument . Nota: Introducida en la versión 1.7.7. «fiscalDocumentNumber», a diferencia de «fiscalisationDocumentNumber», es un elemento de tipo «string».
~~fiscalisationDocumentRevision~~			Número de revisión del documento fiscal. (Lo asigna el sistema fiscal correspondiente —TSE en Alemania—). Importante: la propiedad «fiscalisationDocumentRevision» se eliminó del header del objeto «fiscalResponse» con la release 1.7.7. La propiedad ha pasado a denominarse «fiscalDocumentRevision» y ahora solo se devuelve como parte de los «AdditionalFields» de «fiscalResponse-Alemania ».
TaxPositions			Indicación de todas las posiciones de IVA del documento.
	VatIdentification		ID indicador del tipo de Vat de la partida de Vat. Partida
	VatLabel
	VatPercent1		Tipo impositivo, expresado en porcentaje, de esta partida de Vat. Partida (en este caso, la partida de Vat n.º 1)
	VatAmount		Importe del Vat de la partida de Vat
	NetAmount		Importe neto (sin Vat) de la partida de Vat
	GrossAmount		Importe bruto (VAT incluido) de la partida de VAT
fiscalDocumentStartTime			Hora de creación del documento fiscal: marca de tiempo Unix (asignada por el sistema fiscal correspondiente; p. ej., TSE en Alemania).
processStartTime			Hora de creación del primer documento dentro de todo el proceso (p. ej., en Alemania: hora de creación del primer pedido de cliente relacionado con el presente documento de pago; véase también «características de la hostelería»).
ErrorDescription			Descripción del error en caso de que el proceso de fiscalización haya fallado. Campo vacío si no se ha producido ningún error.
cashRegisterId			Devuelve el número de caja registradora bajo el cual se registró o procesó el documento fiscal.
signature			Firma del documento, generada por el sistema de fiscalización correspondiente (p. ej., dispositivo de creación de firmas en Austria, TSE en Alemania...).
UserMessage			Notificación que debe mostrarse al usuario del sistema de punto de venta. Nota: en ciertos países, dicho mensaje debe mostrarse al operador de caja. Se recomienda implementar este procedimiento para cada país con normativa fiscal.
PrintMessage			Debe imprimirse en el documento (p. ej., «recibo de caja»); de lo contrario, existe el riesgo de que la implementación no cumpla con los requisitos legales del país correspondiente. Tenga en cuenta también «PrintMessage». Atención: en algunos países, la información devuelta a través del elemento «PrintMessage» debe imprimirse en el recibo. Recomendamos aplicar este procedimiento para cada país fiscal.
requestTime			Devuelve la hora de la solicitud
requestCompletionTime			Devuelve la hora en la que el sistema fiscal completó la solicitud
retailForceReceiptId			Identificador único de documento asignado globalmente por el sistema RetailForce. Solo se devuelve en la respuesta fiscal (fiscalResponse) al llamar a la función PUT /api/v1/transactions/createDocument. Nota: Para que se genere el retailForceReceiptId, es necesario activarlo una vez para el cliente correspondiente mediante una llamada a la función POST /api/v1/management/clients/{clientId}/GlobalShortId . Puede encontrar más información en el artículo «ID global de caja registradora e ID global de documento».
AdditionalFields			Información específica de cada país
	{...}		fiscalResponseAustria fiscalResponseBulgaria respuestaFiscalCanadá respuestaFiscalCroacia respuestaFiscalDinamarca respuestaFiscalFrancia respuestaFiscalAlemania respuestaFiscalGrecia respuestaFiscalHungría respuestaFiscalItalia respuestaFiscalLituania respuestaFiscalPolonia respuestaFiscalRumanía respuestaFiscalSerbia respuestaFiscalEslovaquia respuestaFiscalEslovenia respuestaFiscalEspaña respuestaFiscalSuecia

Este artículo ha sido traducido automáticamente.

Objeto fiscalResponse

Artículos relacionados