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:

1. Come parte della singola voce di articolo e quindi come sconto o sovrapprezzo per il rispettivo articolo
   1. All’interno di una voce di tipo “Totale” (Nota: si vedano di seguito le considerazioni particolari)
2. Come voce separata di sconto/sovrapprezzo

La trasmissione di sconti/maggiorazioni su tutte le voci tramite subtotali o totali non è attualmente supportata. Tutti gli sconti e le maggiorazioni devono essere allocati esplicitamente su ciascuna voce.

Tuttavia, per ogni articolo è possibile applicare più sconti o supplementi.

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,

Maggiori 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”, il “DiscountValue” viene sottratto dal “GrossValue”.

Sovrapprezzi

Nel trasferimento dei supplementi, si prega di tenere presente quanto segue:

• "DiscountValue" e "TypeValue" sono valori NEGATIVI nel caso dei supplementi!

Tipi di sconti e supplementi

"Discounts.Type" specifica il tipo di sconto o sovrapprezzo:

"Type": "[0] = Allowance"

"Type": 0

"Type": "[1] = Discount"

"Type": 1

Sconti/supplementi multipli

L’array «Discounts» può contenere sconti/supplementi multipli.

L’ordine in cui i singoli sconti o supplementi vengono applicati per calcolare il «GrossValue» è definito da «DiscountOrder», dove al primo sconto da applicare 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 essere trasferiti anche come parte di una voce “Totale” (voce di riepilogo).

Tuttavia, è importante notare che la semplice 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

Nella maggior parte dei paesi, 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 registrati come valori negativi, i supplementi come valori positivi.

Tali sconti o supplementi vengono definiti tramite il «BusinessTransactionType»: «[1] = Sconto».

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.