AI Commerce tukee nyt debug-näkymää, jonka avulla näet suoraan, missä muodossa tilaus- ja asiakassanoma on lähtenyt toiminnanohjausjärjestelmään (ERP). Tämä helpottaa ja nopeuttaa ongelmatilanteiden selvittämistä, kuten konfigurointivirheitä, toimitus- ja maksutapojen määppäykseen liittyviä virheitä sekä tilanteita, joissa ERP ei näytä tietoja odotetulla tavalla. Kun sinulla on sanoma valmiina, voit myös lyhentää ERP-toimittajan tiketin käsittelyaikaa, koska he yleensä tarvitsevat sanoman ensimmäisenä tutkittavaksi.

Mitä uusi debug-näkymä näyttää?

• Viimeisin onnistuneesti toimitettu sanoma, joka on lähetetty ERP:lle.
• Sanoman tarkka sisältö joko XML- tai JSON-muodossa riippuen siitä, mitä ERP-integraatio käyttää.
• Näkymä täydentää aiempaa tietoa, jossa on voinut näkyä esimerkiksi ERP:stä tullut virhe, ERP-ID tai tunniste, jolla tilaus/asiakas on yhdistetty ERP:hen.

Missä debug-näkymä löytyy Hallintapaneelissa?

• Customers-välilehdellä asiakaskortilla
• Orders-välilehdellä tilauskortilla

Miten debug-näkymää hyödynnetään käytännössä?

1. Avaa oikea kortti Hallintapaneelissa
   • Jos tutkit asiakastietojen siirtymistä, avaa Customers ja valitse asiakas.
   • Jos tutkit tilauksen siirtymistä, avaa Orders ja valitse tilaus.
2. Etsi debug-tieto lähetetystä sanomasta
   • Tarkista, onko sanoma XML- vai JSON-muotoinen (riippuu ERP:stä ja integraatiosta).
   • Vertaile sanoman sisältöä siihen, mitä ERP:n pitäisi vastaanottaa ja näyttää.
3. Selvitä tyypillisimmät ongelmakohdat sanomasta
   • Konfigurointivirheet (esim. puuttuvat tai väärät asetukset)
   • Toimitus- ja maksutapojen yhdistäminen eli määppäys (mapping)
   • Epäily applikaation virheellisestä toiminnasta
   • Tilanne, jossa ERP ei näytä tietoja tarkoitetulla tavalla, vaikka siirto olisi onnistunut
4. Hyödynnä sanomaa tiketeissä ja yhteistyössä
   • Kun teet tiketin ERP-toimittajalle, liitä mukaan sanoma, koska he yleensä tarvitsevat sen ensimmäisenä.
   • Sanoman toimittaminen valmiiksi voi nopeuttaa tiketin käsittelyä, koska ERP-toimittaja pääsee suoraan tutkimaan sanomaa.
   • Jos tutkit asiaa itse tai partnerin kanssa, sanoma auttaa päättelemään, missä muodossa tieto on liikkunut ja miten sen olisi pitänyt liikkua.

Mitä rajoituksia toiminnossa on?

• Järjestelmä näyttää aina vain viimeisimmän toimitetun sanoman sisällön.
• Koko sanomahistoria ei tallennu nähtäväksi debug-näkymään.

Millä integraatioilla toiminto on käytössä?

• Toiminto on aktivoitu kaikkiin toiminnanohjausjärjestelmiin, joiden rajapinnat tukevat käsittelyjonoja.
• Aluksi debug-näkymä on saatavilla asiakaskorteilla ja tilauskorteilla, mutta käyttöä saatetaan myöhemmin laajentaa myös muihin rajapintasanomiin.

Yhteenveto

Debug-näkymä tuo Hallintapaneeliin näkyviin viimeisimmän ERP:lle lähetetyn tilaus- tai asiakassanoman (XML/JSON). Kun tarkistat sanoman sisällön suoraan Orders- ja Customers-näkymistä, pystyt nopeammin paikallistamaan konfigurointi- ja määppäysvirheet sekä selvittämään tilanteet, joissa ERP:n näkymä ei vastaa odotettua. Seuraava suositeltu toimenpide on käyttää sanomaa lähtökohtana, kun vertailet ERP:n odottamaa rakennetta toteutuneeseen sanomaan.

Avainsanat

ERP debug, toiminnanohjausjärjestelmä sanoma, XML-sanoma, JSON-sanoma, Hallintapaneeli Orders, Hallintapaneeli Customers, toimitustavan määppäys, maksutavan määppäys, integraation vianmääritys, AI Commerce