Specifikacija provizijskih modelov

V programu MuLeMa poleg osnovnih načinov provizioniranja, kot so provizija po hierarhiji, provizija samo sodelavcu in podobno, omogoča tudi bolj kompleksne, t.i. posebne provizijske modele, ko lahko še na druge načine razdelimo provizijo, na primer med priporočevalce, sklepalce, njihove hierarhije in morebitne druge sodelavce ali različno glede na način, kako je prišlo do pridobitve stranke in sklenitve police.

Struktura podatkov

Provizjske modele opišemo v posebni datoteki (dokumentu tipa .xml), ki jo uvozimo v program MuLeMa.

Opisni jezik dokumenta tipa .xml je zgrajen iz elementov in atributov, ki so strogo strukturirani. Vsaka datoteka lahko vsebuje le en zunanji ali korenski element, ki lahko v svoji notranjosti vsebuje druge elemente in atribute. 

V datoteki provizijskih modelov se korenski element imenuje CommissionModels. Ta vsebuje poljubno število elementov CommissionModel. Vsak CommissionModel predstavlja svoj provizijski model, ki je opisan z elementi in atributi, ki se v njem nahajajo.

Vsebina provizijske datoteke je videti nekako takole (zaradi večje preglednosti bodo uporabljeni posebni slogi pisav za imena elementov, imena atributov, vrednosti atributov in ostale dele sintakse in ostali tekst):

V nadaljevanju bodo našteti vsi elementi in atributi, s katerimi opišemo posamezni provizijski model. Na koncu bodo podani tudi primeri zapisov modelov.

Opis provizijskega modela

Element CommissionModel

Vsak element CommissionModel vsebuje opis posameznega provizijskega modela, na katerega se lahko sklicujemo v provizijski skupini. V datoteki je lahko definiranih poljubno število provizijskih modelov.

CommissionModel lahko vsebuje naslednje atribute:

• code
  Oznaka modela, na katerega se sklicujemo v provizijski skupini ali na polici. Vsak model mora imeti različno oznako, ki ne sme vsebovati presledkov, ločil in nekaterih posebnih znakov, lahko pa vsebuje znaka minus in podčrtaj.
• description
  Opis modela. Lahko vsebuje poljuben tekst.

Element CommissionModel lahko vsebuje naslednje elemente:

• Agent
  Vsebuje pravila za dodelitev provizije sodelavcu in njegovi hierarhiji. Vsak element CommissionModel vsebuje enega ali več elementov Agent.

Element Agent

Element Agent se mora v opisu modela (to je znotraj elementa CommissionModel) pojaviti najmanj enkrat, lahko pa se pojavi večkrat.

Z elementom Agent opišemo pravila za dodelitev provizije posameznim sodelavcem in/ali njihovim mentorjem oziroma strukturi. Če se pojavi večkrat, mora prvi element vsebovati provizijo za sodelavca iz naslova lastne produkcije (skrbnika stranke oz. police).

Atribut price

Z neobveznim atributom price določimo višino provizije, ki pripada opisanemu sodelavcu. Vrednost parametra je sestavljena iz številke, ki lahko vsebuje tudi decimalno piko in decimalna mesta, in neobveznega znaka '%'. Če je prisoten znak '%', je znesek provizije izražen v odstotkih od celotne izhodne provizije, v nasprotnem primeru številka predstavlja vrednost enote v evrih. Primeri:

• price ="30%"
  Sodelavec prejme 30% od celotne izhodne provizije.
• price ="7.5"
  Vrednost enote za tega sodelavca znaša 7,50 evrov.

Če atribut price ni prisoten ali njegova vrednost ni podana, se kot privzeta upošteva vrednost enote, ki velja za sodelavca.

Atribut reference

Atribut določa izvornega (referenčnega) sodelavca, na katerega se sklicujemo pri dodeljevanju provizije. Atribut je potreben v večini primerov. Lahko vsebuje eno od naslednjih vrednosti:

• Agent
  Provizija se nanaša na sodelavca (priporočevalca ali skrbnika stranke/police) in/ali mentorja iz njegove nadrejene strukture. Primer: reference ="Agent"
• Contractor
  Provizija se nanaša na sodelaveca, ki je naredil (sklenil) polico in/ali mentorja iz njegove nadrejene strukture. Če sklepalec za polico ni določen, se šteje, da jo je naredil sodelavec. V takšnem primeru je enako, kot če bi bil kot parameter atributa reference podan Agent.

Atribut select

Z atributom natančneje določimo sodelavca, ki je prejemnik provizije.

Če je atribut prisoten, mora njegova vrednost vsebovati eno od ključnih besed za ta atribut ter dvopičje in vrednost, ki je odvisna od ključne besede.

Če atribut ni prisoten ali ne vsebuje prave ključne besede, bo provizijo prejel neposredni sodelavec, na katerega se sklicujemo z atributom reference.

Atribut select lahko vsebuje naslednje ključne besede:

•  MentorLevel
  Sklicujemo se na mentorja sodelavcu, ki je določen z atributom reference. Celoštevilčna vrednost za dvopičjem določa, na katerega v vrsti nadrejenih mentorjev se skicujemo: 1 pomeni prvega nadrejenega mentorja, 2 pomeni mentorja od mentorja, 3 pomeni tretji nadrejeni nivo itd. Če sodelavec na nivoju, na katerega se sklicujemo, nima mentorja, se ta provizija ne dodeli, oziroma ostane agenciji.
  Primer: select ="MentorLevel:1" pomeni, da se sklicujemo na prvega nadrejenega mentorja sodelavcu, ki je določen z atributom reference.
• MentorLevelFromTop
  Sklicujemo se na nivo nadrejenega mentorja, ki je določen od vrha strukture navzdol. Vrednost 1 na primer pomeni sodelavca v hierarhiji mentorjev, ki je neposredno pod korenom strukture, ki običajno predstavlja agencijo. V primeru, da je podani nivo nižji od hierarhičnega nivoja sodelavca, na katerega se sklicujemo, se ta provizija ne dodeli, oziroma ostane agenciji. Primer: select ="MentorLevelFromTop:1".
• Code
  Dvopičju sledi neposredna koda sodelavca, ki je prejemnik provizije. V primeru  select ="Code:100" prejme provizijo sodelavec s kodo '100'. V tem primeru atribut reference ni potreben in se ne upošteva.

Podatkovni tipi se bodo v bodočnosti še dopolnjevali glede na potrebe.

Elementi v Agent

Element Agent lahko vsebuje naslednje neobvezne elemente:

• Condition
  Če je prisoten, določa pogoj, pod katerim se element Agent upošteva. Pojavi se lahko večkrat. Če kateri koli od podanih pogojev ni izpolnjen, se element Agent ne upošteva, oziroma je enako, kot da ne bi bil prisoten.
• Hierarhy
  Določa, da se provizija deli tudi po hierarhiji nadrejenim sodelavcem.