MCP: sklad a nákup zboží

Stav zásob a kniha skladových pohybů, dodavatelé zboží a jejich ceníky, objednávky u dodavatele i se změnou stavu, inventury a feedy dodavatelů s průběžnou synchronizací cen a skladu. Zásoba se nikdy nepřepisuje číslem: naskladnění, oprava, odpis, příjem dodávky i uzavření inventury přidávají skladový pohyb.

Nástroje volá klient přes server MCP na doméně obchodu, například https://muj-eshop.cz/api/mcp, a v odpovědi na tools/list dostane jen ty, na jejichž oprávnění klíč dosáhne. Jak server mluví, kdy se ptá člověka a jak se změny vracejí, popisuje článek MCP server.

U každého nástroje stojí oprávnění, které chce, jestli se server před provedením zeptá člověka a kudy, jestli volání strhne kredity obchodu nebo peníze z karty, co vrací pro deník změn a jakou větu o důsledku člověk v potvrzení uvidí. Všechno z toho se vyhodnocuje z téhož kódu, podle kterého se server rozhoduje. Popisy parametrů jsou převzaté ze schématu, které server posílá v tools/list; kde se v něm text obrací přímo k modelu, je tady převedený do vykání. Povinnost parametru platí uvnitř objektu, ve kterém parametr leží.

Před zápisem, který přepisuje nebo maže, před útratou kreditů nebo platbou kartou a před hledáním mimo obchod se server ptá člověka a do té doby neprovede nic. Nejdřív použije schválení, které pro totéž volání se stejnými hodnotami už v administraci leží schválené. Jinak se zeptá formulářem, když ho klient deklaruje a politika akce ho dovoluje; formulář potvrzuje ten, kdo drží klíč, takže před ukradeným klíčem takové potvrzení nechrání. Otázka ve formuláři nese pod nadpisem „Co se změní“ tytéž řádky jako stránka schválení. Klient s elicitací URL dostane odkaz na stránku schválení v administraci a klient bez elicitace odmítnutí approval_required s odkazem v _meta; po schválení volání zopakuje se stejnými hodnotami. Na stránce schválení rozhoduje jen přihlášený člověk, kterého u každé akce jmenuje odrážka Potvrzení přes MCP, a účet podpory SHOPZI nikdy. Když politika nedovoluje nic, co klient umí, přijde odmítnutí confirmation_required a neprovede se nic. Výsledek potvrzeného volání nese v _meta["cz.shopzi/confirmation"] údaj, že akci potvrdil člověk a kde (form nebo approval), a v obsahu českou větu pro model, u placené akce i s cenou a zůstatkem kreditů z dotazu. Na otázku formulářem je 15 minut, schválení na stránce platí 60 minut, pokud u akce není uvedeno jinak.

Zápisové nástroje vracejí v poli change_id ID záznamu v deníku změn; co pole u kterého nástroje nese, říká jeho odrážka Deník změn. Změnu z deníku vrací shopzi_undo_change podle jejího druhu: obnoví předchozí hodnoty, u skladu zapíše vyrovnávací pohyb, u běžné ceny zapíše návrat do 30denní historie cen (nic z ní nemaže) a změnu, která už opustila obchod nebo stála peníze (odeslaný e-mail, stržené kredity, platbu kartou), odmítne s vysvětlením.

shopzi_stock_report

Vrátí zásoby po variantách, fyzický stav i dostupné množství, s filtrem podle názvu, SKU a stavu zásoby a se součty nad celým výběrem. Každý řádek nese název produktu i název varianty z hodnot jejích voleb, takže varianty jde rozlišit i bez SKU. Počítá jen varianty, u kterých se zásoba vede.

• Oprávnění: stock:read, u klíče „Sklad, pohyby a nákup (čtení)“.
• Druh: čtení (readOnlyHint).
• Potvrzení přes MCP: ne.
• Kredity a platba kartou: ne.

shopzi_stock_report: parametry

