Skip to main content
EtusivuBlogiOppaatMiten palautusalustat käyttävät lähetysseuranta-API:a palautuslähetysten seurantaan

Miten palautusalustat käyttävät lähetysseuranta-API:a palautuslähetysten seurantaan

17TRACK

Palautusalustat käyttävät lähetysseurannan API-rajapintaa yhdistääkseen hyväksytyn palautuksen fyysiseen lähetykseen. Alusta tallentaa palautuslähetyksen kuljetusyhtiön ja seurannan tunnisteen, hakee seurantatapahtumat ja käyttää näitä tapahtumia edistymisen näyttämiseen tai operatiivisen tarkistuksen pyytämiseen. API tarjoaa lähetyksen näkyvyyden; palautusalusta vastaa edelleen palautuspyynnöstä, käytäntöpäätöksistä, varaston tarkastuksesta ja hyvitysprosessista.

Miten palautusalustat käyttävät lähetysseurannan API-rajapintaa seurantaan

Palautustoimintojen tai tuotetiimin kannalta hyödyllinen kysymys ei ole yksinkertaisesti se, voiko API näyttää seurantatilan. Olennaista on, pystyykö integraatio luotettavasti tunnistamaan oikean palautuslähetyksen, tulkitsemaan vastaanottamansa tapahtumat ja estämään seurantapäivitystä käynnistämästä väärää asiakasviestiä tai hyvitystoimenpidettä.

Mihin seuranta sopii palautusprosessissa

Palautus alkaa liiketoimintatietueena: asiakas pyytää tuotteen palauttamista ja myyjä päättää, mitä hyväksytään. Seurantatietue kuvaa eri asiaa: paketin liikkumista. Näiden kahden tietueen yhdistäminen antaa palautusalustalle vastaukset esimerkiksi siihen, näyttääkö asiakas luovuttaneen paketin kuljetukseen, liikkuuko se palautusosoitetta kohti ja onko toimitustapahtumasta ilmoitettu.

Yhteyden on oltava selkeä. Tilaus voi sisältää useita tuotteita, asiakas voi tehdä samasta tilauksesta useamman palautuksen ja yksi palautus voi sisältää useita paketteja. Alkuperäistä lähtevän lähetyksen seurantanumeroa ei pidä sekoittaa palautuksen seurantanumeroon. Käytännöllisessä tietomallissa tilaukselle, palautusvaltuutukselle, palautuspaketille, kuljetusyhtiölle ja seurantatietueelle säilytetään erilliset tunnisteet, ja niiden väliset suhteet tallennetaan.

Seurannalla on myös selkeä rajansa. Kuljetusyhtiön toimitustapahtuma voi osoittaa, että paketti on saapunut osoitteeseen tai toimipisteeseen. Se ei osoita, että varasto vastaanotti odotetun tuotteen, että tuote läpäisi tarkastuksen tai että hyvitys kuuluu maksettavaksi. Näille päätöksille tarvitaan omat todisteensa ja sääntönsä.

Integraation kulku valtuutuksesta vastaanottoon

1. Luo palautustietue ennen paketin seuraamista

Palautusalusta tallentaa ensin pyynnön, siihen liittyvät tuotteet, hyväksytyn määränpään ja sallitun ratkaisun. Jos palautuksessa käytetään myyjän myöntämää lähetystarraa, alusta voi yhdistää tarran seurannan tunnisteen palautuspakettiin. Jos asiakas järjestää lähetyksen itsenäisesti, alusta saattaa tarvita tavan kerätä ja vahvistaa kuljetusyhtiön sekä seurantanumeron ennen seurannan aloittamista.

Tässä kohdassa tietojen laatu vaikuttaa ensimmäisen kerran näkyvyyteen. Seurantanumero ilman luotettavaa paketin ja palautuksen välistä yhteyttä voi tuottaa täysin tarkan kuljetusyhtiön päivityksen väärälle palautukselle. Tiimien tulisi myös päättää, miten käsitellään korjattuja seurantanumeroita, korvaavia tarroja ja asiakkaita, jotka lähettävät saman tunnisteen kahdesti.

2. Rekisteröi lähetys tai hae se

Alusta lähettää valitun seurantapalveluntarjoajan edellyttämät tiedot lähetys tietueen luomiseksi tai hakemiseksi. Tarkat pyyntökentät ja järjestys riippuvat palveluntarjoajan dokumentaatiosta. Vähintään toteutuksen on pystyttävä luotettavasti yhdistämään palveluntarjoajan lähetysviite omaan palautuspakettitietueeseensa. Jos kuljetusyhtiön tunnistamista tarvitaan, alustan tulisi varmistaa, miten epäselvät tai tukemattomat kuljetusyhtiötiedot käsitellään, eikä olettaa, että pelkkä seurantanumero riittää.

