Partner-integrációk és bekötési útmutató

Ezen az oldalon azt találja, hogyan kötheti be a BYB partnerfeedet a saját rendszerébe. Minden link a fiókjában, az Árlista-feed kártyán van, a saját tokenjével. A token személyre szól, ne ossza meg; ha kikerül, a fiókban egy gombbal újat kérhet, a régi azonnal érvénytelen lesz.

Mit tartalmaz a feed

Két végpont van, ugyanazzal a tokennel. A sovány feed (/feed) árat és készletet ad, CSV, XML vagy JSON formában, ezt érdemes naponta többször lekérni. A teljes feed (/feed/teljes) ugyanezt viszi tartalommal együtt: kategória, garancia, terméklap-URL, képek, műszaki jellemzők, leírás, XML vagy JSON formában, ezt elég naponta egyszer. A teljes feedből kész import-fájlt is kérhet a saját boltmotorjára: WooCommerce, Shoptet és Shopify formátumban. Az ár a saját árszintjén, nettó forintban jön, mellette a kötelező érvű EUR és USD ár rögzített bázison, a készletből a már lekötött darabok le vannak vonva. A mennyiségi ársávok a feed gyökerében szerepelnek.

Készlet: helyi és beszállítói

Három készlet-szám érkezik minden tételnél, mert nem mindegy, hogy a darab nálunk van-e vagy a beszállítónknál.

1. keszlet_sajat — ami a mi raktárunkban áll. Ez indul aznap vagy másnap.
2. keszlet_kulso — a beszállítónk készlete. Meg tudjuk rendelni, de nem azonnali; a beérkezési idő a beszerzesi_ido mezőben van, ha ismerjük.
3. keszlet — a kettő összege. Ez a mező nem változott, tehát akinek a rendszere eddig erre volt bekötve, annak nem kell hozzányúlnia.

A CSV-ben és a WooCommerce-fájlban külön oszlop, a Shoptet-fájlban pedig az elérhetőség szövege mondja meg: csak a saját raktárkészlet ad Raktáron feliratot, a beszállítói készlet Beszállítói készleten lesz.

Szabja a feedet a boltjához

A linkhez paramétereket írhat, és akkor már úgy érkezik az adat, ahogy a boltjában kell. Nem kell hozzá programozni, se az importban képletet írni: elég a linket kiegészíteni.

1. Csak a felsorolt márkákat kéri: &marka=akyga,colorway
2. Csak a felsorolt kategóriákat, a feedben szereplő kategória-kulcsokkal: &kategoria=usb-kabel
3. Csak azt, amiből van készlet, nálunk vagy a beszállítónknál: &keszlet=van
4. Csak azt, ami a mi raktárunkban áll, tehát azonnal indul: &keszlet=sajat
5. A saját eladási árát kéri a beszerzési ára helyett: &ar=+25%
6. Az árat százra kerekítjük: &kerekites=100
7. Az árat a szokásos, kilencvenre végződő alakra kerekítjük: &kerekites=990

Az árrésnél a nettó beszerzési árára rátesszük a megadott százalékot, hozzáadjuk az áfát, és a kész bruttó árat írjuk oda, ahol a boltmotorja az eladási árat várja. A beszerzési ára külön mezőben marad, tehát az árrése végig látszik. Kerekíteni mindig felfelé kerekítünk, hogy az árrése ne csökkenjen; ha nem kér mást, tíz forintra.

Egy teljes példa, ami csak a raktáron lévő Akyga-termékeket viszi, a saját árával, szép kerekítéssel:

&format=woo&marka=akyga&keszlet=van&ar=+25%&kerekites=990

Ha elgépel egy paramétert, a feed nem üres fájlt ad, hanem megmondja, mi a baj. Így nem fordulhat elő, hogy napokig hibás ár vagy hiányzó termék van a boltjában.

WooCommerce

1. A fiókjában másolja ki a WooCommerce-import (CSV) linket.
2. A saját boltjában: Termékek → Importálás → válassza a fájl helyett az URL-t, vagy töltse le a CSV-t és töltse fel.
3. Az oszlopok a WooCommerce saját importer-sémáját követik (SKU, név, leírás, képek, kategória, készlet, ár), a mezőket nem kell megfeleltetni. A Regular price az ajánlott fogyasztói ár, ezt Ön szabadon átírja; a beszerzési nettó ár és az EUR-ár külön meta-mezőben érkezik.
4. Frissítéshez futtassa újra az importot ugyanarról a linkről; a meglévő termékeket SKU alapján frissíti.

Shoptet

