Motopoint

Dodavatel moto/čtyřkolkových doplňků (Motopoint a.s.). Feed typu MWS Light — pět samostatných paginovaných JSON endpointů (bez vazby na motorky/modely, na rozdíl od "MWS Power").

Přístup

Feed je omezen na konkrétní IP adresy — Motopoint je povolil pro ostrá data:

Implementace byla ověřena živě přes ssh cv (server je na whitelistu, vývojový stroj ne). Oproti Motopointově dokumentaci polí (viz přílohy) se realita liší ve třech bodech — všechny jsou v kódu ošetřené:

• status se vrací velkými písmeny ("SUCCESS", ne "success").
• Výchozí kategorie produktu je pole id_default_groups (množné číslo), ne id_default_group.
• images je pole objektů {"name", "path", "mtime"}, ne prosté URL stringy — použije se path.

Výstupy

Zdrojové endpointy (MWS Light)

Base URL: http://ctyrkolky-vrchlabi.mwsonline.cz/mws-api

Stránkování: první stránka je holá URL endpointu, další stránky /mws-api/<tabulka>/<číslo> (např. /mws-api/products/25). Konec je signalizován prázdným polem data.

Odpověď je JSON obálka {"status": "SUCCESS", "data": [...]} — chybová odpověď má tvar {"status": "ERROR", "message": "..."} (ověřeno živě: bez whitelistované IP endpoint vrací Account IP "..." does not exist).

Výkon: stránka products (5 000 záznamů) trvá ~25 s, stránka stock_count (20 000 záznamů) ~50 s. Guzzle klient má timeout 900 s (viz AbstractSupplier), takže by to i s více stránkami mělo v pohodě stíhat, ale je to výrazně pomalejší než ostatní dodavatelé.

Timestampové URL (?from=<unix_timestamp>) pro inkrementální stahování existují u products, prices a stock_count, ale tento import zatím vždy stahuje všechny stránky od začátku.

Pole (ověřeno živě přes ssh cv)

groups — strom kategorií: id, name, is_universal, category_1, category_2, order, childs (vnořené podřazené skupiny).

groups_goods — vazba kategorie/produkt: id, id_groups, id_goods, updated. (ověřeno, přesně podle dokumentace)

products — id (hlavní klíč napříč všemi tabulkami!), name_with_vehicle, name_without_vehicle, url, id_default_groups (množné číslo — dokumentace uváděla id_default_group), stock_number (interní kód, nezobrazovat), is_variant, stock_count/stock_external/expected_delivery (redundantní kopie skladu přímo v produktu — nepoužito, viz cross-reference na stock_count endpoint níže), desc, description_long (HTML), id_producer, producer, weight, ean, mpn, oem_numbers, other_bar_codes, vat, discontinued (Y/N, aktuálně nefiltrováno), attributes (pole objektů {"name", "value"}), icon, flags, files, images (pole objektů {"name", "path", "mtime"} — použije se path, ne prosté URL stringy), videos, sets, img (hlavní obrázek, string), img_mtime, variants, recommends, price_retail (bez DPH), price_retail_vat, price_dealer, price_without_discount.

stock_count — id, in_storage (sklad Motopoint), stock_external (text o dodací době externího dodavatele), expected_delivery. (ověřeno; central_stock z dokumentace se v živé odpovědi neobjevilo)

prices — id, price_retail, price_retail_vat, price_dealer, price_without_discount. (ověřeno, přesně podle dokumentace)

Obálka odpovědi je vždy {"status": "SUCCESS", "data": [...]} (velkými písmeny) — kód porovnává case-insensitive.

Mapování polí (products.xml)

Kategorie

groups je strom (přes childs), takže cesta ke kořeni jde přímo vyčíst rekurzivním průchodem — není potřeba dopočítávat rodiče. Pro každý produkt se breadcrumby staví ze všech skupin, ke kterým je přiřazen přes groups_goods (M:N vazba), plus jeho id_default_groups (pro jistotu, kdyby v groups_goods chyběl). Cesty se sloučí a deduplikují, kořen je vždy Motopoint (stejný vzor jako u ACI — ACI/A/B/C).

Zdroj dat pro dostupnost

Emitují se jen položky, které existují v mezipaměti products.xml.

Harmonogram

(Stejné jako u ostatních dodavatelů — Motopoint žádnou konkrétní frekvenci nepředepsal.)

Přílohy (testovací XLSX od Motopoint)

Soubory leží ve složce docs/feeds/ v repozitáři; v prohlížeči se načítají přes odkazy výše (náhled = všechny listy jako tabulky). Obsahují úplný popis polí pro tabulky groups, groups_goods, products, stock_count (Light i Power varianta).