indica il Paese corrispondente.

Eseguendo una query GET /api/v1/information/client/{clientId}/countryProperties per recuperare le fiscalCountryProperties, viene restituito il paese assegnato al cliente specifico.

Specifica se in un determinato Paese è richiesta la certificazione di un componente di fiscalizzazione oppure quali elementi devono essere certificati.

"mandatory" - La certificazione del sistema a monte (ad es. il registratore di cassa) è obbligatoria. In questo caso, il registratore di cassa deve essere sottoposto a un processo di certificazione o di approvazione.

"miniPOS" – La certificazione è obbligatoria, ma viene soddisfatta da una componente già certificata che può essere integrata nel RetailForce Middleware.

"notNecessary" - Non è richiesta alcuna certificazione del sistema a monte.

"true" - Nel rispettivo Paese, i dati devono essere inviati riga per riga, ad esempio a una stampante fiscale.

• Attualmente non supportato

"false" - Interfaccia basata su documento (nessuna stampa riga per riga).

• L’integrazione tra il sistema a monte e il Servizio di fiscalizzazione avviene tramite endpoint API standard.

Specifica il tipo di fiscalizzazione.

"fiscalPrinter" - La fiscalizzazione si basa su una stampante fiscale certificata o su un sistema di registratore di cassa fiscale certificato.

• Ciò implica che, oltre al sistema RetailForce, è necessaria una stampante fiscale; potrebbe essere necessario acquisirla da un fornitore locale.

"online" - Fiscalizzazione tramite i servizi telematici delle autorità fiscali locali.

• Non sono richiesti componenti hardware aggiuntivi.

"signature" - Fiscalizzazione mediante la firma dei dati dello scontrino utilizzando un certificato digitale memorizzato nel servizio di fiscalizzazione.

• In alcuni Paesi potrebbe essere necessario ottenere un certificato digitale qualificato rilasciato da una CA (Autorità di Certificazione).

"signatureWithOnline" - Fiscalizzazione tramite generazione di firme e trasmissione telematica dei dati alle autorità fiscali.

• Combinazione dei due tipi sopra menzionati.

Specifica l'ambiente supportato:

"local" - installazione locale del middleware fiscale (in locale sul sistema POS, sul server del punto vendita, ecc.)

• È possibile effettuare chiamate API al servizio di fiscalizzazione installato localmente:
  • http://localhost:7678/ nel caso dell’implementazione REST, oppure
  • chiamata di metodo nel caso dell’implementazione NuGet.

"cloud" - il middleware fiscale è disponibile come servizio cloud ospitato all’indirizzo https://fiscalisation.retailforce.cloud/.

• È possibile effettuare chiamate API al servizio di fiscalizzazione cloud.

Specifica i sistemi operativi/le piattaforme supportate.

"linux"

• tramite container Docker (implementazione REST)

"windows"

• tramite servizio Windows (implementazione REST), oppure
• tramite implementazione NuGet

"iOS"

• tramite implementazione nuget

"Android"

• tramite implementazione NuGet, oppure
• Servizio Android (implementazione REST)

Specifica i requisiti legali supportati e le relative versioni.

Ad esempio, per la Grecia: «myDATA v1.x.x».

Tipi di documenti che devono essere «fiscalizzati» nel rispettivo Paese. Ad esempio, devono essere elaborati dal componente hardware prescritto, firmati, ecc.

I «documentTypes» elencati sotto «fiscalDocumentTypes» vengono elaborati automaticamente (ad es. firmati) nel rispettivo Paese dal servizio di fiscalizzazione, in conformità con la normativa vigente.

Tali tipi di documento DEVONO essere trasmessi al servizio di fiscalizzazione nel rispettivo paese, a condizione che il sistema a monte («registratore di cassa») li supporti.

Elenco dei tipi di documento supportati in ciascun paese.

Oltre ai «fiscalDocumentTypes», i tipi di documento elencati sotto «supportedDocumentTypes» POSSONO essere trasmessi al servizio di fiscalizzazione.

Tali tipi di documento sono definiti «non fiscali», ovvero non sottoposti a fiscalizzazione (ad es. firmati).

Elenco dei tipi di documento non supportati nel rispettivo paese.

I «documentTypes» elencati sotto «notSupportedDocumentTypes» non possono essere trasmessi al servizio di fiscalizzazione nel rispettivo paese.

Le cause possono essere l’impossibilità tecnica o specifiche normative/leggi del Paese.

Se un "notSupportedDocumentType" viene inviato al servizio di fiscalizzazione, quest’ultimo risponderà con un messaggio di errore ("documentType non supportato!").

Il sistema a monte non dovrebbe consentire l’utilizzo di tali tipi di documento nel Paese in questione.

Elenco dei metodi di pagamento supportati (accettati) nel rispettivo Paese.