Säilytä palveluntarjoajan vastaus, integraatiovirheet ja päivämäärä, jolloin alusta aloitti seurannan. Hyväksytty pyyntö ei välttämättä tarkoita, että kuljetusyhtiö on skannannut paketin. Ennen ensimmäistä skannausta asiakasnäytössä saattaa olla tarpeen ilmoittaa, että seuranta odottaa päivitystä, eikä että palautus on kuljetuksessa.

3. Vastaanota päivitykset menettämättä alkuperäistä tapahtumaa

API-rajapinnasta riippuen päivitykset voivat saapua webhookin kautta, ne voidaan hakea polling-kyselyillä tai käyttää muuta dokumentoitua menetelmää. Integraation tulisi säilyttää palveluntarjoajan raakatapahtumatiedot palautusalustassa näytettävän yksinkertaistetun tilan rinnalla. Hyödyllisiä kenttiä voivat olla tapahtuman kuvaus, tapahtuma-aika, sijainti silloin kun se toimitetaan, kuljetusyhtiön viite ja aika, jolloin alusta vastaanotti päivityksen.

Nämä kaksi aikaa vastaavat eri kysymyksiin. Tapahtuman aikaleima kuvaa, milloin toiminnan ilmoitettiin tapahtuneen; vastaanottoaikaleima osoittaa, milloin palautusalusta sai tiedon siitä. Viiveet, toistuvat toimitukset ja väärässä järjestyksessä saapuvat viestit voivat muuten saada palautuksen näyttämään liikkuvan taaksepäin. Jos palveluntarjoaja tarjoaa tapahtumatunnisteita, käytä niitä duplikaattien poistamiseen. Jos tunnisteita ei ole, määrittele varovainen duplikaattien poistomenetelmä ja testaa sitä todellisilla integraationäytteillä.

4. Muunna seurantatapahtumat palautustiloiksi

Kuljetusyhtiön tapahtumakuvaukset eivät ole palautuskäytäntö. Palautusalusta yleensä yhdistää ne pienempään joukkoon operatiivisia tiloja, kuten luovutusta odottava, kuljetuksessa, toimituksesta ilmoitettu tai vaatii tarkistuksen. Yhdistämisessä on huomioitava tuntemattomat tapahtumat sen sijaan, että jokainen tunnistamaton päivitys tulkittaisiin hiljaisesti edistymiseksi.

Esimerkiksi ensimmäinen kuljetusyhtiön skannaus voi riittää kertomaan asiakkaalle, että paketti näyttää olevan matkalla. Se ei välttämättä riitä hyvityspäivän lupaamiseen. Toimitustapahtuma voi auttaa varastoa priorisoimaan vastaavan paketin, mutta hyvityssääntö voi silti edellyttää fyysistä vastaanottoa ja tarkastusta. Tiimien tulisi kirjata nämä erot työnkulkuun ennen tilojen yhdistämistä automaattisiin toimiin.

5. Sulje prosessi varaston todisteilla

Kun paketti saapuu, varasto tai palautuslaitos voi skannata sisäisen viivakoodin, yhdistää paketin palautusvaltuutukseen, tarkastaa sen sisällön ja tallentaa lopputuloksen. Nämä ovat palautuksenhallinnan tapahtumia, eivät kuljetusyhtiön seurantatapahtumia. Kun järjestelmät on yhdistetty, alusta voi näyttää hyödyllisemmän ketjun: lähetyksen liikkuminen, kuljetusyhtiön ilmoittama toimitus, laitoksen vastaanottama paketti ja käsittelyn valmistuminen.

Tämä ketju auttaa myös poikkeusten ratkaisemisessa. Jos seuranta ilmoittaa toimituksesta mutta varaston vastaanottotietoa ei näy, työntekijä voi tutkia määränpään, kuljetusyhtiön tapahtuman, laitoksen vastaanottojonon ja paketin tunnisteen ennen asiakasviestin tekemistä. Jos varasto vastaanottaa paketin ilman käyttökelpoista seurantahistoriaa, fyysinen vastaanotto voidaan silti tallentaa; puuttuvien seurantatietojen ei pidä poistaa riippumatonta varastotodistetta.

