Il servizio di fiscalizzazione RetailForce è un middleware di fiscalizzazione basato su .NET per la Germania e tutti gli altri paesi.

Installazione

È possibile scaricare una copia del servizio di fiscalizzazione per Windows utilizzando il seguente link:

http://www.retailforce.cloud/downloads

Si prega di scaricare la versione più recente del software.

Il programma di installazione è di facile utilizzo e non sono necessarie ulteriori informazioni.

Al termine del setup, il servizio è esposto come servizio web REST (JSON) sulla porta 7678 (HTTPS) su localhost.

Alternativa

In alternativa all’installazione del servizio web REST, il RetailForce Fiskal middleware è disponibile anche come:

• Contenitore Docker – scaricabile da Docker Hub all’indirizzo https://hub.docker.com/u/RetailForce, nonché
• nuget-packages – scaricabili all’indirizzo: https://www.nuget.org/profiles/RetailForceDevelopment

Le informazioni relative a queste varianti di installazione/integrazione sono disponibili nei seguenti articoli:

• Container Docker: Linux - TrustedFiscalService come container Docker
• nuget-packages: primi passi nell’implementazione tramite NuGet

Applicazione di esempio

Nella directory di download sopra indicata, all’interno della sottocartella Samples, è presente anche un’applicazione di esempio (Fiscal Service Client Sample). In questa applicazione di esempio è incluso l’intero codice sorgente per la registrazione e la firma di semplici transazioni in C#.

Per utilizzare l’applicazione di esempio, è possibile utilizzare il seguente client-guid:

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

È possibile utilizzare questo GUID client per i primi test senza alcun problema. Per ulteriori test, anche con l’integrazione Cloud, è necessario creare un proprio client di prova con RetailForce Cloud.

Qualora dovesse riscontrare problemi legati alla mancanza di file DLL, La invitiamo a controllare la cartella bin/debug del progetto nell’applicazione di esempio.

Convalida dei documenti

Per agevolare l’integrazione del Suo software, abbiamo realizzato una funzione che consente di convalidare il modello a oggetti del documento che invierà al modulo di fiscalizzazione.

Quando si richiama il metodo ValidateDocument su un TrustedFiscalModule creato o sul servizio web di fiscalizzazione (a seconda della propria integrazione), si otterranno immediatamente tutti gli errori (e gli avvisi) relativi al documento. In questo modo risulta molto più semplice adattare la procedura di chiamata per completare il processo di integrazione.

Ulteriori informazioni

L’integrazione del middleware può avvenire nei seguenti modi

• Integrazione tramite servizio web (Windows, REST)
• Integrazione tramite servizio web (con Fiskalclient in .NET Standard, NuGet)
• Integrazione tramite servizio web (con Fiskalclient in .NET Framework 2.0, NuGet)
• Integrazione tramite servizio web (come DLL COM/ActiveX, disponibile su richiesta)
• Integrazione come pacchetto AAR su dispositivi Android (per Java) (disponibilità subordinata ai piani di Microsoft)

Alcune informazioni aggiuntive sugli aspetti tecnici

• L’intero sviluppo viene effettuato secondo il metodo Test-Driven Development
• Tutti i test vengono eseguiti durante il processo di compilazione in occasione della creazione di una nuova versione
• Distribuzione della soluzione tramite pacchetti NuGet o tramite download del programma di installazione di Windows.

Sistemi operativi

Il RetailForce Middleware è stato finora testato sui seguenti sistemi operativi:

• Windows 7
• Windows 10
• Android (a partire dalla versione 8) (come integrazione tramite pacchetto nuget)
• Linux (per il servizio)

Si prega di consultare anche la documentazione relativa al sistema di sicurezza per verificare se il sistema di sicurezza prescelto (TSE, HSM, ecc.) nel Paese di riferimento supporti il sistema operativo in uso.

Al momento non testato né supportato, ma dovrebbe funzionare:

• iOS (come integrazione tramite pacchetto NuGet)

Gestione dei clienti fiscali

In base alla nostra esperienza, la gestione dei clienti fiscali può talvolta rivelarsi dispendiosa in termini di tempo e complessa.

Pertanto abbiamo sviluppato i seguenti servizi aggiuntivi:

• Configurazione automatica dei clienti tramite il RetailForce Cloud, che esclude la necessità di manutenzione del client fiscale installato
• API di gestione RetailForce Cloud per la gestione di ulteriori società, punti vendita e terminali, nonché di tutti gli altri dati anagrafici necessari.

Documentazione aggiuntiva / documentazione sui servizi

Qui troverete la documentazione aggiuntiva:

Descrizione completa del servizio per il servizio web

• http://localhost:7678/swagger (dopo l’installazione del servizio web)

Documentazione completa (modello a oggetti) del servizio fiscale

Documentazione contenuta nella sottocartella “download” dei file di installazione (link al capitolo “Installazione”)

Questa documentazione sarà presto disponibile all’indirizzo http://docs.RetailForce Cloud.

Caratteristiche del Paese (fiscalCountryProperties)

Questo articolo è stato tradotto automaticamente.