Ügynöki rendelés modul
A RoolWikiBÓL
 – Bázis
 – BázisÜgynöki (pda/android/...) rendelés modul
| Tartalomjegyzék | 
Partnerek lekérdezése
Ügynök meghatározása a bejelentkezett felhasználó alapján történik. Az ügynöki rendelés modulban csak azon partnerekhez rögzíthet a felhasználó rendelést melyekre igaz, hogy a felhasználóhoz rendelt partner be van állítva a partnernél mint ügynök.
 
Az ügynökhöz tartozó partnerek lekérdezéséhez a magyo_get_vallalat_partner_ugynok_v01 függvény hívása szükséges. A függvény által visszaadott halmaz szerkezete: 
| Mező név | Mező típus | Leírás | 
|---|---|---|
| VPN_ID | bigint | A partner egyedi azonosítója a vállalatban | 
| VLT_ID | bigint | A vállalat azonosítója, mely vállalathoz tartozik a partner | 
| VLT_KOD | varchar(50) | A vállalat kódja | 
| VLT_KOD | varchar(200) | A vállalat neve | 
| PNR_ID | bigint | A partner egyedi azonosítója | 
| PNR_KOD | varchar(50) | A partner kódja kódja | 
| PNR_NEV | varchar(200) | A partner neve | 
| TLS_NEV_SZAMLAZAS | varchar(200) | A számlázási település neve | 
| TLS_IRANYITOSZAM_SZAMLAZAS | varchar(30) | A számlázási település irányítószáma | 
| CIM_SZAMLAZAS | varchar(50) | A számlázási cím | 
Az eljárás híváshoz példa:
select 
    vpn_id 
  , vlt_id  
  , vlt_kod   
  , pnr_kod 
  , pnr_nev 
  , tls_nev_szamlazas 
  , tls_iranyitoszam_szamlazas 
  , cim_szamlazas
from magyo_get_vallalat_partner_ugynok_v01(
 '%CO%'
) 
A magyo_get_vallalat_partner_ugynok_v01 eljárás paramétere a partner név szűrőfeltétel. Amennyiben szűrőfeltétel nélkül szeretnénk hívni, akkor null paraméterrel szükséges az eljárás hívása.
Partner címek lekérdezése
A kiválasztott partnerhez a partner címek a magyo_get_vallalat_partner_cim_ugynok_v01 függvény hívásával kérdezhetőek le. A függvény által visszaadott címek halmazának szerkezete:
| Mező név | Mező típus | Leírás | 
|---|---|---|
| ID | bigint | A partner cím egyedi azonosítója a paraméterként kapott partnerhez tartozó vállalatban | 
| PCM_KOD | varchar(50) | A partner cím kódja | 
| PCM_NEV | varchar(200) | A partner cím neve | 
| TLS_NEV | varchar(200) | A partner cím település neve | 
| TLS_IRANYITOSZAM | varchar(30) | A partner cím település irányítószáma | 
| CIM | varchar(50) | A partner cím címe | 
A függvénynek 1 paramétere van (megadása kötelező):
- a magyo_get_vallalat_partner_ugynok_v01 függvény VPN_ID mezőjében visszaadott partner azonosító
Az eljárás híváshoz példa:
select 
    id 
  , pcm_kod 
  , pcm_nev 
  , tls_nev
  , tls_iranyitoszam
  , cim
