Skip to main content
EtusivuBlogiOppaatKuinka ulkomaiset varastot voivat käyttää seuranta-API-rajapintoja paikallisten toimitusten valvontaan

Kuinka ulkomaiset varastot voivat käyttää seuranta-API-rajapintoja paikallisten toimitusten valvontaan

17TRACK

Ulkomaiset varastot voivat käyttää seuranta-API-rajapintoja paikallisten toimitusten valvontaan yhdistämällä jokaisen lähtevän paketin kuljetusyhtiöön ja seurantanumeroon, tuomalla seurantatapahtumat varasto- tai tilaustenhallintajärjestelmäänsä sekä muuttamalla toimituspoikkeamat kohdistetuiksi tehtäviksi. Hyödyllisimmässä kokoonpanossa erotetaan tarran luominen kuljetusyhtiön vastaanotosta, säilytetään lähetyshistoria ja kerrotaan operatiivisille tiimeille, mitkä paketit vaativat toimenpiteitä – ei ainoastaan sitä, mitkä paketit ovat saaneet uuden tilan.

Miten ulkomaiset varastot voivat käyttää seuranta-API-rajapintoja paikallisten toimitusten valvontaan

Tässä oppaassa keskitytään varastoihin, jotka säilyttävät varastoa kauppiaan kotimarkkinan ulkopuolella ja lähettävät tilauksia kyseisen kohdemarkkinan asiakkaille. Näille tiimeille ulkomaisen varaston seurannan on yhdistettävä varaston lähetysrekisterit paikallisen kuljetusyhtiön toimitusmatkaan. Tämä yhteys auttaa varastopäälliköitä, kuljetuskoordinaattoreita ja kauppiaan tukitiimejä työskentelemään saman lähetysrekisterin pohjalta.

Määritä, missä varaston näkyvyys päättyy ja kuljetusyhtiön näkyvyys alkaa

Varastonhallintajärjestelmä voi kirjata, että tilaus on kerätty, pakattu, merkitty ja siirretty lähetysalueelle. Nämä rekisterit eivät yksinään todista, että kuljetusyhtiö on vastaanottanut paketin. Seuranta-API lisää kuljetusyhtiön ilmoittamat tapahtumat, mutta se ei voi korvata varaston luovutusrekisteriä tai luoda fyysistä skannausta, jota ei ole tapahtunut.

Pidä kolme virstanpylvästä erillään: valmis noudettavaksi, luovutettu varaston rekisterien mukaan ja vastaanotettu kuljetusyhtiön seurantatapahtumien mukaan. Tämä erottelu helpottaa sellaisten pakettien tutkimista, jotka näyttävät sisäisesti lähetetyiltä mutta joista ei ole kuljetusyhtiön liiketietoja.

Jos paketti esimerkiksi näkyy noutoluettelossa mutta siitä ei ole vastaanottotapahtumaa, seuraavaksi on tarkistettava lastausrekisterit ja otettava yhteyttä noudosta vastaavaan kuljetusyhtiöön. Pakettia on liian aikaista luokitella kadonneeksi. Jos kuljetusyhtiö on jo ilmoittanut epäonnistuneesta toimitusyrityksestä, asianmukainen toimenpide on toinen: tutki syy ja sovi seuraavasta vaiheesta kauppiaan tai valtuutetun vastaanottajan yhteyshenkilön kanssa.

Muodosta lähetysrekisteri ennen API:n yhdistämistä

Perustana on luotettava yhteys asiakastilauksen, fyysisen paketin ja kuljetusyhtiön seuranta-tunnisteen välillä. Älä käytä tilausnumeroa paketin tunnisteen korvikkeena. Yksi tilaus voi lähteä varastosta useissa paketeissa, ja korvaava lähetys tarvitsee oman rekisterinsä.

