Tuotteen API-viestin käyttötarkoitus

Tuotteen API-viesti näyttää viimeisimmän integraatiosta tuotteelle tallennetun sanoman ja sen tallennusajan. Sen avulla voit tarkistaa, mitä tuotetietoa AI Commerce vastaanotti ja missä muodossa tieto tuli.

API-viesti ei ole tuotteen koko integraatiohistoria. Se näyttää vain viimeisimmän tallennetun sanoman, joten käytä sitä yksittäisen tuote- tai integraatio-ongelman rajaamiseen.

Avaa tuotteen API-viesti

Tuotteen API-viesti avataan Hallintapaneelin tuotteen muokkausnäkymästä.

1. Avaa Tuotteet ja valitse tarkistettava tuote.
2. Avaa tuotteen välilehti API-viesti.
3. Tarkista viestin yläpuolelta tallennusaika.

Jos tuotteelle ei ole tallennettu sanomaa, näkymässä lukee Tuotteelle ei ole tallennettua API-viestiä. Tyhjä näkymä ei todista, ettei tuotetta olisi koskaan käsitelty; se kertoo vain, ettei tuotteella ole tähän kenttään tallennettua viestiä.

Tunnista viestin muoto

API-viestin esitystapa määräytyy tallennetun sisällön perusteella. JSON-sanoma näytetään jäsenneltynä avaimina, arvoina, taulukoina ja sisäkkäisinä rakenteina. XML-sanoma näytetään muotoiltuina elementteinä, attribuutteina ja arvoina. Muu sisältö näytetään rivitettynä tekstinä.

Jäsentely muuttaa vain esitystapaa, ei tallennetun sanoman merkitystä. Tarkista aina kentän nimi, arvo ja rakenteen taso yhdessä, sillä samanniminen kenttä voi esiintyä useassa kohdassa tietosisältöä.

Varmista, että sanoma kuuluu oikealle tuotteelle

Tuotteen API-viestistä kannattaa etsiä ensin tuotenumero, SKU, integraation ulkoinen tunniste tai muu tuotteelle yksilöllinen arvo. Vertaa tunnistetta avoinna olevan tuotteen tietoihin ennen muiden kenttien tulkintaa.

Jos sanomassa oleva tunniste kuuluu eri tuotteelle, älä tee johtopäätöksiä hinnasta, nimestä tai varastosta. Kirjaa avoinna olevan tuotteen ID, sanoman tunniste ja viestin tallennusaika integraation vianhakua varten. Tarkista myös, ettei sama ulkoinen tunniste ole vahingossa liitetty useaan tuotteeseen.

Etsi tarkistettava tuotetieto

Tuotteen API-viestistä voidaan tarkistaa esimerkiksi hinta, nimi, EAN, tuotenumero tai muu integraation välittämä tuotetieto. Etsi kenttä sanomasta ja vertaa sen raakaa arvoa Hallintapaneelin tuotetietoon tai verkkokaupan näkyvään lopputulokseen.

Sanomassa näkyvä arvo osoittaa, että kyseinen arvo sisältyi viimeisimpään tuotteelle tallennettuun viestiin. Se ei yksin todista, että arvo hyväksyttiin, muunnettiin tai tallennettiin kaikkiin tuotteen lopullisiin kenttiin. Esimerkiksi verotus, valuutta, kieli, yksikkö tai integraation muunnossääntö voi selittää eron raakasanoman ja näkyvän arvon välillä.

Jos kenttä puuttuu, voit päätellä vain, ettei sitä ole viimeisimmässä tallennetussa sanomassa. Aiempi viesti on voinut sisältää kentän, koska näkymä ei säilytä viestihistoriaa.

Rajaa integraatio-ongelma API-viestillä

Tuotteen API-viesti auttaa erottamaan kolme tilannetta:

• Jos odotettu kenttä ja arvo näkyvät sanomassa mutta lopputulos on eri, tarkista AI Commercen kenttäkohdistus, muunnokset ja validointi.
• Jos viesti näkyy mutta odotettu kenttä puuttuu, tarkista lähettävän järjestelmän tietosisältö ja integraation kenttävalinta.
• Jos viestiä ei ole tai tallennusaika ei vastaa viimeisintä siirtoa, tarkista integraatioajo, tuotteen ulkoinen tunniste ja mahdollinen siirtovirhe.

Ota vianhakuun mukaan tuotteen ID, viestin tallennusaika, sanomasta löytyvä ulkoinen tunniste ja täsmällinen kenttä, jota tarkistat. Älä liitä tukipyyntöön salaisuuksia, henkilötietoja tai koko tietosisältöä, jos ongelman osoittamiseen riittää rajattu kenttä ja arvo.

Muista API-viestin rajat

Tuotteen API-viesti kertoo viimeisimmästä tuotteelle tallennetusta integraatiosanomasta. Se ei kerro kaikkien aiempien sanomien sisältöä, integraatioajon koko tulosta tai sitä, miksi yksittäinen arvo mahdollisesti hylättiin myöhemmässä käsittelyssä.

Käytä API-viestiä ensimmäisenä todisteena siitä, mitä tuotteelle saapui. Vahvista lopullinen tallennus tuotteen nykyisistä kentistä ja tarvittaessa integraation lokeista. Sanoman kenttien nimet ja rakenne riippuvat käytetystä ERP-, PIM- tai muusta integraatiosta.