Рекомендований робочий процес

Дотримуйтесь цього робочого процесу перед створенням, редагуванням або публікацією пропозицій.

Мета — уникнути дублікатів пропозицій, невалідних даних, неповних перекладів і небезпечної публікації.

Стандартний робочий процес каталогу

1. Визначте автентифіковану компанію
   Викличте whoami, щоб підтвердити компанію та доступні scope.

2. Ознайомтеся з керівництвом каталогу
   Викличте catalog-readme перед мутацією даних каталогу.

3. Перевірте підтримувані мови
   Викличте get-supported-languages перед створенням перекладів.

4. Шукайте перед створенням
   Викличте list-offerings, використовуючи будь-яку доступну назву, SKU, бренд, URL або ідентифікатор.

5. Створіть або оберіть пропозицію
   Створюйте нову чернетку лише тоді, коли жодна існуюча пропозиція не є відповідним варіантом.

6. Заповніть основні поля
   Використовуйте new-offering для початкового створення або update-offering-core для скалярних полів основною мовою.

7. Додайте переклади пропозиції
   Використовуйте upsert-offering-translations для підтримуваних мов (крім основної).

8. Додайте базові атрибути
   Використовуйте upsert-offering-attributes для фактичних атрибутів порівняння покупцями.

9. Додайте переклади атрибутів
   Використовуйте upsert-offering-attribute-translations для кожного атрибута, що потребує перекладених міток, описів або міток значень.

10. Перевірте готовність до публікації
    Завжди викликайте check-offering-publish-readiness перед публікацією.

11. Публікуйте лише за готовністю
    Викликайте publish-offering лише тоді, коли готовність повертає publishable: true.

12. Виправляйте та повторюйте за потреби
    Якщо готовність повертає помилки, виправте чернетку та знову перевірте готовність.

Робочий процес створення пропозиції

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

Викликайте publish-offering лише тоді, коли публікацію було запитано та готовність підтверджена.

Робочий процес редагування пропозиції

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

Якщо запиту можуть відповідати кілька пропозицій, нічого не мутуйте. Попросіть користувача обрати правильну пропозицію.

Правила перекладу

• Не включайте основну мову пропозиції до перекладів.
• Використовуйте лише підтримувані мовні коди.
• Переклади пропозицій є адитивними: мови, включені до виклику, замінюються, а мови, не включені, зберігаються.
• Перед публікацією всі підтримувані мови (крім основної) мають бути наявні.

Правила атрибутів

• name атрибута є стабільним машинним ключем.
• Використовуйте той самий name для оновлення існуючого атрибута.
• Якщо атрибут має unit, його value має бути числом.
• Якщо атрибут має valueLabel, його value має бути рядком.
• Якщо атрибут має description, для публікації потрібні перекладені описи.
• Якщо атрибут має valueLabel, для публікації потрібні перекладені мітки значень.

Безпечна поведінка

Не вигадуйте факти про продукти, коди категорій, коди HS, походження, сертифікати, кількості, ціни або технічні специфікації.

Якщо вихідні дані є неповними, залиште пропозицію як чернетку та повідомте, чого не вистачає.