Skip to main content
EtusivuBlogiOppaatMiten palautusalustat voivat käyttää lähetysseurannan API-rajapintoja palautuksiin ja vaihtotilauksiin

Miten palautusalustat voivat käyttää lähetysseurannan API-rajapintoja palautuksiin ja vaihtotilauksiin

17TRACK

Palautusalustat voivat käyttää lähetysten seurantaan tarkoitettuja rajapintoja yhdistääkseen palautus- ja vaihtotyönkulut reaaliaikaisiin pakettitapahtumiin. Rajapinta voi auttaa alustaa tunnistamaan, milloin palautustarra on luotu, seuraamaan lähetystä kuljetusliikenteen verkostossa, havaitsemaan toimitus- tai poikkeamatapahtumia ja käynnistämään seuraavan operatiivisen vaiheen. Tuloksena on palautusprosessi, joka on asiakkaiden helpompi ymmärtää ja kauppiaiden helpompi hallita.

How Returns Platforms Can Use Shipment Tracking APIs for Returns

Seuranta ei korvaa palautussääntöjä, varastotarkastusta, hyvityksiä tai varastonhallintaa. Se tarjoaa lähetystiedot, joiden ansiosta nämä prosessit voidaan ajoittaa paremmin ja manuaalisia tarkistuksia voidaan vähentää.

Miksi lähetysten näkyvyys on tärkeää palautuksissa

Etusijainen lähetys tähtää yleensä yhteen päätavoitteeseen: tilauksen toimittamiseen ostajalle. Palautuksella tai vaihdolla voi olla useita mahdollisia lopputuloksia. Paketti voidaan toimittaa varastoon, vastaanottaa kolmannen osapuolen käsittelypisteessä, ohjata uudelleen, viivästyttää tai merkitä toimitetuksi ennen kuin kauppias on saanut tarkastuksen päätökseen. Asiakkaiden on myös tiedettävä, liikkuuko heidän palauttamansa tuote, kun taas tukitiimien on pystyttävä vastaamaan kysymyksiin turvautumatta kuljetusliikkeiden verkkosivustoihin tai manuaalisiin seurantahakuihin.

Seurantarajapinta antaa palautusalustalle rakenteisen tavan hakea ja yhdenmukaistaa lähetystietoja kuljetusliikkeiltä. Käytettävissä olevasta rajapinnasta ja kuljetusliikkeen tiedoista riippuen näihin voivat kuulua seurantanumero, lähetyksen tila, tapahtumien aikaleimat, sijaintitiedot, arvioitu toimitusaika ja poikkeusviestit. Tarkat kentät ja päivitystiheys tulee varmistaa valitun palveluntarjoajan dokumentaatiosta sen sijaan, että niitä oletetaan.

Verkkokaupan palautustyönkulussa käytännön arvo ei ole pelkästään seurantanumeron näyttämisessä. Arvo syntyy lähetystapahtumien käyttämisestä päätösten, asiakasviestien, tapausten hallinnan ja varastokoordinoinnin lähtötietoina.

Palautus- tai vaihtotyönkulun tärkeimmät seurantatapahtumat

Palautusalustan tulee yhdistää kuljetusliikkeen tapahtumat omiin operatiivisiin tiloihinsa. Kuljetusliikkeiden terminologia ei ole aina yhdenmukaista, joten integraation tulee käyttää normalisoitua tilamallia ja säilyttää samalla alkuperäinen kuljetusliikkeen tapahtuma tarkastusta ja tukea varten.

