Il presente articolo illustra le attuali aggiunte e modifiche apportate al modello a oggetti del documento (DOM) nelle rispettive release.
Le implementazioni esistenti non subiscono alcuna modifica a seguito di tali cambiamenti. La retrocompatibilità del DOM è garantita. Qualora una modifica dovesse influire sulla retrocompatibilità, ciò verrà segnalato separatamente.
Le modifiche sono solitamente necessarie nel corso dell’implementazione di nuovi paesi soggetti a fiscalizzazione. Al fine di soddisfare i requisiti di fiscalizzazione in questi paesi aggiuntivi tramite il RetailForce Middleware, si raccomanda di adattare le implementazioni esistenti e di trasferire in futuro i nuovi campi al middleware, a condizione che siano disponibili nel sistema a monte.
Elementi
La tabella seguente illustra quali modifiche a determinati elementi del DOM sono state implementate o rimosse in ciascuna versione.
|
DOM - Ver. |
Oggetto DOM | DocumentPosition | Modifica | Rilascio |
| 1.7.0 | SystemEntryDate | Documento | A seguito dei requisiti normativi vigenti in Portogallo, il campo SystemEntryDate è stato introdotto principalmente per le fatture (nei casi in cui la data della fattura differisca dalla data di registrazione). | 1.11.16 |
| 1.5.2 | IsBusiness | Partner | A causa dei requisiti francesi, il campo “partner.IsBusiness” viene convalidato nei client francesi. | 1.9.1 |
| 1.5.2 | BaseTaxValue2 | Posizione ItemBase |
BaseTaxValue2 specifica il valore (al lordo di sconti o maggiorazioni) di una seconda aliquota fiscale. | 1.9.0 |
| 1.5.2 | VatPercent2 | Posizione ItemBase |
È possibile specificare una seconda aliquota fiscale in VatPercent2. Tale parametro è richiesto, ad esempio, in Québec (Canada). | 1.9.0 |
| 1.5.2 | AdditionalTax | Posizione ItemBase |
È possibile specificare imposte aggiuntive, quali quelle applicate su alcolici o tabacco in alcuni paesi, utilizzando il campo AdditionalTax. | 1.9.0 |
| 1.5.2 | TaxValue | Posizione ItemBase |
TaxValue2 specifica il valore (al netto di sconti o maggiorazioni) di una seconda aliquota fiscale. | |
| 1.5.2 | ItemType | Posizione ItemBase |
ItemType descrive la tipologia dell’articolo: beni o servizi
|
1.8.18 |
| 1.5.0 | DocumentIssueType | Documento | Definisce il tipo di emissione del documento (cartaceo, ricevuta digitale, cartaceo e digitale, non emesso) | 1.8.8 |
| 1.5.0 | ServiceType | Documento | Specificazione del tipo di servizio (servizio al tavolo, servizio allo sportello), con dettagli relativi all’«attività» | 1.8.8 |
| 1.5.0 | Transazione e-commerce | Documento | Indicazione del fatto che la transazione sia una transazione di e-commerce | 1.8.8 |
| 1.5.0 | ID univoco del registratore di cassa | Documento |
L'ID univoco del cashregister viene salvato nel documento a partire dalla versione 1.5.0 del DOM, ma il campo Configuration.CashRegister.Id viene rimosso dalla configurazione. Nell’ambito dell’integrazione con Warrify. |
1.8.8 |
| 1.5.0 | Configurazione |
Obsoleto fino a nuovo avviso. Nell’ambito dell’integrazione con Warrify. |
1.8.8 | |
| 1.5.0 | TerminalSlaveId | Documento | Opzione per specificare l’ID di una stazione di immissione dati (slave) collegata al sistema di registrazione elettronico. | 1.8.8 |
| 1.5.0 | footerGraphicIndex | Documento | Tramite footerGraphicIndex viene inserito un elemento grafico predefinito nel piè di pagina di un documento. | 1.8.8 |
| 1.5.0 | AdditionalHeader | Documento | Testo aggiuntivo nell’header di una ricevuta (aggiunto nell’ambito del potenziamento funzionale per la stampa dei documenti in Italia). | 1.8.8 |
| 1.5.0 | AdditionalFooter | Documento | Testo aggiuntivo nel Footer di un documento contabile (aggiunto nell’ambito del potenziamento funzionale per la stampa dei documenti in Italia). | 1.8.8 |
| 1.5.0 | Coupon | Documento | È stata implementata la funzionalità di stampa di coupon aggiuntivi sulla ricevuta (implementazione effettuata nell’ambito del potenziamento funzionale per la stampa dei documenti in Italia). | 1.8.8 |
| 1.5.0 | IsBusiness | Partner | Definizione secondo cui il “partner” (= cliente) è un cliente aziendale. | 1.8.8 |
| 1.5.0 | Identificazione aggiuntiva | Partner |
Trasmissione di ID aggiuntivi quali:
|
1.8.8 |
| 1.5.0 | VatPercentage2 | Vat | Specificazione di un'aliquota fiscale aggiuntiva (estensione per i paesi con più di un'aliquota fiscale – ad esempio GST e QST in Québec/Canada). | 1.8.8 |
| 1.5.0 | VatPercent2 | Posizione | Trasmissione di un’aliquota fiscale aggiuntiva per la rispettiva voce (estensione per i paesi con più di un’aliquota fiscale – ad es. GST e QST in Québec/Canada). | 1.8.8 |
| 1.5.0 | AdditionalTaxType | Posizione. AdditionalTax | Indicazione delle imposte aggiuntive (alcol, tabacco, NOVA (auto in AT), altre) | 1.8.8 |
| 1.5.0 | Identificativo del AdditionalTaxType | Posizione. AdditionalTax | Dettagli relativi all’imposta aggiuntiva; campo obbligatorio se AdditionalTaxType è “altro”. | 1.8.8 |
| 1.5.0 | TaxPercent | Posizione. AdditionalTax | Indicazione dell’aliquota (in percentuale) di un’imposta aggiuntiva. | 1.8.8 |
| 1.5.0 | TaxValue | Posizione. AdditionalTax | Indicazione dell’importo di un’aliquota fiscale aggiuntiva. | 1.8.8 |
| 1.5.0 | BusinessSector | FiscalClient | Definizione del settore di attività (ambito di attività). | 1.8.8 |
| 1.5.0 | CardData | Pagamento | può essere utilizzato per stampare le ricevute delle carte di credito per il cliente e l’esercente (attualmente disponibile solo in Italia) | 1.8.8 |
| 1.4.1 | FiscalModuleVersion | Documento | Versione del modulo fiscale (Trusted Fiscal Module) utilizzato per generare il documento in questione. Viene impostata automaticamente dal middleware se non viene trasmessa dal software. | 1.8.4 |
| 1.4.1 | Versione del modulo fiscale nazionale | Documento | Versione del modulo nazionale (Trusted Fiscal Country Module) utilizzata per generare il documento in questione. Viene impostata automaticamente dal middleware qualora non venga trasmessa dal software. | 1.8.4 |
| 1.4.1 | SoftwareName | Documento | Nome del software POS con cui è stato generato il rispettivo documento. Viene impostato automaticamente dal middleware se non viene trasmesso dal software. | 1.8.4 |
| 1.4.0 | Offset data-ora | Riferimento al documento | Modificare tutti i campi DateTime in DateTimeOffset in vista della fiscalizzazione nel Cloud. | 1.8.0 |
| 1.3.0 | FiscalDocument-Revision | FiscalResponse - Germania | L'elemento viene ora utilizzato esclusivamente nei campi AdditionalFields del FiscalResponseGermany. | 1.7.7 |
| 1.3.0 | FiscalDocument-Number | fiscalResponse | fiscalDocumentNumber (string ) aggiunto per consentire la mappatura di valori alfanumerici (Ungheria, Serbia). | 1.7.7 |
| 1.2.0 | PayOutType | Posizione. Registrazione |
Elemento introdotto per consentire la classificazione dei pagamenti alla cassa. Si prega di notare che, ad esempio, un trasferimento di denaro (da registratore di cassa a banca e viceversa) è già classificato tramite i BusinessTransactionTypes. | 1.7.6 |
| 1.2.0 | ReturnReasonType | Riferimento al documento |
I valori
|
1.7.6 |
| 1.2.0 | Payment | La proprietà IsCash è stata rimossa dal DOM. | 1.7.6 | |
| 1.1.8 | ItemSerialNumber | Position.Item | Aggiunta la proprietà ItemSerialNumber : numero di serie dell’articolo o numero identificativo. | 1.6.4 |
| 1.1.7 | ReturnReasonType | Riferimento al documento | Proprietà aggiunta. | 1.6.1 |
| 1.1.7 | ReturnReasonText | Riferimento al documento | Proprietà aggiunta. | 1.6.1 |
| 1.1.7 | Barcode | Posizione.Testo | Proprietà aggiunta. Utilizzata per la stampa di Barcode tramite stampanti fiscali. | 1.6.1 |
| 1.1.7 | barcodeType | Posizione.Testo | Proprietà aggiunta. Specificazione del tipo di Barcode. | 1.6.1 |
| 1.1.1 | AccountingDate | Documento | Aggiunta la data di registrazione contabile della transazione. | 1.3.2 |
| 1.1.1 | ServicePeriodStart | Documento | Inizio del periodo di servizio – proprietà aggiunta. | 1.3.2 |
| 1.1.1 | ServicePeriodEnd | Documento | Fine del periodo di servizio – proprietà aggiunta. | 1.3.2 |
| 1.1.1 | PaymentTerms | Documento | Aggiunto l'oggetto "Condizioni di pagamento" (PaymentTerms). | 1.3.2 |
| 1.1.1 | PositionCount | Documento | Numero di articoli trasferiti (errore di convalida se il numero di articoli trasferiti non corrisponde a questo campo). | 1.3.2 |
| 1.1.1 | DueDateDays | PaymentTerms | Aggiunta la proprietà "Pagabile entro". | 1.3.2 |
| 1.1.1 | Sconto | PaymentTerms | Aggiunta la proprietà "sconto". | 1.3.2 |
| 1.1.1 | DiscountDueDays | PaymentTerms | Aggiunta la proprietà "Periodo di sconto". | 1.3.2 |
| 1.1.1 |
Penale per ritardato pagamento - Tasso |
PaymentTerms | Aggiunta la proprietà "Interessi di mora". | 1.3.2 |
| 1.1.0 | PrintCount | Documento | Aggiunta la proprietà "PrintCount " (numero di stampe) – conteggio delle stampe al momento della creazione del documento contabile. | 1.2.11 |
| 1.1.0 | ProformaPrintCount | Documento | Aggiunta la proprietà ProformaPrintCount: conteggio delle stampe prima del salvataggio della ricevuta (ad es.: stampa di informazioni nel settore della ristorazione). | 1.2.11 |
| 1.1.0 | DeliveryPrintCount | Documento | Aggiunta la proprietà DeliveryPrintCount: conteggio delle stampe di ordini intermedi / ad es.: ordini al tavolo o stampa in cucina/bar. | 1.2.11 |
| 1.1.0 | SalesPerson | Documento | Aggiunta la proprietà "SalesPerson" (tipo di oggetto: Utente). | 1.2.11 |
| 1.1.0 | CustomerCount | Documento | Aggiunta la proprietà CustomerCount : numero di clienti presenti su uno scontrino. | 1.2.11 |
| 1.1.0 | CreateDate | Posizione | Aggiunta la proprietà CreateDate: data di creazione dell’articolo, se disponibile. | 1.2.11 |
| 1.1.0 | CostPrice | Posizione.Articolo | Aggiunta la proprietà CostPrice : prezzo di costo/prezzo di acquisto. | 1.2.11 |
| 1.1.0 | ItemDateOfEntry | Posizione.Articolo | ItemDateOfEntry Data di inserimento dell’articolo ItemDateOfEntry: data di inserimento dell’articolo. | 1.2.11 |
| 1.1.0 | CreateDate | Pagamento | Aggiunta la proprietà CreateDate: data di creazione del pagamento, se disponibile. | 1.2.11 |
| 1.1.0 | Utente | Pagamento | Aggiunta la proprietà «Utente »: l’utente che ha inserito il pagamento. | 1.2.11 |
| 1.1.0 | SalesPerson | Pagamento | Aggiunta la proprietà SalesPerson: il venditore che ha effettuato il pagamento. | 1.2.11 |
| 1.1.0 | ID di riferimento del terminale di pagamento | Pagamento | Aggiunto PaymentTerminalReferenceId: consente di specificare un transactionId quando è collegato un terminale di pagamento. | 1.2.11 |
| 1.1.0 | Identificatore | Posizione. Sconto |
Aggiunto l’identificatore della proprietà | 1.2.11 |
| 1.1.0 | FirstName | Utente | Aggiunta la proprietà "Nome". | 1.2.11 |
| 1.1.0 | LastName | Utente | Aggiunta la proprietà "Cognome". | 1.2.11 |
| 1.1.0 | Predecessore | ReferenceType | Aggiunto il tipo di riferimento aggiuntivo «documento precedente». | 1.2.11 |
| 1.0.0 |
FiscalDocument - startTime |
fiscalResponse | Proprietà aggiunta. | 1.0.0 |
| 1.0.0 | PaymentType | Pagamento | Proprietà aggiunta. | 1.0.0 |
| 1.0.0 |
Transazione commerciale - Tipo |
Posizione | Proprietà aggiunta. | 1.0.0 |
Tipi di documento
La tabella seguente mostra in quale versione determinati tipi di documento (DocumentType) sono stati aggiunti o eliminati.
|
DOM - Vers. |
DocumentType | Modifica / Spiegazione | Rilascio |
| 1.3.0 | Stampa ricevuta | Utilizzato per stampare documenti non fiscali senza voci di articolo | 1.7.7 |
| 1.1.0 | Fattura proforma | Aggiunto il tipo di documento "Fattura proforma". Fattura proforma. | 1.2.11 |
| 1.1.0 | Inventario | Aggiunto il tipo di documento “Inventario” – per le operazioni di inventario. | 1.2.11 |
Modalità di pagamento
La tabella seguente indica in quale versione sono state aggiunte o eliminate determinate tipologie di pagamento / modalità di pagamento (PaymentType).
|
DOM - Vers. |
PaymentType | Modifica / Spiegazione | Rilascio |
| 1.1.0 | Criptovaluta | Criptovaluta – per pagamenti tramite Bitcoin e altcoin | 1.2.11 |
| 1.1.0 | App per telefoni cellulari | App per telefoni cellulari – per pagamenti tramite applicazioni per telefoni cellulari. | 1.2.11 |
| 1.1.0 | BankAccount | BankAccount - Pagamento tramite bonifico bancario. | 1.2.11 |
| 1.1.0 | CustomerCard | CustomerCard - conto cliente. | 1.2.11 |
| 1.1.0 | Programma di lealtà | Loyalty - Pagamento tramite punti e coupon. | 1.2.11 |
| 1.1.0 | Assegno | Assegno – pagamenti tramite assegno . | 1.2.11 |
| 1.1.0 | CreditNote | CreditNote - pagamento tramite nota di credito. | 1.2.11 |
Tipi di transazioni commerciali
La tabella seguente indica in quale versione sono stati aggiunti o eliminati determinati tipi di transazioni commerciali (BusinessTransactionType).
|
DOM - Vers. |
BusinessTransactionType | Modifica / Spiegazione | Rilascio |
| 1.2.0 | La proprietà "Sconto" è stata rimossa. | 1.7.6 | |
| 1.1.0 | GrantGenuine | È stata aggiunta la proprietà GrantGenuine (sovvenzione effettiva). | 1.2.11 |
| 1.1.0 | GrantUnreal | Aggiunta la proprietà GrantUnreal - sovvenzione fittizia. | 1.2.11 |
Altre modifiche
Le altre modifiche sono descritte di seguito.
- attualmente nessuna -
La presente nota è stata tradotta automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.