from magyo_get_vallalat_partner_cim_ugynok_v01(
  100
) 
A magyo_get_vallalat_partner_cim_ugynok_v01 eljárás paramétere a magyo_get_vallalat_partner_ugynok_v01 eljárás által vpn_id mezőben visszaadott érték.
Szállítási nap meghatározás
A magyo_get_vevoi_megrendeles_szallitasi_nap_v01 függvény hívásával az adott szállítási címre, adott dátumot követő/megelőző szállítási nap meghatározása lehetséges. A függvény visszatérési értéke dátum. A lehetséges dátumok a szállítási címhez rendelt járat napok alapján történik.
A függvénynek 3 paramétere van (mindegyik érték megadása kötelező):
- a magyo_get_vallalat_partner_cim_ugynok_v01 függvény ID mezőjében visszaadott partner cím azonosítója
- dátum, melyhez képest a következő szállítási dátum meghatározása történik
- irány, mely '+' esetén a következő, '-' esetén a paraméterként átadott dátumhoz képes az előző szállítási dátum
Az eljárás híváshoz példa:
select magyo_get_vevoi_megrendeles_szallitasi_nap_v01( 101 , to_date(now(), 'YYYY-MM-DD') , '+' )
Cikk csoportok szerinti cikk szűkítés
A magyo_get_vevoi_megrendeles_cikkcsoport_v01 függvény visszaadja azon cikk csoportok halmazát, melyre igaz, hogy adott címre, adott napon eladható cikként be vannak sorolva.
A függvénynek 3 paramétere van (mindegyik érték megadása kötelező):
- a magyo_get_vallalat_partner_cim_ugynok_v01 függvény ID mezőjében visszaadott partner cím azonosítója
- a magyo_get_vevoi_megrendeles_szallitasi_nap_v01 függvény által visszaadott dátum
-  típus, melynek lehetséges értékei:
- KSZG - készültség
- KDS - kidolgozás
- MKA - márka
- EAT - értékesítési árucsoport
- TTPS - termék típus
 
Az eljárás híváshoz példa:
select
  id
, kod
, nev
magyo_get_vevoi_megrendeles_cikkcsoport_v01(
  150
, to_date('2012-09-17', 'YYYY-MM-DD')
, 'MKA'
) 
Cikk lekérdezése
A magyo_get_vevoi_megrendeles_cikk_v01 függvény hívásával kérdezhetőek le a rendelhető/rendelt cikkekről, mennyiségekről, árakról adott szállítási cím és teljesítés dátum vonatkozásában. A már rendelt cikkeknél a rendelés/szállítólevél/túra adatok is visszaadásra kerülnek. A függvény által visszaadott cikk halmazának szerkezete: 
| Mező név | Mező típus | Leírás | 
|---|---|---|
| VAU_ID | bigint | A cikk azonosítója | 
| ARU_KOD | varchar(50) | A cikk kódja | 
| ARU_NEV | varchar(200) | A cikk neve | 
| ARU_ETK | varchar(6) | A cikk ETK-ja | 
| RENDELT_GYUJTOKISZERELES_DARAB | numeric(15,0) | A rendelt gyűjtőkiszerelés darab | 
| RENDELT_MENNYISEG | numeric(38,10) | A rendelt mennyiség | 
| AKCIOS_E | varchar(1) | Akciós termék? | 
| EGYSEGAR | numeric(38,4) | Az eladási egységár | 
| PENZNEM_KOD | varchar(50) | Az eladási pénznem kódja | 
| NETTO_ERTEK | numeric(38,4) | A nettó érték | 
| BRUTTO_ERTEK | numeric(38,4) | A bruttó érték | 
| GYUJTO_KISZERELESI_EGYSEG_KOD | varchar(50) | A gyűjtő kiszerelési egység kódja | 
| GYUJTO_KISZERELESI_EGYSEG_NEV | varchar(200) | A gyűjtő kiszerelési egység neve | 
| GYUJTO_EGALIZALT_MENNYISEG | numeric(38,10) | A gyűjtő egalizált mennyiség | 
| MENNYISEGI_EGYSEG_KOD | varchar(50) | A cikk mennyiségi egyésége | 
| VALTOSZAM_SULYRA | numeric(38,10) | A súlyra történő átváltáshoz | 
| PNM_ID | bigint | Pénznem azonosítója | 
| VMS_ID | bigint | A rendelés azonosítója, ha a cikk már tartozik rendeléshez | 
| VEVOI_MEGRENDELES_BIZONYLATSZAM | varchar(30) | A vevői megrendelés bizonylatszáma | 
| VEVOI_MEGRENDELES_STATUSZ | varchar(1) | A vevői megrendelés státusza | 
| SZALLITOLEVEL_BIZONYLATSZAM | varchar(30) | A szállítólevél bizonylatszáma | 
| SZALLITOLEVEL_STATUSZ | varchar(1) | A szállítólevél státusza | 
| TURA_KOD | varchar(50) | A túra kódja, melyben a már rögzített tétel szerepel | 
| TURA_STATUSZ | varchar(1) | A túra státusza | 
| VMT_ID | bigint | A rendelés tétel azonosítója | 
| KSZG_ID | bigint | A készültség azonosítója | 
| KESZULTSEG_KOD | varchar(50) | A készültség kódja | 
| KESZULTSEG_NEV | varchar(200) | A készültség neve | 
| KDS_ID | bigint | A kidolgozás azonosítója | 
| KIDOLGOZAS_KOD | varchar(50) | A kidolgozás kódja | 
| KIDOLGOZAS_NEV | varchar(200) | A kidolgozás neve | 
| MKA_ID | bigint | A márka azonosítója | 
| MARKA_KOD | varchar(50) | A márka kódja | 
| MARKA_NEV | varchar(200) | A márka neve | 
| EAT_ID | bigint | Az értékesítési árucsoport azonosítója | 
| ERTEKESITESI_ARUCSOPORT_KOD | varchar(50) | Az értékesítési árucsoport kódja | 
| ERTEKESITESI_ARUCSOPORT_NEV | varchar(200) | Az értékesítési árucsoport neve | 
| TTPS_ID | bigint | A termék típus azonosítója | 
| TERMEK_TIPUS_KOD | varchar(50) | A termék típus kód | 
| TERMEK_TIPUS_NEV | varchar(200) | A termék típus név | 
| GONGYOLEG_E | varchar(1) | A cikk göngyöleg? | 
A függvénynek 2 paramétere van (mindegyik érték megadása kötelező):
- a magyo_get_vallalat_partner_cim_ugynok_v01 függvény ID mezőjében visszaadott partner cím azonosítója
- a magyo_get_vevoi_megrendeles_szallitasi_nap_v01 függvény által visszaadott dátum
Az eljárás híváshoz példa:
select 
    vau_id 
  , aru_kod
  , aru_nev 
  , rendelt_gyujtokiszereles_darab
  , rendelt_mennyiseg
  , akcios_e
  , egysegar
