På svenska
In EnglishPakettipalvelut yrityksille
Pakettilähetyksen XML-rajapinta
Lähetystietojen automaattinen ja turvallinen välitys Matkahuollon järjestelmään
Verkkokaupiaat ja sovelluskehittäjät voivat kytkeä tilausten käsittelyn suoraan Matkahuollon tietojärjestelmään, jolloin lähetysten käsittely nopeutuu ja yksinkertaistuu. Matkahuolto on kehittänyt XML-rajapinnan, joka helpottaa huomattavasti kytkeytymistä. Seuraavien ohjeiden ja esimerkkikoodien avulla XML-rajapinnan käyttöönotto käy nopeasti ja helposti.Lataa pdf-esitys XML-rajapinnasta.
Testaus ja käyttöönotto
Rajapinnan kehitystyön voi aloittaa heti ohjeiden mukaisesti. 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.Rajapinnan toiminta
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öä.
Esimerkkivastaus: malli_vastaus.zip
Esimerkki pdf-osoitekortista: malli_kortti.pdf
Tekninen rajapintakuvaus
Lataa rajapintakuvaus: MHOsoitekorttihaku.doc.Esimerkkitiedostot
Käyttöönottoa helpottamaan Matkahuolto tarjoaa esimerkkikoodeja muutamalla yleisimmällä web-ohjelmointikielellä. Esimerkkikoodien käyttö on vapaata ja niitä saa käyttää sekä henkilökohtaisiin että kaupallisiin järjestelmiin. Koodeja voi käyttää sellaisenaan tai muokattuina, mutta omalla vastuulla. Huomioithan myös, että esimerkkikoodien toimintavarmuutta ei ole testattu kaikissa olosuhteissa.Koodit ovat zip-pakattuja:
- Php: matkahuolto_php.zip
- C#: matkahuolto_cs.zip
- Java: matkahuolto_java.zip
- Ruby: matkahuolto_ruby.zip
Asiakastunnukset ja tekninen tuki
Testausta ja käyttöönottoa varten tarvitset maksuttoman asiakastunnuksen, jonka voit
tilata Matkahuollosta sähköpostilla
verkkokauppapalvelut@matkahuolto.fi.
Tekninen tuki auttaa käyttöliittymään ja xml-rajapintaan liittyvissä kysymyksissä. Sähköposti tekniseen tukeen on verkkokauppapalvelut@matkahuolto.fi.