ERP-sanoman tarkistaminen Hallintapaneelissa

ERP:hen liittyvä tilaus- tai asiakassanoma näkyy tietueen API-viesti-välilehdellä. Näkymä esittää tietueeseen tallennetun sisällön luettavana JSON-, XML- tai tekstirakenteena, mutta tallennettu sanoma ei välttämättä ole ERP:n lopullinen kuittaus.

Tarkista tilauksen ERP-sanoma

Tilauksen ERP-sanoma tarkistetaan avaamalla Tilaukset reitillä /orders, valitsemalla tilaus ja avaamalla API-viesti-välilehti. Tilauksen välilehti ei sisällä vain yhtä yleistä sanomaa, vaan se erottaa tietueeseen tallennetun Saapuvan tilauksen payload -sanoman, Kuljetuksen / statuksen webhook -sanoman ja Pakkaussäännöt.

ERP-siirtoon liittyvä sisältö on tavallisesti ensimmäisessä sanomassa, mutta tunnista aina sanoman otsikko ja aikaleima ennen tulkintaa. Näkymä muotoilee kelvollisen JSON- ja XML-sisällön rakenteeksi ja näyttää muun sisällön tekstinä. Kopioi jatkoselvitykseen sanoman aikaleima, tilauksen ID, käytetty ERP ja olennainen virhekohta.

Tarkista asiakkaan ERP-sanoma

Asiakkaan ERP-sanoma tarkistetaan avaamalla Asiakkaat reitillä /customers, valitsemalla asiakas ja avaamalla API-viesti-välilehti. Asiakasnäkymä näyttää asiakkaan tietueeseen tallennetun yhden API-sanoman. Sisältö esitetään rakenteensa mukaan luettavana sanomana, eikä sitä muokata tässä välilehdessä.

Tarkista samasta asiakasnäkymästä myös asiakkaan API ID. API ID on ulkoisen järjestelmän tunniste, kun taas API-viesti on viimeisin tietueeseen tallennettu sanomasisältö. Puuttuva sanoma tai tunniste ei yksin kerro epäonnistumisen syytä. Älä kopioi API ID:tä toiselta asiakkaalta tai muuta sitä ilman ERP:stä vahvistettua oikeaa tunnistetta.

Lähetä tietue ERP:hen uudelleen

Tilauksen tai asiakkaan ERP-uudelleenlähetys tehdään tietueen toiminnolla Lähetä ERP:hen uudelleen. Varmista ennen toimintoa oikea tietue, API ID ja se, ettei ERP ole jo käsitellyt samaa tietoa. Vahvista lähetys kerran ja odota toiminnon tulos ennen sivun päivittämistä.

Uudelleenlähetys käyttää ympäristölle määritettyä ERP-käsittelijää. Onnistunut vastaus tarkoittaa, että käsittelijä vastasi 2xx-tilalla; se ei yksin todista ERP:n koko jatkokäsittelyn valmistumista. Päivitä tietuesivu ja tarkista API-viesti sekä aikaleima uudelleen. Jos sisältö ei muutu, tarkista ERP:n tila ja API-prosessijono ennen uutta lähetysyritystä.

Tarkista API-prosessijono

Jos sanomaa ei näy tietueen API-viesti-välilehdellä tai lähetys jää epäselväksi, avaa Raportit reitillä /reports ja valitse API-prosessijono. Raportti näyttää uusimmat jonotietueet ensin. Nykyiset sarakkeet ovat ID, työ-ID, API, päätepiste, metodi, luontiaika ja virhe.

Rajaa oikea rivi tilauksen tai asiakkaan tunnisteen, ajan, API:n ja päätepisteen perusteella. Virhe kertoo jonotietueeseen tallennetun virheen. Vanhan näkymän erillistä Data-saraketta ei ole nykyisessä raporttikyselyssä, joten varsinaista sanomapayloadia ei pidä luvata raportista. Käytä tietueen API-viesti-välilehteä sanoman sisällön tarkistamiseen.

Tunnista sanoman merkitys

ERP-sanoman sisältö voi olla ERP:hen lähetetty pyyntö, integraation tallentama vastaus tai muu tietueeseen liittyvä payload. API-viesti näyttää tallennetun sisällön siinä muodossa, jossa integraatio on sen kirjoittanut; välilehti ei nimeä jokaisen integraation suuntaa tai käsittelyvaihetta automaattisesti.

Tunnista sanomasta integraation nimi, päätepiste, ulkoiset tunnisteet, tila ja mahdollinen virhe. Älä oleta, että välilehden uusin sisältö on aina ERP:lle lähtenyt pyyntö. Tilauksella myös status-webhook ja pakkaussäännöt ovat erillisiä sisältöjä. Jos suunta jää epäselväksi, yhdistä sanoman aikaleima API-prosessijonon ja ERP:n lokien tapahtumiin.

Kerää tiedot jatkoselvitykseen

ERP-sanoman jatkoselvitystä varten kirjaa tilauksen tai asiakkaan ID, API ID, API-viesti-välilehden otsikko ja aikaleima sekä sanoman muoto. Kopioi virheestä olennainen kohta ilman tarpeettomia henkilötietoja tai salaisuuksia. Lisää myös ERP-käsittelijän nimi ja uudelleenlähetyksen pyyntötunniste, jos ne näkyvät.

Jos käytät API-prosessijonoa, kirjaa jonorivin ID, työ-ID, API, päätepiste, metodi, luontiaika ja virhe. Näillä tiedoilla tuki voi erottaa puuttuvan tietuesanoman, jonovirheen, ERP:n hylkäyksen ja tilanteen, jossa uudelleenlähetyspyyntö vastaanotettiin mutta jatkokäsittelyä ei ole vielä vahvistettu.