Flux de lucru recomandat

Folosește acest flux de lucru înainte de a crea, edita sau publica oferte.

Scopul este de a evita oferte duplicate, payload-uri invalide, traduceri incomplete și publicări nesigure.

Fluxul standard de catalog

1. Identifică compania autentificată
   Apelează whoami pentru a confirma compania și scope-urile disponibile.

2. Citește ghidarea pentru catalog
   Apelează catalog-readme înainte de a modifica datele de catalog.

3. Verifică limbile suportate
   Apelează get-supported-languages înainte de a crea traduceri.

4. Caută înainte de a crea
   Apelează list-offerings folosind orice titlu, SKU, brand, URL sau identificator disponibil.

5. Creează sau alege oferta
   Creează un draft nou doar când nicio ofertă existentă nu este o potrivire bună.

6. Scrie câmpurile principale
   Folosește new-offering pentru crearea inițială sau update-offering-core pentru câmpurile scalare în limba principală.

7. Scrie traducerile ofertei
   Folosește upsert-offering-translations pentru limbile non-principale suportate.

8. Scrie atributele de bază
   Folosește upsert-offering-attributes pentru atribute factuale de comparare pentru cumpărători.

9. Scrie traducerile atributelor
   Folosește upsert-offering-attribute-translations pentru fiecare atribut care necesită etichete, descrieri sau etichete de valoare traduse.

10. Verifică pregătirea pentru publicare
    Apelează întotdeauna check-offering-publish-readiness înainte de publicare.

11. Publică doar dacă este pregătit
    Apelează publish-offering doar când pregătirea returnează publishable: true.

12. Corectează și reîncearcă dacă este necesar
    Dacă pregătirea returnează erori, corectează draft-ul și verifică din nou pregătirea.

Flux de creare ofertă

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

Apelează publish-offering doar când publicarea a fost solicitată și pregătirea a trecut.

Flux de revizuire ofertă

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

Când mai multe oferte pot corespunde cererii, nu modifica nimic. Cere utilizatorului să aleagă oferta corectă.

Reguli pentru traduceri

• Nu include limba principală a ofertei în payload-urile de traducere.
• Folosește doar coduri de limbă suportate.
• Traducerile ofertelor sunt aditive: limbile incluse într-un apel sunt înlocuite, iar limbile neincluse sunt păstrate.
• Înainte de publicare, toate limbile non-principale suportate trebuie să fie prezente.

Reguli pentru atribute

• name al atributului este o cheie stabilă de mașină.
• Folosește același name pentru a actualiza un atribut existent.
• Dacă un atribut are unit, value trebuie să fie un număr.
• Dacă un atribut are valueLabel, value trebuie să fie un string.
• Dacă un atribut are description, sunt necesare descrieri traduse pentru publicare.
• Dacă un atribut are valueLabel, sunt necesare etichete de valoare traduse pentru publicare.

Comportament sigur

Nu inventa fapte despre produse, coduri de categorie, coduri HS, origine, certificări, cantități, prețuri sau specificații tehnice.

Când datele sursă sunt incomplete, lasă oferta ca draft și raportează ce lipsește.