Suositeltu työnkulku

Käytä tätä työnkulkua ennen tarjousten luomista, muokkaamista tai julkaisemista.

Tavoitteena on välttää päällekkäisiä tarjouksia, virheellisiä payloadeja, puutteellisia käännöksiä ja epäturvallista julkaisemista.

Vakio-katalogin työnkulku

1. Tunnista autentikoitu yritys
   Kutsu whoami vahvistaaksesi yrityksen ja käytettävissä olevat scopet.

2. Lue katalogin ohjeet
   Kutsu catalog-readme ennen katalogidatan muuttamista.

3. Tarkista tuetut kielet
   Kutsu get-supported-languages ennen käännösten luomista.

4. Hae ennen luomista
   Kutsu list-offerings käyttäen saatavilla olevia otsikkoa, SKU:ta, merkkiä, URL:ia tai tunnistetta.

5. Luo tai valitse tarjous
   Luo uusi luonnos vain, kun mikään olemassa oleva tarjous ei sovi.

6. Kirjoita ydinkentät
   Käytä new-offering-komentoa alkuperäiseen luomiseen tai update-offering-core-komentoa pääkielisten skalaarikenttiä varten.

7. Kirjoita tarjouskäännökset
   Käytä upsert-offering-translations-komentoa tuetuille muille kielille kuin pääkielelle.

8. Kirjoita attribuuttien perustat
   Käytä upsert-offering-attributes-komentoa faktapohjaisille ostajien vertailuattribuuteille.

9. Kirjoita attribuuttikäännökset
   Käytä upsert-offering-attribute-translations-komentoa jokaiselle attribuutille, joka tarvitsee käännettyjä nimiä, kuvauksia tai arvojen nimiä.

10. Tarkista julkaisuvalmius
    Kutsu aina check-offering-publish-readiness ennen julkaisemista.

11. Julkaise vain, jos valmis
    Kutsu publish-offering vain, kun valmius palauttaa publishable: true.

12. Korjaa ja yritä uudelleen tarvittaessa
    Jos valmius palauttaa virheitä, korjaa luonnos ja tarkista valmius uudelleen.

Tarjouksen luomisen työnkulku

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

Kutsu publish-offering vain, kun julkaiseminen on pyydetty ja valmius on hyväksytty.

Tarjouksen muokkaamisen työnkulku

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

Kun useat tarjoukset voivat vastata pyyntöä, älä muuta mitään. Pyydä käyttäjää valitsemaan oikea tarjous.

Käännössäännöt

• Älä sisällytä tarjouksen pääkieltä käännöspaketteihin.
• Käytä vain tuettuja kielikoodeja.
• Tarjouskäännökset ovat lisääviä: kutsun sisältämät kielet korvataan, ja kutsun ulkopuolelle jätetyt kielet säilytetään.
• Ennen julkaisemista kaikkien tuettujen muiden kuin pääkielen käännösten on oltava läsnä.

Attribuuttisäännöt

• Attribuutin name on vakaa koneluettava avain.
• Käytä samaa name-kenttää olemassa olevan attribuutin päivittämiseen.
• Jos attribuutilla on unit, sen value on oltava numero.
• Jos attribuutilla on valueLabel, sen value on oltava merkkijono.
• Jos attribuutilla on description, käännetyt kuvaukset tarvitaan julkaisemiseen.
• Jos attribuutilla on valueLabel, käännetyt arvojen nimet tarvitaan julkaisemiseen.

Turvallinen toimintatapa

Älä keksi tuotefaktoja, kategorikoodeja, HS-koodeja, alkuperää, sertifikaatteja, määriä, hintoja tai teknisiä tietoja.

Kun lähdedata on puutteellista, jätä tarjous luonnokseksi ja raportoi, mitä puuttuu.