from magyo_get_vevoi_megrendeles_cikk_v01(
   150
  ,to_date('2012-09-17', 'YYYY-MM-DD')
) 
Cikk lekérdezése
A magyo_get_vevoi_megrendeles_cikk_v01 függvény hívásával kérdezhetőek le a rendelhető/rendelt cikkekről, mennyiségekről, árakról adott szállítási cím és teljesítés dátum vonatkozásában. A már rendelt cikkeknél a rendelés/szállítólevél/túra adatok is visszaadásra kerülnek. A függvény által visszaadott cikk halmazának szerkezete: 
| Mező név | Mező típus | Leírás | 
|---|---|---|
| VAU_ID | bigint | A cikk azonosítója | 
| ARU_KOD | varchar(50) | A cikk kódja | 
| ARU_NEV | varchar(200) | A cikk neve | 
| ARU_ETK | varchar(6) | A cikk ETK-ja | 
| RENDELT_GYUJTOKISZERELES_DARAB | numeric(15,0) | A rendelt gyűjtőkiszerelés darab | 
| RENDELT_MENNYISEG | numeric(38,10) | A rendelt mennyiség | 
| AKCIOS_E | varchar(1) | Akciós termék? | 
| EGYSEGAR | numeric(38,4) | Az eladási egységár | 
| PENZNEM_KOD | varchar(50) | Az eladási pénznem kódja | 
| NETTO_ERTEK | numeric(38,4) | A nettó érték | 
| BRUTTO_ERTEK | numeric(38,4) | A bruttó érték | 
| GYUJTO_KISZERELESI_EGYSEG_KOD | varchar(50) | A gyűjtő kiszerelési egység kódja | 
| GYUJTO_KISZERELESI_EGYSEG_NEV | varchar(200) | A gyűjtő kiszerelési egység neve | 
| GYUJTO_EGALIZALT_MENNYISEG | numeric(38,10) | A gyűjtő egalizált mennyiség | 
| MENNYISEGI_EGYSEG_KOD | varchar(50) | A cikk mennyiségi egyésége | 
| VALTOSZAM_SULYRA | numeric(38,10) | A súlyra történő átváltáshoz | 
| PNM_ID | bigint | Pénznem azonosítója | 
| VMS_ID | bigint | A rendelés azonosítója, ha a cikk már tartozik rendeléshez | 
| VEVOI_MEGRENDELES_BIZONYLATSZAM | varchar(30) | A vevői megrendelés bizonylatszáma | 
| VEVOI_MEGRENDELES_STATUSZ | varchar(1) | A vevői megrendelés státusza | 
| SZALLITOLEVEL_BIZONYLATSZAM | varchar(30) | A szállítólevél bizonylatszáma | 
| SZALLITOLEVEL_STATUSZ | varchar(1) | A szállítólevél státusza | 
| TURA_KOD | varchar(50) | A túra kódja, melyben a már rögzített tétel szerepel | 
| TURA_STATUSZ | varchar(1) | A túra státusza | 
| VMT_ID | bigint | A rendelés tétel azonosítója | 
| KSZG_ID | bigint | A készültség azonosítója | 
| KESZULTSEG_KOD | varchar(50) | A készültség kódja | 
| KESZULTSEG_NEV | varchar(200) | A készültség neve | 
| KDS_ID | bigint | A kidolgozás azonosítója | 
| KIDOLGOZAS_KOD | varchar(50) | A kidolgozás kódja | 
| KIDOLGOZAS_NEV | varchar(200) | A kidolgozás neve | 
| MKA_ID | bigint | A márka azonosítója | 
| MARKA_KOD | varchar(50) | A márka kódja | 
| MARKA_NEV | varchar(200) | A márka neve | 
| EAT_ID | bigint | Az értékesítési árucsoport azonosítója | 
| ERTEKESITESI_ARUCSOPORT_KOD | varchar(50) | Az értékesítési árucsoport kódja | 
| ERTEKESITESI_ARUCSOPORT_NEV | varchar(200) | Az értékesítési árucsoport neve | 
| TTPS_ID | bigint | A termék típus azonosítója | 
| TERMEK_TIPUS_KOD | varchar(50) | A termék típus kód | 
| TERMEK_TIPUS_NEV | varchar(200) | A termék típus név | 
| GONGYOLEG_E | varchar(1) | A cikk göngyöleg? | 
A függvénynek 2 paramétere van (mindegyik érték megadása kötelező):
- a magyo_get_vallalat_partner_cim_ugynok_v01 függvény ID mezőjében visszaadott partner cím azonosítója
- a magyo_get_vevoi_megrendeles_szallitasi_nap_v01 függvény által visszaadott dátum
Az eljárás híváshoz példa:
select 
    vau_id 
  , aru_kod
  , aru_nev 
  , rendelt_gyujtokiszereles_darab
  , rendelt_mennyiseg
  , akcios_e
  , egysegar
