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ő módon továbbíthatók a dokumentum payload-ja között:
- Az egyes tételek pozíciójának részeként, így az adott tételre vonatkozó kedvezményként vagy felárként
- „Összesen” típusú tételen belül (Megjegyzés: a különleges szempontokat lásd alább)
- Külön kedvezmény/felár tételként
Megjegyzés: A 2. lehetőséget jelenleg csak Németországban és Portugáliában támogatja a rendszer. 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 számítani az összes pozícióra.
Tételenként azonban több kedvezmény vagy felár is átvihető.
Fontos: Az egyes tételekre vonatkozó összes kedvezmény- vagy felárérték összege meg kell, hogy egyezzen a „BaseGrossValue” és a „GrossValue” közötti különbséggel (a felárak negatív értéknek számítanak). Ezt az összeget jelenleg az érvényesítés során nem ellenőrzik, így a helytelen összeg nem kerül jelentésre hibaként.
A kedvezmények és felárak átvitelének lehetőségei
1. változat
A kedvezmények vagy felárak a „Discounts” tömbben szerepelnek az adott tétel pozíciójában.
Példa:
Az alábbi példa csak egy kivonatot mutat be, nem 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 „BaseGrossValue” é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” meghatározza 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 tétel „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” (Összeg) tétel részeként is átvihetők.
Meg kell azonban jegyezni, 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
Németországban és Portugáliában 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 átvinni!
Az ilyen kedvezményeket vagy felárakat a „BusinessTransactionType” segítségével lehet megadni: „[1] = Kedvezmény”.
Minden más országban a szoftver elutasítja az ilyen tételt tartalmazó dokumentumot a következő érvényesítési hibával: „A »Kedvezmény« üzleti tranzakciótípus nem támogatott.” Ott az 1. változatot használja. A „BusinessTransactionType” „[1] = Kedvezmény” beállítás elavultnak minősül, és kizárólag a visszafelé kompatibilitás érdekében marad meg, ezért minden országban az 1. változat használata ajánlott.
Példa:
A következő 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.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.