Aanbevolen workflow

Gebruik deze workflow vóór het aanmaken, bewerken of publiceren van aanbiedingen.

Het doel is het voorkomen van dubbele aanbiedingen, ongeldige payloads, onvolledige vertalingen en onveilige publicatie.

Standaard catalogusworkflow

1. Identificeer het geauthenticeerde bedrijf
   Roep whoami aan om het bedrijf en de beschikbare scopes te bevestigen.

2. Lees de catalogusbegeleiding
   Roep catalog-readme aan vóór het muteren van catalogusdata.

3. Controleer ondersteunde talen
   Roep get-supported-languages aan vóór het aanmaken van vertalingen.

4. Zoek vóór het aanmaken
   Roep list-offerings aan met een beschikbare titel, SKU, merk, URL of identifier.

5. Maak een nieuw aanbod aan of kies een bestaand
   Maak een nieuw concept alleen aan wanneer er geen bestaand aanbod een goede overeenkomst vormt.

6. Schrijf kernvelden
   Gebruik new-offering voor initiële aanmaak of update-offering-core voor scalaire kernvelden in de hoofdtaal.

7. Schrijf aanbodvertalingen
   Gebruik upsert-offering-translations voor ondersteunde niet-hoofdtalen.

8. Schrijf attribuutbases
   Gebruik upsert-offering-attributes voor feitelijke vergelijkingsattributen voor kopers.

9. Schrijf attribuutvertalingen
   Gebruik upsert-offering-attribute-translations voor elk attribuut dat vertaalde labels, beschrijvingen of waardelabels nodig heeft.

10. Controleer publicatiegereedheid
    Roep altijd check-offering-publish-readiness aan vóór publicatie.

11. Publiceer alleen indien gereed
    Roep publish-offering alleen aan wanneer gereedheid publishable: true retourneert.

12. Los op en probeer opnieuw indien nodig
    Als gereedheid fouten retourneert, herstel het concept en controleer de gereedheid opnieuw.

Workflow nieuw aanbod aanmaken

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

Roep publish-offering alleen aan wanneer publicatie is gevraagd en gereedheid is geslaagd.

Workflow bestaand aanbod herzien

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

Wanneer meerdere aanbiedingen mogelijk overeenkomen met het verzoek, niets muteren. Vraag de gebruiker om het juiste aanbod te kiezen.

Vertaalregels

• Neem de hoofdtaal van het aanbod niet op in vertaalpayloads.
• Gebruik alleen ondersteunde taalcodes.
• Aanbodvertalingen zijn additief: talen die in een aanroep zijn opgenomen worden vervangen, talen die niet zijn opgenomen blijven bewaard.
• Vóór publicatie moeten alle ondersteunde niet-hoofdtalen aanwezig zijn.

Attribuutregels

• Attribuut name is een stabiele machinesleutel.
• Gebruik dezelfde name om een bestaand attribuut bij te werken.
• Als een attribuut een unit heeft, moet de value een getal zijn.
• Als een attribuut een valueLabel heeft, moet de value een string zijn.
• Als een attribuut een description heeft, zijn vertaalde beschrijvingen nodig voor publicatie.
• Als een attribuut een valueLabel heeft, zijn vertaalde waardelabels nodig voor publicatie.

Veilig gedrag

Verzin geen productfeiten, categoriecodes, GS-codes, herkomst, certificeringen, hoeveelheden, prijzen of technische specificaties.

Wanneer brondata onvolledig is, laat het aanbod dan als concept staan en rapporteer wat ontbreekt.