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ägg överföras i dokumentets payload enligt följande:

1. Som en del av den enskilda artikelposten 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 Positionobjektet ”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” dras ”DiscountValue” från ”GrossValue”.

Tillägg

Vid överföring av tilläggsavgifter, observera 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ägg 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 Tyskland och Portugal 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”.

I alla andra länder avvisar programvaran ett dokument som innehåller en sådan post med valideringsfelet ”Affärstransaktionstyp ’Rabatt’ stöds inte.” Använd där variant 1. BusinessTransactionType ”[1] = Rabatt” är markerad som föråldrad och behålls endast för bakåtkompatibilitet, därför rekommenderas variant 1 i alla länder.

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.