LähetystapahtumaMahdollinen alustatoimintoAsiakkaalle näkyvä arvo
Tar­ra luotuAvaa seurantatietue ja yhdistä se palautusvaltuutukseen.Osoittaa, että palautusohjeet on annettu, mutta ei tarkoita, että paketti olisi jo liikkeellä.
Kuljetusliike vastaanotti tai ensimmäinen skannausKäynnistä kuljetuksessa-ajan seuranta ja vähennä epävarmuutta siitä, onko paketti saapunut verkostoon.Vahvistaa, että kuljetusliike on vastaanottanut paketin.
KuljetuksessaPäivitä palautuksen aikajana ja tunnista pysähtyneet lähetykset.Tarjoaa etenemistiedot ilman yhteydenottoa tukeen.
Poikkeus tai viivästysLuo hälytys, muuta odotuksia tai ohjaa tapaus tukeen.Selittää, miksi palautus ei ehkä saavu alkuperäisen odotuksen mukaisesti.
ToimitettuIlmoita vastaanottavalle tiimille ja aloita tarkastus- tai vaihtotyönkulku.Vahvistaa saapumisen ilmoitettuun määränpäähän ja tekee samalla selväksi, että tarkastus saattaa vielä olla kesken.

Nämä yhdistämiset tulee pitää erillään kauppiaan lopullisesta hyvityspäätöksestä. Toimitustapahtuma osoittaa, että kuljetusliike ilmoitti toimituksesta; se ei yksin todista, että oikea tuote palautettiin, että tuote on vahingoittumaton tai että palautus täyttää kauppiaan käytännöt.

Seurantarajapinnan yhdistäminen palautustoimintoihin

1. Luo palautuslähetyksen tietue

Kun palautus hyväksytään, palautusalustan tulee luoda tietue, joka yhdistää palautusvaltuutuksen alkuperäiseen tilaukseen, asiakkaaseen, tuotteeseen, määränpäähän ja lähetys­tunnisteeseen. Jos kyseessä on vaihto, tietueessa tulee tunnistaa myös korvaava tilaus tai toimitustoiminto. Tämä yhteys estää seurantatapahtuman tulkitsemisen erilliseksi pakettipäivitykseksi.

Alustan tulee erottaa alkuperäinen lähtevä lähetys palautuslähetyksestä. Niissä voidaan käyttää eri kuljetusliikkeitä, palvelutasoja, seurantanumeroita ja toimitusosoitteita. Yksinkertaiseen tietomalliin voivat kuulua tilaustunnus, palautustunnus, vaihtotunnus tarvittaessa, kuljetusliike, seurantanumero, suunta, nykyinen normalisoitu tila, viimeisimmän tapahtuman aika ja kuljetusliikkeen raakatapahtuma.

2. Lähetä seurantanumero rajapintaan

Integraatio lähettää kuljetusliikkeen ja seurantanumeron seurantapalveluun palveluntarjoajan tunnistautumis-, pyyntö- ja kuljetusliikkeen tunnistusvaatimusten mukaisesti. Jos järjestelmä ei pysty tunnistamaan kuljetusliikettä luotettavasti, sen tulee käyttää hyväksyttyä tunnistusmenetelmää tai pyytää kuljetusliike käyttäjältä tai kauppiaalta. Virheellinen kuljetusliikkeen yhdistäminen voi aiheuttaa viivästyneitä tai epätarkkoja tuloksia.

Tässä vaiheessa alustan tulee tallentaa, milloin seurantapyyntö luotiin ja hyväksyikö, hylkäsikö vai eikö rajapinta vielä pystynyt tunnistamaan lähetystä. Rajapinnan hyväksymä pyyntö ei ole sama asia kuin kuljetusliikkeen skannaus. Näitä tiloja ei tule yhdistää käyttöliittymässä.

3. Vastaanota päivityksiä kyselyillä tai webhookeilla

Seurantapalveluntarjoajat tukevat yleensä yhtä tai useampaa menetelmää myöhempien tapahtumien hankkimiseen. Alusta voi hakea päivityksiä kyselyillä, vastaanottaa push-ilmoituksia tai käyttää näiden yhdistelmää palveluntarjoajan dokumentaation ja vaaditun viiveen mukaan. 17TRACK API -dokumentaatio on oikea paikka tarkistaa sen nykyinen integraatiomalli, tuetut pyyntömallit ja toteutusvaatimukset.

