Î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ă:

1. Ca parte a poziției fiecărui articol în parte și, prin urmare, ca reducere sau suprataxă pentru articolul respectiv
   1. În cadrul unei poziții de tip „Total” (Notă: a se vedea mai jos pentru considerații speciale)
2. Ca poziție separată de reducere/suprataxă

Transferul reducerilor/suprataxelor pe 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, se pot transfera mai multe reduceri sau suprataxe pe articol.

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 „GrossValue”.

Suprataxe

La transferul suprataxelor, vă rugăm să rețineți următoarele:

• „DiscountValue” și „TypeValue” sunt valori NEGATIVE în cazul suprataxelor!

Tipuri de reduceri și suprataxe

„Discounts.Type” specifică tipul de reducere sau suprataxă:

"Type": "[0] = Allowance"

"Type": 0

"Type": "[1] = Discount"

"Type": 1

Reduceri/suprataxe multiple

Matricea „Discounts” poate conține mai multe reduceri/suprataxe.

Ordinea în care sunt aplicate reducerile sau suprataxele individuale pentru calcularea „GrossValue” este definită de „DiscountOrder”, prima reducere care urmează să fie aplicată 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 majoritatea țărilor, 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”.

Exemplu:

În exemplul următor, o reducere de 12 EUR este afișată ca o poziție 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.