Mitä seurannan API voi ja ei voi kertoa alustalle

Lähetysseurannan API voi tuoda kuljetusyhtiön ilmoittaman liikkumisen toisen sovelluksen saataville palveluntarjoajan dokumentoidun kattavuuden, tapahtumien saatavuuden ja integraation toiminnan puitteissa. Se ei yksin voi vahvistaa palautuksen sisältöä tai päättää, onko myyjän käytäntö täytetty. Sillä ei myöskään välttämättä ole päivitystä ilmoitettavana ennen ensimmäistä kuljetusyhtiön skannausta.

Ero on tärkeä automaatiota suunniteltaessa. Tilat tulisi nähdä signaaleina, joilla on määritellyt käyttötarkoitukset, ei keskenään vaihdettavissa olevina todisteina. Kuljetusyhtiölle luovutuksesta kertova tapahtuma voi käynnistää edistymisilmoituksen. Toimitustapahtuma voi luoda varaston seurantatehtävän. Vahvistettu varaston vastaanotto voi siirtää palautuksen tarkastukseen. Hyvitys- tai vaihtopäätöksen tulee perustua myyjän todellisiin sääntöihin ja niiden edellyttämiin todisteisiin.

Asiakkaalle näytettävän kielen tulisi heijastaa samaa rajaa. «Kuljetusyhtiö ilmoittaa, että palautuksesi on toimitettu» on täsmällisempi kuin «Olemme hyväksyneet hyvityksesi», jos tarkastusta ei ole tehty. Samoin «Odotamme kuljetusyhtiön ensimmäistä päivitystä» on informatiivisempi kuin selittämätön tyhjä seurantapage.

Suunnittelutarkistukset, joilla vältetään ehkäistävissä olevat palautusseurannan virheet

  • Yhdistä paketitason mukaan. Testaa osittaiset palautukset, yhden valtuutuksen useat paketit, korvaavat tarrat ja samaan tilaukseen liittyvät toistuvat palautukset. Jokaisella paketilla on oltava yksiselitteinen yhteys omaan seurantatietueeseensa.
  • Määrittele tilojen etusijajärjestys. Päätä, mitä tapahtuu, jos vanhempi kuljetuksessa-tapahtuma saapuu toimitustapahtuman jälkeen. Säilytä tapahtumahistoria ilman, että näytettävää palautustilaa automaattisesti alennetaan.
  • Erota palveluntarjoajan virheet kuljetusyhtiön hiljaisuudesta. Todennusvirhe, hylätty pyyntö tai epäonnistunut webhook-käsittely on integraatio-ongelma. Se, ettei skannausta ole vielä tehty, on eri tilanne ja siitä tulee viestiä eri tavalla.
  • Varaudu duplikaatteihin ja uudelleenyrityksiin. Toimituspäivitys voi toistua. Tee tapahtumien vastaanotosta uudelleenyrityksiä kestävä ja vältä saman asiakasviestin lähettämistä tai saman tehtävän luomista kahdesti.
  • Suojaa asiakas- ja lähetystiedot. Rajoita pääsyä seurantatunnuksiin, säilytä vain työnkulun tarvitsemat tiedot ja tarkista palveluntarjoajan dokumentoidut todennus- ja turvallisuusvaatimukset ennen käyttöönottoa.
  • Säilytä manuaalinen toimintatapa. Joidenkin palautusten seurantatiedot ovat puutteellisia, myöhässä tai ristiriitaisia. Työntekijöillä on oltava tapa tutkia ja korjata palautustietue ilman kuljetusyhtiön tapahtumien keksimistä.

Nämä tarkistukset ovat hyödyllisimpiä, kun niitä testataan konkreettisilla tilanteilla yhden onnistuneen lähetyksen sijaan. Pienen testijoukon tulisi sisältää tapaus, jossa ensimmäistä skannausta ei ole, virheellinen seurantanumero, duplikaattitapahtuma, väärässä järjestyksessä saapuva tapahtuma, toimitusilmoitus ilman varaston vastaanottoa sekä varaston vastaanotto ilman vastaavaa toimitusilmoitusta. Kullekin tapaukselle tulee määritellä odotettu asiakasviesti ja työntekijän toimenpide.

API-rajapinnan valinta ja työnjaon määrittely

