Tipo

INFO

indica il Paese corrispondente.

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

INFO

INFO

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 è soddisfatta da una componente già certificata che può essere integrata nel RetailForce Middleware.

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

RFI

"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 documenti (nessuna stampa riga per riga).

• L’integrazione tra il sistema a monte e il Servizio di fiscalizzazione si basa su endpoint API standard.

INFO

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 acquistarla presso un fornitore locale.

"online" - Fiscalizzazione tramite i sistemi online 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 fornito da una CA (Autorità di Certificazione).

"signatureWithOnline" - Fiscalizzazione mediante generazione di firme e trasmissione dei dati in tempo reale alle autorità fiscali.

• Combinazione dei due tipi sopra menzionati.

RFI

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.

RFI

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)

INFO

Specifica i requisiti legali supportati e le relative versioni.

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

RFI

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.

RFI

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).

RFI

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 motivazioni possono essere l’impossibilità tecnica o specifiche normative/legislative 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.

RFI

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 punto cassa esclusivamente i metodi di pagamento supportati nel Paese di riferimento.

RFI

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.

RFI

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.

RFI

Elenco dei tipi di casi aziendali supportati in ciascun paese.

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

RFI

Elenco dei tipi di transazioni 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.

RFI

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 IVA: "VatIdentification"
• Nome dell’aliquota VAT: "caption" / "caption_EN"
• Aliquote IVA storiche con dettagli sulla validità ("ValidFrom" - "ValidTo")

RFI

RFI

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

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

"obbligatorio (RF)" - L'utilizzo della visualizzazione per il cliente è obbligatorio e il controllo avviene tramite il RetailForce Middleware.

• La visualizzazione per il cliente viene controllata tramite la funzione: POST /api/v1/transactions/display/{clientId}

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

RFI

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 informazioni, si consiglia di consultare la sezione Architetture dei sistemi di registrazione elettronica (EAS).

RFI

"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 relative agli 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.

RFI

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

• È necessario chiamare uno dei seguenti endpoints:
  • 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.

RFI

"terminal" – Il documento può essere ristampato esclusivamente sullo stesso punto 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/negozio della stessa azienda.

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

RFI

"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.

RFI

Indica l’intervallo di tempo trascorso dall’ultima chiusura giornaliera entro il quale deve essere eseguita la successiva chiusura giornaliera (ad es. entro 24 ore). Trascorso tale intervallo, il servizio di fiscalizzazione respinge ogni documento, ad eccezione della chiusura giornaliera ("documentType": "[99] = EndOfDay"), restituendo lo stato HTTP 400 fino a quando non viene memorizzata una chiusura giornaliera. Non si applica alcun limite prima della prima chiusura giornaliera.

"-1" - non impostato.

RFI

Specificare 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’unica ricevuta).

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

"oneReceiptAllowedPerVatRate" - le vendite e i resi possono essere registrati su un’unica (la stessa) ricevuta, purché i totali lordi di tutte le aliquote Vat presenti sulla ricevuta abbiano lo stesso segno (tutti positivi o tutti negativi).

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

• Prima della trasmissione dei 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 analoghi presso l’ufficio contabilità.

RFI

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.

RFI

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 restituiti).

• "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.

RFI

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.

RFI

"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.

RFI

Indica se la modalità di formazione/dimostrazione è supportata dal servizio di fiscalizzazione per il rispettivo Paese

"true" - consentito.

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

"false" - la modalità di formazione/dimostrazione non è supportata. Il servizio di fiscalizzazione rifiuta ogni documento con "IsTraining": true (errore di convalida "Ricevuta di formazione non consentita in questo Paese.").

RFI

"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).

RFI

"true" - Le voci che sono state inserite ma che successivamente non sono state 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.

RFI

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.

RFI

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").

RFI

RFI

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

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

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

RFI

RFI

RFI

RFI

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.)

RFI

RFI

RFI

RFI