Rekommenderat arbetsflöde

Använd det här arbetsflödet innan du skapar, redigerar eller publicerar erbjudanden.

Målet är att undvika dubbletter, ogiltiga payloads, ofullständiga översättningar och osäker publicering.

Standardkatalogarbetsflöde

1. Identifiera det autentiserade företaget
   Anropa whoami för att bekräfta företaget och tillgängliga scopes.

2. Läs katalogvägledningen
   Anropa catalog-readme innan du muterar katalogdata.

3. Kontrollera språk som stöds
   Anropa get-supported-languages innan du skapar översättningar.

4. Sök innan du skapar
   Anropa list-offerings med tillgänglig titel, SKU, varumärke, URL eller identifierare.

5. Skapa eller välj erbjudandet
   Skapa ett nytt utkast endast när inget befintligt erbjudande är en bra matchning.

6. Skriv kärnfält
   Använd new-offering för initial skapande eller update-offering-core för skalärfält på huvudspråket.

7. Skriv erbjudandeöversättningar
   Använd upsert-offering-translations för stödda språk som inte är huvudspråket.

8. Skriv attributbaser
   Använd upsert-offering-attributes för faktabaserade köparjämförelseattribut.

9. Skriv attributöversättningar
   Använd upsert-offering-attribute-translations för varje attribut som behöver översatta etiketter, beskrivningar eller värdetiketter.

10. Kontrollera publiceringsberedskapen
    Anropa alltid check-offering-publish-readiness innan publicering.

11. Publicera bara om redo
    Anropa publish-offering endast när beredskapen returnerar publishable: true.

12. Åtgärda och försök igen vid behov
    Om beredskapen returnerar fel, åtgärda utkastet och kontrollera beredskapen igen.

Arbetsflöde för att skapa erbjudande

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

Anropa publish-offering bara när publicering begärdes och beredskapen godkändes.

Arbetsflöde för att revidera erbjudande

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

När flera erbjudanden kan matcha begäran, mutera ingenting. Be användaren välja rätt erbjudande.

Regler för översättningar

• Inkludera inte erbjudandets huvudspråk i översättningspayloads.
• Använd bara språkkoder som stöds.
• Erbjudandeöversättningar är additiva: språk som inkluderas i ett anrop ersätts, och språk som inte inkluderas bevaras.
• Innan publicering måste alla stödda icke-huvudspråk finnas.

Regler för attribut

• Attributets name är en stabil maskinnyckel.
• Använd samma name för att uppdatera ett befintligt attribut.
• Om ett attribut har unit måste dess value vara ett nummer.
• Om ett attribut har valueLabel måste dess value vara en sträng.
• Om ett attribut har description krävs översatta beskrivningar för publicering.
• Om ett attribut har valueLabel krävs översatta värdetiketter för publicering.

Säkert beteende

Hitta inte på produktfakta, kategorikoder, HS-koder, ursprung, certifieringar, kvantiteter, priser eller tekniska specifikationer.

När källdata är ofullständig, lämna erbjudandet som utkast och rapportera vad som saknas.