1. A fiókjában másolja ki a Shoptet-import (XML) linket.
2. A Shoptet adminjában: Termékek → Importálás → automatikus import, forrásnak ez az URL.
3. A fájl a Shoptet beszállítói XML-sémáját követi, a mezőket nem kell megfeleltetni. Az áfakulcs, a nettó és a bruttó eladási ár külön elemben szerepel benne, így az import beállítása nem tudja félreárazni. Az Ön beszerzési ára és az ajánlott eladási ár is külön elemben van, az utóbbit szabadon átírja.
4. A Shoptet-csomagja szerint naponta egyszertől tizenhatszorig frissíthet. A teljes import éjszaka fut, a csak készlet- és árfrissítés napközben is, és ahhoz ugyanezt a linket adja meg.

Shopify

1. A fiókjában másolja ki a Shopify-import (CSV) linket.
2. Egyszeri feltöltéshez töltse le a fájlt, majd a Shopify adminjában: Products → Import.
3. Ütemezett frissítéshez app kell, mert a Shopify magától nem tud URL-ről importálni. A Stock Sync és a Products Import Wizard is elfogadja ezt a linket, és a teljes XML-t is, saját mező-megfeleltetéssel.
4. Az oszlopok a Shopify saját sémáját követik. A Price oszlop az ajánlott fogyasztói ár, a Cost per item az Ön beszerzési ára, így a Shopify magától számol árrést. A terméket az URL handle oszlop azonosítja. Ha egy terméknek több képe van, a további képek külön sorban jönnek, ez a Shopify importjának szokott formája.

Unas

1. A fiókjában másolja ki az Unas-import (CSV) linket, és töltse le a fájlt.
2. Unas adminban: Termékek → Termék adatbázis → Import, feltöltés típusa: Semmit se töröljön. A fájl az Unas saját import-sémáját követi, a mezőket nem kell megfeleltetni.
3. A Nettó ár és a Bruttó ár az ajánlott fogyasztói ár, ezt Ön szabadon átírja. Az Ön beszerzési nettó ára az Adat 3 mezőben van.
4. Az Unas cikkszáma csak betűt, számot, kötőjelet és aláhúzást enged. Ahol a mi cikkszámunkban pont, perjel vagy szóköz van, ott a fájlban aláhúzás áll, és az eredeti cikkszám az Adat 1 mezőben van. Rendeléskor bármelyik alakot elfogadjuk.
5. A képek a Kép link mezőben jönnek, az Unas ütemezve tölti át őket. Ez csak új terméknél működik, a meglévő képet nem cseréli.
6. Időzített frissítéshez az Unas ügyfélszolgálata köti be a forrást, ehhez a Teljes adat (XML) linket adja meg nekik.

ShopRenter

1. A fiókjában másolja ki a ShopRenter-import (XML) linket.
2. ShopRenter adminban: Beállítások → Import és export → Külső XML/CSV import, forrásnak ez a link. A fájl a ShopRenter saját gépi mezőneveit használja, a mező-megfeleltetés egy az egyben.
3. Időzítse a frissítést: a Gold és Platinum csomagban tíz perctől hetenteig választható.
4. A termék-azonosító a cikkszám, erre frissít. Az ár az ajánlott fogyasztói ár, ezt Ön szabadon átírja vagy árszorzóval kezeli.
5. Képet ez a fájl nem visz, mert a ShopRenter külső képlinket nem jelenít meg. A képeket egyszer töltse fel a Teljes adat (XML) kép-linkjeiből vagy a Marketing-anyagok csomagból.

Octopus8 (E-beszerző)

Ha az Octopus8 vállalatirányítási rendszert használja, a beszállítói kapcsolatnál nem kell fájlt feltölteni: az Octopus maga húzza le tőlünk az öt fájlt. A beszállítói kapcsolat beállításánál a betöltendő fájl neve legyen a teljes URL, tokennel az útvonalban:

• …/octopus/<token>/cikklista.xml törzsadat
• …/octopus/<token>/arlista.xml árak az Ön árszintjén
• …/octopus/<token>/keszletvalt.xml szabad készlet
• …/octopus/<token>/keszletenlevocikkek.xml csak a készleten lévők
• …/octopus/<token>/vonalkodok.xml EAN-ok

Betöltési mód: Mindig teljes lista. A cikkeket a cikkid azonosítja, ami nálunk állandó, így nem keletkezik duplikátum. A pontos linkeket kérje tőlünk, a token nélküli előtagot innen nem tesszük ki.

Kosár egy linkkel

