> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Yhdistä Matkahuolto

> Yhdistä Matkahuolto kohdassa Kuljetusyhtiöt lähettäjän Account numberilla ja kokeile Matkahuolto-palvelun testijärjestelmää Testitila-valintaruudulla.

**Matkahuolto** lähettää paketteja Suomen sisällä ja ulkomaille: noutopisteisiin ja pakettiautomaatteihin, koteihin ja yrityksiin, rahtina ja asiakkaan palautuksina. Kentät, jotka kaikki kuljetusyhtiöt jakavat, ovat sivulla [Kuljetusyhtiöiden tunnukset](/docs/fi/how-to/carrier-credentials).

<Info>
  Tällä lomakkeella ei valita lähettäjän osoitetta. Lisää osoitteesi organisaatiovalikosta → **Hallitse** → **Osoitteet**. Valitset lähettäjän osoitteen jokaiselle lähetykselle tai [toimitussäännössä](/docs/fi/how-to/shipping-rule-fields).
</Info>

## Ennen aloitusta

* Tarvitset Matkahuolto-palvelun **lähettäjän asiakasnumeron** (Matkahuolto kutsuu sitä nimellä SenderId). Se tulee Matkahuolto-sopimuksesi mukana.
* Se on ainoa tieto, jonka annat. Zippendo kirjautuu palveluun Matkahuolto puolestasi, joten käyttäjätunnusta tai salasanaa ei tarvitse täyttää.
* Kortin **Lue lisää** avaa [Matkahuolto-yritysasiakkaiden sivun](https://www.matkahuolto.fi/corporate-customers).

Voit yhdistää Matkahuolto-kuljetusyhtiön useammin kuin kerran, esimerkiksi yhden yhteyden asiakasnumeroa kohti. Anna jokaiselle oma **Kuljetusyhtiön nimi**.

## Yhdistä Matkahuolto

<Steps>
  <Step title="Avaa Kaikki kuljetusyhtiöt">
    Valitse sivupalkista **Kuljetusyhtiöt** ja avaa sitten **Kaikki kuljetusyhtiöt** -välilehti.
  </Step>

  <Step title="Etsi Matkahuolto">
    Valitse **Matkahuolto**-kortista **Yhdistä**.
  </Step>

  <Step title="Täytä lomake">
    **Yhdistä kuljetusyhtiö** -ikkuna avautuu. Anna **Kuljetusyhtiön nimi** ja **Asiakasnumero**. **Testitila** on kohdassa **Valinnaiset kentät**.
  </Step>

  <Step title="Yhdistä kuljetusyhtiö">
    Valitse **Yhdistä**. Näet ”Kuljetusyhtiö yhdistetty”, ja kuljetusyhtiö ilmestyy **Omat kuljetusyhtiöt** -välilehdelle.
  </Step>
</Steps>

<Frame caption="Matkahuolto-kortti Kaikki kuljetusyhtiöt -välilehdellä">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-matkahuolto/01-all-carriers-card-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=85ee0dbe18eef73dfeb0270172474d2a" alt="Kaikki kuljetusyhtiöt -välilehti, jossa Matkahuolto-kortti sekä sen Yhdistä- ja Lue lisää -painikkeet" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-matkahuolto/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-matkahuolto/01-all-carriers-card-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=bc2ac5577b00e33ab449156910f96ce0" alt="Kaikki kuljetusyhtiöt -välilehti, jossa Matkahuolto-kortti sekä sen Yhdistä- ja Lue lisää -painikkeet" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-matkahuolto/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Anna Account number. Testitila on valinnainen.">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-matkahuolto/02-connect-modal-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=60c650908484ecce9f75ab9832b34513" alt="Matkahuolto-kuljetusyhtiön Yhdistä kuljetusyhtiö -ikkuna, jossa Account number -kenttä ja Testitila-valintaruutu" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-matkahuolto/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-matkahuolto/02-connect-modal-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=e5e6215e05bc64a75c949316852ab29f" alt="Matkahuolto-kuljetusyhtiön Yhdistä kuljetusyhtiö -ikkuna, jossa Account number -kenttä ja Testitila-valintaruutu" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-matkahuolto/02-connect-modal-dark.png" />
</Frame>

## Lomakkeen kentät

| Kenttä | Pakollinen | Mitä syötetään |
| - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | Nimi, jonka näet kohdassa **Omat kuljetusyhtiöt** ja valitessasi kuljetusyhtiön lähetykselle. Alkuarvo on **Matkahuolto**. |
| **Brändi** | Ei | Näkyy vain, jos organisaatiollasi on [brändejä](/docs/fi/how-to/create-a-brand). Lomakkeessa lukee: ”Vain tämä brändi voi käyttää tätä kuljetusyhtiötä.” Jätä tyhjäksi, jos haluat jokaisen brändin voivan käyttää sitä. |
| **Asiakasnumero** | Kyllä | Lähettäjän asiakasnumerosi. Lomakkeessa lukee: ”Lähettäjän asiakasnumerosi Matkahuolto-palvelussa (SenderId). Pakollinen jokaiselle varaukselle: lähetyksiä ei voi luoda ilman sitä.” |
| **Testitila** | Ei | Valintaruutu, oletuksena pois. Lomakkeessa lukee: ”Käytä Matkahuolto-palvelun testiympäristöä”. |

**Yhdistä** ei tee mitään, ennen kuin kentillä **Kuljetusyhtiön nimi** ja **Asiakasnumero** on arvo.

**Testitila** lähettää lähetyksesi Matkahuolto-palvelun testijärjestelmään, joten oikeita lähetyksiä ei luoda. Jätä se pois päältä oikeille lähetyksille. Katso [Testitila](/docs/fi/how-to/sandbox-mode).

## Yhdistämisen jälkeen

Kuljetusyhtiö ilmestyy kohtaan **Omat kuljetusyhtiöt** **Yhdistetty**-merkinnällä. Valitset kuljetuspalvelun jokaiselle lähetykselle tai toimitussäännössä, et tällä lomakkeella. Katso [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services).

Kuljetuspalvelut, joilla lähetät:

* **Jakopaketti**, **Kotijakelu**, **XXS-luukkujakelu**, **Lavarahti** ja **Rahti** Suomen sisällä
* **Lähellä-paketti** ja **XXS (noutopiste)** noutopisteeseen tai pakettiautomaattiin Suomessa
* **Ulkomaan Lähellä-paketti**, **Ulkomaan Jakopaketti** ja **Ulkomaan Kotijakelu** ulkomaille

Palautuskuljetuspalvelut: **Asiakaspalautus** ja **Ulkomaan asiakaspalautus**. Molemmat tarjoavat **Palautus ilman osoitekorttia (aktivointikoodi)** -lisäpalvelun.

Lähetyksen lisävalinnat kohdassa **Lisätiedot kuljetusyhtiölle** riippuvat kuljetuspalvelusta. Niihin kuuluvat **Vastaanottajan kieli** (**Suomi**, **Ruotsi** tai **Englanti**), **Sisällön kuvaus**, **Toimituksen PIN-koodi** joissakin kotiinkuljetuksissa ja **Pyydä nouto** yritysjakelun ja rahdin kuljetuspalveluissa. **Pyydä nouto** pyytää kuljetusyhtiötä Matkahuolto noutamaan lähetyksen lähettäjän osoitteesta. Joissakin kuljetuspalveluissa on myös vaarallisten aineiden lisäpalveluja.

### Noutopistekuljetuspalvelut

**Lähellä-paketti**, **XXS (noutopiste)** ja **Ulkomaan Lähellä-paketti** toimittavat noutopisteeseen. Valitse noutopiste lähetykselle ennen lähettämistä. Katso [Noutopisteen valinta](/docs/fi/how-to/pick-a-service-point) ja [Noutopisteet](/docs/fi/how-to/drop-point-and-service-points).

### Noutotilaukset, seuranta ja tulli

* KuljetusyhtiÃ¶ Kuljetusyhtiö Matkahuolto ei ole saatavilla kohdassa **Noutotilaukset**. Käytä sen sijaan lähetyksellä **Pyydä nouto** -toimintoa, jos kuljetuspalvelu tarjoaa sen. Kuljetusyhtiöt, joille se on saatavilla, löytyvät sivulta [Noudon tilaaminen](/docs/fi/how-to/schedule-a-pickup).
* Zippendo hakee seurantapäivitykset palvelusta Matkahuolto tunnin välein. Mitään ei tarvitse määrittää. Katso [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks).
* Ulkomaille menevissä lähetyksissä Matkahuolto luo tulli-ilmoituksen itse, joten Zippendo ei lisää omia tulliasiakirjojaan. Katso [Tulli ja asiakirjat](/docs/fi/how-to/customs-and-documents).

## Yhteyden muuttaminen tai poistaminen

Muuta yhteyttä avaamalla **Kuljetusyhtiöt** → **Omat kuljetusyhtiöt** ja valitsemalla kortilla **Muokkaa kuljetusyhtiötä**. **Muokkaa kuljetusyhtiötä** -sivulla on kaksi osiota:

* **Yleiset**: **Kuljetusyhtiön nimi** ja **Brändi**, jos organisaatiollasi on brändejä.
* **Kuljetusyhtiön asetukset**: **Asiakasnumero** ja **Testitila**.

Valitse **Tallenna**. Näet ”Kuljetusyhtiö päivitetty”.

Poista yhteys valitsemalla samalla sivulla **Poista**, kirjoittamalla kuljetusyhtiön nimi isoilla kirjaimilla ja valitsemalla **Poista**. Tätä kuljetusyhtiötä käyttävät toimitussäännöt poistetaan sen mukana. Jo lähettämäsi lähetykset säilyttävät osoitekorttinsa ja seurantakoodinsa.

## Yleiset ongelmat

| Mitä näet | Mitä tehdä |
| - | - |
| ”Kuljetusyhtiön yhdistäminen epäonnistui. Yritä uudelleen.” | Tarkista, että **Kuljetusyhtiön nimi** ja **Asiakasnumero** on täytetty, ja yritä uudelleen. |
| ”Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä.” | Pakettisi kuljetusyhtiöraja on saavutettu. Katso [Laskutus ja käyttö](/docs/fi/how-to/billing-and-usage). |
| ”Kuljetusyhtiö hylkäsi kirjautumistietosi. Päivitä kuljetusyhtiön tunnukset kohdassa Kuljetusyhtiöt.” lähetettäessä | Tarkista **Asiakasnumero** kohdassa **Muokkaa kuljetusyhtiötä**. Katso [Kuljetusyhtiön tunnistautumisen epäonnistumiset](/docs/fi/knowledge-base/carrier-authentication-failures). |
| ”Matkahuolto ei voinut luoda lähetystä.” tai Matkahuolto-palvelun oma virheteksti | Kuljetusyhtiö Matkahuolto hylkäsi lähetyksen. Korjaa viestissä mainittu asia, kuten osoite tai kuljetuspalvelulle liian suuri paketti, ja lähetä uudelleen. |
| ”Tämä kuljetuspalvelu toimittaa noutopisteeseen. Valitse noutopiste ennen lähettämistä.” | Valitse noutopiste lähetykselle. |
| ”Valittu kuljetuspalvelu ei kuljeta näiden maiden välillä. Valitse toinen kuljetuspalvelu.” | Valitse kuljetuspalvelu, joka kattaa tämän reitin, esimerkiksi **Ulkomaan**-kuljetuspalvelu ulkomaille menevälle lähetykselle. |
| ”Kuljetusyhtiö ei vastannut. Yritä hetken kuluttua uudelleen.” | KuljetusyhtiÃ¶ Kuljetusyhtiö Matkahuolto ei vastannut ajoissa. Odota hetki ja lähetä uudelleen. |

## Aiheeseen liittyvää

* [Kuljetusyhtiön tai integraation yhdistäminen](/docs/fi/how-to/connect-index)
* [Kuljetusyhtiöiden tunnukset](/docs/fi/how-to/carrier-credentials)
* [Testitila](/docs/fi/how-to/sandbox-mode)
* [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services)
* [Kuljetusyhtiöintegraation pyytäminen](/docs/fi/how-to/request-carrier-integration)
* [Kuljetusyhtiöt](/docs/fi/tutorials/carriers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.