RekisteriSuositellut kentätOperatiivinen tarkoitus
Lähetyksen tunnistetiedotSisäinen lähetys-ID, tilaus-ID, paketti-ID, kauppiastiliPidä osalähetykset ja eri asiakkaat erillään.
Kuljetusyhtiön tunnistetiedotKuljetusyhtiön tunniste, seurantanumero, palvelu silloin kun tiedossaLähetä oikea seurantapyyntö ja ohjaa tutkimukset.
Varaston luovutusVarasto, lähetysaika, noutoviite, lähetysluettelon viiteVertaa fyysisen lähetyksen todisteita kuljetusyhtiön tapahtumiin.
Seuranta-historiaRaakatapahtuma, muunnettu tila, tapahtuma-aika, vastaanottoaika, sijainti silloin kun toimitettuSäilytä todisteet ja erota tapahtuman ajoitus raportointiviiveistä.
Poikkeamien työnkulkuOngelmatyyppi, vastuuhenkilö, seuraava toimenpide, tarkistuksen määräaika, ratkaisuMuuta seurantatiedot vastuulliseksi työksi.

Tallenna seurantanumerot tekstinä, jotta niiden muotoilu säilyy. Kun varasto tuntee kuljetusyhtiön jo tarran luonnin yhteydessä, välitä tämä tieto integraation kautta sen sijaan, että luottaisit pelkästään numeron tunnistamiseen. Säilytä myös alkuperäisten, korvaavien, palautus- ja jatkotoimituspakettien väliset suhteet korvaamatta niiden yksittäisiä historioita.

Valitse varaston kuljetusyhtiövalikoimaan sopiva integraatio

Varasto voi integroitua suoraan kuljetusyhtiöihinsä tai käyttää usean kuljetusyhtiön seuranta-API:a. Suora integraatio voi olla käytännöllinen vakaassa toiminnassa, jossa käytetään pientä määrää kuljetusyhtiöitä, erityisesti silloin kun tarvitaan kuljetusyhtiökohtaista dataa. Usean kuljetusyhtiön API:a kannattaa arvioida, kun varasto tarvitsee yhteisen seurantarajapinnan useiden toimitusverkostojen välillä.

17TRACKin Tracking API on tähän integraatiomalliin sopiva vaihtoehto. Arvioi sen official API documentation -dokumentaation avulla, miten lähetysten rekisteröinti, seurannan haku ja seurannan päivitykset sopivat järjestelmääsi. Vahvista kunkin varaston käyttämät täsmälliset kuljetusyhtiö- ja palveluyhdistelmät sen sijaan, että pitäisit yleistä kuljetusyhtiöiden saatavuutta todisteena siitä, että kaikki vaaditut tapahtumat palautetaan.

Arvioi yhteyttä todellisten operatiivisten vaatimusten perusteella:

  • Voiko järjestelmäsi rekisteröidä luotettavasti lähetyshuippujen aikana luodut paketit?
  • Mitä tapahtumia palautetaan tosiasiassa käyttämistäsi paikallisen toimituksen palveluista?
  • Miten epäonnistuneita pyyntöjä, kaksoisrekisteröintejä ja virheellisiä kuljetusyhtiön tunnisteita käsitellään?
  • Miten päivitykset toimitetaan tai haetaan, ja miten puuttuvat päivitykset voidaan täsmäyttää?
  • Mitä käyttörajoituksia, säilytysehtoja, tietoturvatoimia ja kaupallisia ehtoja tiliisi sovelletaan?

Seurantayhteyden ei pidä olettaa sisältävän tarrojen ostamista, osoitteen korjaamista, toimituksen uudelleenajoitusta tai korvausvaatimusten jättämistä. Käsittele niitä erillisinä työnkulkuina, ellei asiaankuuluvassa tuotedokumentaatiossa nimenomaisesti vahvisteta muuta.

Yhdistä lähetys, seurantapäivitykset ja poikkeamien käsittely

1. Rekisteröi paketit hallitussa lähetyksen virstanpylväässä

Valitse johdonmukainen rekisteröinnin laukaisin, kuten tarran vahvistus tai lähetyksen vahvistus. Rekisteröinti tarran luonnin yhteydessä voi paljastaa paketit, joita ei ole vielä noudettu, mutta se edellyttää myös peruutettujen tarrojen käsittelyä. Vasta lähetyksen jälkeen tehtävä rekisteröinti vähentää käyttämättömiä rekisteröintejä, mutta voi peittää tarran luonnin ja fyysisen luovutuksen välisen ajan.