from magyo_get_vevoi_megrendeles_cikk_v01(
   150
  ,to_date('2012-09-17', 'YYYY-MM-DD')
) 
Új rendelés rögzítése
A rendelés fej rögzítéséhez a magyo_uj_vevoi_megrendeles_v01 függvény hívás szükséges. A függvény által visszaadott halmaz szerkezete:
| Mező név | Mező típus | Leírás | 
|---|---|---|
| ID | bigint | A rendelés azonosítója | 
| ROGZITES_IDOPONT | timestamp | A rendelés rögzítés időpontja | 
| bizonylatszam | varchar(30) | A rendelés bizonylatszáma | 
| verzio | varchar(50) | A rendelés verziószáma | 
| nev | varchar(200) | A rendelés neve | 
| statusz | varchar(1) | A rendelés státusza | 
| rendeles_datum | date | A rendelés felvétel dátuma | 
| teljesites_datum | date | A rendelés teljesítés dátuma | 
| hivatkozasi_nev | varchar(200) | A rendelés hivatkozási neve | 
| partner_kod | varchar(50) | A rendeléshez kapcsolódó partner kódja | 
| partner_nev | varchar(200) | A rendeléshez kapcsolódó partner neve | 
| szallitasi_cim_kod | varchar(50) | A rendeléshez kapcsolódó szállítási cím kódja | 
| szallitasi_cim_nev | varchar(50) | A rendeléshez kapcsolódó szállítási cím neve | 
| szallitasi_cim_telepules_iranyitoszam | varchar(30) | A rendeléshez kapcsolódó szállítási település irányítószáma | 
| szallitasi_cim_telepules_nev | varchar(200) | A rendeléshez kapcsolódó szállítási település neve | 
| szallitasi_cim | varchar(50) | A rendeléshez kapcsolódó szállítási cím | 
| penznem_kod | varchar(50) | A rendelés pénznem kódja | 
| penznem_nev | varchar(200) | A rendelés pénznem neve | 
| fizetesi_mod_kod | varchar(50) | A rendelés fizetési módja | 
| fizetesi_mod_nev | varchar(200) | A rendelés fizetési neve | 
| paritas_kod | varchar(50) | A rendelés paritás kódja | 
| paritas_nev | varchar(50) | A rendelés paritás neve | 
| ugynok_partner_kod | varchar(50) | Az ügynök partner kódja | 
| ugynok_partner_nev | varchar(200) | Az ügynök partner neve | 
| ugynoki_jutalek | varchar(50) | Az ügynök jutaléka | 
| rendeles_leadas_mod_kod | varchar(50) | A rendelés leadás kódja | 
| rendeles_leadas_mod_nev | varchar(50) | A rendelés leadás neve | 
| vallalat_bankszamla_kod | varchar(50) | A rendeléshez kapcsolódó vállalat bankszámla kódja | 
| vallalat_bankszamla_nev | varchar(50) | A rendeléshez kapcsolódó vállalat bankszámla neve | 
| vallalat_bankszamla_penzforgalmi_jelzoszam | varchar(50) | A rendeléshez kapcsolódó vállalat bankszámla pénzforgalmi jelzőszáma | 
| hibauzenet | text | A rendelés fej rögzítés hibaüzenet, amennyiben a rögzítés valamilyen oknál fogva nem sikerülne. | 
A függvénynek 3 paramétere van:
- a magyo_get_vallalat_partner_cim_ugynok_v01 függvény ID mezőjében visszaadott partner cím azonosítója (kötelező)
- a magyo_get_vevoi_megrendeles_szallitasi_nap_v01 függvény által visszaadott dátum (kötelező)
- hivatkozási név, mely a kezelő által megadott tetszőleges szöveg (opcionális, null érték is lehet)
Az eljárás híváshoz példa:
select 
    id
  , bizonylatszam
  , statusz
  , rendeles_datum
  , teljesites_datum
  , parnter_kod
  , parnter_nev
  , szallitasi_cim_kod
  , szallitasi_cim_nev
  , szallitasi_cim_telepules_iranyitoszam
  , szallitasi_cim_telepules_nev
  , szallitasi_cim
  , penznem_kod
  , fizetesi_mod_kod
