In questo articolo imparerete come trasmettere sconti e supplementi al RetailForce Middleware.
Prerequisiti
- Esperienza di base con il modello di documento RetailForce
Informazioni
Sconti e supplementi supportati
Attualmente, gli sconti e i supplementi possono essere trasferiti nel payload del documento come segue:
- Come parte della singola voce di articolo e, pertanto, come sconto o supplemento per il rispettivo articolo
- All’interno di una voce di tipo “Totale” (Nota: si vedano di seguito le considerazioni particolari)
- Come voce separata di sconto/sovrapprezzo
Nota: l’opzione 2 è attualmente supportata solo in Germania e in Portogallo. Si veda fiscalCountryProperties per il rispettivo Paese.
Il trasferimento di sconti/maggiorazioni su tutte le voci di articolo tramite subtotali o totali non è attualmente supportato. Tutti gli sconti e le maggiorazioni devono essere applicati a tutte le voci.
Tuttavia, per ogni articolo è possibile applicare più sconti o maggiorazioni.
Importante: la somma di tutti i valori di sconto o di supplemento per ogni articolo deve essere pari alla differenza tra «BaseGrossValue» e «GrossValue» (i supplementi vengono considerati come valori negativi). Attualmente tale somma non viene verificata durante la convalida, pertanto un importo errato non viene segnalato come errore.
Possibile trasferimento di sconti e maggiorazioni
Variante 1
Gli sconti o i supplementi sono inclusi nella rispettiva voce dell’articolo nell’array “Discounts”.
Esempio:
L’esempio seguente mostra solo un estratto e non la voce completa.
"BaseNetValue": 123.08,
"BaseGrossValue": 147.70,
"BaseTaxValue": 24.62,
"VatIdentification": 1,
"VatPercent": 20.0,
"Discounts": [
{
"DiscountValue": 14.7700,
"Caption": "Regular customer discount 10%",
"DiscountOrder": 0,
"Type": 1,
"TypeValue": 10,
"PromotionKeys": null,
"Identifier": "SKR-10"
}
],
"NetValue": 110.78,
"GrossValue": 132.93,
"TaxValue": 22.16,I dettagli sui singoli elementi sono disponibili nell’articolo «Oggetto voce “posizioni”».
Nell’esempio sopra riportato viene applicato uno sconto del 10% (“TypeValue: 10”). Il “DiscountValue” viene calcolato a partire dal “BaseGrossValue” (valore al lordo dello sconto). Per calcolare il “GrossValue”, si sottrae il “DiscountValue” dal “BaseGrossValue”.
Sovrapprezzi
Nel trasferimento dei supplementi, si prega di tenere presente quanto segue:
- Nel caso dei supplementi, “DiscountValue” e “TypeValue” sono valori NEGATIVI.
Tipi di sconti e supplementi
"Discounts.Type" specifica il tipo di sconto o sovrapprezzo:
| Tipo | Descrizione | Elemento |
| sconto / supplemento come somma |
Lo sconto/il supplemento è specificato come valore fisso, ad esempio "sconto di 15 EUR" o "costo di servizio di 5 EUR". In questo caso, «DiscountValue» e «TypeValue» assumono lo stesso valore. |
"Type": "[0] = Allowance" oppure: "Type": 0 |
| sconto / supplemento percentuale |
Il supplemento/sconto è specificato come valore percentuale, ad esempio «sconto del 10% sugli articoli» o «commissione di servizio del 5%». In questo caso, «TypeValue» specifica il valore percentuale, mentre «DiscountValue» viene calcolato a partire dal rispettivo «BaseGrossValue» dell’articolo.
Nota: nel caso di sconti percentuali, «DiscountValue» deve essere sempre calcolato con 4 cifre decimali. |
"Type": "[1] = Discount" oppure: "Type": 1 |
Sconti/supplementi multipli
L’array «Discounts» può contenere più sconti/supplementi.
L’ordine con cui i singoli sconti o maggiorazioni vengono applicati per calcolare il «GrossValue» è definito da «DiscountOrder», dove allo sconto da applicare per primo viene assegnato il valore «0».
Esempio di sconti multipli:
Nell’esempio seguente, a un articolo viene applicato innanzitutto uno sconto percentuale del 10%, seguito da uno sconto di 5 EUR.
"BaseNetValue": 123.08,
"BaseGrossValue": 147.70,
"BaseTaxValue": 24.62,
"VatIdentification": 1,
"VatPercent": 20.0,
"Discounts": [
{
"DiscountValue": 14.7700,
"Caption": "Regular customer discount 10%",
"DiscountOrder": 0,
"Type": 1,
"TypeValue": 10,
"PromotionKeys": null,
"Identifier": "SKR-10"
},
{
"DiscountValue": 5.0000,
"Caption": "Special discount 5 EUR",
"DiscountOrder": 1,
"Type": 0,
"TypeValue": 5.0,
"PromotionKeys": null,
"Identifier": "SKR-10"
}
],
"NetValue": 106.61,
"GrossValue": 127.93,
"TaxValue": 21.32,Caratteristica speciale: la voce “Totale”
Gli sconti o i supplementi possono anche essere trasferiti come parte di una voce "Totale" (voce di riepilogo).
Tuttavia, si noti che la mera indicazione di tale dato all’interno della voce «Totale» NON è sufficiente. Lo sconto deve essere ripartito proporzionalmente tra le singole voci. Ad esempio, se sulla voce «Totale» è indicato uno sconto del 10%, anche le singole voci devono riportare uno sconto del 10%.
Esempio:
{
"PositionNumber": 1,
"Type": 10,
"Rounding": null,
"BaseValue": 147.70,
"Value": 132.93,
"Discounts":[
{
"Identifier": "SKR-10",
"Caption": "Regular customer discount 10%",
"Type": 1,
"DiscountOrder": 0,
"DiscountValue": 14.7700,
"TypeValue": 10
}
],
"Caption": "Summe"
}
Variante 2
In Germania e in Portogallo, gli sconti e i supplementi possono essere riportati anche come voci separate. Lo sconto o il supplemento viene preso in considerazione nel calcolo del totale del documento.
Gli sconti vengono riportati come valori negativi, i supplementi come valori positivi.
Tali sconti o supplementi vengono definiti tramite il «BusinessTransactionType»: «[1] = Sconto».
In tutti gli altri Paesi, il software rifiuta un documento contenente una voce di questo tipo con l’errore di convalida «BusinessTransactionType “Sconto” non supportato». In tali casi, si utilizzi la Variante 1. Il BusinessTransactionType «[1] = Sconto» è contrassegnato come obsoleto e viene mantenuto solo per motivi di retrocompatibilità; pertanto, in tutti i Paesi si raccomanda l’utilizzo della Variante 1.
Esempio:
Nell’esempio seguente, uno sconto di 12 EUR viene riportato come voce separata.
{
"PositionNumber": 1,
"Type": 3,
"Caption": "Discount",
"Identifier": "Discount",
"BusinessTransactionType": 1,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -10.0,
"GrossValue": -12.0,
"TaxValue": -2.0
}
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.