Voiko seuranta-API toimia ilman lähetysetikettejä? 3Pl- ja markkinapaikkatilausten seuranta?
Kyllä. Seuranta-API voi toimia ilman, että yrityksesi luo lähetysosoitekortteja, kunhan kuljetusliike tai toimituskumppani on luonut seurattavan lähetyksen ja saat käyttökelpoisen seurantanumeron tai muun API:n tukeman tunnisteen. Tämä on yleistä, kun kolmannen osapuolen logistiikkapalveluntarjoaja (3PL) tai markkinapaikka hoitaa toimitukset. Ero on siinä, että et itse osta osoitekorttia verrattuna siihen, että sinulla ei ole lainkaan lähetyksen tunnistetta: ensimmäinen on yleensä toteutettavissa, kun taas toinen voi jättää API:n ilman seurattavaa kohdetta.

Myyjän, markkinapaikan ylläpitäjän tai integraatiotiimin käytännön tehtävänä on yhdistää jokainen tilaus sen osapuolen luomaan lähetykseen, joka tosiasiassa lähettää sen. Tämä edellyttää pääsyä oikeisiin tietoihin, ei välttämättä osoitekorttien luomisen hallintaa.
Mitä seuranta-API tarvitsee, kun et luo osoitekorttia
Lähetysosoitekortti on yksi tapa tuottaa lähetyksen tunniste, mutta se ei yleensä ole seuranta-API:n lukema syöte. Seurannan integraatiot perustuvat yleensä lähetystietoihin, jotka toimitetaan sen jälkeen, kun osoitekortti on luotu muualla. Ennen yhteyden suunnittelua erottele kolme tietuetta, joita usein käsitellään toistensa vastineina:
- Tilaustunnus: Tunnistaa ostoksen verkkokaupassasi, markkinapaikkatililläsi tai tilaustenhallintajärjestelmässäsi. Se voi kattaa useita tuotteita ja useita lähetyksiä.
- Toimitus- tai pakettitunnus: Tunnistaa toimitustoimenpiteen tai paketin 3PL- tai markkinapaikkajärjestelmässä. Sen muoto ja merkitys riippuvat kyseisestä järjestelmästä.
- Kuljetusliikkeen seurantanumero: Tunnistaa lähetyksen seurantaa varten, mikäli kuljetusliike ja seurantapalvelu hyväksyvät sen.
Sisäinen tilaustunnuksesi auttaa löytämään oikean asiakastilauksen. Se ei automaattisesti toimi kuljetusliikkeen seurantanumerona. Tavallinen integraatiomalli on hankkia seurantanumero 3PL-palveluntarjoajalta tai markkinapaikalta, rekisteröidä tai kysellä kyseistä numeroa seuranta-API:n kautta ja tallentaa palautetut lähetystiedot asiaankuuluvan tilauksen tai paketin yhteyteen.
Kuljetusliikkeen nimi tai koodi voi myös olla tarpeen. Jotkin palvelut voivat yrittää tunnistaa kuljetusliikkeen automaattisesti, mutta tämä on testattava eikä oletettava, etenkin kun tunnisteet menevät päällekkäin kuljetusliikkeiden välillä tai tilaus kulkee useiden toimitusverkostojen kautta. Tarkista API:n dokumentaatiosta hyväksytyt tunnisteet, kuljetusliikkeen valintasäännöt, rekisteröintivaatimukset ja tilakentät ennen toteutukseen sitoutumista.
3PL-palveluntarjoajan lähettämien tilausten seuranta
Kun 3PL pakkaa tilauksen, ostaa osoitekortin ja luovuttaa paketin kuljetusliikkeelle, yrityksesi ei välttämättä koskaan näe itse osoitekorttia. Tarvitset silti prosessin tuloksena syntyvät lähetystiedot. Kysy 3PL-palveluntarjoajalta, mikä järjestelmä tai tietosyöte tarjoaa seurantanumerot, kuljetusliikkeen tiedot, pakettitunnisteet ja tilausviitteen, jonka annoit toimitusta pyytäessäsi.
Toimiva 3PL-prosessi näyttää yleensä tältä:
- Lähetä tilaus ja pysyvä viite 3PL-palveluntarjoajalle nykyisen toimitusprosessisi kautta.
- Vastaanota toimitusvahvistus, joka sisältää pakettikohtaisen seurantanumeron ja mahdollisuuksien mukaan kuljetusliikkeen.
- Yhdistä paketti oikeaan asiakastilaukseen ja tuotteisiin.
- Lähetä tuettu lähetyksen tunniste seuranta-API:lle tai käytä API:n määrittämää hakuprosessia.
- Tallenna seurantapäivitykset paketin yhteyteen ja esitä sitten tilaustason näkymä operatiiviselle tiimillesi tai asiakkaallesi.
Yhdistämisvaihe vaatii erityistä huomiota. Yksi tilaus voi lähteä varastosta kahdessa laatikossa tai yksi tuote voidaan lähettää myöhemmin kuin muut. Kummassakaan tapauksessa yksi paketin tila ei kuvaa tarkasti koko tilausta. Säilytä pakettitason tiedot ja muodosta niiden perusteella mahdolliset tilaustason viestit. Älä esimerkiksi merkitse tilausta toimitetuksi vain siksi, että sen ensimmäinen paketti on toimitettu.
Sopikaa 3PL-palveluntarjoajan kanssa, miten korjaukset toimitetaan. Osoitekortteja voidaan mitätöidä, paketit voidaan pakata uudelleen ja alkuperäinen seurantanumero voidaan vaihtaa. Integraatiosi on pystyttävä yhdistämään korvaava numero samaan tilaukseen ilman, että molemmat numerot näkyvät aktiivisina lähetyksinä loputtomasti.
Markkinapaikkatilausten seuranta, kun markkinapaikka hallitsee toimitusta
Markkinapaikan toimitukset tuovat esiin saman teknisen kysymyksen mutta erilaisen käyttöoikeuksiin liittyvän kysymyksen. Markkinapaikka tai sen toimituskumppani voi luoda osoitekortin, mutta myyjä voi saada vain ne toimitustiedot, jotka hänen tilinsä, tilausprosessinsa tai valtuutettu integraationsa paljastaa. Seuranta-API ei voi korvata seurantanumeroa, jota markkinapaikka ei ole antanut käyttöösi.
Aloita selvittämällä jokaisen tilauksen toimitusmalli. Myyjän itse toimittamissa tilauksissa oma toimitusprosessisi tai 3PL-palveluntarjoajasi voi olla pakettitietojen lähde. Markkinapaikan toimittamissa tilauksissa markkinapaikka voi olla lähetystietojen lähde, ja myyjälle saatavilla olevat kentät voivat olla erilaisia. Älä oleta, että toimitustilan näyttävä tilaussivu tarjoaa myös kuljetusliikkeen seurantanumeron, joka soveltuu rekisteröitäväksi erilliseen API:in.
Jos markkinapaikka tarjoaa seurattavan numeron, varmista, että sinulla on lupa hakea ja käyttää sitä aiotussa järjestelmässäsi. Testaa sitten, hyväksyykö seuranta-API kyseisen tunnisteen ja tuovatko saadut tapahtumat hyödyllistä lisätietoa markkinapaikan tilan lisäksi. Jos markkinapaikka paljastaa vain oman tilaus- tai toimitusviitteensä, tarkista, onko sille nimenomaisesti tuettua hakumenetelmää. Älä lähetä sisäistä markkinapaikan tilaustunnusta kuljetusliikkeen numerona ja odota luotettavia tuloksia.
Pidä markkinapaikan tila ja seuranta-API:n lähetyksen tila erillään. Markkinapaikka voi kuvata tilauksen lähetetyksi heti toimituksen vahvistamisen jälkeen, kun taas kuljetusliikkeen seuranta voi edelleen näyttää, ettei vastaanottoskannausta ole tehty. Nämä tietueet vastaavat eri kysymyksiin ja voivat päivittyä eri aikoina.
Milloin seuranta ilman osoitekorttia ei ratkaise ongelmaa
”Me emme luoneet osoitekorttia” ei ole este. Seuraavat tilanteet voivat olla:
- Lähetystä ei ole luotu: Ennen kuin toimitus luo käyttökelpoisen tunnisteen, kyseltävää kuljetusliikkeen lähetystä ei välttämättä ole. Pelkkä tilausvahvistus ei todista paketin olevan matkalla.
- Tunniste ei ole käytettävissäsi: 3PL-palveluntarjoaja tai markkinapaikka voi pitää numeron hallussaan paljastamatta sitä valtuutetun prosessisi kautta. Ratkaise tämä tietojen saatavuuteen liittyvä ongelma lähteellä.
- Tunnistetta ei tueta: Viitenumero, vain markkinapaikan käyttämä koodi tai tukematon kuljetusliikkeen muoto ei ehkä toimi valitun API:n kanssa. Varmista hyväksytyt syötteet dokumentaatiosta ja testilähetyksellä.
- Paketista ei ole vielä uutta skannausta: Numero voi olla olemassa ennen kuin kuljetusliike tallentaa vastaanottotapahtuman. Käsittele tyhjää tai muuttumatonta tulosta tutkittavana tilana, älä automaattisena todisteena numeron virheellisyydestä.
- Seuranta on rajoitettua tai puutteellista: Kuljetusliike, palvelu tai toimitusprosessi ei ehkä tarjoa asiakaslähtöisessä käyttötapauksessasi tarvittavia tapahtumia. Varmista tapahtumien todellinen laatu edustavilla lähetyksillä.
Nämä rajoitukset ovat tärkeitä, koska API ei voi luoda puuttuvia fyysisiä tapahtumia eikä myöntää pääsyä toisen osapuolen tilaustietoihin. Sen arvo on tuettujen seurantatietojen hakemisessa ja järjestämisessä, kun tarvittava tunniste ja käyttöoikeudet ovat olemassa.
API:n arviointi tätä prosessia varten
17TRACKin Tracking API on tutkimisen arvoinen vaihtoehto, kun tiimisi tarvitsee lähetystietoja omiin järjestelmiinsä eikä työkalua osoitekorttien ostamiseen. Sen kehittäjädokumentaatio on paikka, jossa voit tarkistaa käyttötapaukseesi hyväksytyt rekisteröintikentät, tuetut kuljetusliikkeet, vastausrakenteen, todennuksen ja mahdolliset päivitysten toimitusmenetelmät. Älä päättele yleisen seuranta-API:n olemassaolosta, että tiettyä 3PL-palveluntarjoajaa, markkinapaikkaa tai omaa tunnistetta tuetaan.
Luo pieni testijoukko ennen palveluntarjoajan valintaa tai käyttöönottoa. Sisällytä 3PL-tilaus, jossa on kuljetusliikkeen numero, markkinapaikkatilaus, jonka yhteydessä tilisi paljastaa numeron, usean paketin tilaus, ennen ensimmäistä skannausta luotu numero sekä lähetys, jossa on myöhempi toimitustapahtuma. Jos korvaavat numerot tai kansainväliset luovutukset ovat tavallisia, sisällytä myös ne. Testin tulee vastata toiminnallisiin kysymyksiin, ei vain siihen, palauttaako pyyntö onnistuneen HTTP-vastauksen:
- Voitko välittää tosiasiassa saamasi tunnisteet ilman niiden manuaalista uudelleenkirjoittamista?
- Voitko yhdistää jokaisen seurantatietueen luotettavasti oikeaan tilaukseen ja pakettiin?
- Ovatko tapahtumakuvaukset, aikaleimat ja kuljetusliikkeen tiedot riittäviä asiakasviesteihisi ja tukiprosesseihisi?
- Miten järjestelmäsi käsittelee päällekkäiset päivitykset, puuttuvat tapahtumat, numeromuutokset ja epäonnistuneet pyynnöt?
- Onko suunniteltu markkinapaikka- ja asiakastietojen käyttö kyseisiin tietoihin sovellettavien käyttöehtojen mukaista?
Säilytä itse integraatiota varten sekä alkuperäinen lähdetietue että seuranta-API:n tietue. Tallenna tilausviite, pakettiviite, lähetetty seurantanumero, kuljetusliikkeen tiedot, jos ne ovat saatavilla, sekä kunkin päivityksen vastaanottoaika. Näin ristiriitaa on helpompi tutkia esittämättä API-tapahtumaa täydellisenä toimitushistoriana. Jos API tarjoaa vaihtoehdon aikataulutettujen tarkistusten ja tuetun toimitusmenetelmän kautta vastaanotettavien päivitysten välillä, valitse dokumentoidun toiminnan ja ajantasaisten päivitysten tarpeesi perusteella; kumpikaan tapa ei poista virheenkäsittelyn tarvetta.
Käytännön päätös
Käytä seuranta-API:a ilman osoitekorttien luomista, kun toinen osapuoli lähettää paketin ja antaa sinulle tuetun lähetyksen tunnisteen, jonka käyttöön sinulla on lupa. Hanki ensin luotettava pakettitietojen syöte 3PL-palveluntarjoajalta tai markkinapaikalta. Testaa sen jälkeen tunnisteet ja seurantatapahtumat API:a ja tilausten yhdistämislogiikkaasi vasten. Jos sinulla on vain tilaustunnus tai markkinapaikan tila, ratkaise tämä lähdetietojen puute ennen kuljetusliikkeen seurannan integraatioon investoimista.
UKK
Voinko seurata tilausta käyttämällä vain verkkokauppani tilausnumeroa?
Yleensä et kuljetusliikkeen seuranta-API:n kautta. Verkkokauppasi tilausnumero tunnistaa ostoksen järjestelmässäsi. Yleensä tarvitset vastaavan lähetyksen tunnisteen, ellei kyseinen palvelu nimenomaisesti tue hakua tilaustyyppisi mukaisella viitteellä.
Tarvitsenko 3PL-palveluntarjoajan luvan sen seurantanumeroiden käyttöön?
Varmista sopimukseen perustuva ja tekninen pääsysi lähetystietoihin. 3PL-palveluntarjoaja voi jo palauttaa seurantanumerot osana toimitussyötettä, mutta integraation tulee käyttää valtuutettua kanavaa ja käsitellä asiakastietoja asianmukaisesti.
Miksi API ei näytä liikettä sen jälkeen, kun 3PL-palveluntarjoaja lähettää numeron?
Numero on voitu luoda ennen kuljetusliikkeen ensimmäistä tallennettua skannausta. Tarkista, ovatko tunniste ja kuljetusliike oikein, onko alkuperäinen osoitekortti korvattu ja tuottaako myöhempi kysely tapahtumia. Älä rinnasta ”ei vielä skannausta” tilanteeseen ”ei lähetetty” tarkistamatta toimitustietuetta.
Mitä jos yksi markkinapaikkatilaus lähetetään useissa paketeissa?
Seuraa jokaista saatavilla olevaa pakettitunnistetta erikseen ja yhdistä kaikki paketit samaan tilaukseen. Pidä asiakkaalle näkyvä tilaustila erillään yksittäisen paketin tilasta, jotta yksi toimitettu paketti ei saa koko tilausta näyttämään valmiilta.
Lähteet
- 17TRACK Tracking API — tuotetietoja lähetysseurannan integraation arviointiin.
- 17TRACK API Documentation — tekninen viite hyväksyttyjen syötteiden ja integraation toiminnan tarkistamiseen.


