Edasimüüjale – XML-i importimise juhend

Ostuklikki XML võimaldab importida sinu e-poodi meie tooteid, eestikeelseid tekste, pilte, hindu ja laoseise. Ligipääsu taotlemiseks kirjuta info@ostuklikk.ee, lisades ettevõtte nime, e-poe aadressi ja soovitud laovaliku.

1. Vali sobiv laovoog

Voog Sisu
Kohalik ladu Malda laos olemas olevad tooted. Shopify laonimi: Local warehouse.
Vahelaod Teiste ladude tooted. Tarneaeg üldjuhul 8–18 tööpäeva.
Kõik laod Kohaliku lao ja vaheladude tooted koos. Kogused on eraldi väljadena ja laokohtade kaupa.

Ära impordi sama toodet mitmest voost topelt. Ühisvoo kasutamisel erista kohaliku lao ja vahelao tarneinfot. Vahelao tarneaega ei tohi näidata kohalikust laost saatmise lubadusena.

2. Lisa oma isiklik XML-link impordiprogrammi

Partnerile väljastatakse lubatud voogude isiklikud lingid. Lisa link oma poe impordiprogrammi andmeallikaks. Tooterea element on products/product. Link sisaldab ligipääsuvõtit: hoia seda saladuses ja ära lisa avalikule veebilehele. Võtme lekkimisel palu see vahetada.

3. Seo andmeväljad

XML-väli Kasutus
variant_id Soovitatav püsiv imporditunnus. Kasuta tunnusega ainult Ostuklikist imporditud toodete sidumist.
product_id, sku, barcode Toote tunnus, tootekood ja vöötkood. SKU järgi sidumisel kontrolli, et kood pole tühi ega korduv.
title, description_html Nimi ja HTML-kirjeldus. Eelistatud on kehtiv eestikeelne tõlge, selle puudumisel algtekst.
vendor, product_type Tootja ja tootetüüp. Tootetüüp ei ole täielik kategooriapuu.
price Shopify tootevariandi müügihind eurodes, käibemaksuga. Sama hinnaloogika nagu senises XML-is; partnerisoodustust ega uut käibemaksu ei lisata.
compare_at_price Shopify võrdlushind, kui olemas. See ei ole partneri ostuhind.
stock Valitud voo saadaolev kogus. Ühisvoos kohaliku lao ja vaheladude summa.
local_stock, supplier_stock Ühisvoo koguste jaotus. Vahelaovoos local_stock on 0. Kohaliku lao voos neid lisavälju pole.
warehouses/warehouse Vahelao- ja ühisvoo laokohtade tunnused, nimed, kogused ja tüüp.
supplier_delivery_min_workdays, supplier_delivery_max_workdays Vahelao tarnevahemik 8–18 tööpäeva.
weight, weight_unit, weight_grams Algkaal koos ühikuga ja kaal grammides. Puuduvat kaalu ei asendata oletusega.
image, images/image Põhipilt ning kuni 20 pilti tootegalerii algusest.
product_url Ostuklikki eestikeelse tootelehe link.

4. Seadista automaatne import

Ostuklikki süsteem alustab tavapäraselt andmete uuendamist iga 30 minuti järel; suure andmemahu või tõrke korral võib valmimine kauem võtta. Seadista ka oma poe import automaatselt vähemalt iga 30 minuti järel. Need on kaks eraldi ajastust, mistõttu muutus ei pruugi jõuda sinu poodi kohe meie uuenduse valmimisel. XML-i juure generated_at näitab koostamise algusaega UTC-s.

Hinnad ja kogused uuenda igal impordil. Kirjelduste ja piltide uuendamise valik sõltub sellest, kas soovid oma muudatusi säilitada.

5. Nulli voost kadunud toodete laoseis

HTTP vea, aegumise, vigase või pooliku XML-i korral katkesta import ja säilita senised andmed. Viga ei tähenda tühja tootevalikut. Ka korrektse tühja voo korral kontrolli enne massilist nullimist selle terviklikkust. Kui importija ei toeta puuduvate toodete nullimist, tuleb sellele lisada vastav loogika enne automaatse müügi alustamist.

6. Tee proovimport

Kontrolli väikese tootevalimiga hindu, koguseid, pilte, täpitähti, variante ja tarneinfot. Kontrolli ka puuduvate toodete nullimise seadistust. Shopify ja WooCommerce vajavad XML-i lugemiseks sobivat impordirakendust või integratsiooni; konkreetsed menüüvalikud sõltuvad kasutatavast programmist.

Vead ja ligipääs

401: võti on vale, ligipääs on peatatud või voog pole partnerile lubatud. 503: XML pole valmis, on ajutiselt kättesaamatu või viimase eduka andmekogumi vanus ületab kolm tundi; proovi hiljem uuesti ja ära nulli selle vea põhjal laoseise. Selle süsteemi ligipääsuvõti ei anna ligipääsu Shopify haldusele ega tellimustele.

Küsimused: info@ostuklikk.ee.

Ostuklikki partnerite haldus

Partnerite haldus – logi sisse. Haldus on mõeldud Ostuklikki administraatorile ning nõuab haldusparooli. Edasimüüja saab oma isikliku XML-lingi Ostuklikilt.