Este artículo describe el objeto fiscalResponse («posiciones») dentro del objeto Document
(objeto Document).
En la sección de descargas del RetailForce website (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 de origen (caja registradora, sistema de registro electrónico) como respuesta a una transmisión satisfactoria del documento (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 el recibo del país correspondiente o almacenarse en el libro de contabilidad. Esta información se devuelve en el array «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:
|
||
| 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 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:
Nota
: Introducida en la versión 1.7.7. «fiscalDocumentNumber», a diferencia de «fiscalisationDocumentNumber», es un elemento de tipo «string»
|
||
|
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 la respuesta fiscal de Alemania
.
|
|||
| TaxPositions | Indicación de todas las posiciones del Vat 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 identificador numérico del punto de venta en el que 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 algunos países, debe mostrarse un posible mensaje de usuario al cajero. Recomendamos 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 a efectos fiscales.
|
||
| requestTime | Devuelve la marca de tiempo de la solicitud. | ||
| requestCompletionTime | Devuelve la hora en la que el sistema fiscal completó la solicitud | ||
| retailForceReceiptId |
Identificador de documento único a nivel global asignado por el RetailForce system. 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 llamando 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 | ||
| {...} |
respuestaFiscalCroacia respuestaFiscalHungría respuestaFiscalSerbia respuestaFiscalEslovaquia |
||
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.