> ## 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.
# Connect Matkahuolto
> Connect Matkahuolto from Carriers → All Carriers — Account number and optional Sandbox Mode.
**Matkahuolto** books Finnish parcel-point, home, business, freight, and return labels from Zippendo. The catalog card copy is: **Ship with Matkahuolto through Zippendo — parcel points and lockers, home and business delivery, freight, and customer returns across Finland and abroad.** Catalog slug: `matkahuolto`.
This page is the Matkahuolto connect form. Shared chrome for every carrier: [Carrier credentials](/docs/how-to/carrier-credentials). Inventory of every connector: [Connect a carrier or integration](/docs/how-to/connect-index). Walkthrough: [Carriers](/docs/tutorials/carriers).
You do **not** pick a sender address on this form. Add addresses under **Manage → Addresses**. The address is chosen on the shipment or on a [shipping rule](/docs/how-to/shipping-rule-fields).
You do **not** enter Matkahuolto’s platform user ID or password. Zippendo supplies those. You only store your sender **Account number**.
## Prerequisites
* A Matkahuolto **sender account number** (`SenderId`). Required on every booking — shipments cannot be created without it. **Learn more** opens [Matkahuolto corporate customers](https://www.matkahuolto.fi/corporate-customers).
* Permission to create carriers in the organization. You can connect Matkahuolto more than once if each connection has its own **Carrier name**.
## Connect from All Carriers
Sidebar **Carriers**. Page title **Carriers / Integrations**. Header tabs: **My Carriers** (`?tab=my-carriers`) and **All Carriers** (`?tab=all-carriers`).
Card title **Matkahuolto**. Buttons: **Connect** and **Learn more** (opens the corporate-customers page in a new tab).
Modal id `connect-carrier-modal`. Title **Create new carrier**. Subtitle **Fill out the information below to create a new carrier**.
Shared fields first, then **Carrier Configuration → Required Fields** (**Account number**). **Optional Fields** is **Sandbox Mode**. Empty required values make **Create** return without saving.
Click **Create** (shows **Creating…** while the request runs) or **Cancel**. Success toast: **Carrier created successfully**. Failure copy in the modal: **Failed to create carrier. Please try again.**
## Shared fields
These appear on every connect dialog, including Matkahuolto.
| Field | Required | What it is |
| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Carrier name \*** | Yes | Display name in **My Carriers** and on shipments. Placeholder **Enter carrier name**. Defaults to **Matkahuolto**. Empty blocks **Create**. |
| **Brand** | No | Only when the organization has [brands](/docs/how-to/create-a-brand). Label **Brand**. Helper: **Only this brand can use this carrier.** Leave unset for organization-wide. Hidden when you have no brands. |
## Matkahuolto credentials
**Carrier Configuration** splits into **Required Fields** and **Optional Fields**. Each helper is catalog copy. Placeholder on **Account number** is the same helper.
| Field | Required | Control | Where you get it | Format | Sandbox vs live |
| ------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Account number** | Yes | Text. Helper: **Your Matkahuolto sender account number (SenderId). Required for every booking — shipments cannot be created without it.** | Your Matkahuolto sender agreement. Not Zippendo’s platform login. | String (`SenderId` on every booking). | Same field. |
| **Sandbox Mode** | No | Checkbox, default off. Helper: **Use Matkahuolto's test environment** | Zippendo checkbox. | Boolean. | On: `https://extservicestest.matkahuolto.fi`. Off: `https://extservices.matkahuolto.fi`. |
There is no API key or password field. Zippendo is the Matkahuolto API user.
Leave **Sandbox Mode** off for live orders. Details: [Sandbox mode](/docs/how-to/sandbox-mode).
## After you connect
The connection appears on **My Carriers** with a **Connected** badge and **Edit Carrier**. Products are **not** on this form — they appear when you [create a shipment](/docs/how-to/send-a-shipment) or save a [shipping rule](/docs/how-to/shipping-rule-fields). See [Carrier products and services](/docs/how-to/carrier-products-and-services).
Outbound products include **Jakopaketti (business delivery)**, **Kotijakelu (home delivery)**, **XXS-luukkujakelu (mail-slot delivery)**, **Lavarahti (pallet home delivery)**, **Rahti (freight)**, **Lähellä-paketti (parcel point)**, **XXS (parcel point)**, **Ulkomaan Lähellä-paketti (international parcel point)**, **Ulkomaan Jakopaketti (international business delivery)**, and **Ulkomaan Kotijakelu (international home delivery)**. Inbound: **Asiakaspalautus (customer return)** and **Ulkomaan asiakaspalautus (international return)**. Extra options can include **Receiver language** (**Finnish**, **Swedish**, **English**), **Contents description**, and on some products **Request pickup**.
### Parcel point products (droppoint)
**Lähellä-paketti (parcel point)**, **XXS (parcel point)**, and **Ulkomaan Lähellä-paketti (international parcel point)** are service-point products. On **Create Shipment** pick a **Service Point** on the **Drop Point** card before send. Error: **This carrier product delivers to a service point — select a droppoint before sending.** How to pick: [Pick a service point](/docs/how-to/pick-a-service-point). Naming: [Droppoint vs service point](/docs/how-to/drop-point-and-service-points).
Matkahuolto does **not** appear in **Pickups**. That list is Bring and PostNord only — [Schedule a pickup](/docs/how-to/schedule-a-pickup). Some products expose **Request pickup** as an additional option on the shipment.
Tracking is pulled on a schedule. There is no tracking-webhook field on **Edit your carrier** — [Carrier tracking webhooks](/docs/how-to/tracking-webhooks).
Matkahuolto generates customs documents for international lanes. It does **not** generate a commercial invoice in Zippendo — [Customs and documents](/docs/how-to/customs-and-documents).
## Edit
On **My Carriers**, click **Edit Carrier**. Page title: **Edit your carrier**. URL `/dashboard/carriers/:id`.
Two cards:
* **General** — **Carrier name** (helper: **Update the name of your carrier**), plus **Brand** when brands exist.
* **Carrier settings** — **Account number** and **Sandbox Mode**.
Header actions: **Delete** and **Save** (pending **Saving…**). Success toast: **Carrier updated successfully**. Loading: **Loading carrier…**. Load failure: **Failed to load carrier. Please try again.** Save failure: **Failed to update carrier. Please try again.**
Shared delete chrome: [Carrier credentials](/docs/how-to/carrier-credentials).
## Delete
On **Edit your carrier**, click **Delete**. Modal id `global-delete-modal`. Title **Delete Carrier**. Subtitle **You are about to delete carrier "\{\{name}}".** Body: **This will permanently delete carrier "\{\{name}}". This action cannot be undone.** Type the carrier name in **uppercase** to enable **Delete**. Toast: **Carrier deleted successfully**. Failure: **Failed to delete carrier**.
Booked shipments keep their labels and tracking.
## Common errors
| When | Copy |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Required field empty on connect | **Create** does nothing until **Carrier name** and **Account number** have values. |
| Connect request fails | **Failed to create carrier. Please try again.** |
| Plan / resource cap | **You have reached your plan limit for this resource.** / **You have exceeded your plan limits. Please upgrade or remove excess items.** |
| Send with bad credentials | **The carrier rejected your API credentials. Update the carrier's API key or secret in Carrier settings.** |
| Booking rejected | **Matkahuolto could not book the shipment.** |
| Parcel-point product without a point | **This carrier product delivers to a service point — select a droppoint before sending.** |
| Product vs countries | **The selected carrier product does not ship between these countries. Choose a different product.** |
| Carrier down | **The carrier service is currently unavailable.** / **The carrier rejected the request.** |
Auth failures after send: [Carrier authentication failures](/docs/knowledge-base/carrier-authentication-failures).
## Related
* [Connect a carrier or integration](/docs/how-to/connect-index)
* [Carrier credentials](/docs/how-to/carrier-credentials)
* [Sandbox mode](/docs/how-to/sandbox-mode)
* [Carrier products and services](/docs/how-to/carrier-products-and-services)
* [Connect an integration](/docs/how-to/connect-an-integration)
* [Request a carrier integration](/docs/how-to/request-carrier-integration)
* [Carriers](/docs/tutorials/carriers)