Skip to main content
EtusivuBlogiOppaatMiten tilauspohjaiset verkkokauppabrändit voivat seurata toistuvia lähetyksiä seuranta-API:n avulla

Miten tilauspohjaiset verkkokauppabrändit voivat seurata toistuvia lähetyksiä seuranta-API:n avulla

17TRACK

Voit seurata toistuvia lähetyksiä seuranta-API:n avulla luomalla lähetysmerkinnän jokaiselle fyysiselle paketille, yhdistämällä sen kyseisen tilausjakson toimitustilaukseen ja rekisteröimällä sen seurantanumeron, kun varastosi tai toimituskumppanisi toimittaa sen. Näytä asiakkaille API:n seurantapäivitysten avulla, missä paketti on, ja merkitse toimituspoikkeamat tiimisi käsiteltäviksi. Säilytä tilauksen tunnus jaksojen välisenä linkkinä, äläkä käytä sitä paketin tunnisteena.

Miten tilausverkkokauppabrändit voivat seurata toistuvia lähetyksiä

Seuraa pakettia, älä tilausta

Tilaus kertoo, mitä asiakkaan on määrä vastaanottaa ajan mittaan. Toimitustilaus kertoo, mitä yhden jakson aikana on lähetettävä. Seurantanumero kertoo tietystä paketista. Näiden tietojen pitäminen erillään estää yhden jakson myöhästyneen lähetyksen näkymisen seuraavan jakson seurantatiedoissa.

Oletetaan esimerkiksi, että toukokuun tilauslaatikko jaetaan kahdeksi paketiksi ja kesäkuun laatikko lähetetään, kun toinen toukokuun paketeista on vielä matkalla. Asiakkaan pitäisi nähdä toukokuun tilauksen alla kaksi pakettia ja kesäkuun tilauksen alla erillinen paketti. Myöhästyneen toukokuun päivityksen pitäisi vaikuttaa vain toukokuun pakettiin. Jos lähetät korvaavan paketin, luo uusi lähetysmerkintä ja yhdistä se alkuperäiseen, jotta asiakastuki näkee, miksi molemmat ovat olemassa.

  • Tilaus: Tallenna tilauksen tunnus, jotta asiakastuki löytää asiakkaan lähetyshistorian.
  • Jakso ja tilaus: Tallenna jakson tunniste tai suunniteltu toimituspäivä, tilauksen tunnus sekä tarvittavat toimitustunnukset pakettien yhdistämiseksi oikeaan tilaukseen. Älä päättele jaksoa seuranta­tapahtuman saapumispäivän perusteella.
  • Lähetys: Anna jokaiselle paketille sisäinen lähetyksen tunnus. Tallenna kuljetusyritys ja seurantanumero, asiaankuuluva toimitusviite sekä palveluntarjoajan palauttama seurannan rekisteröintitunnus. Pidä peruutetut tarrat ja korvatut seurantanumerot poissa asiakkaan aktiivisesta näkymästä, mutta säilytä historia asiakastukea varten.

Näytä tilaussivulla pakettikohtainen eteneminen tilauksen yhteenvedon rinnalla. Jos yksi paketti on toimitettu ja toinen on matkalla, kerro se selkeästi. Näytä koko tilaus toimitettuna vasta, kun kaikki sen valmistumiseen tarvittavat paketit ovat saapuneet, huomioiden peruutetut lähetykset ja korvaavat lähetykset.

