Vai al contenuto principale

Processo di base per il trasferimento dei documenti

Harald Krondorfer
  • Aggiornato

Creazione del modulo fiscale

Per trasferire i documenti fiscali (dati fiscali) è necessario innanzitutto creare un modulo fiscale. Ciò può essere effettuato in diversi modi:

  • Se si utilizza il servizio fiscale certificato (servizio Windows o Linux), il modulo fiscale verrà creato automaticamente dal servizio stesso.
  • Se si intende effettuare l’integrazione del modulo fiscale tramite l’integrazione diretta con la DLL .NET, è necessario istanziare il modulo fiscale autonomamente. Di seguito è riportata una descrizione dettagliata:
    Creazione/istanziazione del modulo fiscale
Attenzione: il modulo fiscale inizializza alcuni sottomoduli e non deve essere ricreato per ogni ricevuta (ad esempio, l’autotest dell’hardware TSS (Germania) richiede almeno 30 secondi). Inoltre, è necessario richiamare CloudConnect prima di trasferire i documenti; in caso contrario, l’archiviazione nel cloud non andrà a buon fine (necessario solo se l’archiviazione nel cloud è abilitata).

Trasferimento dei documenti

Per trasferire i documenti fiscali al modulo fiscale sono necessari almeno 2 passaggi:

  • createDocument
  • storeDocument

Indipendentemente dal Paese, si raccomanda di richiamare il metodo CreateDocument in ogni caso.

Attenzione: il metodo CreateDocument deve essere invocato all’inizio del documento (al momento della registrazione di un articolo). Questa operazione è assolutamente necessaria per garantire la conformità legale alla normativa fiscale (ad es.: in Germania). È necessario impostare il campo fiscalResponse del documento da archiviare con il valore ottenuto al momento dell’invocazione del metodo CreateDocument.

Esempio di documento di ricevuta in formato JSON:

{
"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
   "Id": "1234",
   "Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
   {
      "ItemCaption": "Blume grün", // the caption of the item
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "Quantity": 1.0,
      "QuantityUnit": null,
      "ItemId": "000714", // the item id
      "BaseNetValue": 3.61, // base value (without discounts)
      "BaseGrossValue": 4.3,
      "BaseTaxValue": 0.69,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1, 
      "VatPercent": 19.0, 
      "NetValue": 3.61, // net value (quantity * price)
      "GrossValue": 4.3, // gross value of the position
      "TaxValue": 0.69,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
   }
],
"Payments": [
   {
      "Amount": 5.0, // payment with over payment
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   },
   {
      "Amount": -0.7, // cash return (second payment)
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   }
]
}

Questa ricevuta contiene:

  • una voce con l’articolo "000714", "Blume grün", al prezzo lordo di 4,3 EUR (1 pezzo).
  • 2 pagamenti: una voce con 5 EUR in contanti e un resto di 0,7 EUR
Nota: per comprendere come deve essere strutturato un documento, è possibile consultare l’esempio del Fiscal Service Client Sample (C#) disponibile nella sezione download (http://www.retailforce.cloud/downloads ). Esso mostra anche il JSON risultante all’avvio dell’applicazione di esempio. Si assicuri che il servizio fiscale sia installato e in esecuzione sullo stesso computer.

Per annullare un documento già creato, è possibile invocare il metodo:

  • cancelDocument
Attenzione: ogni documento creato (con createDocument) deve essere chiuso con storeDocument o annullato con cancelDocument.

Per convalidare un documento prima di trasferirlo al modulo fiscale, è possibile richiamare

  • ValidateDocument
Nota: il documento viene sempre convalidato prima di essere archiviato (anche se viene annullato). In caso di errore di convalida, il metodo StoreDocument fallisce generando un'eccezione.

Processi in dettaglio

Processo di vendita al dettaglio

La vendita di merci, ad esempio nel settore della vendita al dettaglio, si svolge come segue:

Operatore Sistema di cassa Servizio di fiscalizzazione RetailForce
1. L’operatore (utente del registratore di cassa) inserisce il primo articolo che il cliente desidera acquistare.    
  2. Il sistema di cassa invia una richiesta al servizio fiscale (createDocument) per registrare l’inizio della transazione corrispondente.  
    3. Il servizio di fiscalizzazione riceve la richiesta dal sistema a monte e la elabora in conformità con i requisiti specifici del Paese (ad es. firma, ecc.).
    4. Il servizio di fiscalizzazione invia una risposta (fiscalResponse) al sistema a monte.
  5. Il sistema di cassa (sistema a monte) riceve la risposta e ne memorizza alcune parti (o l’intero oggetto di risposta) per un ulteriore utilizzo (come riferimento) una volta completata la transazione.  
6. L’operatore scansiona tutti gli articoli del cliente e avvia la procedura di pagamento.    
 

7. Una volta determinati tutti i dati della transazione (articoli, metodo di pagamento, ecc.), il sistema POS genera il payload della transazione (JSON) e invia un’altra richiesta al servizio fiscale (storeDocument), che completa (salva) la transazione.

Alcune informazioni contenute nella risposta fiscale (fiscalResponse) ricevuta durante la fase createDocument devono essere incluse nel payload («fiscalDocumentNumber», «fiscalDocumentStartTime» e, se applicabile, elementi specifici per paese come «fiscalDocumentRevision» in Germania).

Attenzione: nel payload possono essere inclusi solo gli elementi sopra elencati e NON l’intero oggetto fiscalResponse!
  
    8. Il servizio fiscale riceve le richieste dal sistema a monte e le elabora in conformità con i requisiti specifici del Paese (ad es. firma, ecc.).
    9. Il servizio fiscale invia una risposta (fiscalResponse) al sistema a monte.
  10. Il sistema di cassa riceve la «fiscalResponse», estrae le informazioni necessarie per la creazione del documento (ad es. firma del documento, codice QR, ecc.) e stampa il documento.  
11. L’operatore consegna lo scontrino stampato al cliente    

Processo di vendita nel commercio al dettaglio con annullamento della transazione

Come descritto in precedenza, durante la fase 6 – ovvero DOPO l’invio di createDocument (fase 2) e PRIMA dell’invio di storeDocument (fase 7) – il sistema POS invia un cancelDocument anziché uno storeDocument.

Attenzione: il comando cancelDocument viene utilizzato per annullare (abbandonare) una transazione incompleta e NON (!) per registrare i resi.

I resi vengono gestiti allo stesso modo delle normali transazioni di vendita, utilizzando createDocument e storeDocument.

 

Questo articolo è stato tradotto automaticamente.

Articoli correlati

Commenti

0 commenti

Accedi per aggiungere un commento.

Powered by Zendesk