Tali metodi di pagamento possono essere utilizzati nel Paese in questione.

Il sistema a monte deve esporre all’utente del registratore di cassa esclusivamente i metodi di pagamento supportati nel rispettivo Paese.

Elenco dei metodi di pagamento non supportati (o non consentiti) nel rispettivo Paese.

Il sistema a monte deve escludere i metodi di pagamento non supportati nel rispettivo Paese.

Elenco dei metodi di pagamento (PaymentTypes) per i quali non è consentito il pagamento in eccesso rispetto all’importo dovuto nel Paese in questione.

Esempi:

Totale dello scontrino = 38,50 EUR

• Il cliente paga 50 EUR con carta di debito poiché desidera ricevere il resto in contanti.
• Il cliente paga 50 EUR in contanti e riceve 11,50 EUR di resto (resto consegnato).

Tali transazioni non sono consentite in alcuni Paesi (ovvero, non possono essere trasmesse al sistema di fiscalizzazione).

Ciò implica che gli importi dei pagamenti («payment.amount») devono sempre corrispondere al totale lordo delle voci («GrossValue» di tutte le «positions») e non è consentito trasferire importi di pagamento negativi.

Elenco dei tipi di casi aziendali supportati in ciascun paese.

Tali casi aziendali possono essere utilizzati nel rispettivo Paese, a differenza di notSupportedBusinessTransactionTypes.

Elenco dei tipi di casi aziendali non supportati (o non consentiti) nel rispettivo paese.

Tali casi aziendali non possono essere utilizzati nel rispettivo paese e devono essere soppressi dal sistema di origine e non trasmessi al servizio di fiscalizzazione.

Informazioni dettagliate sulle aliquote Vat supportate in ciascun paese.

Questo array contiene le seguenti informazioni:

• Aliquota IVA: "VatPercent" / "VatPercent2"
• ID interno utilizzato per mappare la rispettiva aliquota Vat: "VatIdentification"
• Nome dell’aliquota Vat: "caption" / "caption_EN"
• Aliquote IVA storiche con dettagli sulla validità ("ValidFrom" - "ValidTo")

"non obbligatorio" - La visualizzazione del cliente non è richiesta (nessun obbligo).

"obbligatorio (no-RF)" - La visualizzazione sul display cliente è obbligatoria, ma non è controllata tramite il RetailForce Middleware; il controllo viene effettuato automaticamente dal rispettivo sistema di fiscalizzazione (ad es. dalla stampante fiscale).

"obbligatorio (RF)" - L’uso del display cliente è obbligatorio e la gestione avviene tramite il RetailForce Middleware.

• Il controllo del display cliente avviene tramite la funzione: POST /api/v1/transactions/display/{clientId}

"non consentito" - L’uso di un display cliente è vietato in questo Paese.

Specifica se i dispositivi di input devono essere registrati nel rispettivo paese ("true" / "false").

I dispositivi di input non costituiscono sistemi di registrazione autonomi. Per ulteriori dettagli, si consiglia di consultare la sezione Architetture dei sistemi di registrazione elettronica (EAS).

"true" - nel rispettivo Paese vige l’obbligo di tenere un registro tecnico (audit log) (in questo caso incluso nella licenza RF).

• In tal caso, le registrazioni degli eventi tecnici devono essere inviate al servizio di fiscalizzazione tramite
  • POST /api/v1/transactions/AuditLog , oppure
  • POST /api/v1/transactions/storeDocument ("documentType": "[1002] = AuditLog")

"false" - non sussiste l’obbligo di tenere un registro tecnico (non incluso nella licenza).

• Gli eventi tecnici POSSONO essere registrati, ma non è obbligatorio farlo.

"true" – nel Paese in questione, la ristampa di un documento deve essere registrata obbligatoriamente.

• Chiamare una delle seguenti opzioni:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, oppure

  • PUT /api/v1/transactions/reprintDocument

    obbligatorio.

"false" - La ristampa di un documento non deve essere registrata come obbligatoria.

"terminal" – Il documento può essere ristampato esclusivamente sullo stesso registratore di cassa su cui è stato emesso il documento originale.

"store" - Le ristampe di un documento possono essere effettuate esclusivamente all’interno della stessa filiale/negozio in cui è stato emesso il documento originale.

• La funzionalità di ristampa tra più filiali deve essere implementata dal sistema a monte.

"tutti" - La ristampa di un documento può essere effettuata su un altro registratore di cassa, nonché in un’altra filiale o in un altro punto vendita della stessa azienda.

• La funzione di ristampa tra più filiali deve essere implementata dal sistema a monte.

"true" - È necessario generare una chiusura giornaliera (rapporto Z) una volta al giorno.

• chiusura giornaliera
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = EndOfDay"

"false" - non è richiesta alcuna chiusura giornaliera.

