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

> Verbinde Helthjem unter Versanddienstleister mit Client-ID, Client-Secret und Shop-ID, dazu optional den Testmodus.

**Helthjem** versendet Pakete innerhalb Norwegens: Hauszustellung an die Haustür oder in den Briefkasten, Express über Nacht, Zustellung an Paketshops und Paketautomaten von Helthjem sowie Retouren, die Helthjem an der Haustür deines Kunden abholt oder die dein Kunde in einem Paketshop abgibt. Die Felder, die alle Versanddienstleister gemeinsam haben, stehen unter [Zugangsdaten der Versanddienstleister](/docs/de/how-to/carrier-credentials).

<Info>
  In diesem Formular wählst du keine Absenderadresse. Füge deine Adressen über das Organisationsmenü → **Verwalten** → **Adressen** hinzu. Die Absenderadresse wählst du bei jeder Sendung oder in einer [Versandregel](/docs/de/how-to/shipping-rule-fields). Helthjem versendet nur innerhalb Norwegens, daher müssen Absender und Empfänger beide in Norwegen sein.
</Info>

## Bevor du startest

* Ein Geschäftskundenkonto bei Helthjem. Das Integrationsteam von Helthjem ([integrations@helthjem.no](mailto:integrations@helthjem.no)) schickt Bestandskunden eine **Client-ID**, ein **Client-Secret** und eine **Shop-ID**. Wenn du noch kein Kunde von Helthjem bist, bewirb dich zuerst unter [helthjem.no/bli-kunde](https://helthjem.no/bli-kunde).
* Für den **Testmodus** separate Testzugangsdaten vom Integrationsteam von Helthjem. Deine Live-Zugangsdaten funktionieren im Testsystem nicht.

Du kannst Helthjem mehrmals verbinden. Gib jeder Verbindung einen eigenen **Name des Versanddienstleisters**. **Mehr erfahren** auf der Karte öffnet [helthjem.no/bli-kunde](https://helthjem.no/bli-kunde).

## Helthjem verbinden

<Steps>
  <Step title="Alle Versanddienstleister öffnen">
    Klicke in der Seitenleiste auf **Versanddienstleister** und öffne dann den Tab **Alle Versanddienstleister**.
  </Step>

  <Step title="Helthjem suchen">
    Klicke auf der Karte **Helthjem** auf **Verbinden**.
  </Step>

  <Step title="Formular ausfüllen">
    Das Fenster **Versanddienstleister verbinden** öffnet sich. Gib einen **Name des Versanddienstleisters**, deine **Client-ID**, dein **Client-Secret** und deine **Shop-ID** ein. **Testmodus** findest du unter **Optionale Felder**.
  </Step>

  <Step title="Versanddienstleister verbinden">
    Klicke auf **Verbinden**. Du siehst „Versanddienstleister verbunden“, und der Versanddienstleister erscheint im Tab **Meine Versanddienstleister**.
  </Step>
</Steps>

<Frame caption="Die Karte Helthjem unter Alle Versanddienstleister">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/01-all-carriers-card-light.png" alt="Alle Versanddienstleister mit der Karte Helthjem und ihren Schaltflächen Verbinden und Mehr erfahren" 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 Versanddienstleister mit der Karte Helthjem und ihren Schaltflächen Verbinden und Mehr erfahren" className="hidden dark:block" />
</Frame>

<Frame caption="Versanddienstleister verbinden für Helthjem - fülle Client-ID, Client-Secret und Shop-ID aus">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/02-connect-modal-light.png" alt="Fenster Versanddienstleister verbinden für Helthjem mit den erforderlichen Feldern Client-ID, Client-Secret und 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="Fenster Versanddienstleister verbinden für Helthjem mit den erforderlichen Feldern Client-ID, Client-Secret und Shop-ID" className="hidden dark:block" />
</Frame>

## Felder im Formular

| Feld | Erforderlich | Was du eingibst |
| - | - | - |
| **Name des Versanddienstleisters** | Ja | Der Name, den du unter **Meine Versanddienstleister** siehst und wenn du bei einer Sendung einen Versanddienstleister wählst. Er lautet zunächst **Helthjem**. |
| **Marke** | Nein | Wird nur angezeigt, wenn deine Organisation [Marken](/docs/de/how-to/create-a-brand) hat. Im Formular steht: „Nur diese Marke kann diesen Versanddienstleister nutzen.“ Lass das Feld leer, damit jede Marke ihn nutzen kann. |
| **Client-ID** | Ja | Kopiere sie genau so, wie Helthjem sie geschickt hat. Im Formular steht: „Die API-Client-ID, die das Integrationsteam von Helthjem für deinen Onlineshop ausgestellt hat ([integrations@helthjem.no](mailto:integrations@helthjem.no)).“ |
| **Client-Secret** | Ja | Im Formular steht: „Das API-Client-Secret, das zusammen mit der Client-ID ausgestellt wurde.“ |
| **Shop-ID** | Ja | Eine ganze Zahl. Im Formular steht: „Deine Helthjem-Shop-ID, eine Zahl wie 16, ausgestellt zusammen mit den API-Zugangsdaten.“ |
| **Testmodus** | Nein | Ein Kontrollkästchen, standardmäßig aus. Im Formular steht: „Nutzt die Testumgebung von Helthjem. Erfordert Testzugangsdaten von Helthjem. Produktive Zugangsdaten funktionieren dort nicht.“ |

**Verbinden** tut nichts, solange **Name des Versanddienstleisters**, **Client-ID**, **Client-Secret** und **Shop-ID** leer sind. Zippendo speichert deine Angaben, ohne sie bei Helthjem zu prüfen. Ein Fehler zeigt sich erst beim ersten Versand einer Sendung.

Der **Testmodus** sendet deine Sendungen an das Testsystem von Helthjem. Testzugangsdaten funktionieren nur bei eingeschaltetem **Testmodus** und Live-Zugangsdaten nur bei ausgeschaltetem. Gib zu den Testzugangsdaten die **Shop-ID** ein, die du dazu bekommst. Lass den **Testmodus** für echte Bestellungen aus. Siehe [Testmodus](/docs/de/how-to/sandbox-mode).

## Nach dem Verbinden

Der Versanddienstleister erscheint unter **Meine Versanddienstleister** mit dem Badge **Verbunden**. Das Versandprodukt wählst du bei jeder Sendung oder in einer Versandregel, nicht in diesem Formular. Siehe [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services). Ein Versandprodukt, das nicht in deinem Vertrag mit Helthjem steht, wird beim Versenden abgelehnt, und die Sendung zeigt die Begründung von Helthjem.

Viele Versandprodukte nennen eine Alternative. Helthjem probiert die Zustellwege in der angegebenen Reihenfolge und nutzt den ersten, der das Paket an dieser Adresse annehmen kann. Die Hauszustellung erreicht nicht jede Adresse in Norwegen. **Helthjem Home** und **Helthjem Express (alternativ Hauszustellung)** haben keinen Paketshop als Alternative, daher lehnt Helthjem eine solche Adresse ab. PostNord-Paketshops gehören zum Netz von Helthjem, du brauchst dafür also keine Verbindung zu PostNord.

| Zustellprodukt | Wohin das Paket geht |
| - | - |
| **Helthjem Home** | An die Haustür oder in den Briefkasten des Empfängers, innerhalb von 1-3 Tagen. |
| **Helthjem Home (alternativ Paketshop)** | Nach Hause. Sonst an einen Paketautomaten, einen Paketshop von Helthjem oder einen PostNord-Paketshop. |
| **Helthjem Home (alternativ Helthjem-Paketshop)** | Nach Hause. Sonst an einen Paketautomaten oder einen Paketshop von Helthjem. |
| **Helthjem Express (alternativ Hauszustellung)** | Über Nacht bis 07:00 Uhr an die Haustür, wo verfügbar. Sonst normale Hauszustellung. |
| **Helthjem Express (alle Alternativen)** | Über Nacht bis 07:00 Uhr, wo verfügbar. Sonst nach Hause, dann an einen Paketautomaten, einen Paketshop von Helthjem oder einen PostNord-Paketshop. |
| **Helthjem Service Point** | Der Paketshop von Helthjem, den du auswählst. |
| **Helthjem Service Point (alternativ PostNord)** | Der Paketshop von Helthjem oder PostNord, den du auswählst. |
| **Helthjem Parcel Locker** | Der Paketautomat, den du auswählst. |

| Retourenprodukt (Retourensendung) | Wie dein Kunde es zurückschickt |
| - | - |
| **Helthjem Return - Home Pickup** | Helthjem holt es bei deinem Kunden zu Hause ab. |
| **Helthjem Return - Home Pickup (alternativ Paketshop)** | Abholung zu Hause. Sonst gibt dein Kunde es in einem Paketshop von Helthjem oder PostNord ab. |
| **Helthjem Return - Home Pickup (alternativ Helthjem-Paketshop)** | Abholung zu Hause. Sonst gibt dein Kunde es in einem Paketshop von Helthjem ab. |
| **Helthjem Return - Home Pickup (alternativ Paketshop ohne Versandetikett)** | Abholung zu Hause. Sonst gibt dein Kunde es in einem Paketshop ab, mit einem Code statt eines Versandetiketts. |
| **Helthjem Return - Home Pickup (alternativ etikettenlos, dann mit Versandetikett)** | Abholung zu Hause. Sonst gibt dein Kunde es in einem Paketshop ab, zuerst mit einem Code, dann mit einem Versandetikett. |
| **Helthjem Return - Service Point** | Dein Kunde gibt es in einem Paketshop von Helthjem ab. |
| **Helthjem Return - Service Point (alternativ PostNord)** | Dein Kunde gibt es in einem Paketshop von Helthjem oder PostNord ab. |
| **Helthjem Return - Service Point, etikettenlos** | Dein Kunde gibt es in einem Paketshop ab, mit einem Code auf dem Paket statt eines Versandetiketts. |
| **Helthjem Return - Service Point, etikettenlos (alternativ PostNord)** | Etikettenlos in einem Paketshop. Sonst in einem PostNord-Paketshop, mit Versandetikett. |

Gewichtsgrenzen: 5 kg für Hauszustellung, Express, Paketautomaten und Abholung zu Hause, 20 kg in einem Paketshop von Helthjem, 90 kg bei Zustellung an einen PostNord-Paketshop und 35 kg bei Retouren aus einem solchen. Ein Paketautomat nimmt Pakete bis 59 x 45 x 50 cm an.

### Weitere Angaben und Adressen

Jedes Versandprodukt bietet unter **Weitere Angaben für den Versanddienstleister** das **Etikettenformat** an: PDF (Standard) oder ZPL für einen Thermoetikettendrucker. Zustellprodukte bieten außerdem **Nachricht an den Fahrer** und **Nachricht an den Empfänger**. Retouren mit Abholung zu Hause bieten **Abholdatum**.

Schreib die Wohnungs- oder Eingangsnummer in die Straßenadresse des Empfängers, zum Beispiel `Kongsberggata 18 H0201`. Eine zweite Adresszeile, die mit `c/o` beginnt, wird als c/o-Zeile gedruckt.

Helthjem sendet Abholbenachrichtigungen, PIN-Codes für Paketautomaten und Retourencodes per SMS oder E-Mail. Jedes Versandprodukt außer **Helthjem Home** und **Helthjem Express (alternativ Hauszustellung)** braucht die Telefonnummer oder E-Mail-Adresse des Empfängers. Jede Retoure braucht die deines Kunden.

### Paketshops und Paketautomaten

**Helthjem Service Point**, **Helthjem Service Point (alternativ PostNord)** und **Helthjem Parcel Locker** liefern an einen Paketshop oder Paketautomaten. Wähle ihn vor dem Versenden im Bereich **Paketshop** der Sendung. Siehe [Paketshop auswählen](/docs/de/how-to/pick-a-service-point) und [Paketshops](/docs/de/how-to/drop-point-and-service-points). Wenn ein Haus- oder Expressprodukt auf einen Paketautomaten oder Paketshop ausweicht, wählt Helthjem den, der dem Empfänger am nächsten liegt.

### Retouren

Eine Retoure bringt ein Paket von deinem Kunden in Norwegen an deine Adresse in Norwegen. Du wählst dafür keinen Paketshop. Wie du eine erstellst, steht unter [Retourensendungen](/docs/de/how-to/inbound-and-returns).

Lege bei einer Retoure mit Abholung zu Hause den Tag unter **Abholdatum** fest. Lässt du das Feld leer, fragt Zippendo nach dem ersten Tag, den Helthjem für die Adresse deines Kunden anbietet. Wenn Helthjem an dieser Adresse nicht abholen kann, wird **Helthjem Return - Home Pickup** nicht erstellt. Die anderen Versandprodukte mit Abholung zu Hause weichen auf ihre Alternative aus.

Eine etikettenlose Retoure gibt deinem Kunden einen Code statt eines Versandetiketts. Die Sendung zeigt ihn als **Code statt Versandetikett** unter **Sendungsverfolgung**, mit einem Button zum Kopieren. Schick den Code an deinen Kunden: Er schreibt ihn auf das Paket und gibt es in einem Paketshop ab.

### Versandetiketten, Abholungen, Sendungsverfolgung und Zoll

* Helthjem druckt ein Versandetikett im Format 102 x 192 mm pro Paket. Wenn das Versandetikett beim Versenden nicht ankommt, klicke bei der Sendung auf **Versandetikett abrufen**. Siehe [Überblick über Versandetiketten](/docs/de/labels/overview). Ein erneut abgerufenes Versandetikett ist immer ein PDF.
* Helthjem ist unter **Abholungen** nicht verfügbar. Unter [Eine Abholung planen](/docs/de/how-to/schedule-a-pickup) findest du die Versanddienstleister, bei denen das geht. Übergib deine Pakete so an Helthjem, wie es dein Vertrag beschreibt.
* Zippendo holt die Updates zur Sendungsverfolgung etwa einmal pro Stunde bei Helthjem ab. Du musst nichts einrichten. Jedes Paket hat seine eigene Sendungsnummer, und der Link zur Sendungsverfolgung öffnet die Sendungsverfolgung von Helthjem. Siehe [Webhooks zur Sendungsverfolgung der Versanddienstleister](/docs/de/how-to/tracking-webhooks).
* Helthjem versendet nur innerhalb Norwegens, daher braucht keine Sendung Zolldokumente.

## Verbindung ändern oder entfernen

Um sie zu ändern, öffne **Versanddienstleister** → **Meine Versanddienstleister** und klicke auf der Karte auf **Versanddienstleister bearbeiten**. Die Seite **Versanddienstleister bearbeiten** hat zwei Bereiche:

* **Allgemein**: **Name des Versanddienstleisters** und **Marke**, wenn deine Organisation Marken hat.
* **Einstellungen des Versanddienstleisters**: **Client-ID**, **Client-Secret**, **Shop-ID** und **Testmodus**.

Klicke auf **Speichern**. Du siehst „Versanddienstleister aktualisiert“.

Um sie zu entfernen, klicke auf derselben Seite auf **Löschen**, gib den Namen des Versanddienstleisters in Großbuchstaben ein und klicke auf **Löschen**. Versandregeln, die diesen Versanddienstleister nutzen, werden mit ihm gelöscht. Sendungen, die du bereits versendet hast, behalten ihre Versandetiketten und Sendungsnummern.

## Häufige Probleme

| Was du siehst | Was du tun kannst |
| - | - |
| „Der Versanddienstleister konnte nicht verbunden werden. Versuch es noch einmal.“ | Prüfe, ob jedes Pflichtfeld einen Wert hat, und versuch es dann noch einmal. |
| „Du hast das Limit deines Tarifs erreicht. Upgrade deinen Tarif oder entferne etwas, das du nicht mehr brauchst.“ oder „Du hast die Limits deines Tarifs überschritten. Upgrade deinen Tarif oder entferne, was du nicht mehr brauchst.“ | Das Limit für Versanddienstleister in deinem Tarif ist erreicht. Siehe [Abrechnung und Nutzung](/docs/de/how-to/billing-and-usage). |
| „Der Versanddienstleister hat deine Anmeldedaten abgelehnt. Aktualisiere die Zugangsdaten unter „Versanddienstleister“.“ beim Versenden | **Client-ID** oder **Client-Secret** ist falsch, oder die Zugangsdaten passen nicht zum **Testmodus**. Korrigiere sie unter **Versanddienstleister bearbeiten**. |
| „Die Einstellungen des Versanddienstleisters sind unvollständig oder ungültig. Prüfe sie unter „Versanddienstleister“.“ | Die **Shop-ID** ist keine ganze Zahl, oder es ist nicht die, die Helthjem mit diesen Zugangsdaten geschickt hat. |
| „Helthjem konnte die Sendung nicht erstellen.“ | Helthjem hat die Sendung abgelehnt, zum Beispiel wegen eines zu schweren oder zu großen Pakets, einer Adresse, die Helthjem mit diesem Versandprodukt nicht bedient, einer fehlenden Telefonnummer oder E-Mail-Adresse oder einer zu langen Straßenadresse. Die Sendung zeigt die Begründung von Helthjem. Behebe das und versende erneut. |
| „Helthjem konnte die Sendung nicht erstellen.“ bei **Helthjem Return - Home Pickup** | Helthjem kann an dieser Adresse nicht abholen, und es wurde nichts erstellt. Wähle stattdessen ein Retourenprodukt, das einen Paketshop nutzt. |
| „Dieses Versandprodukt liefert an einen Paketshop. Wähle vor dem Versenden einen Paketshop aus.“ | Wähle bei der Sendung einen Paketshop oder Paketautomaten. |
| „Das gewählte Versandprodukt versendet nicht zwischen diesen Ländern. Wähle ein anderes Versandprodukt.“ | Absender oder Empfänger ist außerhalb Norwegens. Helthjem versendet nur innerhalb Norwegens. |
| „Der Versanddienstleister hat die Sendung angenommen, aber das Versandetikett konnte nicht heruntergeladen werden. Das Paket wird trotzdem abgeholt. Klicke in der Sendung auf „Versandetikett abrufen“, um es noch einmal zu versuchen.“ | Klicke bei der Sendung auf **Versandetikett abrufen**. |
| „Die Verbindung zum Versanddienstleister ist abgebrochen, bevor er geantwortet hat. Zippendo hat keine Bestätigung, dass die Sendung erstellt wurde. Frag beim Versanddienstleister nach, bevor du sie erneut versendest.“ | Frag bei Helthjem nach, ob die Sendung existiert, bevor du sie erneut versendest. |
| „Der Versanddienstleister hat die Anfrage abgelehnt. Prüfe seine Begründung, korrigiere die Angaben und versuch es noch einmal.“ | Helthjem hat die Anfrage abgelehnt. Lies die Begründung bei der Sendung, korrigiere die Angaben und versende erneut. |
| „Wir erreichen die Versanddienstleister gerade nicht. Versuch es gleich noch einmal.“ | Zippendo erreicht die Versanddienstleister gerade nicht. Warte einen Moment und versende erneut. |

Weitere Hilfe: [Anmeldefehler bei Versanddienstleistern](/docs/de/knowledge-base/carrier-authentication-failures).

## Verwandte Themen

* [Versanddienstleister oder Integration verbinden](/docs/de/how-to/connect-index)
* [Zugangsdaten der Versanddienstleister](/docs/de/how-to/carrier-credentials)
* [Testmodus](/docs/de/how-to/sandbox-mode)
* [Versandprodukte und Zusatzleistungen](/docs/de/how-to/carrier-products-and-services)
* [Paketshop auswählen](/docs/de/how-to/pick-a-service-point)
* [Retourensendungen](/docs/de/how-to/inbound-and-returns)
* [Integration eines Versanddienstleisters anfragen](/docs/de/how-to/request-carrier-integration)
* [Versanddienstleister](/docs/de/tutorials/carriers)


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