Provozujete vlastní e-shop nebo jiný systém a potřebujete automaticky přebírat data z Axilogi? Pomocí XML datové výměny (I6WS) můžete automaticky získávat aktuální informace o našich produktech, skladech, cenách, kategoriích, obrázcích, přílohách a dalších údajích. Nemusíte tak data ručně opisovat nebo pravidelně stahovat. Váš e-shop nebo informační systém si může data z Axilogi pravidelně načítat automaticky.
Co můžete pomocí XML získávat?
- seznam produktů
- základní informace o produktech
- skladovou dostupnost
- ceny
- kategorie a zařazení produktů ve stromu
- parametry produktů
- obrázky
- přílohy a odkazy
- informace o termínech dodání
- údaje související s objednávkami a další dostupná data
K dispozici je více než 40 různých typů datových výstupů.
Jak začít?
- Nejprve si vyžádejte přístup
Přihlašovací údaje do XML služby si nelze vytvořit samostatně. Pokud chcete XML datovou výměnu používat, požádejte o přístup svého obchodníka v Axilogi. Obchodník vám předá přihlašovací údaje pro webovou službu I6WS. Tyto údaje mohou být jiné než vaše běžné přihlášení do e-shopu. - Přihlaste se do webové služby
Po získání přihlašovacích údajů můžete službu otevřít zde: https://www.axilogi.com/I6ws/. Webová služba umožňuje zobrazit dostupné datové výstupy a u některých z nich je možné jejich stažení rovnou vyzkoušet v prohlížeči. - Vyberte, jaká data potřebujete
Pro získání dat slouží tři základní způsoby:
GetResult - Stáhne obecný seznam dat. Například všechny dostupné produkty nebo všechny produkty skladem.
GetResultByCode - Stáhne informace ke konkrétnímu produktu podle jeho kódu.
GetResultByFromTo - Stáhne údaje, které se změnily v určitém časovém období.
Jednoduše řečeno
Chci všechno › GetResult
Chci jeden konkrétní produkt › GetResultByCode
Chci jen změny za určité období › GetResultByFromTo
Příklady URL s metodou GET
- Základní vlastnosti všech produktů:
https://www.axilogi.com/i6ws/Default.asmx/GetResult?resultType=StoItemBase - Základní vlastnosti jednoho produktu s kódem 10120808:
https://www.axilogi.com/i6ws/Default.asmx/GetResultByCode?resultType=StoItemBase&code=10120808 - Informace o stavu skladu jednoho produktu s kódem produktu 10120808:
https://www.axilogi.com/i6ws/Default.asmx/GetResultByCode?resultType=StoItemQtyFree&code=10120808 - Informace o ceně produktu s kódem produktu 10120808:
https://www.axilogi.com/i6ws/Default.asmx/GetResultByCode?resultType=StoItemPriceOrd&code=10120808 - Všechny produkty skladem:
https://www.axilogi.com/i6ws/Default.asmx/GetResult?resultType=StoItemQtyFree - Základní vlastnosti více produktů, u kterých došlo ke změně mezi 01. 01. 2023 - 01. 01. 2077:
https://www.axilogi.com/i6ws/Default.asmx/GetResultByFromTo?resultType=StoItemBase&from=2023-01-01&to=2077-01-01 - Ceníkový strom 0 (typicky: 0=Druhy; 1=Výrobci => Id se sestavuje jako Id Stromu-2147483648):
https://www.axilogi.com/i6ws/Default.asmx/GetResultByCode?resultType=SPresentTree&code=-2147483648
Nejčastěji používané datové výstupy
| Co potřebujete | Název metody |
|---|---|
| Produkty skladem | StoItemQtyFree |
| Seznam aktivních produktů | StoItemActive |
| Produkty skladem a produkty s termínem dodání | StoItemQtyFreeEx |
| Základní informace o produktech | StoItemBase |
| Hiearchická stromová struktura stoitem. IdP je vztah k rodičovskému stromu (prázdný - nejvyšší úroveň); Každá úroveň má vyhrazené 3 znaky - Např. AAA = první úroveň, AAABBB = druhá úroveň. Metoda ByCode filtrovat data podle IdP | SPresentTree |
| Koncové ceny | StoItemPriceEU |
| Přílohy a odkazy produktů | AttSti |
| Datumy dodání u vámi objednaných produktů | Queue |
... zbylé metody a jejich popis je zde: /I6ws/ResultTypeInfo.ashx
Automatické aktualizace dat
XML výměna je vhodná především pro automatické napojení vašeho e-shopu nebo informačního systému. Například váš systém může:
- pravidelně stáhnout seznam produktů
- aktualizovat jejich názvy a popisy
- aktualizovat ceny
- aktualizovat skladovou dostupnost
- doplnit nebo změnit obrázky
- aktualizovat kategorie
- stáhnout nové přílohy a další informace
Není tedy nutné každý den ručně stahovat a upravovat jednotlivé produkty. U některých výstupů lze navíc stáhnout pouze data, která se změnila v určitém časovém období. To je vhodné pro pravidelnou automatickou synchronizaci.
Jak vypadá technický odkaz?
Základní syntaxe URL: https://NAME:PASSWORD@axilogi.com/i6ws/Default.asmx/NAZEV_METODY?resultType=NAZEV_RESULTU&PARAMETRY
- NAME - Přihlašovací jméno do webové služby
- PASSWORD - Přihlašovací heslo do webové služby
- NAZEV_METODY - způsob, jakým chcete data získat - GetResult (všechno) | GetResultByCode (pouze 1 kod) | GetResultByFromTo (od-do)
- NAZEV_RESULTU - jaký typ dat chcete získat
- PARAMETRY:
GetResult - resultType=XXX
GetResultByCode - resultType=XXX&code=YYY
GetResultByFromTo - resultType=XXX&from=YYY&to=ZZZ
Objednávky a další data
XML služba není určena pouze pro stahování produktů. Podle dostupného nastavení lze využít také další datové výstupy, například pro práci s objednávkami a dalšími obchodními daty. U objednávek je používána samostatná služba Order.asmx. Její dostupnost je závislá na nastavení konkrétního účtu. Pokud potřebujete napojit objednávky nebo další obchodní procesy, doporučujeme nejprve kontaktovat svého obchodníka v Axilogi.
Technická dokumentace
Popis od vývojářů v češtině: /i6ws/ReadMe.txt
Popis od vývojářů v angličtině: /i6ws/ReadMe-en.txt
Potřebujete přístup?
Přihlašovací údaje do I6WS vám vytvoří / předá váš obchodník v Axilogi. Pokud přístup ještě nemáte nebo potřebujete poradit, obraťte se na svého obchodníka a požádejte ho o aktivaci přístupu k XML datové výměně (I6WS).
