> ## 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.

# Helthjem koppelen

> Koppel Helthjem onder Vervoerders met je Client-ID, Clientgeheim en Shop-ID, plus de optionele Testmodus.

**Helthjem** verzendt pakketten binnen Noorwegen: thuisbezorging aan de deur of in de brievenbus, express voor de volgende ochtend, bezorging bij afhaalpunten en pakketautomaten van Helthjem, en retouren die Helthjem aan de deur van je klant ophaalt of die je klant bij een afhaalpunt afgeeft. De velden die elke vervoerder heeft, staan onder [Inloggegevens van de vervoerder](/docs/nl/how-to/carrier-credentials).

<Info>
  In dit formulier kies je geen afzenderadres. Voeg je adressen toe via het organisatiemenu → **Beheren** → **Adressen**. Je kiest het afzenderadres bij elke zending of in een [verzendregel](/docs/nl/how-to/shipping-rule-fields). Helthjem verzendt alleen binnen Noorwegen, dus de afzender en de ontvanger moeten allebei in Noorwegen zijn.
</Info>

## Voordat je begint

* Een zakelijk klantaccount bij Helthjem. Het integratieteam van Helthjem ([integrations@helthjem.no](mailto:integrations@helthjem.no)) stuurt bestaande klanten een **Client-ID**, een **Clientgeheim** en een **Shop-ID**. Ben je nog geen klant van Helthjem, meld je dan eerst aan via [helthjem.no/bli-kunde](https://helthjem.no/bli-kunde).
* Voor **Testmodus**: aparte testinloggegevens van het integratieteam van Helthjem. Je live inloggegevens werken niet in het testsysteem.

Je kunt Helthjem meer dan één keer koppelen. Geef elke koppeling een eigen **Naam van de vervoerder**. **Meer informatie** op de kaart opent [helthjem.no/bli-kunde](https://helthjem.no/bli-kunde).

## Helthjem koppelen

<Steps>
  <Step title="Alle vervoerders openen">
    Klik in de zijbalk op **Vervoerders** en open dan het tabblad **Alle vervoerders**.
  </Step>

  <Step title="Helthjem zoeken">
    Klik op de kaart **Helthjem** op **Koppelen**.
  </Step>

  <Step title="Het formulier invullen">
    Het venster **Vervoerder koppelen** gaat open. Vul een **Naam van de vervoerder**, je **Client-ID**, **Clientgeheim** en **Shop-ID** in. **Testmodus** staat onder **Optionele velden**.
  </Step>

  <Step title="De vervoerder koppelen">
    Klik op **Koppelen**. Je ziet "Vervoerder gekoppeld" en de vervoerder verschijnt op het tabblad **Mijn vervoerders**.
  </Step>
</Steps>

<Frame caption="De kaart Helthjem bij Alle vervoerders">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/01-all-carriers-card-light.png" alt="Alle vervoerders met de kaart Helthjem en de knoppen Koppelen en Meer informatie" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/01-all-carriers-card-dark.png" alt="Alle vervoerders met de kaart Helthjem en de knoppen Koppelen en Meer informatie" className="hidden dark:block" />
</Frame>

<Frame caption="Vervoerder koppelen voor Helthjem - vul Client-ID, Clientgeheim en Shop-ID in">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/02-connect-modal-light.png" alt="Venster Vervoerder koppelen voor Helthjem met de verplichte velden Client-ID, Clientgeheim en Shop-ID" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/02-connect-modal-dark.png" alt="Venster Vervoerder koppelen voor Helthjem met de verplichte velden Client-ID, Clientgeheim en Shop-ID" className="hidden dark:block" />
</Frame>

## Velden op het formulier

| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam van de vervoerder** | Ja | De naam die je ziet bij **Mijn vervoerders** en wanneer je een vervoerder kiest bij een zending. Begint als **Helthjem**. |
| **Merk** | Nee | Alleen zichtbaar als je organisatie [merken](/docs/nl/how-to/create-a-brand) heeft. Het formulier zegt: "Alleen dit merk kan deze vervoerder gebruiken." Laat leeg zodat elk merk hem kan gebruiken. |
| **Client-ID** | Ja | Kopieer hem precies zoals Helthjem hem heeft gestuurd. Het formulier zegt: "De API-client-ID die het integratieteam van Helthjem voor je webshop heeft uitgegeven ([integrations@helthjem.no](mailto:integrations@helthjem.no))." |
| **Clientgeheim** | Ja | Het formulier zegt: "Het API-clientgeheim dat samen met de client-ID is uitgegeven." |
| **Shop-ID** | Ja | Een geheel getal. Het formulier zegt: "Je shop-ID bij Helthjem, een nummer zoals 16, uitgegeven samen met de API-inloggegevens." |
| **Testmodus** | Nee | Een selectievakje, standaard uit. Het formulier zegt: "Gebruik de testomgeving van Helthjem. Hiervoor zijn testinloggegevens van Helthjem nodig; productie-inloggegevens werken daar niet." |

**Koppelen** doet niets zolang **Naam van de vervoerder**, **Client-ID**, **Clientgeheim** en **Shop-ID** geen waarde hebben. Zippendo slaat je gegevens op zonder ze bij Helthjem te controleren. Een fout zie je pas de eerste keer dat je een zending verzendt.

**Testmodus** stuurt je zendingen naar het testsysteem van Helthjem. Testinloggegevens werken alleen met **Testmodus** aan, en live inloggegevens alleen met de modus uit. Vul bij de testinloggegevens de **Shop-ID** in die daarbij hoort. Laat **Testmodus** uit voor echte bestellingen. Zie [Testmodus](/docs/nl/how-to/sandbox-mode).

## Na het koppelen

De vervoerder verschijnt bij **Mijn vervoerders** met het label **Gekoppeld**. Je kiest het verzendproduct bij elke zending of in een verzendregel, niet in dit formulier. Zie [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services). Een verzendproduct dat niet in je overeenkomst met Helthjem staat, wordt bij het verzenden geweigerd, en de zending toont de reden van Helthjem.

Veel verzendproducten noemen een alternatief. Helthjem probeert elke bezorgmanier in de getoonde volgorde en gebruikt de eerste die het pakket op dat adres kan aannemen. Thuisbezorging bereikt niet elk adres in Noorwegen. **Helthjem Home** en **Helthjem Express (alternatief: thuisbezorging)** hebben geen afhaalpunt als alternatief, dus Helthjem weigert zo'n adres. Afhaalpunten van PostNord horen bij het netwerk van Helthjem, dus daarvoor heb je geen koppeling met PostNord nodig.

| Bezorgproduct | Waar het pakket naartoe gaat |
| - | - |
| **Helthjem Home** | De deur of brievenbus van de ontvanger, binnen 1-3 dagen. |
| **Helthjem Home (alternatief: afhaalpunt)** | Thuis. Anders een pakketautomaat, een afhaalpunt van Helthjem of een afhaalpunt van PostNord. |
| **Helthjem Home (alternatief: afhaalpunt van Helthjem)** | Thuis. Anders een pakketautomaat of een afhaalpunt van Helthjem. |
| **Helthjem Express (alternatief: thuisbezorging)** | 's Nachts aan de deur, vóór 07:00 waar dat kan. Anders gewone thuisbezorging. |
| **Helthjem Express (alle alternatieven)** | 's Nachts, vóór 07:00 waar dat kan. Anders thuis, dan een pakketautomaat, een afhaalpunt van Helthjem of een afhaalpunt van PostNord. |
| **Helthjem Service Point** | Het afhaalpunt van Helthjem dat je kiest. |
| **Helthjem Service Point (alternatief: PostNord)** | Het afhaalpunt van Helthjem of PostNord dat je kiest. |
| **Helthjem Parcel Locker** | De pakketautomaat die je kiest. |

| Retourproduct (retourzending) | Hoe je klant het terugstuurt |
| - | - |
| **Helthjem Return - Home Pickup** | Helthjem haalt het op bij je klant thuis. |
| **Helthjem Return - Home Pickup (alternatief: afhaalpunt)** | Ophalen aan huis. Anders geeft je klant het af bij een afhaalpunt van Helthjem of PostNord. |
| **Helthjem Return - Home Pickup (alternatief: afhaalpunt van Helthjem)** | Ophalen aan huis. Anders geeft je klant het af bij een afhaalpunt van Helthjem. |
| **Helthjem Return - Home Pickup (alternatief: afhaalpunt zonder label)** | Ophalen aan huis. Anders geeft je klant het af bij een afhaalpunt, met een code in plaats van een verzendlabel. |
| **Helthjem Return - Home Pickup (alternatief: zonder label, daarna met label)** | Ophalen aan huis. Anders geeft je klant het af bij een afhaalpunt met een code, en daarna met een verzendlabel. |
| **Helthjem Return - Service Point** | Je klant geeft het af bij een afhaalpunt van Helthjem. |
| **Helthjem Return - Service Point (alternatief: PostNord)** | Je klant geeft het af bij een afhaalpunt van Helthjem of PostNord. |
| **Helthjem Return - Service Point, zonder label** | Je klant geeft het af bij een afhaalpunt, met een code op het pakket in plaats van een verzendlabel. |
| **Helthjem Return - Service Point, zonder label (alternatief: PostNord)** | Zonder label bij een afhaalpunt. Anders bij een afhaalpunt van PostNord, met een verzendlabel. |

Gewichtslimieten: 5 kg voor thuisbezorging, express, pakketautomaten en ophalen aan huis; 20 kg bij een afhaalpunt van Helthjem; 90 kg bij bezorging aan een afhaalpunt van PostNord en 35 kg bij een retour vanaf zo'n afhaalpunt. Een pakketautomaat neemt pakketten tot 59 x 45 x 50 cm aan.

### Extra gegevens en adressen

Elk verzendproduct biedt **Labelformaat** onder **Extra gegevens voor de vervoerder**: PDF (de standaard), of ZPL voor een thermische labelprinter. Bezorgproducten bieden ook **Bericht aan de chauffeur** en **Bericht aan de ontvanger**. Retouren die aan huis worden opgehaald, bieden **Ophaaldatum**.

Zet het appartement- of ingangsnummer in het straatadres van de ontvanger, bijvoorbeeld `Kongsberggata 18 H0201`. Een tweede adresregel die met `c/o` begint, wordt als c/o-regel geprint.

Helthjem stuurt ophaalmeldingen, pincodes voor pakketautomaten en retourcodes per sms of e-mail. Elk verzendproduct behalve **Helthjem Home** en **Helthjem Express (alternatief: thuisbezorging)** heeft het telefoonnummer of e-mailadres van de ontvanger nodig. Elke retour heeft dat van je klant nodig.

### Afhaalpunten en pakketautomaten

**Helthjem Service Point**, **Helthjem Service Point (alternatief: PostNord)** en **Helthjem Parcel Locker** bezorgen bij een afhaalpunt of pakketautomaat. Kies dat in de sectie **Afhaalpunt** van de zending voordat je verzendt. Zie [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point) en [Afhaalpunten](/docs/nl/how-to/drop-point-and-service-points). Als een thuis- of expressproduct terugvalt op een pakketautomaat of afhaalpunt, kiest Helthjem degene die het dichtst bij de ontvanger ligt.

### Retouren

Een retour brengt een pakket van je klant in Noorwegen naar jouw adres in Noorwegen. Je kiest er geen afhaalpunt voor. Hoe je een retour aanmaakt, lees je in [Retourzendingen](/docs/nl/how-to/inbound-and-returns).

Bij een retour die aan huis wordt opgehaald, stel je de dag in bij **Ophaaldatum**. Laat je die leeg, dan vraagt Zippendo om de eerste dag die Helthjem voor het adres van je klant aanbiedt. Kan Helthjem op dat adres niet ophalen, dan wordt **Helthjem Return - Home Pickup** niet aangemaakt. De andere producten voor ophalen aan huis gaan dan over op hun alternatief.

Een retour zonder label geeft je klant een code in plaats van een verzendlabel. De zending toont die als **Code voor verzenden zonder label** onder **Track & trace**, met een kopieerknop. Stuur de code naar je klant: die schrijft hem op het pakket en geeft het af bij een afhaalpunt.

### Verzendlabels, ophaalopdrachten, track & trace en douane

* Helthjem print per pakket één verzendlabel van 102 x 192 mm. Komt het verzendlabel bij het verzenden niet aan, klik dan op **Verzendlabel ophalen** bij de zending. Zie [Overzicht van verzendlabels](/docs/nl/labels/overview). Een verzendlabel dat je opnieuw ophaalt, is altijd een pdf.
* Helthjem is niet beschikbaar onder **Ophaalopdrachten**. Zie [Een ophaalopdracht plannen](/docs/nl/how-to/schedule-a-pickup) voor de vervoerders waarbij dat wel kan. Geef je pakketten aan Helthjem mee zoals in je overeenkomst staat.
* Zippendo haalt ongeveer één keer per uur track & trace-updates op bij Helthjem. Je hoeft niets in te stellen. Elk pakket heeft een eigen trackingnummer, en de track & trace-link opent de trackingpagina van Helthjem. Zie [Trackingwebhooks van vervoerders](/docs/nl/how-to/tracking-webhooks).
* Helthjem verzendt alleen binnen Noorwegen, dus geen enkele zending heeft douanedocumenten nodig.

## De koppeling wijzigen of verwijderen

Om te wijzigen open je **Vervoerders** → **Mijn vervoerders** en klik je op de kaart op **Vervoerder bewerken**. De pagina **Vervoerder bewerken** heeft twee secties:

* **Algemeen**: **Naam van de vervoerder**, en **Merk** als je organisatie merken heeft.
* **Vervoerderinstellingen**: **Client-ID**, **Clientgeheim**, **Shop-ID** en **Testmodus**.

Klik op **Opslaan**. Je ziet "Vervoerder bijgewerkt".

Om te verwijderen, klik je op dezelfde pagina op **Verwijderen**, typ je de naam van de vervoerder in hoofdletters en klik je op **Verwijderen**. Verzendregels die deze vervoerder gebruiken, worden samen met hem verwijderd. Zendingen die je al hebt verzonden, houden hun verzendlabels en trackingnummers.

## Veelvoorkomende problemen

| Wat je ziet | Wat je doet |
| - | - |
| "Kan de vervoerder niet koppelen. Probeer het opnieuw." | Controleer of elk verplicht veld een waarde heeft en probeer het opnieuw. |
| "Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt." of "Je zit boven de limieten van je abonnement. Upgrade je abonnement of verwijder wat je niet meer gebruikt." | De vervoerderlimiet van je abonnement is bereikt. Zie [Facturatie en gebruik](/docs/nl/how-to/billing-and-usage). |
| "De vervoerder heeft je inloggegevens geweigerd. Werk de inloggegevens bij onder Vervoerders." bij het verzenden | De **Client-ID** of het **Clientgeheim** klopt niet, of de inloggegevens passen niet bij **Testmodus**. Corrigeer ze bij **Vervoerder bewerken**. |
| "De instellingen van de vervoerder zijn onvolledig of ongeldig. Controleer ze onder Vervoerders." | De **Shop-ID** is geen geheel getal, of het is niet de ID die Helthjem bij deze inloggegevens heeft gestuurd. |
| "Helthjem kon de zending niet aanmaken." | Helthjem heeft de zending geweigerd, bijvoorbeeld een pakket dat te zwaar of te groot is, een adres dat Helthjem met dit verzendproduct niet bedient, een ontbrekend telefoonnummer of e-mailadres, of een straatadres dat te lang is. De zending toont de reden van Helthjem. Los het op en verzend opnieuw. |
| "Helthjem kon de zending niet aanmaken." bij **Helthjem Return - Home Pickup** | Helthjem kan op dit adres niet ophalen, en er is niets aangemaakt. Kies in plaats daarvan een retourproduct dat een afhaalpunt gebruikt. |
| "Dit verzendproduct bezorgt bij een afhaalpunt. Kies een afhaalpunt voordat je verzendt." | Kies een afhaalpunt of pakketautomaat bij de zending. |
| "Het gekozen verzendproduct verzendt niet tussen deze landen. Kies een ander verzendproduct." | De afzender of de ontvanger is buiten Noorwegen. Helthjem verzendt alleen binnen Noorwegen. |
| "De vervoerder heeft de zending geaccepteerd, maar het verzendlabel kon niet worden gedownload. Het pakket wordt wel opgehaald. Gebruik Verzendlabel ophalen bij de zending om het opnieuw te proberen." | Klik op **Verzendlabel ophalen** bij de zending. |
| "De verbinding met de vervoerder werd verbroken voordat er antwoord kwam. Zippendo heeft geen bevestiging dat de zending is aangemaakt. Controleer dit bij de vervoerder voordat je opnieuw verzendt." | Controleer bij Helthjem of de zending bestaat voordat je hem opnieuw verzendt. |
| "De vervoerder heeft dit geweigerd. Bekijk de reden van de vervoerder, corrigeer de gegevens en probeer het opnieuw." | Helthjem heeft het verzoek geweigerd. Lees de reden bij de zending, corrigeer de gegevens en verzend opnieuw. |
| "We kunnen de vervoerders nu niet bereiken. Probeer het zo opnieuw." | Zippendo kan de vervoerders op dit moment niet bereiken. Wacht even en verzend opnieuw. |

Meer hulp: [Authenticatiefouten bij vervoerders](/docs/nl/knowledge-base/carrier-authentication-failures).

## Gerelateerd

* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)
* [Inloggegevens van de vervoerder](/docs/nl/how-to/carrier-credentials)
* [Testmodus](/docs/nl/how-to/sandbox-mode)
* [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services)
* [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point)
* [Retourzendingen](/docs/nl/how-to/inbound-and-returns)
* [Een vervoerdersintegratie aanvragen](/docs/nl/how-to/request-carrier-integration)
* [Vervoerders](/docs/nl/tutorials/carriers)


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