Käytetystä menetelmästä riippumatta alustan tulee tehdä päivityksistä idempotentteja. Sama tapahtuma voidaan toimittaa useammin kuin kerran, vastaanottaa väärässä järjestyksessä tai kuljetusliike voi muuttaa sitä. Tallenna tapahtumatunniste, kun se on saatavilla, vertaa tapahtumien aikaleimoja ja säilytä historia sen sijaan, että korvaisit kaikki aiemmat tilat.

4. Normalisoi tapahtumat liiketoimintatiloiksi

Kuljetusliikkeiden tilat on suunniteltu kuljetustoimintoihin, eivät välttämättä palautuspäätöksiä varten. Palautusalusta voi yhdistää ne esimerkiksi seuraaviin tiloihin: tarra myönnetty, odottaa jättämistä, kuljetuksessa, viivästynyt, toimitettu, toimituspoikkeus ja edellyttää selvitystä. Yhdistämisen tulee säilyttää epävarmuus. Esimerkiksi ”toimitettu” voi siirtää tapauksen tilaan ”odottaa tarkastusta”, ei suoraan tilaan ”hyvitys hyväksytty”.

Liiketoimintasääntöjen tulee huomioida myös puuttuvat tai ristiriitaiset tapahtumat. Paketti, josta ei ole tullut uutta skannausta useaan päivään, voi edellyttää sisäistä hälytystä, mutta sitä ei tule automaattisesti käsitellä kadonneena, elleivät kauppiaan käytäntö ja kuljetusliikkeen prosessi tue tätä johtopäätöstä.

5. Käynnistä operatiiviset ja asiakastoiminnot

Kun normalisoidut tapahtumat ovat saatavilla, alusta voi soveltaa sääntöjä. Ensimmäinen kuljetusliikkeen skannaus voi lähettää asiakkaalle vahvistuksen. Toimituspoikkeus voi luoda tukitehtävän. Toimitustapahtuma voi ilmoittaa palautusvarastolle paketin etsimisestä. Vaihdoissa yritys voi päättää, vapautetaanko korvaava tuote ensimmäisen skannauksen, toimituksen vai tarkastuksen jälkeen. Päätös riippuu riskistä, varastosta ja käytännöistä; seurantatiedot voivat ohjata päätöstä, mutta eivät voi määrittää sitä yleispätevästi.

Ilmoituksissa tulee käyttää selkeää kieltä ja kertoa seuraava odotettu vaihe. Asiakkaan tulee pystyä erottamaan toisistaan ”kuljetusliike on vastaanottanut palautuksesi”, ”kauppias on tarkastanut palautuksesi” ja ”hyvityksesi on maksettu”. Nämä ovat eri tapahtumia, joista vastaavat prosessin eri osat.

Seurantatietojen käyttö vaihdoissa

Vaihtotyönkuluissa on yksi lisäriippuvuus: korvaava tuote voidaan joutua lähettämään ennen kuin palautettu tuote on saapunut perille. Seurantaa käyttävä palautusalusta voi ylläpitää kahta toisiinsa liittyvää lähetys­tietuetta: saapuvaa palautusta ja lähtevää korvaavaa lähetystä. Niiden yhdistäminen antaa tukihenkilöille kattavamman kuvan vaihdosta.

Hyödyllisiä vaihtosääntöjä voivat olla:

  • Älä ilmoita korvaavaa tuotetta lähetetyksi ennen kuin toimitusjärjestelmä vahvistaa tämän tilan.
  • Näytä palautuksen ja korvaavan lähetyksen aikajanat erikseen, vaikka ne kuuluisivat samaan vaihtotapaukseen.
  • Ilmoita tuelle, kun palautus on viivästynyt mutta korvaava tuote on jo toimitettu.
  • Pidä asiakkaan kelpoisuuspäätös erillään kuljetusliikkeen toimitustilasta.
  • Tallenna, mikä tapahtuma aiheutti automaattisen toiminnon, jotta tiimi voi tarkastaa tai peruuttaa sen.

