Ugrás a fő tartalomhoz

Kedvezmények és felárak átvitele

DEVELOPMENT
  • Frissítve

Ebben a cikkben megtudhatja, hogyan továbbíthatja a kedvezményeket és a felárakat a RetailForce Middleware-hez.

Előfeltételek

  • Alapvető ismeretek a RetailForce dokumentummodellről

További információk

Támogatott kedvezmények és felárak

Jelenleg a kedvezmények és felárak a következőképpen továbbíthatók a dokumentum payload-ja között:

  1. Az egyes tételek pozíciójának részeként, így az adott tételre vonatkozó kedvezményként vagy felárként
    1. „Összesen” típusú tételen belül (Megjegyzés: a különleges szempontokat lásd alább)
  2. Külön kedvezmény/felár tételként

Megjegyzés: A 2. lehetőséget nem minden ország támogatja. Az adott országra vonatkozóan lásd a fiscalCountryProperties tulajdonságot.

A kedvezmények/felárak átvitele az összes tételpozícióra részösszegek vagy végösszegek útján jelenleg nem támogatott. Minden kedvezményt és felárat át kell alakítani az összes pozícióra.

Tételenként azonban több kedvezmény vagy felár is átvihető.

Fontos: Az egyes tételekhez tartozó összes kedvezmény- vagy felárérték összegének meg kell egyeznie a „GrossValue” és a „BaseGrossValue” közötti különbséggel, ellenkező esetben az érvényesítés sikertelen lesz.

 

A kedvezmények és felárak átvitele

1. változat

A kedvezmények vagy felárak a „Discounts” tömbben szerepelnek az adott tételnél.

Példa:

Az alábbi példa csak egy kivonatot mutat be, nem pedig a teljes tételpozíciót.

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

Az egyes elemekkel kapcsolatos részletek a „Tételobjektumok” című cikkben találhatók.

A fenti példában 10%-os kedvezmény („TypeValue: 10”) kerül alkalmazásra. A „DiscountValue” értéket a „BaseGrossValue” (kedvezmény előtti érték) alapján számítják ki. A „GrossValue” kiszámításához a „DiscountValue” értéket levonják a „GrossValue” értékből.

Felárak

A felárak átvitelekor kérjük, vegye figyelembe az alábbiakat:

  • A „DiscountValue” és a „TypeValue” felárak esetén NEGATÍV értékek!

Kedvezmények és felárak típusai

A „Discounts.Type” határozza meg a kedvezmény vagy felár típusát:

Típus Leírás Elem
kedvezmény / felár összegként

A kedvezmény/felár rögzített értékként van megadva, pl. „15 EUR kedvezmény” vagy „5 EUR szolgáltatási díj”.

Ebben az esetben a „DiscountValue” és a „TypeValue” értéke megegyezik.

 
"Type": "[0] = Allowance"

vagy:

"Type": 0
százalékos kedvezmény/felár

A felárat/kedvezményt százalékos értékben határozzák meg, pl. „10% kedvezmény a tételekre” vagy „5% szolgáltatási díj”.

Itt a „TypeValue” határozza meg a százalékos értéket, míg a „DiscountValue” az adott termék „BaseGrossValue” értékéből kerül kiszámításra.

Megjegyzés: Százalékos kedvezmények esetén a „DiscountValue” értéket mindig 4 tizedesjegy pontossággal kell kiszámítani!

 
"Type": "[1] = Discount"

vagy:

"Type": 1

Többszörös kedvezmények/felárak

A „Discounts” tömb több kedvezményt/felárat is tartalmazhat.

Az egyes kedvezmények vagy felárak alkalmazásának sorrendjét a „GrossValue” kiszámításához a „DiscountOrder” határozza meg, ahol az elsőként alkalmazandó kedvezmény értéke „0”.

Példa több kedvezményre:

A következő példában először 10%-os százalékos kedvezményt alkalmaznak egy tételre, majd ezt követi egy 5 EUR-os kedvezmény.

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

Különleges jellemző: „Összesen” tétel

A kedvezmények vagy felárak a „Total” (Összesen) tétel részeként is átvihetők.

Ugyanakkor fontos megjegyezni, hogy NEM elegendő ezt egyszerűen a „Total” tételben megadni. A kedvezményt arányosan kell elosztani az egyes tételek között. Például, ha a teljes összegű tételen 10%-os kedvezmény szerepel, az egyes tételeken is 10%-os kedvezménynek kell szerepelnie.

Példa:

{
  "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. változat

A legtöbb országban a kedvezmények és felárak külön tételként is átvihetők. A kedvezményt vagy felárat a dokumentum végösszegének kiszámításakor veszik figyelembe.

A kedvezményeket negatív értékekként, a felárakat pedig pozitív értékekként kell feltüntetni!

Az ilyen kedvezményeket vagy felárakat a „BusinessTransactionType” segítségével határozzák meg: „[1] = Kedvezmény”.

Példa:

Az alábbi példában egy 12 EUR-os kedvezmény külön tételként jelenik meg.

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

 

Ezt a cikket automatikusan lefordították.

Kapcsolódó cikkek

Hozzászólások

0 hozzászólás

Hozzászólások írásához jelentkezzen be.

Szolgáltató: Zendesk