Gränssnitt
Gränssnitt
Matkahuolto erbjuder en möjlighet att bygga integrationer i din webbutik eller något annat av dina bakgrundssystem med hjälp av öppna gränssnitt. Nedan hittar du närmare beskrivningar av gränssnitten.
Matkahuoltos XML-gränssnitt
Alla näthandelsprogram kan kopplas direkt till Matkahuoltos datasystem med hjälp av ett XML-gränssnitt.
XML-gränssnittet består i praktiken av en enkel XML-begäran, som besvaras i XML-format. Begäran skickas (POST) med https-protokoll till kontaktadressen. Som svar på en mottagen begäran får kunden en XML-fil som innehåller förutom själva svaret även ett adresskort som pdf-dokument. Pdf-filen ska skrivas ut och fogas till försändelsen.
XML-begäran har en bestämd form, men den innehåller flera frivilliga fält. Https-protokollet är det enda möjliga alternativet, eftersom tjänsten inte godkänner en oskyddad http-begäran.
Matkahuoltos sökning av avhämtningsställen
I sökningen av avhämtningsställen är det möjligt att i realtid använda API-gränssnittet i sökningen av avhämtningsställen som tillhandahålls av Matkahuolto eller uppdatera Matkahuoltos uppgifter om avhämtningsställen till exempel en gång per dag i webbutikens databas, där de visas för kunderna.
Matkahuoltos sökning av avhämtningsställen finns också färdigt i till exempel nShifts system.
Ladda teknisk beskrivning av serviceställe
Spårningsuppgifter
Mottagaren kan spåra en försändelse via spårningen av försändelser på Matkahuoltos webbplats. Spårningsuppgifterna kan också visas på webbutikens webbplats utifrån spårningsuppgifter som förmedlats av Matkahuolto.
Teknisk beskrivning av spårningsuppgifter
Gränssnittsbeskrivning för Matkahuoltos adresskortssökning
Försändelseuppgifterna förmedlas elektroniskt till Matkahuolto som en API-inbjudan eller dataöverföring. EDI-meddelandet kan vara i XML- eller CSV-format. De flesta datasystemen för webbutiker stöder de filformat som krävs utan separat utveckling.
I EDI-meddelandet förmedlas bl.a. avsändarens och mottagarens uppgifter. Mottagarens mobiltelefonnummer eller e-postadress är obligatoriska uppgifter bl.a. för leverans av ankomstavi.
Gränssnittsbeskrivning för adresskortssökning (API)
Hämta modelladresskort som A5 pdf
Hämta modelladresskort som A6 pdf
Testning och ibruktagning
Gränssnittet kan testas i en testmiljö på Matkahuoltos servrar. Då kunderna skickar en begäran till testmiljön får de ett svar i korrekt form. I testmiljön behandlas inga försändelser. Då man vill ta i bruk gränssnittet går det enkelt bara genom att byta kontaktadress.
Så kommer du igång – API-uppgifter och teknisk support
Om du ännu inte har ett avtal, teckna ett avtal online direkt
Du behöver ett giltigt avtal för att kunna bygga integrationer med hjälp av våra öppna API:er. Det går snabbt och enkelt att teckna ett avtal online, och du får genast tillgång till alla tjänster du behöver.
Du har redan ett avtal men saknar API-uppgifter
För testning och implementering behöver du kostnadsfria API-uppgifter. Om du redan har ett avtal men saknar API-uppgifter, fyll i formuläret nedan så skickar vi uppgifterna till dig.
Teknisk support
Om du redan har ett avtal och ett kundnummer men behöver hjälp med frågor som gäller användargränssnittet eller XML-gränssnittet, kontakta vår tekniska support på verkkokauppapalvelut@matkahuolto.fi.
Observera att kundnumret ska beställas via detta formulär, inte via e-post.