Tämä lähestymistapa vähentää yleistä sekaannusta: korvaavan tuotteen toimitusta ei pidetä todisteena alkuperäisen palautuksen valmistumisesta. Nämä kaksi lähetystä voivat edetä itsenäisesti ja edellyttää erilaisia ratkaisuja.

17TRACKin rooli

17TRACK julkaisee kehittäjäintegraatioita varten erillisen Tracking API -rajapinnan ja tarjoaa myös palautuksiin keskittyvän 17RETURNS-tuotteen. Näitä tuotteita tulee arvioida sen mukaan, minkä roolin kauppias tarvitsee täyttää. Seurantarajapinta on olennainen, kun palautusalusta tarvitsee lähetystiedot omaan työnkulkuunsa tai sovellukseensa. Palautustenhallintatuote on olennainen, kun yritys tarvitsee laajemman prosessin palautusten aloittamiseen, järjestämiseen ja hallintaan.

Virallisia 17TRACK-materiaaleja tulee käyttää nykyisen rajapintakäyttäytymisen, tuettujen kuljetusliikkeiden ja integraatioiden tietojen, tunnistautumisvaatimusten sekä tuotekohtaisten rajoitusten varmistamiseen ennen toteutusta. 17RETURNS-tuotesivu ja 17RETURNS Shopify -listaus tarjoavat tuotetietoa, kun taas API-dokumentaatio on sopivampi lähde teknisiä integraatiopäätöksiä varten. Kauppias, joka käyttää jo omaa palautusalustaa, voi käyttää rajapintaa tietokerroksena; kauppiaan, joka etsii hallinnoitua palautustyönkulkua, tulee arvioida itse palautustuotetta eikä olettaa, että pelkkä rajapinta tarjoaa nämä toiminnot.

Toteutuksen tarkistukset ennen julkaisua

Proof of concept -toteutuksessa tulee käyttää todellisia palautustilanteita eikä vain onnistunutta kuljetuksessa olevaa esimerkkiä. Testaa vähintään yksi kotimainen palautus, yksi rajat ylittävä palautus, jos se on liiketoiminnan kannalta olennainen, viivästynyt lähetys, toimituspoikkeus, toimitettu paketti, päällekkäinen päivitys sekä seurantanumero, jota ei voida tunnistaa heti.

Toteutustiimin tulee varmistaa seuraavat asiat:

  • Mitä kuljetusliikkeitä ja palveluja kauppiaan palautusreiteillä tarvitaan ja miten kyseiset kuljetusliikkeet tunnistetaan.
  • Mitä tapahtumia kustakin olennaisesta kuljetusliikkeestä on saatavilla ja vaihteleeko tapahtuman tarkkuus määränpään mukaan.
  • Kuinka usein päivitykset haetaan ja miten alusta käsittelee API-virheet, nopeusrajoitukset ja tilapäiset käyttökatkot.
  • Miten päällekkäiset, myöhästyneet, puuttuvat tai väärässä järjestyksessä saapuvat tapahtumat tallennetaan ja täsmäytetään.
  • Mitkä toiminnot ovat automaattisia ja mitkä edellyttävät ihmisen tarkastusta.
  • Miten asiakasviestit käännetään, brändätään, keskeytetään ja auditoidaan.
  • Miten henkilötiedot ja lähetystiedot suojataan, säilytetään ja poistetaan kauppiaan vaatimusten mukaisesti.
  • Miten järjestelmä erottaa kuljetusliikkeen toimituksen varaston vastaanotosta, tarkastuksesta, hyväksynnästä, hyvityksestä ja vaihdon toimituksesta.

