U ovom članku naučit ćete kako prenijeti popuste i doplate na RetailForce Middleware.
Preduvjeti
- Osnovno iskustvo s modelom dokumenata RetailForce
Informacije
Podržani popusti i doplate
Trenutno se popusti i doplate mogu prenijeti u teretu dokumenta na sljedeći način:
- Kao dio pozicije pojedinačnog artikla i time kao popust ili dopuna za odgovarajući artikal
- Unutar pozicije tipa "Total" (Napomena: Pogledajte dolje za posebna razmatranja)
- Kao zasebna pozicija popusta/dodatne naplate
Napomena: Opcija 2 je trenutno podržana samo u Njemačkoj i Portugalu. Pogledajte FiscalCountryProperties za odgovarajuću zemlju.
Prijenos popusta/dodatnih troškova na sve stavke putem podzbrojeva ili ukupnih iznosa trenutno nije podržan. Svi popusti i dodatni troškovi moraju biti preneseni na sve stavke.
Međutim, više popusta ili doplate može se prenijeti po stavci.
Važno: Zbir svih vrijednosti popusta ili doplate po stavci mora biti jednak razlici između "GrossValue" i "BaseGrossValue"; u suprotnom će validacija ne uspjeti.
Mogući prijenos popusta i doplate
Varijanta 1
Popusti ili doplate se uključuju u odgovarajuću poziciju stavke u nizu "Discounts".
Primjer:
Sljedeći primjer prikazuje samo izvadak, a ne cjelokupnu poziciju stavke.
"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,Detalji o pojedinačnim elementima mogu se pronaći u članku Position-object "positions".
U gornjem primjeru primjenjen je popust od 10% ("TypeValue: 10"). "DiscountValue" se izračunava iz "BaseGrossValue" (vrijednost prije popusta). Da bi se izračunala "GrossValue", "DiscountValue" se oduzima od "GrossValue".
Doplate
Prilikom prijenosa nadoplate, molimo imajte na umu sljedeće:
- "DiscountValue" i "TypeValue" su NEGATIVNE vrijednosti u slučaju doplate!
Vrste popusta i doplate
"Discounts.Type" specificira vrstu popusta ili doplate:
| Tip | Opis | Element |
| popust / nadoplata kao iznos |
Popust/dodatak se navodi kao fiksna vrijednost, npr. "popust od 15 EUR" ili "naknada za uslugu od 5 EUR". U ovom slučaju, "DiscountValue" i "TypeValue" imaju istu vrijednost. |
"Type": "[0] = Allowance" ili: "Type": 0 |
| popust / nadoplata u procentima |
Doplate/popusti se navode kao postotna vrijednost, npr. "10% popusta na artikle" ili "5% naknade za uslugu". Ovdje "TypeValue" specificira postotnu vrijednost, dok se "DiscountValue" izračunava na osnovu odgovarajuće "BaseGrossValue" stavke.
Napomena: U slučaju postotnih popusta, "DiscountValue" se uvijek mora izračunati sa 4 decimalne znamenke! |
"Type": "[1] = Discount" ili: "Type": 1 |
Više popusta/dodatnih naplate
Mreža "Discounts" može sadržavati više popusta/dodatnih naplate.
Redoslijed u kojem se pojedinačni popusti ili doplate primjenjuju za izračun "GrossValue" definiran je pomoću "DiscountOrder", pri čemu prvi popust koji se primjenjuje ima vrijednost '0'.
Primjer višestrukih popusta:
U sljedećem primjeru, prvo se na stavku primjenjuje popust od 10%, a zatim popust od 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 karakteristika pozicije "Total"
Popusti ili doplate se također mogu prenijeti kao dio stavke "Total" (ukupna stavka).
Međutim, treba napomenuti da jednostavno navođenje ovoga unutar stavke "Ukupno" NIJE dovoljno. Popust se mora proporcionalno raspodijeliti među pojedinačnim stavkama. Na primjer, ako je na ukupnoj stavci prikazan popust od 10%, pojedinačne stavke također moraju prikazivati popust od 10%.
Primjer:
{
"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"
}
Varijanta 2
U Njemačkoj i Portugalu, popusti i doplate se također mogu prenijeti kao zasebne stavke. Popust ili doplata se uzimaju u obzir u okviru obračuna ukupnog iznosa dokumenta.
Popusti se prenose kao negativne vrijednosti, a doplate kao pozitivne vrijednosti!
Takvi popusti ili doplate se definiraju putem "BusinessTransactionType": "[1] = Discount".
U svim ostalim zemljama softver odbacuje dokument koji sadrži takvu stavku s greškom validacije "Business transaction type 'Discount' not supported." Tamo koristite varijantu 1. BusinessTransactionType "[1] = Discount" je označen kao zastario i zadržan je samo radi kompatibilnosti unazad, stoga se u svim zemljama preporučuje varijanta 1.
Primjer:
U sljedećem primjeru popust od 12 EUR prikazan je kao zasebna stavka.
{
"PositionNumber": 1,
"Type": 3,
"Caption": "Discount",
"Identifier": "Discount",
"BusinessTransactionType": 1,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -10.0,
"GrossValue": -12.0,
"TaxValue": -2.0
}
Ovaj članak je automatski preveden.
Comments
0 comments
Please sign in to leave a comment.