I den här artikeln lär du dig hur du överför rabatter och tilläggsavgifter till RetailForce Middleware.

Förutsättningar

• Grundläggande erfarenhet av RetailForce-dokumentmodellen

Information

Rabatter och tilläggsavgifter som stöds

För närvarande kan rabatter och tilläggsavgifter överföras i dokumentets payload på följande sätt:

1. Som en del av den enskilda artikelpositionen och därmed som en rabatt eller tilläggsavgift för respektive artikel
   1. Inom en post av typen ”Totalt” (Obs! Se nedan för särskilda överväganden)
2. Som en separat rabatt-/tilläggsposition

Överföring av rabatter/tillägg på alla artikelposter via delsummor eller totalsummor stöds för närvarande inte. Alla rabatter och tillägg måste omvandlas till alla poster.

Det går dock att överföra flera rabatter eller tillägg per artikel.

Möjlig överföring av rabatter och tillägg

Alternativ 1

Rabatter eller tillägg ingår i respektive artikelposition i matrisen ”Discounts”.

Exempel:

Följande exempel visar endast ett utdrag och inte hela artikelposten.

"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 enskilda elementen finns i artikeln Positionobjekt ”positioner”.

I exemplet ovan tillämpas en rabatt på 10 % (”TypeValue: 10”). ”DiscountValue” beräknas utifrån ”BaseGrossValue” (värdet före rabatt). För att beräkna ”GrossValue” subtraheras ”DiscountValue” från ”GrossValue”.

Tillägg

Vid överföring av tilläggsavgifter bör du beakta följande:

• ”DiscountValue” och ”TypeValue” är NEGATIVA värden när det gäller tilläggsavgifter!

Typer av rabatter och tillägg

"Discounts.Type" anger typen av rabatt eller tilläggsavgift:

"Type": "[0] = Allowance"

"Type": 0

"Type": "[1] = Discount"

"Type": 1

Flera rabatter/tillägg

Arrayen ”Discounts” kan innehålla flera rabatter/tillägg.

Ordningen i vilken enskilda rabatter eller tillägg tillämpas för att beräkna ”GrossValue” definieras av ”DiscountOrder”, där den första rabatten som ska tillämpas har värdet '0'.

Exempel på flera rabatter:

I följande exempel tillämpas först en procentuell rabatt på 10 % på en artikel, följt av en rabatt 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ärskild egenskap: "Total"-position

Rabatter eller tilläggsavgifter kan också överföras som en del av en "Total"-post (summapost).

Det bör dock noteras att det INTE räcker med att endast ange detta i ”Total”-posten. Rabatten måste fördelas proportionellt mellan de enskilda artikelposterna. Om till exempel en rabatt på 10 % visas på totalposten måste även de enskilda artiklarna visa en rabatt på 10 %.

Exempel:

{
  "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 flesta länder kan rabatter och tillägg även överföras som separata poster. Rabatten eller tillägget beaktas som en del av beräkningen av dokumentets totalsumma.

Rabatter överförs som negativa värden, tillägg som positiva värden!

Sådana rabatter eller tillägg definieras via ”BusinessTransactionType”: ”[1] = Rabatt”.

Exempel:

I följande exempel visas en rabatt 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
} 

Den här artikeln har översatts automatiskt.