• search (text; nepovinný): Hledá v názvu produktu nebo v SKU varianty.
• stockStatus (jedna z hodnot all, in, low a out; nepovinný): Stav zásoby: in = skladem, low = dochází (na nastaveném prahu nebo pod ním), out = vyprodáno, all = bez filtru. Odpovídá dlaždicím nad Skladem.
• updatedSince (text se vzorem; nepovinný): ISO datum. Jen zásoby změněné od té doby.
• limit (celé číslo od 1 do 100, výchozí 25; nepovinný): Počet položek na stránku, 1 až 100. Velká stránka se do jedné odpovědi nemusí vejít a nástroj ji pak odmítne, což stojí krok navíc: berte jen tolik položek, kolik na odpověď opravdu potřebujete.
• cursor (text; nepovinný): Průběžná pozice z předchozí odpovědi (next_cursor). Vynechte pro první stránku.

shopzi_list_inventory

Vrátí podle resource skladové pohyby i s názvem produktu a varianty, inventury, dodavatele zboží, nebo objednávky zboží u dodavatele. S id vrátí detail i s řádky: u objednávky zboží a inventury jejich položky, u dodavatele kartu s ceníkem. Feedy dodavatelů vrací i s vypnutým modulem Sklad: co obchod odebírá a může odebírat, frontu ke schválení, položky katalogu jednoho feedu (u odebíraného feedu i s prodejní cenou, kterou synchronizace zapíše podle dnešních cenových pravidel) a dropship objednávky u dodavatelů.

• Oprávnění: stock:read, u klíče „Sklad, pohyby a nákup (čtení)“.
• Druh: čtení (readOnlyHint).
• Potvrzení přes MCP: ne.
• Kredity a platba kartou: ne.

shopzi_list_inventory: oblasti

• movements
• stocktakes
• suppliers
• purchase_orders
• supplier_feeds
• feed_approvals
• feed_catalog
• feed_supplier_orders

shopzi_list_inventory: parametry

• resource (jedna z hodnot movements, stocktakes, suppliers, purchase_orders, supplier_feeds, feed_approvals, feed_catalog a feed_supplier_orders; povinný)
• status (jedna z hodnot in_progress, completed, cancelled, draft, sent, confirmed, partially_received a received; nepovinný): Filtr stavu u stocktakes a purchase_orders.
• movementType (jedna z hodnot receipt, usage, writeoff, correction, return, transfer a stocktake_adjustment; nepovinný): Jen movements: druh pohybu. receipt = naskladnění, usage = výdej nebo prodej, writeoff = odpis, correction = oprava, return = vratka, transfer = přesun, stocktake_adjustment = korekce z inventury.
• search (text; nepovinný): Hledání v názvu produktu nebo SKU (movements), v názvu dodavatele (suppliers).
• id (UUID; nepovinný): Jen purchase_orders, stocktakes a suppliers: ID z výpisu pro detail.
• limit (celé číslo od 1 do 100, výchozí 25; nepovinný): Počet položek na stránku, 1 až 100. Velká stránka se do jedné odpovědi nemusí vejít a nástroj ji pak odmítne, což stojí krok navíc: berte jen tolik položek, kolik na odpověď opravdu potřebujete.
• offset (celé číslo od 0 do 100000, výchozí 0; nepovinný): Kolik položek přeskočit. 0 = první stránka.

shopzi_adjust_stock

Zapíše jeden skladový pohyb varianty: naskladnění, opravu stavu, nebo odpis s důvodem. Zásobu nepřepisuje na číslo, přidává pohyb.

• Oprávnění: stock:write, u klíče „Sklad, dodavatelé, nákup, inventury a feedy dodavatelů (zápis)“.

• Druh: zápis, který umí přepsat nebo smazat existující data (destructiveHint).

• Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.

• Kredity a platba kartou: ne.

• Deník změn: výsledek nese change_id. ID záznamu v deníku. Předejte ho do shopzi_undo_change.

• Věta o důsledku, kterou člověk uvidí v potvrzení:

  Pohyb zůstane v historii skladu. Vrácení ho nemaže, přičte k němu opačný pohyb.

shopzi_adjust_stock: parametry