from magyo_uj_vevoi_megrendeles_v01(
  150
, to_date('2012-09-17', 'YYYY-MM-DD')
, 'teszt'
) 
Új rendelés tétel rögzítése
A rendelés tétel felvételéhez/módosításához a magyo_set_vevoi_megrendeles_cikk_v01 eljárás hívása szükséges. A függvény a Cikk lekérdezése részben megadott szerkezettel tér vissza.
A függvénynek 7 paramétere van:
- a magyo_uj_vevoi_megrendeles_v01 függvény ID mezőjében visszaadott vevői megrendelés azonosítója (kötelező)
- a rendelés tétel azonosítója, mely új rendelés tétel esetén null, már meglévő esetén a korábban lekérdezett rendelés tétel azonosítója. (kötlező)
- a magyo_get_vevoi_megrendeles_cikk_v01 függvény VAU_ID mezőjében visszaadott cikk azonosító (kötelező)
- a rendelt gyűjtőkiszerelés darab (opcionális, null érték is lehet)
- a rendelt mennyiség (kötelező, 0 érték és konkrét rendelés tétel azonosító megadásakor a korábbi rendelés tétel törlésre kerül)
- a mennyiségi egység kódja (kötelező)
- az egységár (kötelező)
Az eljárás híváshoz példa:
select vms_id , vmt_id , vevoi_megrendeles_bizonylatszam , szallitolevel_bizonylatszam , tura_kod , aru_kod , aru_nev , rendelt_gyujtokiszereles_darab , rendelt_mennyiseg , egysegar , penznem_kod from magyo_set_vevoi_megrendeles_cikk_v01( 999 , null , 712 , 2 , 14 , 'KG' , 231.5 )