Indica l’intervallo di tempo, espresso in ore, che deve trascorrere dall’apertura giornaliera del registratore di cassa fino alla chiusura giornaliera (ad es. entro 24 ore).

"-1" - non impostato.

Specifica se le vendite e i resi possono essere registrati contemporaneamente su uno scontrino (documento).

"oneReceiptAllowed" - consentito (vendite e resi possono essere riportati insieme su un unico scontrino).

• Vendite:
  • "positions" (Tipo 0 o 1) con valori positivi,
• Resi:
  • "positions" (Tipo 0 o 1) con valori negativi e
  • "documentReference" impostato.

"oneReceiptAllowedVat" – fintantoché l’importo del Vat rimane positivo, le vendite e i resi possono essere registrati su un’unica (la stessa) ricevuta.

"multiReceipt" – Le vendite e i resi devono essere registrati su ricevute diverse.

• Prima di inoltrare i dati al servizio di fiscalizzazione, il sistema a monte deve suddividere automaticamente le vendite e i resi in transazioni distinte.

"NoReturnAllowed" – nel rispettivo Paese, l’elaborazione dei resi tramite il sistema di fiscalizzazione non è possibile. In tali Paesi, i resi vengono spesso gestiti tramite moduli speciali o simili dall’ufficio contabilità.

Dove è possibile restituire gli articoli acquistati?

"terminal" - Gli articoli possono essere ritirati esclusivamente presso la stessa cassa (emissione del buono) presso la quale è stata effettuata la vendita originale.

"store" - Gli articoli possono essere restituiti esclusivamente presso la stessa filiale/negozio (emissione dello scontrino) in cui è stata effettuata la vendita originaria.

"tutti" - Gli articoli possono essere restituiti anche presso filiali diverse della stessa azienda.

Riferimento del documento per i resi

"singolo" - in caso di resi, è possibile fare riferimento solo a UN unico documento precedente (documento di vendita dei servizi o dei beni oggetto del reso).

• "documentReference" è ammesso esclusivamente per un singolo documento preliminare, oppure
• il riferimento a livello di voce («positionReference») è consentito solo per un unico documento preliminare.

"multiple" – in caso di resi, è possibile fare riferimento a più documenti precedenti (più ricevute di vendita qualora vengano restituiti più servizi o beni provenienti da più acquisti). 

• "documentReference" a più documenti precedenti, oppure
• riferimento al documento precedente corrispondente tramite "positionReference" sulla singola voce di reso.

Specifica se l’elemento «fiscalDocumentNumber» della «fiscalResponse» del Paese corrispondente deve essere stampato sui documenti.

• I numeri di documento trasferiti dal sistema a monte vengono ignorati. Il sistema fiscale (ad es. la stampante) assegna autonomamente il rispettivo numero di documento/ID documento.

"true" - nel rispettivo Paese sono consentiti i supplementi su beni o servizi.

• surcharges:
  • "positions.discounts" con valori NEGATIVI

"false" - I supplementi di prezzo non sono consentiti.

Indica se nel rispettivo Paese è consentita la modalità di formazione/dimostrazione del registratore di cassa

"true" - consentito.

• Modalità di formazione:
  • "IsTraining": true

"false" - Il registratore di cassa non deve disporre di una modalità di formazione/dimostrazione.

"true" - La somma delle singole voci viene calcolata in base all’importo netto (NetValue) (ad es. Québec/Canada).

"false" - La somma delle singole voci viene calcolata in base all’importo lordo (GrossValue) (impostazione predefinita).

"true" - Le voci inserite ma non incluse nel documento devono essere trasmesse nel payload (JSON).

"false" - Le voci che sono state inserite ma che successivamente non sono state incluse nel documento non devono essere trasmesse.

Specifica il tipo di documento iniziale nel Paese di riferimento.

Rilevante solo se il sistema a monte NON utilizza la funzione GET /api/v1/transactions/document/{clientId}/start durante l’inizializzazione e genera autonomamente il relativo documento iniziale.

Elenco dei tipi di pagamento supportati nel Paese in questione.

Le voci elencate sotto "supportedPayOutTypes" possono/devono essere specificate per i pagamenti ("documentType": "[10] = PayOut" e "BusinessTransactionType": "[10] = PayOut").

Indica se le aliquote IVA vengono calcolate dal rispettivo modulo di fiscalizzazione del Paese.

"true" - Il modulo di fiscalizzazione calcola le aliquote IVA.

"false" - Il registratore di cassa deve calcolare le aliquote VAT.

Specifica se e quante cifre decimali devono essere incluse nel documento JSON destinato al middleware fiscale al momento dell’invio di importi/totali.

Si applica a tutte le specifiche di valore nel payload ("GrossValue", "NetValue", "TaxValue", "Amount", ecc.)