V tomto článku sa dozviete, ako prenášať zľavy a príplatky do RetailForce Middleware.

Predpoklady

• Základné skúsenosti s dokumentovým modelom RetailForce

Informácie

Podporované zľavy a príplatky

V súčasnosti je možné zľavy a príplatky prenášať v payloadu dokumentu nasledovne:

1. Ako súčasť položky jednotlivých tovarov, a teda ako zľava alebo príplatok k príslušnému tovaru
   1. V rámci položky typu „Celkom“ (Poznámka: Špeciálne hľadiská nájdete nižšie)
2. Ako samostatná pozícia zľavy/prirážky

Prenos zliav/prirážok na všetky pozície položiek prostredníctvom čiastkových súčtov alebo súčtov v súčasnosti nie je podporovaný. Všetky zľavy a prirážky musia byť prenesené do všetkých pozícií.

Na jednu položku je však možné preniesť viacero zliav alebo príplatkov.

Možný prenos zliav a príplatkov

Variant 1

Zľavy alebo príplatky sú zahrnuté v príslušnej položke tovaru v poli „Discounts“.

Príklad:

Nasledujúci príklad zobrazuje len výňatok a nie kompletnú pozíciu položky.

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

Podrobnosti o jednotlivých prvkoch nájdete v článku Položkový objekt „položky“.

V uvedenom príklade sa uplatňuje zľava 10 % („TypeValue: 10“). Hodnota „DiscountValue“ sa vypočíta z hodnoty „BaseGrossValue“ (hodnota pred zľavou). Na výpočet hodnoty „GrossValue“ sa od hodnoty „GrossValue“ odpočíta hodnota „DiscountValue“.

Prirážky

Pri prenose príplatkov vezmite na vedomie nasledujúce:

• „DiscountValue“ a „TypeValue“ sú v prípade príplatkov ZÁPORNÉ hodnoty!

Typy zliav a príplatkov

„Discounts.Type“ určuje typ zľavy alebo príplatku:

"Type": "[0] = Allowance"

"Type": 0

"Type": "[1] = Discount"

"Type": 1

Viacnásobné zľavy/prirážky

Pole „Discounts“ môže obsahovať viacero zliav/príplatkov.

Poradie, v akom sa jednotlivé zľavy alebo príplatky uplatňujú pri výpočte „GrossValue“, je definované parametrom „DiscountOrder“, pričom prvá zľava, ktorá sa má uplatniť, má hodnotu „0“.

Príklad viacerých zliav:

V nasledujúcom príklade sa na položku najskôr uplatní percentuálna zľava vo výške 10 %, po ktorej nasleduje zľava vo výške 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,

Špeciálna charakteristika „Total“

Zľavy alebo príplatky je možné preniesť aj ako súčasť položky „Total“ (súhrnná položka).

Je však potrebné poznamenať, že samotné uvedenie tejto informácie v položke „Total“ NIE JE postačujúce. Zľava musí byť proporcionálne rozdelená medzi jednotlivé položky. Ak je napríklad na súhrnnej položke uvedená zľava 10 %, aj jednotlivé položky musia vykazovať zľavu 10 %.

Príklad:

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

Vo väčšine krajín je možné zľavy a príplatky prenášať aj ako samostatné položky. Zľava alebo príplatok sa zohľadňuje pri výpočte celkovej sumy dokladu.

Zľavy sa prenášajú ako záporné hodnoty, príplatky ako kladné hodnoty!

Takéto zľavy alebo príplatky sa definujú prostredníctvom „BusinessTransactionType“: „[1] = Zľava“.

Príklad:

V nasledujúcom príklade je zľava vo výške 12 EUR zobrazená ako samostatná položka.

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

Tento článok bol preložený automaticky.