V tomto článku sa dozviete, ako prenášať zľavy a príplatky do RetailForce Middleware.
Predpoklady
- Základné skúsenosti s dokumentovým modelom RetailForce
Informácie
Podporované zľavy a príplatky
V súčasnosti je možné zľavy a príplatky prenášať v payloadu dokumentu nasledovne:
- Ako súčasť položky jednotlivých tovarov, a teda ako zľava alebo príplatok k príslušnému tovaru
- V rámci položky typu „Celkom“ (Poznámka: Špeciálne hľadiská nájdete nižšie)
- Ako samostatná pozícia zľavy/prirážky
Poznámka: Možnosť 2 je v súčasnosti podporovaná len v Nemecku a Portugalsku. Pozrite si vlastnosti fiscalCountryProperties pre príslušnú krajinu.
Prenos zliav/prirážok na všetky položky prostredníctvom čiastkových súčtov alebo súčtov v súčasnosti nie je podporovaný. Všetky zľavy a prirážky musia byť prenesené do všetkých položiek.
Na jednu položku je však možné preniesť viacero zliav alebo príplatkov.
Dôležité: Súčet všetkých hodnôt zliav alebo príplatkov na jednu položku sa musí rovnať rozdielu medzi „BaseGrossValue“ a „GrossValue“ (príplatky sa počítajú ako záporné hodnoty). Tento súčet sa v súčasnosti počas validácie nekontroluje, takže nesprávny súčet sa nehlási ako chyba.
Možnosti prenesenia zliav a príplatkov
Variant 1
Zľavy alebo príplatky sú zahrnuté v príslušnej položke v poli „Discounts“.
Príklad:
Nasledujúci príklad zobrazuje len výňatok a nie kompletnú pozíciu položky.
"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 jednotlivých prvkoch nájdete v článku Položkový objekt „positions“.
V uvedenom príklade sa uplatňuje zľava 10 % („TypeValue: 10“). Hodnota „DiscountValue“ sa vypočíta z hodnoty „BaseGrossValue“ (hodnota pred zľavou). Na výpočet hodnoty „GrossValue“ sa od hodnoty „BaseGrossValue“ odpočíta hodnota „DiscountValue“.
Prirážky
Pri prenose príplatkov si prosím všimnite nasledujúce:
- „DiscountValue“ a „TypeValue“ sú v prípade príplatkov ZÁPORNÉ hodnoty!
Typy zliav a príplatkov
„Discounts.Type“ určuje typ zľavy alebo príplatku:
| Typ | Popis | Prvok |
| zľava / príplatok ako suma |
Zľava/príplatok je špecifikovaný ako pevná hodnota, napr. „zľava 15 EUR“ alebo „servisný poplatok 5 EUR“. V tomto prípade majú „DiscountValue“ a „TypeValue“ rovnakú hodnotu. |
"Type": "[0] = Allowance" alebo: "Type": 0 |
| percentuálna zľava / príplatok |
Príplatok/zľava je uvedená ako percentuálna hodnota, napr. „10 % zľava na položky“ alebo „5 % servisný poplatok“. Tu „TypeValue“ určuje percentuálnu hodnotu, pričom „DiscountValue“ sa vypočíta z príslušnej „BaseGrossValue“ položky.
Poznámka: V prípade percentuálnych zliav sa „DiscountValue“ musí vždy vypočítať na 4 desatinné miesta! |
"Type": "[1] = Discount" alebo: "Type": 1 |
Viacnásobné zľavy/prirážky
Pole „Discounts“ môže obsahovať viacero zliav/prirážok.
Poradie, v akom sa jednotlivé zľavy alebo príplatky uplatňujú pri výpočte „GrossValue“, je definované parametrom „DiscountOrder“, pričom prvá zľava, ktorá sa má uplatniť, má hodnotu „0“.
Príklad viacerých zliav:
V nasledujúcom príklade sa na položku najskôr uplatní percentuálna zľava vo výške 10 %, po ktorej nasleduje zľava vo výške 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,Špeciálna charakteristika položky „Total“
Zľavy alebo príplatky je možné preniesť aj ako súčasť položky „Total“ (súhrnná položka).
Je však potrebné poznamenať, že samotné uvedenie tejto informácie v položke „Total“ NESTAČÍ. Zľava musí byť proporcionálne rozdelená medzi jednotlivé položky. Ak je napríklad na súhrnnej položke uvedená zľava 10 %, aj jednotlivé položky musia vykazovať zľavu 10 %.
Príklad:
{
"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"
}
Variant 2
V Nemecku a Portugalsku je možné zľavy a príplatky prenášať aj ako samostatné položky. Zľava alebo príplatok sa zohľadňuje pri výpočte celkovej sumy dokladu.
Zľavy sa prenášajú ako záporné hodnoty, príplatky ako kladné hodnoty!
Takéto zľavy alebo príplatky sa definujú prostredníctvom „BusinessTransactionType“: „[1] = Zľava“.
Vo všetkých ostatných krajinách softvér odmietne dokument obsahujúci takúto položku s chybou validácie „Typ obchodnej transakcie ‚Zľava‘ nie je podporovaný.“ V týchto krajinách použite variantu 1. BusinessTransactionType „[1] = Zľava“ je označený ako zastaraný a zachováva sa len z dôvodu spätnej kompatibility, preto sa vo všetkých krajinách odporúča varianta 1.
Príklad:
V nasledujúcom príklade je zľava vo výške 12 EUR zobrazená ako samostatná položka.
{
"PositionNumber": 1,
"Type": 3,
"Caption": "Discount",
"Identifier": "Discount",
"BusinessTransactionType": 1,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -10.0,
"GrossValue": -12.0,
"TaxValue": -2.0
}
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.