Návody

Tu sú napísané návody, ako použiť jednotlivé funkcie API.

Import skladových kariet #

Importovať treba takto.

• /interface/[db]/eshop/v1/strom - Získa sa strom skladových kariet.
• /interface/[db]/eshop/v1/typ_produktu - Získa sa číselník typov produktu.
• /interface/[db]/eshop/v1/karty/premenne - Získa sa zoznam používaných premenných.
• /interface/[db]/eshop/v1/karty - Získa sa zoznam skladových kariet.
• Pre každú skladovú kartu treba zavolať.
  • /interface/[db]/eshop/v1/karty/ceny - Získa sa zoznam rôznych cien.
  • /interface/[db]/eshop/v1/karty/mnozstvo - Získa sa množstvo tovaru na sklade.
  • /interface/[db]/eshop/v1/karty/premenne/all - Získa sa zoznam premenných ku skladovej karte.
  • /interface/[db]/eshop/v1/karty/obrazky/zoznam - Získa sa zoznam obrázkov ku skladovej karte.
  • /interface/[db]/eshop/v1/karty/obrazky/subor - Podľa predchádzajúceho zoznamu sa stiahnu jednotlivé obrázky ku skladovej karte.
• Koniec

Import firiem #

Prvotné naplnenie firmami.

• /interface/[db]/eshop/v1/firmy/zoznam - Takto sa dá získať zoznam firiem v našom programe.
• Koniec

Import osôb #

Prvotné naplnenie osobami.

• /interface/[db]/eshop/v1/osoby/zoznam - Takto sa dá získať zoznam osôb v našom programe.
• Koniec

Vytvorenie objednávky #

Vytvoriť objednávku treba takto.

• Ak sa jedná o objednávku pre firmu a taká firma nie je v našej databáze.
  • /interface/[db]/eshop/v1/firmy/vytvor - Vytvorí sa firma.
• Ak sa jedná o objednávku pre osobu a taká osoba nie je v našej databáze.
  • /interface/[db]/eshop/v1/osoby/vytvor - Vytvorí sa osoba.
• /interface/[db]/eshop/v1/objednavky/vytvor - Vytvorí sa objednávka.
• Koniec

Sledovanie stavu objednávky #

Stav objednávky sa sleduje takto.

• /interface/[db]/eshop/v1/objednavky/stavy - Získanie číselníka možných stavov.
• /interface/[db]/eshop/v1/objednavky/stav - Získanie stavu konkrétnej objednávky.
• /interface/[db]/eshop/v1/objednavky/dokumenty - Získanie zoznamu dokumentov k objednávke.
• /interface/[db]/eshop/v1/objednavky/dokumenty/subor - Získanie konkrétneho súboru.
• Koniec

Ako používať version #

Myslím si, že pokiaľ sa používa version, nemalo by sa súčasne sťahovať z toho endpointu viackrát s iným limitom a offsetom. Treba vychádzať z toho, že užívatelia v Optivuse pracujú paralelne s API a kedykoľvek môžu spôsobiť zmenu údajov. Ak totiž stiahnem napríklad prvých 100 záznamov od version 1000 a potom ďalších 100 záznamov posunutých offsetom od version 1000, medzi oboma operáciami uplynie nejaký čas a vtedy môže dať napríklad niekto v Optivuse prepočítať stav na sklade, čo spôsobí posunutie version na každom zázname (v MS SQL serveri aj zeditovanie záznamu bez nejakých zmien spôsobí posun version, pretože to server urobí sám v okamihu commitnutia riadku do databázy).

Správne sa to má robiť tak, že offset je vtedy 0 a limit je nejaké rozumné množstvo záznamov. Stiahnem si prvé dáta, spracujem ich a na dalšie sťahovanie použijem už modifikované version s rovnakým limitom a offsetom. Vtedy nehrozí to, že sa dáta nejako zmenia. API bude dodávať záznamy dovtedy, kým nebude mať version nad najvyššou version, ktorú má v danej tabuľke. A je jedno, čo robia lokálni užívatelia, pretože oni iba môžu posunúť databázové version v tabuľke. A je úplne jedno, či medzitým aj niekoľkokrát nezmenili version na jednom konkrétnom riadku.

Sledovanie zmien skladových kariet a obrázkov #

Množstvo skladových kariet v programe môže dosahovať tisíce. Je vhodné, ak sa v pravidelných intervaloch aktuálizuje celý zoznam. To však môže dosť dlho trvať. Ak potrebujete okamžite reagovať na zmeny, môžete používať sledovanie zmien, ktoré poskytuje program Optivus od verzie 5.90.

Množstvo tovaru na sklade #

Na zistenie množstva tovaru na sklade možno použiť tri funkcie.

• /interface/{db}/eshop/v1/karty/mnozstvo - Dodáva množstvo podľa prednastaveneho skladu v konfigurácii API.
• /interface/{db}/eshop/v2/karty/mnozstvo - Dodáva množstvo podľa nastaveneho skladu v programe Optivus. Táto funkcia dodáva množstvo sumárne za všetky sklady, ktoré majú nastavený príznak.
• /interface/{db}/eshop/v1/karty/sklady - Tu sa dá skontrolovať, ktoré sklady majú nastavený stĺpec eshop_mnozstvo.

Nastavenie v programe Optivus #

V programe treba v nastavení skladu zaškrtnúť položku Počítať množstvo tovaru pre E-shop.

---