În acest articol, veți afla cum să transmiteți reducerile și suprataxele către RetailForce Middleware.
Cerințe preliminare
- Experiență de bază cu modelul de documente RetailForce
Informații
Reduceri și suprataxe acceptate
În prezent, reducerile și suprataxele pot fi transferate în payload-ul documentului după cum urmează:
- Ca parte a poziției fiecărui articol în parte și, prin urmare, ca reducere sau suprataxă pentru articolul respectiv
- În cadrul unei poziții de tip „Total” (Notă: a se vedea mai jos pentru considerații speciale)
- Ca poziție separată de reducere/suprataxă
Notă: Opțiunea 2 este acceptată în prezent doar în Germania și Portugalia. Consultați fiscalCountryProperties pentru țara respectivă.
Transferul reducerilor/suprataxelor pentru toate pozițiile de articol prin intermediul subtotalurilor sau totalurilor nu este acceptat în prezent. Toate reducerile și suprataxele trebuie convertite în toate pozițiile.
Cu toate acestea, pot fi transferate mai multe reduceri sau suprataxe per articol.
Important: Suma tuturor valorilor de reducere sau suprataxă pe articol trebuie să fie egală cu diferența dintre „BaseGrossValue” și „GrossValue” (suprataxele sunt considerate valori negative). În prezent, această sumă nu este verificată în timpul validării, astfel încât o sumă incorectă nu este raportată ca eroare.
Posibilități de transfer al reducerilor și suprataxelor
Varianta 1
Reducerile sau suprataxele sunt incluse în poziția respectivă a articolului în matricea „Discounts”.
Exemplu:
Exemplul următor prezintă doar un fragment și nu poziția completă a articolului.
"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,Detalii despre elementele individuale pot fi găsite în articolul Obiectul de poziție „poziții”.
În exemplul de mai sus, se aplică o reducere de 10% („TypeValue: 10”). „DiscountValue” se calculează pe baza „BaseGrossValue” (valoarea înainte de reducere). Pentru a calcula „GrossValue”, „DiscountValue” se scade din „BaseGrossValue”.
Suprataxe
La transferul suprataxelor, vă rugăm să țineți cont de următoarele:
- „DiscountValue” și „TypeValue” sunt valori NEGATIVE în cazul suprataxelor!
Tipuri de reduceri și suprataxe
„Discounts.Type” specifică tipul de reducere sau suprataxă:
| Tip | Descriere | Element |
| reducere / suprataxă ca sumă |
Reducerea/suprataxa este specificată ca valoare fixă, de exemplu, „reducere de 15 EUR” sau „taxă de serviciu de 5 EUR”. În acest caz, „DiscountValue” și „TypeValue” au aceeași valoare. |
"Type": "[0] = Allowance" sau: "Type": 0 |
| reducere/suprataxă procentuală |
Suprataxa/reducerea este specificată ca valoare procentuală, de exemplu, „reducere de 10% la articole” sau „taxă de serviciu de 5%”. Aici, „TypeValue” specifică valoarea procentuală, iar „DiscountValue” se calculează pe baza „BaseGrossValue” corespunzătoare articolului.
Notă: În cazul reducerilor procentuale, „DiscountValue” trebuie calculat întotdeauna cu 4 zecimale! |
"Type": "[1] = Discount" sau: "Type": 1 |
Reduceri/suprataxe multiple
Matricea „Discounts” poate conține mai multe reduceri/suprataxe.
Ordinea în care se aplică reducerile sau suprataxele individuale pentru calcularea „GrossValue” este definită de „DiscountOrder”, prima reducere care se aplică având valoarea „0”.
Exemplu de reduceri multiple:
În exemplul următor, se aplică mai întâi o reducere procentuală de 10% la un articol, urmată de o reducere de 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,Caracteristică specială a poziției „Total”
Reducerile sau suprataxele pot fi, de asemenea, transferate ca parte a unui articol „Total” (articol de sumă).
Cu toate acestea, trebuie reținut faptul că simpla specificare a acestui lucru în cadrul articolului „Total” NU este suficientă. Reducerea trebuie distribuită proporțional între pozițiile individuale ale articolelor. De exemplu, dacă pe articolul „Total” este afișată o reducere de 10%, articolele individuale trebuie să prezinte, de asemenea, o reducere de 10%.
Exemplu:
{
"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
În Germania și Portugalia, reducerile și suprataxele pot fi, de asemenea, transferate ca poziții separate. Reducerea sau suprataxa este luată în considerare în cadrul calculului totalului documentului.
Reducerile sunt transferate ca valori negative, iar suprataxele ca valori pozitive!
Astfel de reduceri sau suprataxe sunt definite prin „BusinessTransactionType”: „[1] = Reducere”.
În toate celelalte țări, software-ul respinge un document care conține o astfel de poziție, afișând eroarea de validare „Tipul de tranzacție comercială «Reducere» nu este acceptat.” În aceste țări, utilizați Varianta 1. BusinessTransactionType „[1] = Reducere” este marcat ca fiind învechit și este păstrat doar din motive de compatibilitate cu versiunile anterioare, astfel încât Varianta 1 este recomandată în toate țările.
Exemplu:
În exemplul următor, o reducere de 12 EUR este afișată ca un element separat.
{
"PositionNumber": 1,
"Type": 3,
"Caption": "Discount",
"Identifier": "Discount",
"BusinessTransactionType": 1,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -10.0,
"GrossValue": -12.0,
"TaxValue": -2.0
}
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.