Doporučený pracovní postup

Tento pracovní postup používejte před vytvářením, úpravou nebo publikováním nabídek.

Cílem je předejít duplicitním nabídkám, neplatným datovým strukturám, neúplným překladům a nebezpečnému publikování.

Standardní pracovní postup katalogu

1. Identifikujte ověřenou společnost
   Zavolejte whoami pro potvrzení společnosti a dostupných rozsahů.

2. Přečtěte si průvodce katalogem
   Zavolejte catalog-readme před úpravou dat katalogu.

3. Zkontrolujte podporované jazyky
   Zavolejte get-supported-languages před vytvářením překladů.

4. Hledejte před vytvářením
   Zavolejte list-offerings s dostupným názvem, SKU, značkou, URL nebo identifikátorem.

5. Vytvořte nebo vyberte nabídku
   Nový koncept vytvářejte pouze tehdy, když žádná existující nabídka neodpovídá.

6. Zapište základní pole
   Pro počáteční vytvoření použijte new-offering, pro skalární pole hlavního jazyka update-offering-core.

7. Zapište překlady nabídky
   Pro podporované jazyky kromě hlavního použijte upsert-offering-translations.

8. Zapište základní atributy
   Pro věcné atributy pro porovnání kupujícími použijte upsert-offering-attributes.

9. Zapište překlady atributů
   Pro každý atribut, který potřebuje přeložená označení, popisy nebo popisky hodnot, použijte upsert-offering-attribute-translations.

10. Zkontrolujte připravenost k publikování
    Před publikováním vždy zavolejte check-offering-publish-readiness.

11. Publikujte pouze pokud je připraveno
    Zavolejte publish-offering pouze tehdy, když připravenost vrátí publishable: true.

12. V případě potřeby opravte a zkuste znovu
    Pokud připravenost vrátí chyby, opravte koncept a znovu zkontrolujte připravenost.

Pracovní postup vytvoření nabídky

whoami
catalog-readme
get-supported-languages
list-offerings
new-offering
upsert-offering-translations
upsert-offering-attributes
upsert-offering-attribute-translations
check-offering-publish-readiness
publish-offering

Volejte publish-offering pouze tehdy, když bylo publikování požadováno a připravenost prošla.

Pracovní postup revize nabídky

whoami
catalog-readme
list-offerings or get-offering
update-offering-core
upsert-offering-translations
upsert-offering-attributes
upsert-offering-attribute-translations
check-offering-publish-readiness
publish-offering

Pokud může požadavku odpovídat více nabídek, nic neměňte. Požádejte uživatele, aby zvolil správnou nabídku.

Pravidla překladů

• Do překladových dat nezahrnujte hlavní jazyk nabídky.
• Používejte pouze podporované jazykové kódy.
• Překlady nabídek jsou aditivní: jazyky zahrnuté v volání jsou nahrazeny, jazyky nezahrnuté jsou zachovány.
• Před publikováním musí být přítomny všechny podporované jazyky kromě hlavního.

Pravidla atributů

• name atributu je stabilní strojový klíč.
• Pro aktualizaci existujícího atributu použijte stejný name.
• Pokud atribut má unit, jeho value musí být číslo.
• Pokud atribut má valueLabel, jeho value musí být řetězec.
• Pokud atribut má description, jsou pro publikování potřebné přeložené popisy.
• Pokud atribut má valueLabel, jsou pro publikování potřebné přeložené popisky hodnot.

Bezpečné chování

Nevymýšlejte fakta o produktech, kódy kategorií, kódy HS, původ, certifikace, množství, ceny ani technické specifikace.

Pokud jsou zdrojová data neúplná, ponechte nabídku jako koncept a nahlaste, co chybí.