Workflow recommandé

Utilisez ce workflow avant de créer, modifier ou publier des offres.

L'objectif est d'éviter les offres en double, les payloads invalides, les traductions incomplètes et les publications non sécurisées.

Workflow standard du catalogue

1. Identifiez l'entreprise authentifiée
   Appelez whoami pour confirmer l'entreprise et les scopes disponibles.

2. Lisez l'orientation du catalogue
   Appelez catalog-readme avant de modifier les données du catalogue.

3. Vérifiez les langues prises en charge
   Appelez get-supported-languages avant de créer des traductions.

4. Recherchez avant de créer
   Appelez list-offerings en utilisant tout titre, SKU, marque, URL ou identifiant disponible.

5. Créez ou choisissez l'offre
   Créez un nouveau brouillon uniquement lorsqu'aucune offre existante ne correspond bien.

6. Écrivez les champs principaux
   Utilisez new-offering pour la création initiale ou update-offering-core pour les champs scalaires dans la langue principale.

7. Écrivez les traductions de l'offre
   Utilisez upsert-offering-translations pour les langues non principales prises en charge.

8. Écrivez les attributs de base
   Utilisez upsert-offering-attributes pour les attributs factuels de comparaison pour les acheteurs.

9. Écrivez les traductions des attributs
   Utilisez upsert-offering-attribute-translations pour chaque attribut nécessitant des étiquettes, descriptions ou étiquettes de valeur traduites.

10. Vérifiez la préparation à la publication
    Appelez toujours check-offering-publish-readiness avant de publier.

11. Publiez uniquement si prêt
    Appelez publish-offering uniquement lorsque la préparation renvoie publishable: true.

12. Corrigez et réessayez si nécessaire
    Si la préparation renvoie des erreurs, corrigez le brouillon et vérifiez à nouveau la préparation.

Workflow de création d'offre

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

N'appelez publish-offering que lorsque la publication a été demandée et que la préparation a réussi.

Workflow de révision d'offre

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

Lorsque plusieurs offres peuvent correspondre à la demande, ne modifiez rien. Demandez à l'utilisateur de choisir la bonne offre.

Règles de traduction

• N'incluez pas la langue principale de l'offre dans les payloads de traduction.
• Utilisez uniquement des codes de langue pris en charge.
• Les traductions des offres sont additives : les langues incluses dans un appel sont remplacées, et les langues non incluses sont conservées.
• Avant de publier, toutes les langues non principales prises en charge doivent être présentes.

Règles d'attributs

• Le name de l'attribut est une clé machine stable.
• Utilisez le même name pour mettre à jour un attribut existant.
• Si un attribut a unit, sa value doit être un nombre.
• Si un attribut a valueLabel, sa value doit être une chaîne de caractères.
• Si un attribut a description, des descriptions traduites sont nécessaires pour la publication.
• Si un attribut a valueLabel, des étiquettes de valeur traduites sont nécessaires pour la publication.

Comportement sécurisé

Ne pas inventer des données produits, des codes de catégorie, des codes HS, l'origine, des certifications, des quantités, des prix ou des spécifications techniques.

Lorsque les données sources sont incomplètes, laissez l'offre comme brouillon et signalez ce qui manque.