POPIS PRACE S OBJEDNAVKAMI PRES WEBOVOU SLUZBU I6WS
=====================================================================
Zakladani objednavek: WebMethod: Create
---------------------------------------------------------------------
Obecny popis:
-----------------------------
Pozadavky na vytvoreni objednavky se zasilaji pomoci XML struktury: Order.
Vysledkem vlozeni objednavky je zase XML struktura Order,
kde je vracen finalni stav vytvorene objednavky,
tak jak je ulozena v informacnim systemu dealera.
(Stav se muze lisit, napr. o automaticky pridane dopravne a pod.)
Kompletni XML struktura Order je vypsana v detailu WebMetody Create
primo v detailu webove sluzby (Order.asmx?op=Create).
Nektere attributy struktury Order jsou vyuzivany jen pro cteni (vraceni finalniho stavu),
pro zapis slouzi jen cast z attributu - viz ukazky vytvoreni objednavek nize.
Vsechny uvedene ukazky XML jsou az element ,
ktery jeste musi byt vlozen SOAP obalky:
Zalozeni objednavky B2B: Minimalni verze
-----------------------------
Staci zaslat jen sadu polozek s kodem + mnozstvim.
Zbyle potrebne udaje se vezmou z defaultnich nastaveni systemu.
Zalozeni objednavky B2B: Sirsi nastaveni
-----------------------------
Vlastni kod lze specifikovat pomoci CodeO. Zasilane CodeO musi byt jedinecne.
Pokud CodeO neni specifikovano, generuje se z nastavene ciselne rady objednavek.
Vyber zpusobu dopravy lze specifikovat pomoci ZDmDemIdO. Obor hodnot _WS_DIST_XXX viz. nastaveni.
Dodaci adresa se specifikuje elementem ComShipTo.
V odpovedi se vrati Id dodaci adresy, jak je vedeno v informacnim systemu.
Pokud se bude Id dodaci adresy zasilat take v pozadavku bude se dodaci adresa aktualizovat a ne zakladat nova.
Aby se dodaci adresy nemnozily, tak doporucujeme Id dodaci adresy ukladat a v pozadavku zasilat.
Seznam dodacich adres, jak jsou evidovany u distributora viz. nastaveni.
Zalozeni objednavky B2C
-----------------------------
B2C objednavky jsou zasilany distributorem primo koncovemu zakaznikovi s doklady dealera.
Fcnost nemusi byt vsemi distributory podporovana, pokud neni vrati se chyba: "ZDirect hasn't configured!".
Udaje o koncovem zakaznikovi se specifikuji v elementu ZCompany.
Na udaje v ZCompany se vystavuje take faktura.
Pokud neni uveden element ComShipTo zasila se zbozi na adresu v ZCompany jinak na adresu v ComShipTo.
Stejne jako je dobre si pamatovat ComShipTo/@Id (viz ukazka vyse),
je dobre si take pamatovat vracene id koncovych zakazniku ZCompany/@Id a zasilat je nazpet,
aby se duplicitne nezakladali znovu.
Seznam koncovych zakazniku, jak jsou evidovany u distributora viz. nastaveni.
V attributu Order/@Tag lze specifikovat oznaceni objednavky od koncoveho zakaznika.
Cena jaka se ma vytisknout na B2C FA se specifikuje v attributu: OrdItem/@ZPrc (cena bez DPH a poplatku).
Pokud je zbozi koncovemu zasilane na dobirku, tak penize se zasilaji na ucet dealera, ktery ma distrubutor zaregistrovany.
(Z bezpecnostnich duvodu nelze ucet specifikovat primo v pozadavku - musi se o pripadnou zmenu pozadat distributor.)
Zjistovani stavu objednavek: WebMethod: GetStatus
---------------------------------------------------------------------
Kdykoli se lze dotazat na stav objednavky.
Pri dotazu na stav objednavky je vracena stejna XML struktura, jako po vlozeni objednavky.
Vstupni parametr je Id objednavky u distributora.
Ve vracenem XML se postupne aktualizuji/pridavaji udaje a lze mj. zjistit:
OrdItem/@Block - stav blokovani polozek
OrdItem/@Proc - stav zpracovanych(fakturovanych) polozek
OrdItem/@Deliv - stav vydanych polozek
OrdItem/@Prc - cena polozky B2B (+ @PrcRef/recyklacni popl./ + @PrcRef2/autorsky popl./ * @TaxRate/%DPH/)
OrdItem/@ZPrc - cena polozky B2C (+ @PrcRef/recyklacni popl./ + @ZPrcRef2/autorsky popl. z B2C ceny/ * @TaxRate/%DPH/)
InvoiceList - seznam faktur z dane objednavky
ExpeditionList - seznam expedic
SNList - seznam zaruk/seriovych cisel
Stav objednavek pres metodu GetStatus lze zjistovat pro vsechny objednavky,
nejen pro objednavky vytvorene pres webovou sluzbu.
Stejne tak lze objednavky vytvorene pres webovou sluzbu vizualne sledovat v eShopu distributora,
kde lze take provadet export tiskovych sestav objednavek a souvisejich dokumentu
Nastaveni: (seznam ciselniky)
---------------------------------------------------------------------
Vypis zpusobu doprav - obor hodnot: Order/@ZDmDemIdO
-----------------------------
Default.asmx/GetResult?resultType=OrderDelivMode
@Code - obor hodnot pro @ZDmDemIdO
@Type -
0...Dopravy za pouziti plateb prevodem (bezhotovostne)
1...Osobni odbery
2...Dobirky
@IsB2B - lze pouzit pro objednavky B2B
@IsB2C - lze pouzit pro objednavky B2C
@IsDefault - Vase vychozi doprava
Vypis dodacich adres evidovanych distributorem
-----------------------------
Default.asmx/GetResult?resultType=ComShipTo
@Type -
0...Dodaci adresa pro B2B objednavku
1...Dodaci adresa pro B2C objednavku
@Hide - nepouzivana dodaci adresa
Vypis koncovych zakazniku evidovanych distributorem
-----------------------------
Default.asmx/GetResult?resultType=ZCompany
Vypis bankovnich uctu evidovanych distributorem
-----------------------------
Default.asmx/GetResult?resultType=ComBank
@IsDefault - Vychozi ucet (na tebnto budou prevadeny penize z B2C dobirek)
Vypis nastaveni ciselniku
-----------------------------
Default.asmx/GetResult?resultType=ZShop
@OrdCode - aktualni ciselnik objednavek (inkrementuje se, kdyz se neposle vase oznaceni Orders/@OrdCode)
@InvCode - aktualni ciselnik B2C faktur (inkrementuje se, kdyz se vytori nova B2C faktura)
@DelCode - aktualni ciselnik B2C dodacich listu (inkrementuje se, kdyz se vytori novy B2C dodaci list)
@InvFooter - paticka(volny text) B2C faktury
Tyto vlastnosti lze nastavit metodou Order.asmx/SetOption
Vlastnosti *Code musi koncit aleposn nekolikacifernym cislem napr.: 2008-00001 (max. 10 znaku)