Operatiivinen vastuunjako on yhtä tärkeää kuin tekninen yhteys. Logistiikkatiimien tulee määritellä tapahtumien merkitykset, tukitiimien asiakkaille näkyvät viestit, taloustiimien hyvitysten hallinta ja varastotiimien toimituksen jälkeiset toimet. Ilman näitä päätöksiä teknisesti onnistunut rajapintayhteys voi silti johtaa harhaanjohtavaan automaatioon.

Käytännöllinen päätösmalli

Käytä lähetysten seurantarajapintaa, kun palautusprosessi riippuu ajantasaisista kuljetusliikkeen tapahtumista, yrityksen on yhdistettävä useita järjestelmiä tai asiakkaat ja tukihenkilöt tarvitsevat yhteisen näkymän paketin etenemiseen. Harkitse palautustenhallinta-alustaa, kun laajempi ongelma sisältää käytäntöjen määrittelyn, palautusvaltuutuksen, tarratyönkulut, asiakasviestinnän, varaston käsittelyn ja raportoinnin. Joissakin toiminnoissa nämä kaksi kerrosta toimivat yhdessä: palautusjärjestelmä hallitsee tapausta ja seurantapalvelu toimittaa normalisoidut lähetystapahtumat.

Vahvimmassa suunnittelussa seurantaa käsitellään osana suurempaa tilakonetta. Se kertoo alustalle, mitä kuljetusliike on ilmoittanut, milloin se ilmoitettiin ja mihin lähetykseen se kuuluu. Liiketoimintasäännöt päättävät sitten, mitä seuraavaksi tulee tapahtua. Tämä erottelu tekee palautuksista ja vaihdoista läpinäkyvämpiä lupaamatta varmuutta, jota kuljetusliikkeen tiedot eivät pysty tarjoamaan.

Usein kysytyt kysymykset

Voiko seurantarajapinta vahvistaa, että hyvitys kuuluu maksaa?

Ei. Se voi ilmoittaa lähetystapahtumista, kuten vastaanotosta, etenemisestä, poikkeuksesta tai toimituksesta, kun nämä tapahtumat ovat saatavilla. Hyvitykseen oikeuttaminen riippuu yleensä myös palautuskäytännöstä, tuotteen kunnosta, tarkastuksesta, petosten torjunnasta ja kauppiaan hyväksynnästä.

Tulisiko toimitetun palautuksen käynnistää hyvitys automaattisesti?

Ei välttämättä. Toimitus tarkoittaa, että kuljetusliike ilmoitti paketin saapuneen määränpäähänsä. Kauppiaan on ehkä vielä tarkistettava tuote, määrä, kunto ja palautusvaltuutus ennen hyvityksen hyväksymistä.

Onko kysely vai webhook parempi palautusten seurantaan?

Kumpikaan menetelmä ei ole yleisesti parempi. Valinta riippuu palveluntarjoajan tukemista menetelmistä, vaaditusta päivitysnopeudesta, toteutustyöstä ja viivästyneiden ilmoitusten sietokyvystä. Jotkin alustat käyttävät push-päivityksiä ja säännöllistä täsmäytystä puuttuvien tapahtumien havaitsemiseen.

Miten vaihtoja käsittelevän alustan tulisi seurata kahta lähetystä?

Tallenna saapuva palautus ja lähtevä korvaava tuote erillisinä lähetys­tietueina, jotka on yhdistetty samaan vaihtotapaukseen. Näytä niiden tilat itsenäisesti ja määrittele säännöt, jotka estävät yhden lähetyksen tilan tulkitsemisen toisen valmistumiseksi.

Mitä tulee testata ennen seurantarajapinnan yhdistämistä?

Testaa onnistunut seuranta, viivästyneet skannaukset, poikkeukset, päällekkäiset tapahtumat, virheelliset tai tuntemattomat kuljetusliikkeen tiedot, rajat ylittävät tapaukset tarvittaessa sekä API-käyttökatkot. Testaa myös jokaista tapahtumaa seuraavat asiakasviestit ja ihmisen tarkastusta edellyttävät polut.

Lähteet