Valitsemastasi laukaisimesta riippumatta tallenna rekisteröinnin tulos paketin yhteyteen. Epäonnistuneiden rekisteröintien tulee siirtyä uudelleenyritys- tai korjausjonoon sen sijaan, että ne katoaisivat sovelluslokeihin. Käytä vakaata sisäistä tunnistetta estääksesi toistuvan käsittelyn luomasta päällekkäisiä liiketoimintarekistereitä.

2. Vastaanota päivitykset tekemättä koontinäytöstä totuuden lähdettä

API:n dokumentoitujen vaihtoehtojen mukaan päivitykset voidaan hakea pyynnöillä tai vastaanottaa webhook-ilmoituksina. Webhook on järjestelmällesi lähetetty viesti, kun palveluntarjoajalla on päivitys; kyselyssä järjestelmäsi pyytää tiedot.

Webhook-pohjaisissa toteutuksissa vahvista saapuvat viestit palveluntarjoajan dokumentoidulla varmennusmenetelmällä. Tallenna hyväksytyt viestit pysyvästi ennen niiden kuittaamista ja käsittele ne sitten asynkronisesti. Varaudu päällekkäisiin viesteihin ja väärässä järjestyksessä saapuviin tapahtumiin. Noudata dokumentoituja vastaus- ja uudelleenyritysvaatimuksia sen sijaan, että olettaisit kaikkien palveluntarjoajien toimivan samalla tavalla.

Kyselyissä priorisoi aktiiviset lähetykset ja ratkaisemattomat poikkeamat sovellettavien käyttörajojen puitteissa. Jos mahdollista, käytä täsmäytyspyyntöjä sellaisten lähetysten tarkistamiseen, joiden päivityshistoria näyttää puutteelliselta. Kirjaa tiedonsiirron epäonnistumiset erikseen kuljetusyhtiön toimituspoikkeamista: rikkoutunut yhteys ei ole todiste siitä, että paketti olisi lakannut liikkumasta.

3. Yhtenäistä tilat säilyttäen alkuperäiset todisteet

Luo pieni joukko operatiivisia luokkia, kuten vastaanottoa odottava, kuljetuksessa, toimitettavana, toimitusyritys tehty, toimitettu ja palautus matkalla. Nämä ovat ehdotettuja varastoluokkia, eivät lupaus siitä, että jokainen kuljetusyhtiö toimittaa niitä vastaavat tapahtumat.

Säilytä alkuperäinen kuvaus muunnetun luokan rinnalla. ”Noudettavissa” ei saa muuttua huomaamatta tilaksi ”toimitettu”, eikä ”palautus aloitettu” saa muuttua tilaksi ”vastaanotettu takaisin varastoon”. Salli tuntematon tai kartoittamaton tila, jotta vieraat tapahtumat pysyvät näkyvissä tarkistusta varten.

Tallenna sekä tapahtuman aikaleima että aika, jolloin järjestelmäsi vastaanotti sen. Säilytä alkuperäinen aikavyöhyke tai poikkeama silloin kun se toimitetaan ja käytä johdonmukaista sisäistä aika-standardia. Myöhässä saapuva tapahtuma ei saa automaattisesti siirtää lähetystä taaksepäin vain siksi, että se vastaanotettiin viimeisenä; käytä selkeitä järjestyssääntöjä ja säilytä historia.

4. Määritä poikkeamille vastuuhenkilöt

Hälytys on hyödyllinen vain, jos joku voi toimia sen perusteella. Ohjaa puuttuvat vastaanottoskannaukset varaston lähetysryhmälle, vastaanottajan tietoja edellyttävät toimitusyritykset kauppiaan tukitiimille ja jatkuvat kuljetusyhtiön liikeongelmat kuljetuskoordinaattorille. Nämä ovat suositeltuja lähtökohtia; vastuiden tulee vastata varaston sopimuksia ja toimintamallia.