• variantId (UUID; povinný): ID varianty (UUID) z shopzi_stock_report, ne ID produktu.
• kind (jedna z hodnot receipt, correction a writeoff; povinný): receipt = naskladnění (kladné), correction = oprava stavu (kladná i záporná), writeoff = odpis (záporný).
• quantityChange (číslo; povinný): Znaménkové množství. Kladné přidává na sklad, záporné odebírá. Nula není pohyb.
• reason (jedna z hodnot damage, loss, expiry, theft, correction a other; nepovinný): Důvod odpisu. Povinný u writeoff, u ostatních pohybů se neuvádí. damage = poškození, loss = ztráta, expiry = expirace, theft = krádež, correction = oprava, other = jiné.
• notes (text; nepovinný): Poznámka k pohybu, kterou uvidí obchodník v historii skladu.
• idempotencyKey (text, 1 až 200 znaků; nepovinný): Klíč idempotence. Stejný klíč = stejný zápis: opakované volání vrátí původní výsledek a NEZAPÍŠE podruhé. Použijte vlastní náhodný řetězec pro každou zamýšlenou změnu; při opakování po chybě sítě pošlete tentýž.

shopzi_manage_supply

Spravuje dodavatele zboží a jejich ceníky, objednávky zboží u dodavatele včetně příjmu dodávky a ruční změny stavu (jen záznam, dodavateli nic neodchází), inventury včetně jejich uzavření a nákupní cenu skladové položky. Objednávku dodavateli neodešle ani nezruší. U feedů dodavatelů odebírá feed, mění jeho nastavení, mapuje kategorie dodavatele na kategorie obchodu, spravuje cenová pravidla, rozhoduje frontu ke schválení, žádá o přístup, převezme nebo vrátí pole produktu, připojí, přejmenuje a naplní vlastní feed a zapíše odpověď dodavatele k dropship objednávce (potvrzení, odeslání s číslem zásilky, nemožnost dodat, nové odeslání); míru automatizace smí jen snížit. Rozhodnutí fronty a nové odeslání objednávky dodavateli musí potvrdit člověk: automatický běh bez potvrzení je odmítne.

• Oprávnění: stock:write, u klíče „Sklad, dodavatelé, nákup, inventury a feedy dodavatelů (zápis)“.
• Druh: zápis, který umí přepsat nebo smazat existující data (destructiveHint).
• Potvrzení přes MCP: ano: formulář v klientu, který potvrdí ten, kdo drží klíč; jinak odkaz na stránku schválení přes elicitaci URL; jinak odkaz na stránku schválení v odmítnutí approval_required. Na stránce schválení rozhoduje vlastník nebo manažer obchodu.
• Kredity a platba kartou: ne.
• Deník změn: výsledek nese change_id. ID záznamu v deníku. Předejte ho do shopzi_undo_change.
• Věta o důsledku, kterou člověk uvidí v potvrzení: podle resource a operation, viz seznam níž. Oblast s vlastní větou má přednost, ostatní oblasti mají větu své operace.

shopzi_manage_supply: oblasti

• supplier (Dodavatel zboží)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• purchase_order (Objednávka zboží)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• stocktake (Inventura)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• variant_cost (Nákupní cena)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• supplier_item (Ceník dodavatele)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• feed_subscription (Odběr feedu dodavatele)

  • Věta o důsledku v potvrzení:

    Spuštěný odběr zakládá produkty a mění jejich ceny a sklad podle feedu a cenových pravidel. Co čeká na schválení, určuje úroveň odběru. Pozastavit odběr jde kdykoli.

• pricing_rule (Cenové pravidlo feedů)

  • Věta o důsledku v potvrzení:

    Pravidlo přepočítá prodejní ceny produktů odběru při příští synchronizaci, podle úrovně odběru rovnou, nebo přes frontu ke schválení. Pod nákupní cenu nic neprodá.

• feed_approval (Položka ke schválení z feedu)

  • Věta o důsledku v potvrzení:

    Schválení zapíše změnu do obchodu: zveřejní produkt, změní cenu nebo text. U objednávky dodavateli ji ODEŠLE e-mailem a dodavatel podle ní pošle zboží zákazníkovi; to vrátit nejde.

