Šiame straipsnyje sužinosite, kaip perduoti nuolaidas ir antkainius į „RetailForce“ tarpinę programinę įrangą. 

Reikalavimai

• Bazinė patirtis dirbant su „RetailForce“ dokumentų modeliu

Informacija

Palaikomos nuolaidos ir priedai

Šiuo metu nuolaidos ir priedai gali būti perduodami „Document-Payload“ taip:

1. kaip atskirų prekių pozicijų dalis, taigi kaip nuolaida arba priedas prie atitinkamos prekės
   1. „Iš viso“ tipo pozicijoje (dėmesio: ypatumus žr. žemiau)
2. kaip atskira nuolaidos / priedo pozicija

Nuolaidų / priedų perdavimas visoms prekės pozicijoms per tarpines sumas ar sumas šiuo metu nėra palaikomas. Visos nuolaidos ir priedai turi būti perskaičiuoti į visas pozicijas.

Tačiau vienai pozicijai galima perkelti kelias nuolaidas ar priedus. 

Galimas nuolaidų ir priedų perdavimas

1 variantas

Nuolaida arba priedas įtraukiami į atitinkamą prekės poziciją, į „Discounts“ masyvą.

Pavyzdys:

Toliau pateiktas pavyzdys rodo tik ištrauką, o ne visą prekės poziciją.

"BaseNetValue": 123.08,
"BaseGrossValue": 147.70,
"BaseTaxValue": 24.62,
"VatIdentification": 1,
"VatPercent": 20.0,
"Discounts": [
  {
    "DiscountValue": 14.7700,
    "Caption": "Stammkundenrabatt 10%",
    "DiscountOrder": 0,
    "Type": 1,
    "TypeValue": 10,
    "PromotionKeys": null,
    "Identifier": "SKR-10"
  }
],
"NetValue": 110.78,
"GrossValue": 132.93,
"TaxValue": 22.16,

Išsami informacija apie atskirus elementus pateikta prekės pozicijos objekte „positions“.

Pirmiau pateiktame pavyzdyje perduodama 10 % nuolaida („TypeValue: 10“). „DiscountValue“ apskaičiuojamas pagal „BaseGrossValue“ (vertė prieš nuolaidą). Apskaičiuojant „GrossValue“, „DiscountValue“ atimamas iš „GrossValue“.

Priedai

Perdavus priedus, reikia atkreipti dėmesį į tai, kad:

• „DiscountValue“ ir „TypeValue“ priedų atveju yra NEIGIAMOS vertės!

Nuolaidų ir priedų rūšys

„Discounts.Type“ nurodo nuolaidos arba priedo tipą:

"Type": "[0] = Allowance"

"Type": 0

"Type": "[1] = Discount"

"Type": 1

Kelios nuolaidos / priedai

„Discounts“ masyvas gali turėti kelias nuolaidas / priedus.

Atskirų nuolaidų ar priedų taikymo tvarka, skaičiuojant „GrossValue“, apibrėžiama „DiscountOrder“, kur pirmoji taikytina nuolaida turi vertę „0“.

Kelių nuolaidų pavyzdys:

Toliau pateiktame pavyzdyje pirmiausia taikoma 10 % procentinė nuolaida, o po to – 5 EUR nuolaida prekės pozicijai.

"BaseNetValue": 123.08,
"BaseGrossValue": 147.70,
"BaseTaxValue": 24.62,
"VatIdentification": 1,
"VatPercent": 20.0,
"Discounts": [
  {
    "DiscountValue": 14.7700,
    "Caption": "Stammkundenrabatt 10%",
    "DiscountOrder": 0,
    "Type": 1,
    "TypeValue": 10,
    "PromotionKeys": null,
    "Identifier": "SKR-10"
  },
  {
    "DiscountValue": 5.0000,
    "Caption": "Sonderrabatt 5 EUR",
    "DiscountOrder": 1,
    "Type": 0,
    "TypeValue": 5.0,
    "PromotionKeys": null,
    "Identifier": "SKR-10"
  }  
],
"NetValue": 106.61,
"GrossValue": 127.93,
"TaxValue": 21.32,

„Total“ pozicijos ypatumas

Nuolaidos arba priedai taip pat gali būti perduodami kaip „Total“ tipo pozicijos dalis (=bendrosios sumos pozicija).

Tačiau čia reikia atkreipti dėmesį, kad vien tik nurodymas „Total“ pozicijoje NEPAKAKS. Nuolaida turi būti proporcingai paskirstyta atskiroms prekės pozicijoms. Pavyzdžiui, jei „Iš viso“ pozicijoje nurodyta 10 % nuolaida, atskirose pozicijose taip pat turi būti nurodyta 10 % nuolaida.

Pavyzdys:

{
  "PositionNumber": 1,
  "Type": 10,
  "Rounding": null,
  "BaseValue": 147.70,
  "Value": 132.93,
  "Discounts":[
    {
      "Identifier": "SKR-10",
      "Caption": "Stammkundenrabatt 10%",
      "Type": 1,
      "DiscountOrder": 0,
      "DiscountValue": 14.7700,
      "TypeValue": 10
    }
  ],
  "Caption": "Summe"
}

2 variantas

Daugelyje šalių nuolaidos ir priedai taip pat gali būti perduodami kaip atskira pozicija. Nuolaida arba priedas įtraukiami į dokumento sumos skaičiavimą.

Nuolaidos perduodamos kaip neigiamos, o priedai – kaip teigiamos vertės!

Tokios nuolaidos ar priedai apibrėžiami per „BusinessTransactionType“: „[1] = Discount“.

Pavyzdys:

Toliau pateiktame pavyzdyje 12 EUR nuolaida nurodoma kaip atskira pozicija.

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