Yhdistä toimitus seuranta-API:in

  1. Rekisteröi toimitustapahtumasta. Käynnistä rekisteröinti, kun toimitusjärjestelmä, varasto tai kolmannen osapuolen logistiikkakumppani lähettää kuljetusyrityksen ja seurantanumeron. Uusintamaksu on liian aikainen vaihe: tilaus saattaa vielä odottaa lähetystä, eikä seurantanumeroa välttämättä ole olemassa.
  2. Tallenna lähetys ennen API-kutsua. Tallenna sisäinen lähetysmerkintä ja aseta rekisteröintipyyntö jonoon. Jos sama toimitusviesti saapuu kahdesti, käytä olemassa olevaa merkintää uuden paketin luomisen sijaan. Jos API-kutsu aikakatkaistaan, tarkista ennen uutta yritystä, onnistuiko alkuperäinen pyyntö, jos palveluntarjoaja tarjoaa siihen mahdollisuuden.
  3. Yhdistä päivitykset rekisteröityyn pakettiin. Käytä palveluntarjoajan rekisteröintitunnusta, jos se palautetaan päivityksissä. Muussa tapauksessa käytä palveluntarjoajan dokumentaatiossa määriteltyjä tunnisteita ja varmista tulos lähetysmerkintöjesi perusteella. Jos päivitys voisi kuulua useampaan kuin yhteen merkintään, lähetä se tarkistettavaksi sen sijaan, että kohdistaisit sen uusimpaan tilaukseen.
  4. Erota tarran luominen kuljetuksesta. Seurantanumero voi olla olemassa ennen kuin kuljetusyritys on vastaanottanut paketin. Käytä viestiä kuten ”Valmistellaan kuljetusyrityksen noutoa varten”, kun käytettävissäsi on vasta lähetystarra. Käytä tilaa ”Matkalla” vasta, kun kuljetusyrityksen tiedot tukevat sitä.

17TRACK Tracking API on yksi vaihtoehto tähän ratkaisuun. Sen kehittäjädokumentaatio on viite seurantanumeroiden rekisteröintiin ja seurantapäivitysten vastaanottamiseen. Käytä näitä päivityksiä pakettimerkinnän ylläpitämiseen järjestelmässäsi; pidä jakson kohdistaminen, tilauksen valmistuminen ja asiakasilmoitusten säännöt verkkokauppasovelluksessasi. Testaa ennen käyttöönottoa oikeiden kuljetusreittiesi ja toimituskumppaniesi paketeilla sen sijaan, että luottaisit pelkkään kuljetusyritysten luetteloon.

Tee päivitysten käsittelystä turvallista myös toistettaessa

Jos palveluntarjoajasi tarjoaa webhookeja, käytä niitä päivitysten vastaanottamiseen sen sijaan, että kyselisit jatkuvasti jokaisen paketin tietoja. Webhook on HTTP-pyyntö, jonka palveluntarjoaja lähettää sovelluksellesi. Noudata palveluntarjoajan varmennusvaatimuksia, tallenna hyväksytyt hyötykuormat pysyvästi ja kuittaa pyynnöt dokumentoitujen vastaussääntöjen mukaisesti. Suorita hitaammat toiminnot, kuten tilausnäkymien päivittäminen tai sähköpostien lähettäminen, pyyntökäsittelijän ulkopuolella.

Rakenna käsittelypolku niin, ettei toistetulla päivityksellä ole ylimääräistä vaikutusta. Jos palveluntarjoaja toimittaa pysyvät tapahtumatunnukset, käytä niitä toistojen tunnistamiseen. Jos se lähettää yksittäisten tapahtumien sijaan seurantatilannekuvia, vertaa saapuvaa tilaa ja skannaushistoriaa jo tallennettuihin tietoihin ennen toimenpiteitä. Dedupplikoi asiakasviestit erikseen: jo lähetettyä toimitusilmoitusta ei pidä lähettää uudelleen vain siksi, että samat lähetystiedot käsiteltiin kahdesti.

Pidä skannauksen tapahtuma-aika erillään ajasta, jolloin sovelluksesi vastaanotti sen. Myöhässä saapuva matkalla-tilan skannaus voi kuulua paketin historiaan korvaamatta uudempaa toimitettu-tilaa. Älä kuitenkaan oleta, että jokainen oikeellinen muutos vie pakettia eteenpäin. Kuljetusyrityksen korjaus tai palautus lähettäjälle -päivitys saattaa edellyttää näytettävän tilan muuttamista. Jos uudet tiedot ovat ristiriidassa tallennetun tilan kanssa etkä pysty määrittämään, kumpi on oikein, siirrä lähetys tarkistusjonoon.

