Šiame straipsnyje sužinosite, kaip perduoti nuolaidas ir priedus į RetailForce Middleware.

Reikalavimai

Pagrindinė patirtis dirbant su „RetailForce“ dokumentų modeliu

Informacija

Palaikomos nuolaidos ir priedai

Šiuo metu nuolaidos ir priedai gali būti perduodami dokumento payload taip:

Kaip atskiro prekės pozicijos dalis, taigi kaip nuolaida arba priedas atitinkamai prekei
1. „Iš viso“ tipo pozicijoje (Pastaba: ypatingus atvejus žr. toliau)
Kaip atskira nuolaidos/priedo pozicija

Pastaba: 2-asis variantas šiuo metu palaikomas tik Vokietijoje ir Portugalijoje. Žr. „fiscalCountryProperties“ atitinkamai šaliai.

Nuolaidų ir priedų perkėlimas į visas prekių pozicijas per tarpines sumas ar bendrąsias sumas šiuo metu nepalaikomas. Visos nuolaidos ir priedai turi būti perkelti į visas pozicijas.

Tačiau vienam prekių vienetui galima perkelti kelias nuolaidas ar priedus.

Svarbu: visų nuolaidų ar priedų sumai vienam elementui turi būti lygi „GrossValue“ ir „BaseGrossValue“ skirtumui; priešingu atveju patikrinimas bus nesėkmingas.

Galimas nuolaidų ir priedų perkėlimas

1 variantas

Nuolaidos arba priedai įtraukiami į atitinkamą prekės poziciją „Discounts“ masyve.

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": "Regular customer discount 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 straipsnyje „Pozicijos objektas „pozicijos““.

Pateiktame pavyzdyje taikoma 10 % nuolaida („TypeValue: 10“). „DiscountValue“ apskaičiuojama pagal „BaseGrossValue“ (vertė prieš nuolaidą). Norint apskaičiuoti „GrossValue“, iš „GrossValue“ atimama „DiscountValue“.

Priedai

Perkeliančiu papildomus mokesčius, atkreipkite dėmesį į šiuos dalykus:

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

Nuolaidų ir priedų tipai

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

Tipas

Aprašymas

Elementas

nuolaida / priedas kaip suma

Nuolaida / priedas nurodomas kaip fiksuota vertė, pvz., „15 EUR nuolaida“ arba „5 EUR aptarnavimo mokestis“.

Šiuo atveju „DiscountValue“ ir „TypeValue“ turi tą pačią vertę.

"Type": "[0] = Allowance"

arba:

"Type": 0

nuolaida / priedas procentais

Priedas / nuolaida nurodoma kaip procentinė vertė, pvz., „10 % nuolaida prekėms“ arba „5 % aptarnavimo mokestis“.

Čia „TypeValue“ nurodo procentinę vertę, o „DiscountValue“ apskaičiuojama pagal atitinkamą prekės „BaseGrossValue“.

Pastaba: taikant procentines nuolaidas, „DiscountValue“ visada turi būti apskaičiuojama su 4 skaičiais po kablelio!

"Type": "[1] = Discount"

arba:

"Type": 1

Keli nuolaidos / priedai

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

Eilės tvarką, kuria atskirų nuolaidų ar priedų taikomos apskaičiuojant „GrossValue“, apibrėžia „DiscountOrder“, o pirmajai taikytinai nuolaidai priskiriama reikšmė „0“.

Kelių nuolaidų pavyzdys:

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

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

Ypatinga „Iš viso“ pozicija

Nuolaidos ar priedai taip pat gali būti perkelti kaip „Iš viso“ pozicijos (sumos pozicijos) dalis.

Tačiau reikėtų atkreipti dėmesį, kad vien tik nurodyti tai „Iš viso“ pozicijoje NEPAKAKS. Nuolaida turi būti proporcingai paskirstyta tarp atskirų prekių pozicijų. Pavyzdžiui, jei „Iš viso“ pozicijoje nurodyta 10 % nuolaida, atskirose prekių 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": "Regular customer discount 10%",
      "Type": 1,
      "DiscountOrder": 0,
      "DiscountValue": 14.7700,
      "TypeValue": 10
    }
  ],
  "Caption": "Summe"
}

2 variantas

Vokietijoje ir Portugalijoje nuolaidos ir priedai taip pat gali būti perkelti kaip atskiri elementai. Nuolaida arba priedas įskaičiuojami apskaičiuojant dokumento bendrą sumą.

Nuolaidos perkeliamos kaip neigiamos reikšmės, o priedai – kaip teigiamos reikšmės!

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

Visose kitose šalyse programinė įranga atmeta dokumentą, kuriame yra tokia pozicija, pateikdama patvirtinimo klaidą „Verslo sandorio tipas „Nuolaida“ nepalaikomas“. Ten naudokite 1 variantą. „BusinessTransactionType“ „[1] = Nuolaida“ yra pažymėtas kaip pasenęs ir išlaikomas tik atgalinio suderinamumo tikslais, todėl visose šalyse rekomenduojamas 1 variantas.

Pavyzdys:

Toliau pateiktame pavyzdyje 12 EUR nuolaida parodoma kaip atskira pozicija.

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

Šis straipsnis buvo išverstas automatiškai.

Reikalavimai

Informacija

Palaikomos nuolaidos ir priedai

Galimas nuolaidų ir priedų perkėlimas

1 variantas

Priedai

Nuolaidų ir priedų tipai

Keli nuolaidos / priedai

Ypatinga „Iš viso“ pozicija

2 variantas

Susiję straipsniai