• feed_access (Žádost o přístup k dodavateli)

  • Věta o důsledku v potvrzení:

    Žádost o přístup dostane ke schválení provozovatel platformy. Dokud ji neschválí, odběr se nespustí.

• feed_lock (Převzetí polí produktu z feedu)

• own_feed (Vlastní feed)

  • Věta o důsledku v potvrzení:

    Vlastní feed z adresy se stahuje automaticky podle plánu a jeho položky vidí jen tento obchod. Smazat ho jde jen v administraci.

• feed_supplier_order (Objednávka u dodavatele (dropship))

  • Věta o důsledku v potvrzení:

    Nové odeslání pošle dodavateli skutečnou objednávku e-mailem a dodavatel podle ní pošle zboží zákazníkovi; to vrátit nejde. Potvrzení, odeslání a zamítnutí jen zaznamenají odpověď dodavatele.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_supply: operace

• create (založit)

  • Věta o důsledku v potvrzení:

    Nového dodavatele ani objednávku zboží vrátit nejde. Dodavatele jde jen deaktivovat; objednávka nese pořadové číslo dokladu a zrušit ji jde v Sklad → Objednávky zboží. Na stav skladu to nemá vliv.

• update (upravit)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• start (zahájit)

  • Věta o důsledku v potvrzení:

    Zahájenou inventuru vrátit nejde: zrušit ji může obchodník v Sklad → Inventura a do jejího uzavření se skladu nic nestane.

• count (zapsat napočítaný stav)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• receive (naskladnit dodávku)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• complete (uzavřít)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

• set_status (změnit stav objednávky)

• remove (odebrat)

• map_category (namapovat kategorii dodavatele)

  • Věta o důsledku v potvrzení:

    Naskladnění a uzavření inventury zapíšou skutečné skladové pohyby, naskladnění navíc přepočítá nákupní cenu. Vrácení pohyby nemaže, přičte k nim opačné; nákupní cenu vrátí jen tehdy, když ji mezitím nezměnil další příjem. Ruční změna nákupní ceny přepíše marži a zisk u BUDOUCÍCH objednávek; už uzavřené objednávky mají náklad zmrazený z okamžiku prodeje a nemění se.

Hodnota bez odrážky Věta o důsledku v potvrzení žádnou takovou větu nemá.

shopzi_manage_supply: parametry resource, operation a id

• resource (jedna z hodnot supplier, purchase_order, stocktake, variant_cost, supplier_item, feed_subscription, pricing_rule, feed_approval, feed_access, feed_lock, own_feed a feed_supplier_order; povinný): Čeho se změna týká. Pole i lines musí patřit k němu.
• operation (jedna z hodnot create, update, start, count, receive, complete, set_status, remove a map_category; povinný): supplier: create | update. purchase_order: create | receive | set_status. stocktake: start | count | complete. variant_cost: update. supplier_item: update | remove. feed_subscription: create | update | set_status | start | map_category. pricing_rule: create | update | remove. feed_approval: complete. feed_access: create. feed_lock: update. own_feed: create | update | receive. feed_supplier_order: update (feed_supplier_order přes feed.orderAction).
• id (text; nepovinný): ID dodavatele u update a u supplier_item, ID objednávky zboží u receive a set_status, ID inventury u count a complete, ID varianty u variant_cost. U zakládání a u start se vynechává.

shopzi_manage_supply: parametry fields a lines

