Eshop — zboží a objednávky#

Největší modul API.

Každý zdroj nabízí standardní sadu akcí

get, get-by, get-all, save, update-columns, delete, delete-all — není-li u něj uvedeno jinak. Podrobně CRUD vzor.

Zboží#

Zdroj	Poznámka
`product`	produkt
`product-variant`	varianta
`product-set`	prodejní jednotka — veřejné čtení
`product-category`	kategorie — strom, veřejné
`product-type`, `product-state`, `product-tag`	číselníky
`producer`	výrobce
`parameter`, `parameter-group`, `parameter-rule`	parametry — veřejné
`product-set-fee`, `product-set-fee-type`	poplatky
`product-set-link`, `product-set-link-type`	vazby mezi zbožím
`product-set-statistic`	statistiky

Prodává se sada, ne produkt

Cena, sklad i objednávka pracují se sadou. Produkt je jen obal. Hledáte-li cenu na produktu, nenajdete ji.

Zdroj	Poznámka
`order`	objednávka — vlastník
`order-status`	stavy
`complaint`	reklamace — vlastník
`complaint-solution`, `complaint-status`	číselníky

Zdroj	Poznámka
`shipper`, `shipper-region`, `shipper-tariff`	dopravci a tarify
`payment-method`	způsoby platby
`voucher`, `gift`	kupóny a dárky
`feed`, `feed-parameter-action`	výdeje pro srovnávače

Zdroj	Stav
`cart`	⛔ nemá HTTP akce
`statistics`	⛔ nemá HTTP akce

Košík a dokončení objednávky přes API nejde

Objednávka se zvenčí nezaloží. Vlastní cesta objednání je vnitřní a nemá HTTP obal. Přes API se objednávky jen čtou.

Totéž platí pro dostupnost, aktuální ceny, přehledy „moje objednávky“, opakování objednávky a přechod stavu.

Cena není sloupec — je to časový snímek klíčovaný datem, množstevní hranicí, skupinou uživatelů a měnou.

Vrácená cena závisí na kontextu

Přihlášený uživatel se slevovou úrovní vidí jinou cenu než anonym. Ceník z get-all bez kontextu berte jako orientační.

Stavy nesou příznaky akcí — potvrdit sklad, stornovat, odeslat e-mail.

Změna stavu spouští nevratné akce

Odpis skladu a odeslaný e-mail se zpět nevezmou.