| Both sides previous revision Previous revision Next revision | Previous revision |
| kb:kb:dodatni_moduli:modul_70_main [2025/12/19 14:35] – milano | kb:kb:dodatni_moduli:modul_70_main [2025/12/28 15:36] (current) – [Postavke modula] milano |
|---|
| ====== POS Loyalty kartice (članske kartice) ====== | ====== POS Loyalty kartice (članske kartice) ====== |
| |
| Verzije: **Balans4** | Verzije: Balans3, **Balans4** |
| |
| Modul obezbeđuje registraciju, evidenciju, podešavanje i upotrebu tzv. //Loyalty// kartica, odnosno kartica povlašćenih kupaca. \\ | Modul obezbeđuje registraciju, evidenciju, podešavanje i upotrebu tzv. //Loyalty// kartica, odnosno kartica povlašćenih kupaca. \\ |
| ===== Postavke modula ===== | ===== Postavke modula ===== |
| |
| Parametri modula zadaju se JSON objektom u polju Parametri definicije modula (fn_dodatnimoduli). | Polje ''fn_dodatnimoduli.parametri'' koristi se za podešavanje parametara modula, sastoji se od ''key=value'' parova odvojenih tačkazarezom. \\ Koriste se sledeće ''key'' promenljive: |
| Prethodni sistem postavki oslanjao se na ''key=value'' biće pretvoren u JSON zapis tokom ažuriranja baze podataka. | |
| | |
| ==== JSON objekat ==== | |
| <code> | |
| {"programs":[{#LoyaltyProgram}], | |
| "nazid": ID_vrste_placanja -- 'nazivi.nazid' vrste plaćanja za prefakturisanje koja će se forsirati unutar Balans POS-a kada se pokrene procedura prodaje toplog obroka, | |
| "norefund": true, -- Indikator da računi izdati po osnovu ovog posla ne mogu biti refundirani | |
| "fakper": "30d", -- Period za fakturisanje | |
| "fakdtp": 31, -- Datum fakture | |
| "fakractip": ID_tipa_računa, -- Obračunska struktura fakture | |
| "faksklid": ID_skladišta, -- Skladište sa kog se fakturiše | |
| "sqlcoll": "topli_obrok" -- core naziva upita koji se koriste za sakupljanje podataka | |
| "elid": ID_artikla -- Podrazumevani elid za fakturisanje | |
| } | |
| </code> | |
| | |
| ==== LoyaltyProgram ==== | |
| | |
| Opisuje parametre konkretnog loyalty programa (vrste kartice). | |
| | |
| <code> | |
| { | |
| "name":string, -- Naziv tipa loyalty kartice (programa). Odgovara zapisu u 'cdtype.opis'. | |
| "cdtid":number, -- ID loyalty kartice (programa). Odgovara zapisu u 'cdtype.cdtid'. | |
| "constraints":{#LoyaltyConstraints}, -- Aktivna ograničenja. | |
| "src_ext":number, -- Mogućnosti napredne pretrage po kartoteci članova kluba. Zastavice su definisane enumeratorom ''BE_LoyaltyCardSearchCriteria'' | |
| } | |
| </code> | |
| | |
| ==== LoyaltyConstraints ==== | |
| | |
| Ograničenja, odnosno slučajevi koji se ignorišu ili blokiraju prilikom prodaje. \\ | |
| Sve pozicije imaju jednu od mogućih oznaka: \\ | |
| * "ignore"; Stavka se ne uzima u obračun vrednosti ili poena niti se registruje kao prodaja na kartici. | |
| * "register"; Stavka se ne uzima u obračun vrednosti ili poena ali se registruje kao prodaja na kartici. | |
| * "reject"; Stavka ne može da se pojavi u računu u kom je aktivirana kartica. Pokušaj unosa biće odbijen. | |
| | |
| | |
| <code> | |
| "blacklist":string -- Reakcija {"ignore"|"register"|"reject"} na artikle/kataloge/kategorije iskazane na "crnoj listi" (tabela 'cdblack'). | |
| "action":string -- Reakcija {"ignore"|"register"|"reject"} na artikle koji se nalaze na akcijama. | |
| "discount":string -- Reakcija {"ignore"|"register"|"reject"} na artikle koji se nalaze na predefinisanim (stalnim) popustima poznatih kupaca. | |
| </code> | |
| | |
| | |
| ==== BE_LoyaltyCardSearchCriteria ==== | |
| | |
| | |
| ==== Prehodi key=value zapisi ==== | |
| |
| ^Key^Obevezno^Values^Opis| | ^Key^Obevezno^Values^Opis| |
| |src_ext|Da|ceo broj|//Bitwise// zastavice koje označavaju uključene napredne pretrage po kartoteci članova kluba. Zastavice su definisane enumeratorom ''BE_LoyaltyCardSearchCriteria''. \\ Moguće vrednosti su kombinacija sledećih bitova: \\ **0** - Napredna pretraga nije uključena. \\ **1** - Pretraga po fiksnom telefonu \\ **2** - Pretraga po mobilnom telefonu \\ **4** - Pretraga po email-u \\ **8** - Pretraga po adresi \\ **16** - Pretraga po imenu \\ **32** - Pretraga po prezimenu. \\ \\ **Primeri:** \\ ''src_ext=0'' znači da je napredna pretraga isključena \\ ''src_ext=1'' znači da se može tražiti samo po broju telefona \\ ''src_ext=3'' znači da se može tražiti po telefonu i email-u | | |src_ext|Da|ceo broj|//Bitwise// zastavice koje označavaju uključene napredne pretrage po kartoteci članova kluba. Zastavice su definisane enumeratorom ''BE_LoyaltyCardSearchCriteria''. \\ Moguće vrednosti su kombinacija sledećih bitova: \\ **0** - Napredna pretraga nije uključena. \\ **1** - Pretraga po fiksnom telefonu \\ **2** - Pretraga po mobilnom telefonu \\ **4** - Pretraga po email-u \\ **8** - Pretraga po adresi \\ **16** - Pretraga po imenu \\ **32** - Pretraga po prezimenu. \\ \\ **Primeri:** \\ ''src_ext=0'' znači da je napredna pretraga isključena \\ ''src_ext=1'' znači da se može tražiti samo po broju telefona \\ ''src_ext=3'' znači da se može tražiti po telefonu i email-u | |
| | |address_ext|Ne|zastavica| Indikator da je aktivna ekstenzija sa poštanskim podacima o ulicama i dostavnim kodovima.| |
| |
| \\ | \\ |
| |