• fields (objekt; nepovinný): Údaje k uložení. Vynechané pole zůstane u úpravy beze změny.
• fields.name (text; nepovinný): Dodavatel: název firmy. POVINNÝ při zakládání.
• fields.contactPerson (text nebo null; nepovinný)
• fields.email (text nebo null; nepovinný)
• fields.phone (text nebo null; nepovinný)
• fields.ico (text nebo null; nepovinný): Dodavatel: IČO.
• fields.dic (text nebo null; nepovinný): Dodavatel: DIČ.
• fields.addressStreet (text nebo null; nepovinný)
• fields.addressCity (text nebo null; nepovinný)
• fields.addressPostalCode (text nebo null; nepovinný)
• fields.bankAccount (text nebo null; nepovinný)
• fields.iban (text nebo null; nepovinný)
• fields.deliveryDays (text nebo null; nepovinný): Dny závozu jako čísla 1..7 oddělená čárkou (1 = pondělí).
• fields.notes (text nebo null; nepovinný)
• fields.minimumOrderAmount (číslo; nepovinný): Minimální objednávka v HALÉŘÍCH, celé číslo (1 000 Kč = 100000).
• fields.paymentTermsDays (číslo; nepovinný): Splatnost faktur dodavatele ve dnech.
• fields.leadTimeDays (číslo; nepovinný): Za kolik dní od objednání zboží dorazí.
• fields.isActive (true nebo false; nepovinný): false = dodavatele deaktivovat. Dodavatel se nikdy nemaže.
• fields.supplierId (text; nepovinný): Jen purchase_order + create: ID dodavatele ze shopzi_list_inventory (suppliers).
• fields.expectedDeliveryDate (text nebo null; nepovinný): Jen purchase_order: očekávané dodání, ISO datum.
• fields.variantId (text; nepovinný): stocktake + count a supplier_item: ID varianty ze shopzi_stock_report, ne ID produktu.
• fields.quantity (číslo; nepovinný): Jen stocktake + count: skutečně napočítané množství.
• fields.poStatus (jedna z hodnot sent, confirmed a received; nepovinný): Jen purchase_order + set_status. received = uzavřít částečně naskladněnou s manky. Dodavateli se nic neposílá; zrušit nejde.
• fields.supplierPriceMinor (celé číslo aspoň 0; nepovinný): Jen supplier_item: nákupní cena za kus BEZ DPH, v haléřích.
• fields.supplierSku (text nebo null; nepovinný): Jen supplier_item.
• fields.minOrderQuantity (číslo; nepovinný): Jen supplier_item: minimální odběr, výchozí 1.
• fields.isPreferred (true nebo false; nepovinný): Jen supplier_item.
• fields.feed (objekt; nepovinný): Jen zdroje feed_*, pricing_rule a own_feed.
• fields.feed.feedId (text; nepovinný): ID feedu z shopzi_list_inventory (supplier_feeds).
• fields.feed.status (jedna z hodnot active a paused; nepovinný)
• fields.feed.trustLevel (jedna z hodnot review_all, review_exceptions a autopilot; nepovinný): Míra automatizace: review_all | review_exceptions | autopilot. Agent ji smí jen SNÍŽIT.
• fields.feed.autoPublish (true nebo false; nepovinný)
• fields.feed.oosBehaviour (jedna z hodnot hide a show_unavailable; nepovinný)
• fields.feed.aiPolicy (jedna z hodnot off, review a auto_apply; nepovinný)
• fields.feed.priceChangeThresholdPct (celé číslo od 1 do 100; nepovinný)
• fields.feed.fallbackCategoryId (text nebo null; nepovinný)
• fields.feed.fxRatePpm (celé číslo větší než 0 nebo null; nepovinný): Kurz cizí měny feedu: Kč za jednotku × 1 000 000 (25,12 Kč = 25120000).
• fields.feed.brands (pole, položka: text; nepovinný): Filtr: jen tyto značky. Prázdné pole = všechny.
• fields.feed.minStock (celé číslo aspoň 0; nepovinný)
• fields.feed.requireImage (true nebo false; nepovinný)
• fields.feed.sourcePath (pole, položka: text, 1 až 200 znaků, 1 až 5 položek; nepovinný): Jen map_category: cesta kategorie dodavatele po úrovních, např. ["Dům", "Kuchyně"]; platí i pro podstrom.
• fields.feed.categoryId (UUID nebo null; nepovinný): Jen map_category: ID kategorie obchodu; null spolu se skip: false mapování zruší.
• fields.feed.skip (true nebo false; nepovinný): Jen map_category: true = zboží z té kategorie nebrat.
• fields.feed.defaultMarkupPct (číslo od 0 do 1000; nepovinný)
• fields.feed.scope (jedna z hodnot all, category a brand; nepovinný): Pravidlo: na co platí.
• fields.feed.scopeValue (text nebo null; nepovinný): Kategorie „Dům › Kuchyně“ nebo značka.
• fields.feed.markupPct (číslo od 0 do 1000; nepovinný)
• fields.feed.minMarginMinor (celé číslo aspoň 0; nepovinný): Minimální marže v haléřích.
• fields.feed.rounding (jedna z hodnot none, whole, x9, x90 a x99; nepovinný)
• fields.feed.target (jedna z hodnot catalog a wholesale; nepovinný)
• fields.feed.subscriptionId (text nebo null; nepovinný): Pravidlo jen pro jeden odběr; null = všechny.
• fields.feed.decision (jedna z hodnot approve a reject; nepovinný)
• fields.feed.catalogSupplierId (text; nepovinný)
• fields.feed.customerNumber (text nebo null; nepovinný)
• fields.feed.message (text nebo null; nepovinný)
• fields.feed.lock (pole, položka: jedna z hodnot title, description, images, category, attributes, price a wholesale_price; nepovinný)
• fields.feed.unlock (pole, položka: jedna z hodnot title, description, images, category, attributes, price a wholesale_price; nepovinný)
• fields.feed.supplierName (text; nepovinný)
• fields.feed.label (text; nepovinný)
• fields.feed.url (text nebo null; nepovinný)
• fields.feed.format (jedna z hodnot heureka_xml, google_xml, csv a custom_xml; nepovinný)
• fields.feed.body (text, nejvýš 4000000 znaků; nepovinný): Jen own_feed + receive: obsah feedu (XML nebo CSV) jako text, do 4 MB.
• fields.feed.partial (true nebo false; nepovinný): receive: jen část položek, nic se neskryje.
• fields.feed.orderAction (jedna z hodnot confirm, ship, reject, cancel a resend; nepovinný): Jen feed_supplier_order: odpověď dodavatele nebo nové odeslání.
• fields.feed.tracking (text nebo null; nepovinný): Číslo zásilky u ship.
• fields.feed.carrier (text nebo null; nepovinný)
• fields.feed.note (text nebo null; nepovinný)
• fields.unitCostMinor (celé číslo aspoň 0; nepovinný): Jen variant_cost: nákupní cena za kus BEZ DPH, v HALÉŘÍCH, celé číslo (250,50 Kč = 25050). Živí marži a zisk; minulé objednávky se tím nemění, ty mají náklad zmrazený z okamžiku prodeje.
• lines (pole objektů; nepovinný): U purchase_order + create položky objednávky (povinné). U purchase_order + receive částečná dodávka; VYNECHEJTE je, pokud dorazilo všechno objednané, naskladní se pak celý zbytek.
• lines[].variantId (text; povinný): ID varianty ze shopzi_stock_report.
• lines[].quantity (číslo; povinný): U create objednávané množství, u receive množství, které z téhle položky dorazilo.
• lines[].unitPriceMinor (číslo; nepovinný): Jen create: nákupní cena za kus BEZ DPH, v haléřích, celé číslo (250,50 Kč = 25050). U receive se neuvádí, cena je na objednávce.
• lines[].vatRate (číslo; nepovinný): Jen create: sazba DPH dodavatele v celých procentech: 21, 12 nebo 0.
• lines[].unit (text; nepovinný): Jednotka, výchozí „ks“.
• lines[].notes (text nebo null; nepovinný)

shopzi_manage_supply: parametry idempotencyKey

• idempotencyKey (text, 1 až 200 znaků; nepovinný): Klíč idempotence. Stejný klíč = stejný zápis: opakované volání vrátí původní výsledek a NEZAPÍŠE podruhé. Použijte vlastní náhodný řetězec pro každou zamýšlenou změnu; při opakování po chybě sítě pošlete tentýž.