Rajapinnat
Rajapinnat
Matkahuolto tarjoaa mahdollisuuden rakentaa integraatioita verkkokauppaasi tai muuhun taustajärjestelmääsi avoimien rajapintojen avulla. Alta löydät tarkemmat kuvaukset rajapinnoista.
Matkahuollon XML-rajapinta
Kaikki verkkokauppasovellukset on mahdollista kytkeä suoraan Matkahuollon tietojärjestelmään XML-rajapinnan avulla.
XML-rajapinta on toteutettu yksinkertaisena XML-pyyntönä, johon vastaus tulee XML-muodossa. Pyyntö lähetetään (POST) https-protokollalla yhteysosoitteeseen. Onnistuneen pyynnön vastauksena tulee XML-tiedosto, joka sisältää vastauksen lisäksi osoitekortin pdf-dokumenttina. Pdf tulostetaan ja liitetään lähetykseen.
XML-pyynnön muoto on määrätty, mutta mukana on useita vapaaehtoisia kenttiä. Https-protokolla on ainoa sallittu, palvelin ei hyväksy suojaamatonta http-pyyntöä.
Matkahuollon noutopistehaku
Noutopistehaussa on mahdollista käyttää reaaliaikaisesti Matkahuollon tarjoamaa noutopistehaun API-rajapintaa tai päivittää Matkahuollon noutopistetiedot esimerkiksi kerran päivässä verkkokaupan tietokantaan, josta ne näytetään asiakkaille.
Matkahuollon noutopistehaku löytyy valmiina myös esimerkiksi nShiftin järjestelmistä.
Lataa noutopistehaun rajapintakuvaus
Seurantatiedot
Vastaanottaja voi seurata lähetyksen kulkua Matkahuollon verkkosivuilla olevan lähetysten seurannan kautta. Seurantatiedot voidaan näyttää myös verkkokaupan sivuilla Matkahuollon välittämien seurantatietojen perusteella.
Seurantatietojen tekninen kuvaus
Matkahuollon osoitekorttihaun rajapintakuvaus
Lähetystiedot välitetään Matkahuollolle sähköisesti API-kutsuna tai tiedostosiirtona. EDI-sanoma voi olla XML- tai CSV-muotoinen. Useimmat verkkokaupan tietojärjestelmät tukevat vaadittuja tiedostomuotoja ilman erilliskehitystä.
EDI-sanomassa välitetään mm. lähettäjän ja vastaanottajan tiedot. Vastaanottajan matkapuhelinnumero tai sähköpostiosoite ovat pakollisia tietoja mm. saapumisilmoituksen toimittamista varten.
Osoitekorttihaun rajapintakuvaus (API)
Osoitekorttihaun rajapintakuvaus (CSV)
Lataa malli A5 pdf-osoitekortista
Lataa malli A6 pdf-osoitekortista
Testaus ja käyttöönotto
Rajapinnan testausta varten Matkahuollon palvelimilla on testiympäristö, johon lähetetyt pyynnöt palauttavat oikeamuotoisen vastauksen. Testiympäristössä lähetystä ei oteta käsittelyyn. Käyttöönotto tapahtuu helposti yhteysosoitetta vaihtamalla.
Näin pääset alkuun - API-tunnukset ja tekninen tuki
Jos sinulla ei vielä ole sopimusta, tee sopimus heti verkossa
Tarvitset voimassa olevan sopimuksen, jos haluat rakentaa integraatioita avoimien rajapintojen avulla. Sopimuksen tekeminen onnistuu helposti ja nopeasti verkossa. Saat kaikki tarvitsemasi palvelut käyttöösi saman tien.
Sinulla on jo sopimus, mutta ei API-tunnuksia
Testausta ja käyttöönottoa varten tarvitset maksuttomat API-tunnukset. Jos sinulla on jo sopimus, mutta API-tunnukset puuttuvat, täytä oheinen lomake, niin toimitamme sinulle tunnuksen.
Tekninen tuki
Jos sinulla on jo sopimus ja API-tunnukset, mutta tarvitset apua käyttöliittymään ja XML-rajapintaan liittyvissä kysymyksissä, olethan yhteydessä tekniseen tukeen sähköpostitse verkkokauppapalvelut@matkahuolto.fi.
Huomaathan, että API-tunnukset tulee tilata tällä lomakkeella, ei sähköpostitse.