Ha a saját rendszeréből vagy egy táblázatból rendel, nem kell átgépelnie a cikkszámokat. Készítsen egy linket a tételekkel, és a kosara nálunk már készen várja:

https://byb.hu/cart/betolt?tetelek=AK-EC-21:5,AK-USB-15:2

1. A tételeket vessző választja el, a cikkszám és a darabszám közé kettőspont, csillag, x vagy szóköz is jöhet.
2. Darabszám nélkül egy darab kerül a kosárba.
3. Amit nem viszünk, az kimarad, és a kosár oldalán kiírjuk, melyik cikkszám volt az. A többi tétel bemegy.
4. Egy linkkel legfeljebb 200 tétel adható át.
5. A saját árait belépés után látja, és a kosár túléli a belépést.

A link nem ad le rendelést és nem mutat adatot: pontosan annyit tesz, mintha kézzel írná be a cikkszámokat. A megrendelés az Ön kezében marad.

Gépi rendelés a saját rendszeréből

Ha a rendszere tud HTTP-kérést küldeni, a rendelést emberi kéz nélkül is leadhatja nálunk. Ehhez külön rendelési kulcsot adunk, ami nem azonos az árlista-linkjével: az csak olvas, ez rendel.

POST https://feed.byb.hu/partner-rendeles?t=RENDELESI-KULCS

A kérés törzse JSON, ennyiből áll:

{"hivatkozas":"PO-2026-1234","tetelek":[{"kod":"AK-EC-21","db":5}]}

1. A hivatkozas mező az Ön saját rendelésszáma, hogy a két oldalon ugyanarra tudjunk hivatkozni. Elhagyható.
2. Árat nem kell küldenie, és nem is tudunk fogadni: a tételek a saját árszintjén és a saját egyedi árain számolódnak, ugyanúgy, mint a boltban.
3. Amit nem viszünk, az kimarad, és a válaszban megírjuk, melyik cikkszám volt az. A többi tétel bekerül a rendelésbe.
4. Egy kérésben legfeljebb 200 tétel adható át.
5. A válasz megadja, mi került be, és a napi gyűjtő azonosítóját (gyujto).

A napközben beküldött tételek egy gyűjtőbe kerülnek, és a zárási időpontban abból lesz egy rendelés. Küldhet akárhány kérést egy nap, nálunk egy rendelés, egy összeszedés és egy számla lesz belőle. A zárás után érkező kérés a következő nap gyűjtőjébe megy. A rendelésszámunkat a záráskor kapja meg: az állapot-végponton a gyujto paraméterrel kérdezheti le, vagy a visszaigazoló levélben olvassa. A készlet a zárásig nincs lefoglalva; ha a záráskor egy tételre nincs elegendő szabad készlet, kollégánk kézzel rendezi, és jelentkezik.

Ha a rendszerének a beküldéskor kell a rendelésszám, kérje, és a kulcsát átállítjuk: akkor minden kérésből azonnal külön rendelés lesz.

A rendelés nálunk tervezetként áll meg, ahogy a portálon leadott megrendelés is: visszaigazoljuk, egyeztetjük a beérkezéseket, és utána válik véglegessé. Kártyás fizetés ezen az úton nincs, a számlát a megszokott módon küldjük.

Próba rendelés nélkül

POST https://feed.byb.hu/partner-rendeles/proba?t=RENDELESI-KULCS

Ugyanaz a törzs, de rendelés nem jön létre: a válasz megmondja, melyik cikkszámot ismerjük, mennyi az egységár az Ön árszintjén, van-e rá szabad készlet, és mennyi a tételek nettó összege. A bekötés tesztelésére való, bármennyiszer hívható.

A rendelés állapota

GET https://feed.byb.hu/partner-rendeles/allapot?t=RENDELESI-KULCS

Az Ön cégének utolsó ötven rendelése állapottal: tervezet, visszaigazolva, fizetve, kiszállítva. Egy rendelésre szűkítve a rendeles paraméterrel, egy napi gyűjtőre a gyujto paraméterrel. Más cég rendelését ezen az úton nem lehet elérni.

A rendelési kulcsot kérje tőlünk. Ha a bekötéshez segítség kell, írjon, és megcsináljuk Önnel együtt.

Marketing-anyagok

A fiókjában a Marketing-anyagok kártyán márkánként letölthető csomag van: logó, terméklista fotó-linkekkel és leírásokkal. A képek maguk a teljes feeddel is érkeznek, teljes felbontásban.

Ha elakad

Írjon nekünk az info@byb.hu címre, melyik rendszert köti be és hol akadt el, és segítünk a mező-megfeleltetésben is.