Aloita palautusreiteistä ja kuljetusyhtiöistä, joita yritys todella käyttää. Varmista sen jälkeen palveluntarjoajan ajantasaisesta dokumentaatiosta, miten lähetysten rekisteröinti toimii, mitä tunnisteita tarvitaan, miten päivitykset toimitetaan, mitä tapahtumatietoja julkaistaan ja miten virheitä sekä uudelleenyrityksiä käsitellään. Vahvista olennaiset kuljetusyhtiöt ja palautusreitit suoraan sen sijaan, että päättelisit ne yleisestä kuljetusyhtiöiden kattavuutta koskevasta lausumasta. Testaa edustavilla lähetyksillä ennen kuin käytät yhdistettyjä tiloja asiakasviestintään tai automaatioon.

17TRACK julkaisee Tracking API overview -yleiskatsauksen ja API documentation -dokumentaation; sen 17RETURNS product page käsittelee työnkulun palautuksenhallinnan puolta. Ne ovat hyödyllisiä lähtökohtia tiimille, joka arvioi seurannan näkyvyyttä yhdessä palautusprosessin kanssa. Molempien tuotealueiden olemassaoloa ei pidä pitää todisteena siitä, että tietty integraatio, kuljetusyhtiö, tapahtuma tai automaattinen hyvityssääntö on saatavilla. Vahvista tarkka työnkulku ajantasaisesta dokumentaatiosta ja tarvittaessa palveluntarjoajalta.

Hankintaa tai proof of concept -projektia varten pyydä palautuskäytännöstä ja varastotoiminnoista vastaavaa tiimiä tarkistamaan tilojen yhdistäminen yhdessä teknisen tiimin kanssa. Tekninen tiimi voi vahvistaa, toimittaako API käyttökelpoisia tapahtumia; operatiivinen tiimi voi vahvistaa, oikeuttavatko kyseiset tapahtumat ehdotetun toimenpiteen. Onnistunut integraatio auttaa työntekijöitä ja asiakkaita seuraamaan pakettia samalla, kun valtuutus, vastaanotto, tarkastus ja ratkaisu säilyvät erillisinä vaiheina.

Usein kysytyt kysymykset

Tarvitseeko palautus eri seurantanumeron kuin alkuperäinen tilaus?

Alustan tulisi ylläpitää erillisiä lähtevän ja palautettavan lähetyksen tietueita. Palautus kulkee yleensä erillisenä lähetyksenä, joten sen seurannan tunniste on yhdistettävä palautuspakettiin sen sijaan, että sen oletettaisiin olevan alkuperäisen tilauksen lähtevän lähetyksen tunniste. Käytettävissä olevat tunnisteet riippuvat palautuksen toimitustavasta.

Voiko seurannan API vahvistaa, että hyvitys pitäisi myöntää?

Ei. Mikään yksittäinen seurantatapahtuma ei vahvista, että palautettu tuote täyttää myyjän hyvitysehdot. Alusta voi käyttää kuljetusyhtiön tapahtumia työnkulun syötteinä, mutta hyvityskelpoisuus voi riippua myös valtuutuksesta, fyysisestä vastaanotosta, tarkastuksesta ja myyjän käytännöstä.

Mitä jos seuranta näyttää toimituksen, mutta varasto ei löydä pakettia?

Säilytä kuljetusyhtiön ilmoittama toimitustapahtuma ja varaston vastaanottotietue erillään. Tarkista ilmoitettu määränpää ja tapahtuman tiedot ja tutki sen jälkeen laitoksen vastaanotto- ja yhdistämisprosessi. Älä muunna kuljetusyhtiön toimitusta hiljaisesti vahvistetuksi varaston vastaanotoksi.

Tarvitaanko palautuslähetysten seurantaan webhookeja?

Ei välttämättä. Päivitystapa riippuu valitusta palveluntarjoajasta ja sen dokumentoiduista vaihtoehdoista. Jos webhookit ovat käytettävissä, varaudu todennukseen, uudelleenyrityksiin, duplikaattitoimituksiin ja käsittelyvirheisiin. Jos käytössä on polling, valitse palautusprosessiin ja palveluntarjoajan vaatimuksiin sopiva aikaväli ja lopetussääntö.

Milloin asiakkaan pitäisi nähdä ensimmäinen seurantapäivitys?

Se riippuu siitä, milloin kuljetusyhtiö ilmoittaa tapahtumasta ja milloin integraatio vastaanottaa sen. Tunnisteen luominen tai lähetyksen rekisteröinti voi tapahtua ennen kuljetusyhtiön skannausta. Näytä tämä ero selkeästi, jotta asiakkaat eivät tulkitse ensimmäisen päivityksen odottamista vahvistetuksi liikkumiseksi.

Lähteet