I denne artikel lærer du, hvordan du overfører rabatter og tillæg til RetailForce Middleware.

Forudsætninger

• Grundlæggende erfaring med RetailForce-dokumentmodellen

Oplysninger

Understøttede rabatter og tillæg

I øjeblikket kan rabatter og tillæg overføres i dokumentets payload på følgende måde:

1. Som en del af den enkelte vareposition og dermed som en rabat eller et tillæg for den pågældende vare
   1. Inden for en position af typen "Total" (Bemærk: Se nedenfor for særlige overvejelser)
2. Som en separat rabat-/tillægsposition

Overførsel af rabatter/tillæg på alle varepositioner via deltotaler eller totaler understøttes i øjeblikket ikke. Alle rabatter og tillæg skal konverteres til alle positioner.

Der kan dog overføres flere rabatter eller tillæg pr. vare.

Mulig overførsel af rabatter og tillæg

Variant 1

Rabatter eller tillæg er inkluderet i den respektive vareposition i "Discounts"-arrayet.

Eksempel:

Følgende eksempel viser kun et uddrag og ikke den komplette vareposition.

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

Detaljer om de enkelte elementer findes i artiklen Position-objektet »positioner«.

I eksemplet ovenfor anvendes en rabat på 10 % ("TypeValue: 10"). "DiscountValue" beregnes ud fra "BaseGrossValue" (værdien før rabat). For at beregne "GrossValue" trækkes "DiscountValue" fra "GrossValue".

Tillæg

Ved overførsel af tillæg skal du være opmærksom på følgende:

• "DiscountValue" og "TypeValue" er NEGATIVE værdier i tilfælde af tillæg!

Typer af rabatter og tillæg

"Discounts.Type" angiver typen af rabat eller tillæg:

"Type": "[0] = Allowance"

"Type": 0

"Type": "[1] = Discount"

"Type": 1

Flere rabatter/tillæg

"Discounts"-arrayet kan indeholde flere rabatter/tillæg.

Rækkefølgen, hvori de enkelte rabatter eller tillæg anvendes til beregning af "GrossValue", defineres af "DiscountOrder", hvor den første rabat, der skal anvendes, har værdien '0'.

Eksempel på flere rabatter:

I det følgende eksempel anvendes først en procentvis rabat på 10 % på en vare, efterfulgt af en rabat på 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,

Særlig egenskab "Total"-position

Rabatter eller tillæg kan også overføres som en del af en "Total"-post (sumpost).

Det skal dog bemærkes, at det IKKE er tilstrækkeligt blot at angive dette i "Total"-positionen. Rabatten skal fordeles proportionalt mellem de enkelte varer. Hvis der f.eks. vises en rabat på 10 % på totalpositionen, skal de enkelte varer også vise en rabat på 10 %.

Eksempel:

{
  "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"
}

Variant 2

I de fleste lande kan rabatter og tillæg også overføres som separate poster. Rabatten eller tillægget indgår i beregningen af dokumentets totalbeløb.

Rabatter overføres som negative værdier, tillæg som positive værdier!

Sådanne rabatter eller tillæg defineres via »BusinessTransactionType«: »[1] = Rabat«.

Eksempel:

I det følgende eksempel vises en rabat på 12 EUR som en separat post.

{
  "PositionNumber": 1,
  "Type": 3,
  "Caption": "Discount",
  "Identifier": "Discount",
  "BusinessTransactionType": 1,
  "VatIdentification": 1,
  "VatPercent": 20.0,
  "NetValue": -10.0,
  "GrossValue": -12.0,
  "TaxValue": -2.0
} 

Denne artikel er oversat automatisk.