Liitä jokaiseen tapaukseen seurantahistoria, luovutusviite, viimeisin tapahtuma, tutkimusmuistiinpanot ja seuraavan tarkistuksen aika. Ryhmittele toistuvat hälytykset saman avoimen ongelman alle, jotta yksi pysähtynyt paketti ei luo uutta tehtävää jokaisen synkronoinnin jälkeen.

Aseta hälytykset palveluodotusten, ei mielivaltaisten ajastimien, ympärille

Ei ole olemassa yleispätevää aikaväliä, jonka jälkeen paketista ilman uutta skannausta tulee myöhästynyt tai kadonnut. Määritä hälytyskynnykset kuljetusyhtiön palvelun, noutoaikataulun, toimintapäivien, kohteen ja kauppiaan sitoumuksen perusteella. Pidä sisäinen tutkimuskynnys erillään asiakkaalle annetusta toimituslupauksesta.

  • Ei vastaanottoa luovutuksen jälkeen: Tarkista noutorekisteri ja kuljetusyhtiön kuittaus ennen eskalointia.
  • Ei liikettä odotettua aikaväliä pidempään: Tarkista viimeisin tapahtuma, palveluodotukset ja tunnetut toimintakatkokset.
  • Epäonnistunut toimitusyritys: Lue syy ennen kuin päätät, kuuluuko seuraava toimenpide kuljetusyhtiölle, kauppiaalle vai vastaanottajalle.
  • Palautus matkalla: Valmistele palautusten työnkulku, mutta älä lisää myyntikelpoista varastoa ennen fyysistä vastaanottoa ja vaadittua tarkastusta.
  • Toimitettu mutta kiistetty: Avaa tutkimus ja etsi saatavilla olevat toimitustodisteet; älä pidä pelkkää tilaa valituksen ratkaisuna.

Seuranta kuvaa ilmoitettuja lähetystapahtumia, ei paketin jatkuvaa sijaintia. Viimeisimmän päivityksen aikaleiman näyttäminen auttaa henkilöstöä ymmärtämään tiedon tuoreuden antamatta vaikutelmaa reaaliaikaisesta GPS-näkyvyydestä.

Anna jokaiselle tiimille käyttökelpoinen näkymä

Varaston valvojat tarvitsevat lähetyksestä vastaanottoon liittyvät poikkeamat. Kuljetuskoordinaattorit tarvitsevat kuljetusyhtiökohtaiset jonot ja vanhenevat tapaukset. Kauppiaan tukitiimit tarvitsevat selkeän lähetysaikajanan ja seuraavan sovitun toimenpiteen. Yhteinen tietomalli voi tukea näitä näkymiä antamatta jokaiselle käyttäjälle pääsyä kaikkien kauppiaiden lähetyksiin.

Usean asiakkaan varastossa valvo käyttöoikeuksia palvelintasolla, ei ainoastaan koontinäytön suodattimilla. Pidä API-tunnistetiedot poissa selainkoodista, rajoita pääsyä vastaanottajatietoihin ja määritä säilytys- ja poistamissäännöt. Vältä tarpeettomien henkilötietojen sijoittamista seurannan viitteisiin tai diagnostiikkalokeihin.

Hyödyllisiä mittareita ovat seurannan onnistuneesti rekisteröityjen lähetettyjen pakettien osuus, kuljetusyhtiön vastaanottotapahtumien osuus, lähetyksestä vastaanottoon kuluva aika, ratkaisemattomien poikkeamien ikä ja integraation käsittelyvirheet. Määritä kunkin mittarin nimittäjä ja aikaperuste. Jos mittaat oikea-aikaista toimitusta, vertaa sitä dokumentoituun lupaukseen tai palvelusitoumukseen yleisen toimituksen keston sijaan.

Pilotoi työnkulku ennen sen laajentamista

Aloita selkeästi määritellystä varastosta, kuljetusyhtiöjoukosta ja kauppiasryhmästä. Sisällytä tavalliset toimitukset sekä vaikeat rekisterit: peruutetut tarrat, osatilaukset, puuttuvat ensimmäiset skannaukset, epäonnistuneet toimitusyritykset, päällekkäiset ilmoitukset, väärässä järjestyksessä saapuvat tapahtumat ja palautukset. Käytä tarvittaessa valtuutettuja testitietoja tai historiallisia rekistereitä; älä keksi kuljetusyhtiön tapahtumia tuotannossa.

