Il presente articolo descrive la mappatura tra il RetailForce DOM e il modello lituano iEKA.
Mappatura dei documentType
In Lituania si opera una distinzione fondamentale tra i seguenti tipi di documento (indicati come «tipo di documento»):
- FiscalReceipt – transazioni di vendita
- nonFiscalReceipt - documenti per finalità diverse
- FiscalDay - rapporto di chiusura giornaliero
All’interno della categoria «nonFiscalReceipt» esistono ulteriori tipologie che consentono di effettuare ulteriori distinzioni.
Tutti i tipi (fiscalReceipt, nonFiscalReceipt, FiscalDay) devono essere inviati al sistema iEKA e sono pertanto «fiscalDocuments» secondo la definizione di RetailForce, ovvero documenti che devono essere fiscalizzati. L’unica differenza consiste nel fatto che i nonFiscalReceipts, a differenza dei fiscalReceipts e dei documenti FiscalDay, non vengono firmati tramite un modulo di sicurezza.
| Lituania | RetailForce documentType | ||||
| Tipo | Tipo | Descrizione | N. | Descrizione | Nota |
| ricevuta fiscale | ricevuta | Scontrino fiscale – vendita di beni/servizi | 0 | Scontrino | - |
| ricevuta fiscale | ricevuta | Scontrino nullo | 1000 | Ricevuta nulla | - |
| nonFiscalReceipt | Documento di reso non fiscale | Scontrino di cassa per la registrazione di resi/sostituzioni e rimborsi | 0 | Scontrino |
Si tratta dello stesso tipo di documento di una normale ricevuta di cassa. Mappatura: IF
|
| nonFiscalReceipt | documento di annullamento non fiscale | Interruzione di una transazione prima del completamento, transazione incompleta | 0 | La ricevuta | viene generata quando viene richiamato l'endpoint POST /api/v1/transactions/cancelDocument. |
| - | - | - | 1 | Fattura | Attualmente non supportata |
| - | - | - | 2 | Bolla di consegna | Al momento non supportato |
| nonFiscalReceipt | Documento di incasso non fiscale |
Operazione di pagamento, prelievo di denaro dalla cassa | 10 | Pagamento | Le operazioni di PayOut devono essere trasmesse con valori NEGATIVI (GrossValue, Amount, ecc.) |
| nonFiscalReceipt | Documento finanziario non fiscale |
Operazioni specifiche relative alle farmacie | 10 | PayOut | Attualmente non supportato |
| nonFiscalReceipt | Documento di incasso non fiscale | Operazioni di versamento, ad es. versamento di resto | 11 | PayIn | Le operazioni PayIn devono essere trasmesse con valori POSITIVI (GrossValue, Amount, ecc.) |
| nonFiscalReceipt | Documento finanziario non fiscale | Operazioni specifiche relative alle farmacie | 11 | PayIn | Attualmente non supportato |
| - | - | - | 12 | Fattura proforma | Al momento non supportato |
| - | - | - | 13 | CustomerOrder | Al momento non supportato |
| nonFiscalReceipt | preOrderDocument | - | 14 | PreliminaryReceipt | - |
| - | - | - | 15 | Ricevuta di pagamento | Attualmente non supportato |
| - | - | - | 80 | LongTermOrder | Tipo di documento supportato |
| nonFiscalReceipt | Documento di incasso non fiscale | Operazioni di versamento, ad esempio versamento del resto | 90 | OpeningBalance | viene considerato come un PayIn |
| nonFiscalReceipt | documento non fiscale | "Report (X)" - relazione intermedia | 98 | CashCheck | È possibile generare un CashCheck tramite l’endpoint GET /api/v1/closing/{clientId}/endofdayDocument. Tuttavia, prima di eseguire un’operazione /storeDocument, è necessario adeguare di conseguenza i campi documentType e documentCaption |
| giornoFiscale | giorno fiscale | «Report (Z)» – report di chiusura giornaliero | 99 | EndOfDay | È possibile generare un documento EndOfDay tramite l’endpoint GET /api/v1/closing/{clientId}/endofdayDocument e salvarlo tramite storeDocument. |
| - | - | - | 100 | Inventario | Attualmente non supportato |
| nonFiscalReceipt | Documento finanziario non fiscale | Struttura «Altre operazioni di incasso» (collectionType: 3 – acquisto) | 101 | Acquisto | Attualmente non supportato |
| - | - | - | 1001 | Stampa della ricevuta | Al momento non implementato |
| - | - | - | 1100 | Varie non fiscali | Al momento non supportato |
Mappatura dei PaymentType
La tabella seguente illustra i metodi di pagamento descritti nella documentazione tecnica del sistema lituano iEKA e la loro mappatura al RetailForce DOM.
| <paymenttype> iEKA Lituania</paymenttype> | "PaymentType" RetailForce | Nota | |
| 1 - Contanti | Contanti | 0 | Pagamento in contanti |
| 2 - Pagamento con carta di debito/credito | EcCard | 1 | pagamento con carta di debito |
| 2 - Pagamento con carta di debito/credito | CreditCard | 2 | pagamento con carta di credito |
| 3 – Altra carta di pagamento (es. carta loyalty) | Loyalty | 13 | |
| 4 – Buoni | MultiPurposeVoucher | 4 | I buoni monouso (3) non sono attualmente supportati come PaymentType, ma devono essere trasferiti nell’elemento «positions». |
| 5 - Vaglia postale | BankAccount | 11 | Pagamento tramite bonifico bancario |
| 6 - Rimborsato dal bilancio del Fondo di assicurazione sanitaria obbligatoria | non supportato | ||
| 7 - Rimborsato dal bilancio dello Stato | non supportato | ||
| 8 - Criptovaluta | Criptovaluta | 9 | |
| 9 - Altro | non supportato | ||
| Struttura "Altre operazioni di incasso in contanti" (collectionType 1 – versamento) | Deposito | 6 | Non supportato in Lituania come metodo di pagamento specifico, ma come operazione di incasso in contanti |
| 10 - Arrotondamento | non costituisce un metodo di pagamento autonomo in RetailForce, ma è rappresentato dall’elemento «rounding» (document.positions.rounding). | ||
| NoCash | 7 | Attualmente non implementato | |
| Nessuno | 8 | Al momento non supportato | |
| App per telefoni cellulari | 10 | Al momento non supportato | |
| Scheda cliente | 12 | Attualmente non supportato | |
| Assegno | 14 | Al momento non supportato | |
| CreditNote | 15 | Attualmente non supportato | |
Mappatura dei BusinessTransactionType
I BusinessTransactionTypes di RetailForce sono essenzialmente mappati alle cosiddette «operazioni» in Lituania.
| Lituania | RetailForce | |
| Operazione | N. | BusinessTransactionType |
| Operazione di vendita | 0 | Ricavi |
| Aggiunte di sconti | 1 | Sconto |
| Operazione di pagamento (collectionType 1 – versamento) | 2 | Deposito su vuoti |
|
PaymentType 4 – buoni PayOutType 4 – buoni |
3 | Buono monouso |
|
PaymentType 4 – buoni PayOutType 4 – buoni |
4 | MultiPurposeVoucher |
|
Non registrato Nella legislazione lituana, le mance non sono considerate transazioni commerciali nel settore della vendita al dettaglio e dell’ospitalità. Sono trattate come reddito personale. |
5 | Mance |
| Non registrato. | 6 | Mancia aziendale |
| Operazione PayIn (tipo di incasso 1 – versamento) | 7 | Deposito |
| Altre operazioni di incasso in contanti (direzione di incasso OUT) | 10 | Pagamento |
| Altre operazioni di incasso (direzione di incasso IN) | 11 | PayIn |
| Altre operazioni di incasso (direzione di incasso IN o OUT) | 90 | MoneyTransfer |
| Attualmente non supportato | 91 | Differenza di contante |
| Non supportato | 92 | |
| Non supportato | 93 | |
collectionTypes
Le altre operazioni di pagamento sono rappresentate da collectionTypes.
| Lituania | RetailForce | |
| collectionType | N. | Mappatura |
| Deposito | 1 |
PaymentType: [6] = Deposito BusinessTransactionType: [7] = Deposito |
| Altro | 2 | non mappato |
| Acquisto | 3 | Attualmente non supportato |
| Rimborso | 4 |
SE:
|
Il sistema RetailForce registra le comunicazioni con il sistema iEKA. Tali dati di debug sono persistiti nella cartella C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\lithuaniaFiscalFiles.
Per ulteriori dettagli, consultare l’articolo Comunicazione iEKA.
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.