Tarkista säännöllisesti avoimet lähetykset, jotka saattavat tarvita huomiota: vielä odottavat rekisteröinnit, paketit, joista ei ole ensimmäistä skannausta odotetun luovutuksen jälkeen, sekä lähetykset, joiden seuranta on hiljentynyt. Jos API tukee hakua tai päivitystä, käytä sitä valikoivasti palveluntarjoajan rajojen puitteissa. Tarkista eri kuljetusyritysten ja varastojen muodostama kokonaiskuva ennen eskalointia. Jos päivitykset loppuvat samanaikaisesti monista toisiinsa liittymättömistä lähetyksistä, tutki integraatio ennen yksittäisten toimitustapausten avaamista.

Muunna seurantatiedot hyödyllisiksi asiakasviesteiksi

Asiakkaat tarvitsevat harvoin sähköpostia jokaisesta skannauksesta. Aloita viesteistä, jotka liittyvät johonkin, mitä heidän tarvitsee tietää tai tehdä: paketti on saapunut kuljetusyrityksen verkostoon, toimitusyritys edellyttää toimenpiteitä tai kuljetusyritys ilmoittaa toimituksesta. Näytä tilausviite ja asiaankuuluva laatikko tai jakso, jotta tilaajat tietävät, mistä lähetyksestä viestissä on kyse. Jos tilaus on jaettu, yksilöi paketti ja kerro selvästi, onko tilauksen loppuosa vielä matkalla.

  • Tarra luotu, ei skannausta: Tarkista odotettu luovutus varaston tietojen perusteella. Jos luovutusikkuna on päättynyt, pyydä toimitustiimiä vahvistamaan, lähtikö paketti laitoksesta, ennen kuin kerrot asiakkaalle sen viivästyvän kuljetuksessa.
  • Seuranta ei etene: Käytä reittiä ja palvelua vastaavia raja-arvoja yhden kaikille paketeille tarkoitetun ajastimen sijaan. Rajat ylittävissä lähetyksissä tarkista viimeisin kuljetustapahtuma ennen kuin päätät ottaa yhteyttä asiakkaaseen tai eskaloida asian.
  • Epäonnistunut toimitusyritys tai nouto vaaditaan: Kerro asiakkaalle tarvittava toimenpide, jos kuljetusyritys antaa selkeät ohjeet. Jos tapahtuma on epäselvä, ohjaa tapaus asiakastuelle sen sijaan, että arvaisit uuden toimituspäivän tai noutopaikan.
  • Merkitty toimitetuksi, mutta ei vastaanotettu: Säilytä kuljetusyrityksen ilmoittama tila ja avaa erillinen tukipyyntö. Tukiprosessisi pitäisi erottaa asiakkaan ilmoitus kuljetusyrityksen korjauksesta.

Anna asiakastuelle yksi näkymä jaksosta, tilauksesta, pakettihistoriasta ja jo lähetetyistä viesteistä. Nimeä jokaiselle poikkeamalle vastuuhenkilö ja seuraava toimenpide. Toimitustiimi voi tutkia puuttuvan luovutuksen, logistiikka voi selvittää kuljetusyrityksen poikkeaman ja asiakastuki voi hoitaa viestinnän asiakkaan kanssa. Seurantatila kuvaa pakettia; se ei päätä, kuuluuko asiakkaalle korvaava lähetys tai hyvitys.

Testaa päällekkäisyys ennen käyttöönottoa

Aloita yhdestä toimituskumppanista ja lähetysjoukosta, joka vastaa sen todellista tilausten lähettämistapaa. Sisällytä jakso, jossa on useita paketteja, mitätöity tarra, korvaava lähetys sekä vanhempi edelleen avoin lähetys seuraavan jakson lähetessä. Toista sitten tarkoituksella kaksois-webhook ja toimita vanhempi tapahtuma uudemman jälkeen. Tarkista pakettimerkintä, asiakkaan tilaussivu, asiakastuen näkymä ja ilmoitusloki. Pelkkä onnistuneen API-vastauksen varmistava testi voi jättää huomaamatta kalleimman virheen: väärän tilauksen päivittämisen tai väärälle asiakkaalle viestimisen.