Sopikaa hyväksymiskriteereistä ennen julkaisua. Jokaisella lähetetyllä paketilla tulee olla joko onnistunut rekisteröinti tai vastuuhenkilölle osoitettu virhetapaus. Toistettujen viestien ei pidä luoda päällekkäisiä tehtäviä. Seurantatapahtumien tulee olla jäljitettävissä lähteeseensä, eivätkä käyttäjät saa nähdä toisen kauppiaan rekistereitä.

Laajenna vasta, kun operatiivinen henkilöstö pystyy käsittelemään poikkeamajonoa luotettavasti ja tekninen henkilöstö palauttamaan epäonnistuneet päivitykset. Käytännön tavoitteena ei ole tiloja täynnä oleva koontinäyttö. Tavoitteena on jäljitettävä yhteys varaston lähetyksestä kuljetusyhtiön toimitukseen sekä selkeä vastuunjako aina, kun tämä matka vaatii huomiota.

UKK

Voiko seuranta-API korvata varastonhallintajärjestelmän?

Ei. Seuranta-API tarjoaa näkyvyyden lähetyksiin. Varastojärjestelmä vastaa edelleen esimerkiksi varastonhallinnasta, keräilystä, pakkaamisesta ja fyysisen lähetyksen rekistereistä. Yhdistä järjestelmät pakettitunnisteiden avulla, jotta kuljetusyhtiön tapahtumat lisäävät kontekstia korvaamatta varaston todisteita.

Tarjoaako seuranta-API reaaliaikaisen GPS-sijainnin?

Älä oleta niin. Pakettien seuranta koostuu yleensä ilmoitetuista tapahtumista ja sijainneista. Päivitysten ajoitus riippuu kuljetusyhtiöstä ja integraatiosta. Jatkuva ajoneuvon tai paketin sijainti edellyttää erikseen varmennettua ominaisuutta.

Mitä henkilöstön tulee tehdä, kun paketissa ei ole seurantapäivityksiä?

Tarkista ensin rekisteröinnin onnistuminen, kuljetusyhtiön tunnistetiedot ja seurantanumeron oikeellisuus. Vertaa sitten viimeisintä tapahtumaa varaston luovutustietoihin ja odotettuun palveluaikaan. Tutki integraation virheet erillään puuttuvista kuljetusyhtiön skannauksista ennen kuin päätät, minkä tiimin tulee eskaloida asia.

Voivatko seurantatapahtumat käynnistää automaattisesti hyvityksiä tai varastopäivityksiä?

Ne voivat antaa tietoa työnkululle, mutta merkittävät toimenpiteet edellyttävät lisävalvontaa. Toimituspoikkeama ei välttämättä vahvista oikeutta hyvitykseen, eikä palautuksen eteneminen vahvista fyysistä vastaanottoa varastoon. Sovella kauppiaan käytäntöjä, valtuutustarkistuksia ja vastaanottomenettelyjä ennen raha- tai varastorekisterien muuttamista.

Miten osatilaukset tulee näyttää kauppiaan tukitiimeille?

Näytä jokainen paketti erikseen päätason tilauksen alla. Yhden paketin toimitus ei saa merkitä koko tilausta valmiiksi, kun toinen paketti on edelleen kuljetuksessa. Pidä korvaavat ja palautuslähetykset linkitettyinä mutta eroteltavina.

Lähteet

  • 17TRACK Tracking API — virallinen tuoteviite seuranta-API-integraation vaihtoehdolle.
  • 17TRACK API Documentation — tekninen viite rekisteröinnin, seurantapyyntöjen, päivitysten käsittelyn ja toteutusvaatimusten validointiin. Tämän oppaan operatiiviset työnkulut ja hälytyssäännöt ovat suosituksia eivätkä takuita palveluntarjoajan tai kuljetusyhtiön toiminnasta.