Oggetto FiscalResponse «fiscalResponse» – RetailForce

Il presente articolo descrive l’oggetto fiscalResponse (“positions”) all’interno dell’oggetto Document (
oggetto Document).

Una descrizione completa del RetailForce DOM (Document Object Model), nonché una descrizione dei singoli elementi, è disponibile nell’area download del sito web di RetailForce (Documentazione sul modello a oggetti.pdf) nella rispettiva directory delle versioni.

L’oggetto FiscalResponse viene restituito al sistema a monte (registratore di cassa, sistema di registrazione elettronica) come risposta a una trasmissione del documento andata a buon fine (createDocument e storeDocument).

L’oggetto fiscalResponse è costituito da:

Informazioni standard: dati indipendenti dal paese fiscale (uguali per ogni paese)
Informazioni specifiche per paese: dati che devono essere stampati sullo scontrino nel paese corrispondente o memorizzati nel registro. Tali informazioni vengono restituite nell’array «AdditionalFields» dell’oggetto fiscalResponse.

Oggetto fiscalResponse

L’oggetto seguente contiene dati di esempio.

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

L’oggetto fiscalResponse contiene le seguenti informazioni.

Informazioni nella colonna “Type”:

M ... obbligatorio / richiesto
M* ... obbligatorio / richiesto in determinati paesi o in determinate condizioni
R ... raccomandato
O... facoltativo

Elementi		Tipo	Descrizione
fiscalCountry			Indicatore relativo al rispettivo paese fiscale. Enum: [0] = Germania [1] = Austria [2] = Francia [3] = Bulgaria [4] = Danimarca [5] = Svezia [6] = Slovenia [7] = Polonia [8] = Serbia [9] = Italia [10] = Croazia [12] = Romania [15] = Lituania [16] = Ungheria [18] = Spagna [99999] = Nessuna fiscalizzazione
fiscalisationDocumentNumber			Numero del documento fiscale (assegnato dal rispettivo sistema fiscale – ad es. TSE in Germania). Valore intero Nota: Obsoleto; nelle versioni future sarà sostituito dalla proprietà di tipo stringa fiscalDocumentNumber.
fiscalDocumentNumber			Numero del documento fiscale (assegnato dal rispettivo sistema fiscale – ad es. TSE in Germania). Dettagli per paese: Germania: la proprietà fiscalDocumentNumber (e il relativo valore) della fiscalResponse ottenuta dopo aver richiamato il metodo createDocument deve essere inclusa nel documento JSON da inviare a storeDocument . Nota: Introdotta con la versione 1.7.7. A differenza di fiscalisationDocumentNumber, fiscalDocumentNumber è un elemento di tipo «stringa».
~~fiscalisationDocumentRevision~~			Numero di revisione del documento fiscale. (Assegnato dal rispettivo sistema fiscale – TSE in Germania). Attenzione: la proprietà «fiscalisationDocumentRevision» è stata rimossa dall’header dell’oggetto fiscalResponse a partire dalla release 1.7.7. La proprietà è stata rinominata «fiscalDocumentRevision» ed è ora restituita esclusivamente come parte degli AdditionalFields della fiscalResponse-Germania .
TaxPositions			Indicazione di tutte le posizioni Vat del documento.
	VatIdentification		ID indicativo dell’aliquota Vat della voce Vat. Voce
	VatLabel
	VatPercent1		Aliquota fiscale in percentuale di questa voce Vat. Voce (in questo caso la voce Vat 1)
	VatAmount		Importo IVA della voce IVA
	NetAmount		Importo netto (Vat escluso) della voce Vat
	GrossAmount		Importo lordo (IVA inclusa) della voce IVA
fiscalDocumentStartTime			Ora di creazione del documento fiscale – Timestamp Unix (assegnato dal rispettivo sistema fiscale – ad es. TSE in Germania).
processStartTime			Ora di creazione del primo documento nell’ambito dell’intero processo (ad es. Germania: ora di creazione del primo ordine del cliente in relazione al presente documento di pagamento – si veda anche «caratteristiche della ristorazione»).
ErrorDescription			Descrizione dell’errore qualora il processo di fiscalizzazione non sia andato a buon fine. Campo vuoto se non si è verificato alcun errore.
cashRegisterId			Restituisce il numero del registratore di cassa con cui il documento fiscale è stato registrato/elaborato.
signature			Firma del documento, generata dal rispettivo sistema di fiscalizzazione (ad es. dispositivo di creazione della firma in AT, TSE in DE...)
UserMessage			Notifica che deve essere visualizzata all’utente del sistema POS. Attenzione: in alcuni Paesi, un eventuale messaggio per l’utente deve essere visualizzato al cassiere. Si raccomanda di implementare questa procedura per ciascun Paese soggetto a fiscalizzazione.
PrintMessage			Deve essere stampato sul documento (ad es. «scontrino fiscale»), altrimenti sussiste il rischio che l’implementazione non sia conforme ai requisiti di legge del rispettivo paese. Si veda anche «PrintMessage». Attenzione: in alcuni paesi, le informazioni restituite tramite l’elemento PrintMessage devono essere stampate sulla ricevuta. Si raccomanda di implementare questa procedura per ciascun paese fiscale.
requestTime			Restituisce l’istante di richiesta
requestCompletionTime			Restituisce l’istante di completamento della richiesta da parte del sistema fiscale
retailForceReceiptId			ID documento univoco a livello globale assegnato dal sistema RetailForce. Viene restituito esclusivamente nella risposta fiscale (fiscalResponse) quando si effettua la chiamata PUT a /api/v1/transactions/createDocument. Nota: affinché il retailForceReceiptId venga generato, è necessario attivarlo una volta per il rispettivo cliente richiamando la funzione POST /api/v1/management/clients/{clientId}/GlobalShortId . Per ulteriori dettagli si rimanda all’articolo «ID globale del registratore di cassa e ID globale del documento».
AdditionalFields			Informazioni specifiche per paese
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada Risposta fiscale della Croazia Risposta fiscale Danimarca risposta_fiscale_Francia risposta_fiscale_Germania risposta_fiscale_Grecia risposta_fiscale_Ungheria risposta-fiscale-Italia Risposta fiscale Lituania Risposta fiscale della Polonia risposta_fiscale_Romania Risposta fiscale in Serbia Risposta fiscale in Slovacchia Risposta fiscale in Slovenia Risposta fiscale in Spagna risposta-fiscale-Svezia

Questo articolo è stato tradotto automaticamente.

Oggetto fiscalResponse

Articoli correlati