Seuraa rekisteröintivirheitä, onnistuneesti rekisteröityjen kelvollisten pakettien osuutta, odotettua myöhemmin tehtyjä ensimmäisiä skannauksia sekä kohdistamattomia päivityksiä. Jos seuraat päivitysviivettä, erota kuljetustapahtuman ja sen vastaanottamisen välinen aika ajasta, jonka oma järjestelmäsi käyttää sen käsittelyyn. Näin voit päättää, tutkitko kuljetusyrityksen tietosyötettä, webhook-päätepistettäsi vai sovelluksesi sisäistä jonoa.

Laajenna uusille reiteille, kun pystyt vastaamaan jokaisen paketin osalta kolmeen kysymykseen: Mihin jaksoon se kuuluu? Mitä kuljetusyritys ilmoitti viimeksi? Kuka toimii, jos päivitys puuttuu tai on virheellinen? Jos jokin vastaus on epäselvä, korjaa tietojen yhdistäminen tai poikkeamaprosessi ennen uusien ilmoitussääntöjen lisäämistä.

UKK

Voiko seuranta-API kertoa asiakkaille, milloin heidän seuraava tilauslaatikkonsa lähetetään?

Käytä seuraavan suunnitellun lähetyspäivän määrittämiseen tilaustasi ja toimitusjärjestelmääsi. Seuranta-API on tarkoitettu tietylle paketille sen jälkeen, kun seurantatiedot ovat olemassa. Suunniteltu lähetyspäivä, kuljetusyrityksen toimitusarvio ja vahvistettu toimitus ovat eri tietoja, ja ne pitäisi merkitä erikseen.

Mitä jos varasto korvaa seurantanumeron sähköpostin lähettämisen jälkeen?

Merkitse vanha tarra korvatuksi ja yhdistä uusi seurantanumero samaan tilaukseen. Jos sähköpostisi ohjaa tilaustason seurantásivulle, päivitä sivu, jotta asiakas löytää aktiivisen paketin ilman alkuperäistä kuljetusyrityksen linkkiä. Lähetä korjaus, kun muutos vaikuttaa tietoihin, joiden perusteella asiakkaan on toimittava.

Mitä jos toimituskumppani lähettää seurantanumerot ilman kuljetusyrityksen koodeja?

Pyydä kumppanilta yhdenmukainen kuljetusyrityskenttä tai yhdistämisohjeet sen toimituspalvelukoodeista. Jos API tarjoaa kuljetusyrityksen tunnistuksen, varmista ennen siihen luottamista, miten se toimii kumppanin tarroilla. Ohjaa epäselvät osumat tarkistettaviksi sen sijaan, että valitsisit kuljetusyrityksen pelkän seurantanumeron perusteella.

Tarvitaanko keskeytetyille tai ohitetuille tilauksille seurantamerkintöjä?

Jaksosta, jota ei koskaan lähetetä, ei tarvita pakettimerkintää. Jos aiempi lähetys on edelleen avoin, jatka sen seurantaa, vaikka tilaus olisi keskeytetty, ohitettu tai peruutettu. Tilauksen tila ohjaa tulevaa toimitusta; se ei kerro, mitä jo varastosta lähteneelle paketille tapahtui.

Lähteet

  • 17TRACK Tracking API — tuotekatsaus pakettien seurannan integroimiseksi liiketoimintajärjestelmiin.
  • 17TRACK Tracking API -dokumentaatio — toteutusohje seurantanumeroiden rekisteröintiin ja seurantatietojen vastaanottamiseen.
  • Stripen webhook-dokumentaatio — yleisten webhook-käytäntöjen viite, kuten kaksoistapahtumien käsittely ja toimitusjärjestystä koskevien oletusten välttäminen. Noudata varmennuksessa ja kuittauksissa oman seurantapalveluntarjoajasi sääntöjä.