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)