V tem članku boste izvedeli, kako prenesti popuste in doplačila v RetailForce Middleware.
Predpogoji
- Osnovne izkušnje z dokumentnim modelom RetailForce
Informacije
Podprti popusti in doplačila
Trenutno je mogoče popuste in doplačila prenesti v payload dokumenta na naslednji način:
- kot del posamezne postavke in s tem kot popust ali doplačilo za zadevno postavko
- znotraj postavke tipa »Skupaj« (Opomba: glejte spodaj za posebne vidike)
- Kot ločena postavka popusta/doplačila
Opomba: Možnost 2 je trenutno podprta le v Nemčiji in na Portugalskem. Glejte fiscalCountryProperties za zadevno državo.
Prenos popustov/doplačil na vse postavke artiklov prek vmesnih ali končnih seštevkov trenutno ni podprt. Vsi popusti in doplačila morajo biti pretvorjeni v vse postavke.
Vendar je mogoče na posamezno postavko prenesti več popustov ali doplačil.
Pomembno: Vsota vseh vrednosti popustov ali doplačil na postavko mora biti enaka razliki med »BaseGrossValue« in »GrossValue« (doplačila se štejejo kot negativne vrednosti). Ta vsota se trenutno med preverjanjem veljavnosti ne preverja, zato se napačna vsota ne poroča kot napaka.
Možnosti prenosa popustov in doplačil
Varianta 1
Popusti ali doplačila so vključeni v ustrezno postavko artikla v nizu »Discounts«.
Primer:
Naslednji primer prikazuje le izvleček in ne celotne postavke.
"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 posameznih elementih najdete v članku »Postavka«.
V zgornjem primeru se uporablja popust v višini 10 % („TypeValue: 10“). „DiscountValue“ se izračuna iz „BaseGrossValue“ (vrednost pred popustom). Za izračun „GrossValue“ se „DiscountValue“ odšteje od „BaseGrossValue“.
Doplačila
Pri prenosu doplačil upoštevajte naslednje:
- »DiscountValue« in »TypeValue« sta v primeru doplačil NEGATIVNI vrednosti!
Vrste popustov in doplačil
»Discounts.Type« določa vrsto popusta ali doplačila:
| Vrsta | Opis | Element |
| popust/doplačilo kot vsota |
Popust/doplačilo je določeno kot fiksna vrednost, npr. »15 EUR popusta« ali »5 EUR stroškov storitve«. V tem primeru imata »DiscountValue« in »TypeValue« enako vrednost. |
"Type": "[0] = Allowance" ali: "Type": 0 |
| odstotni popust / doplačilo |
Doplačilo/popust je določen kot odstotna vrednost, npr. »10 % popust na artikle« ali »5 % strošek storitve«. Tukaj »TypeValue« določa odstotno vrednost, pri čemer se »DiscountValue« izračuna iz ustrezne »BaseGrossValue« artikla.
Opomba: Pri odstotnih popustih je treba »DiscountValue« vedno izračunati na 4 decimalna mesta! |
"Type": "[1] = Discount" ali: "Type": 1 |
Več popustov/doplačil
Niz »Discounts« lahko vsebuje več popustov/doplačil.
Vrstni red, v katerem se posamezni popusti ali doplačila uporabljajo za izračun »GrossValue«, je določen s »DiscountOrder«, pri čemer ima prvi popust, ki se uporabi, vrednost »0«.
Primer več popustov:
V naslednjem primeru se na artikel najprej uporabi odstotni popust v višini 10 %, nato pa popust v višini 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,Posebna značilnost položaja »Total«
Popusti ali doplačila se lahko prenesejo tudi kot del postavke »Skupaj« (postavka seštevka).
Vendar je treba opozoriti, da zgolj navedba tega v postavki »Total« NI zadostna. Popust mora biti sorazmerno porazdeljen med posamezne postavke. Če je na primer na postavki »Total« prikazan 10-odstotni popust, morajo tudi posamezne postavke prikazovati 10-odstotni popust.
Primer:
{
"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"
}
Varianta 2
V Nemčiji in na Portugalskem se popusti in doplačila lahko prenesejo tudi kot ločene postavke. Popust ali doplačilo se upošteva pri izračunu skupnega zneska dokumenta.
Popusti se prenesejo kot negativne vrednosti, doplačila pa kot pozitivne vrednosti!
Takšni popusti ali doplačila so opredeljeni prek »BusinessTransactionType«: »[1] = Popust«.
V vseh drugih državah program zavrne dokument, ki vsebuje takšno postavko, z napako pri preverjanju veljavnosti »Vrsta poslovne transakcije 'Popust' ni podprta«. Tam uporabite varianto 1. BusinessTransactionType »[1] = Popust« je označen kot zastarel in se ohranja le zaradi združljivosti z starejšimi različicami, zato se v vseh državah priporoča varianta 1.
Primer:
V naslednjem primeru je popust v višini 12 EUR prikazan kot ločena postavka.
{
"PositionNumber": 1,
"Type": 3,
"Caption": "Discount",
"Identifier": "Discount",
"BusinessTransactionType": 1,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -10.0,
"GrossValue": -12.0,
"TaxValue": -2.0
}
Ta članek je bil samodejno preveden.
Komentar
0 komentarjev
Za dodajanje komentarja prosimo kliknite Vpis.