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

# Connecter Helthjem

> Connectez Helthjem sous Transporteurs avec votre ID client, votre secret client et votre ID de boutique, ainsi que le mode test facultatif.

**Helthjem** expédie des colis en Norvège : livraison à domicile à la porte ou en boîte aux lettres, express de nuit, livraison dans des points relais et des consignes automatiques Helthjem, et retours que Helthjem enlève à la porte de votre client ou que votre client dépose dans un point relais. Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials).

<Info>
  Vous ne choisissez pas d'adresse de l'expéditeur dans ce formulaire. Ajoutez vos adresses sous le menu de l'organisation → **Gérer** → **Adresses**. Vous choisissez l'adresse de l'expéditeur sur chaque expédition ou dans une [règle d'expédition](/docs/fr/how-to/shipping-rule-fields). Helthjem n'expédie qu'en Norvège : l'expéditeur et le destinataire doivent donc tous deux se trouver en Norvège.
</Info>

## Avant de commencer

* Un compte client professionnel Helthjem. L'équipe d'intégration de Helthjem ([integrations@helthjem.no](mailto:integrations@helthjem.no)) envoie aux clients existants un **ID client**, un **Secret client** et un **ID de boutique**. Si vous n'êtes pas encore client de Helthjem, faites d'abord votre demande sur [helthjem.no/bli-kunde](https://helthjem.no/bli-kunde).
* Pour **Mode test**, des identifiants de test distincts fournis par l'équipe d'intégration de Helthjem. Vos identifiants de production ne fonctionnent pas sur le système de test.

Vous pouvez connecter Helthjem plusieurs fois. Donnez à chaque connexion son propre **Nom du transporteur**. **En savoir plus** sur la carte ouvre [helthjem.no/bli-kunde](https://helthjem.no/bli-kunde).

## Connecter Helthjem

<Steps>
  <Step title="Ouvrir Tous les transporteurs">
    Dans la barre latérale, cliquez sur **Transporteurs**, puis ouvrez l'onglet **Tous les transporteurs**.
  </Step>

  <Step title="Trouver Helthjem">
    Sur la carte **Helthjem**, cliquez sur **Connecter**.
  </Step>

  <Step title="Remplir le formulaire">
    La fenêtre **Connecter un transporteur** s'ouvre. Saisissez un **Nom du transporteur**, votre **ID client**, votre **Secret client** et votre **ID de boutique**. **Mode test** se trouve sous **Champs facultatifs**.
  </Step>

  <Step title="Connecter le transporteur">
    Cliquez sur **Connecter**. Vous voyez « Transporteur connecté », et le transporteur apparaît dans l'onglet **Mes transporteurs**.
  </Step>
</Steps>

<Frame caption="La carte Helthjem dans Tous les transporteurs">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/01-all-carriers-card-light.png" alt="Tous les transporteurs avec la carte Helthjem et ses boutons Connecter et En savoir plus" 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="Tous les transporteurs avec la carte Helthjem et ses boutons Connecter et En savoir plus" className="hidden dark:block" />
</Frame>

<Frame caption="Connecter un transporteur pour Helthjem - renseignez ID client, Secret client et ID de boutique">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-helthjem/02-connect-modal-light.png" alt="Fenêtre Connecter un transporteur pour Helthjem avec les champs obligatoires ID client, Secret client et ID de boutique" 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="Fenêtre Connecter un transporteur pour Helthjem avec les champs obligatoires ID client, Secret client et ID de boutique" className="hidden dark:block" />
</Frame>

## Champs du formulaire

| Champ | Obligatoire | Ce qu'il faut saisir |
| - | - | - |
| **Nom du transporteur** | Oui | Le nom que vous voyez dans **Mes transporteurs** et lorsque vous choisissez un transporteur sur une expédition. Il démarre à **Helthjem**. |
| **Marque** | Non | Affiché uniquement si votre organisation a des [marques](/docs/fr/how-to/create-a-brand). Le formulaire indique : « Seule cette marque peut utiliser ce transporteur. » Laissez vide pour que toutes les marques puissent l'utiliser. |
| **ID client** | Oui | Copiez-le exactement tel que Helthjem l'a envoyé. Le formulaire indique : « L'ID client d'API que l'équipe intégrations de Helthjem a fourni pour votre boutique en ligne ([integrations@helthjem.no](mailto:integrations@helthjem.no)). » |
| **Secret client** | Oui | Le formulaire indique : « Le secret client d'API fourni avec l'ID client. » |
| **ID de boutique** | Oui | Un nombre entier. Le formulaire indique : « Votre ID de boutique Helthjem, un nombre comme 16, fourni avec les identifiants d'API. » |
| **Mode test** | Non | Une case à cocher, décochée par défaut. Le formulaire indique : « Utiliser l'environnement de test de Helthjem. Nécessite des identifiants de test fournis par Helthjem ; les identifiants de production n'y fonctionnent pas. » |

**Connecter** ne fait rien tant que **Nom du transporteur**, **ID client**, **Secret client** et **ID de boutique** n'ont pas de valeur. Zippendo enregistre vos informations sans les vérifier auprès de Helthjem. Une erreur apparaît la première fois que vous envoyez une expédition.

**Mode test** envoie vos expéditions au système de test de Helthjem. Les identifiants de test ne fonctionnent que lorsque **Mode test** est activé, et les identifiants de production que lorsqu'il est désactivé. Avec les identifiants de test, saisissez l'**ID de boutique** qui les accompagne. Laissez **Mode test** désactivé pour les vraies commandes. Voir [Mode test](/docs/fr/how-to/sandbox-mode).

## Après la connexion

Le transporteur apparaît dans **Mes transporteurs** avec un badge **Connecté**. Vous choisissez l'offre sur chaque expédition ou dans une règle d'expédition, pas dans ce formulaire. Voir [Offres transporteur et services](/docs/fr/how-to/carrier-products-and-services). Une offre qui ne figure pas dans votre contrat Helthjem est refusée lors de l'envoi, et l'expédition affiche le motif donné par Helthjem.

De nombreuses offres prévoient une solution de repli. Helthjem essaie chaque mode de livraison dans l'ordre indiqué et utilise le premier qui peut prendre en charge le colis à cette adresse. La livraison à domicile n'atteint pas toutes les adresses en Norvège. **Helthjem Home** et **Helthjem Express (repli à domicile)** n'ont pas de point relais de repli : Helthjem refuse donc une telle adresse. Les points relais PostNord font partie du réseau de Helthjem : vous n'avez donc pas besoin d'une connexion PostNord pour les utiliser.

| Offre de livraison | Destination du colis |
| - | - |
| **Helthjem Home** | La porte ou la boîte aux lettres du destinataire, sous 1-3 jours. |
| **Helthjem Home (repli en point relais)** | Le domicile. Sinon, une consigne automatique, un point relais Helthjem ou un point relais PostNord. |
| **Helthjem Home (repli en point relais Helthjem)** | Le domicile. Sinon, une consigne automatique ou un point relais Helthjem. |
| **Helthjem Express (repli à domicile)** | De nuit, à la porte avant 07:00 là où c'est disponible. Sinon, une livraison à domicile ordinaire. |
| **Helthjem Express (repli complet)** | De nuit avant 07:00 là où c'est disponible. Sinon, le domicile, puis une consigne automatique, un point relais Helthjem ou un point relais PostNord. |
| **Helthjem Service Point** | Le point relais Helthjem que vous choisissez. |
| **Helthjem Service Point (repli PostNord)** | Le point relais Helthjem ou PostNord que vous choisissez. |
| **Helthjem Parcel Locker** | La consigne automatique que vous choisissez. |

| Offre de retour (expédition retour) | Comment votre client le renvoie |
| - | - |
| **Helthjem Return - Home Pickup** | Helthjem l'enlève au domicile de votre client. |
| **Helthjem Return - Home Pickup (repli en point relais)** | Enlèvement à domicile. Sinon, votre client le dépose dans un point relais Helthjem ou PostNord. |
| **Helthjem Return - Home Pickup (repli en point relais Helthjem)** | Enlèvement à domicile. Sinon, votre client le dépose dans un point relais Helthjem. |
| **Helthjem Return - Home Pickup (repli en point relais sans étiquette)** | Enlèvement à domicile. Sinon, votre client le dépose dans un point relais, avec un code au lieu d'une étiquette. |
| **Helthjem Return - Home Pickup (repli sans étiquette, puis avec étiquette)** | Enlèvement à domicile. Sinon, votre client le dépose dans un point relais avec un code, puis avec une étiquette. |
| **Helthjem Return - Service Point** | Votre client le dépose dans un point relais Helthjem. |
| **Helthjem Return - Service Point (repli PostNord)** | Votre client le dépose dans un point relais Helthjem ou PostNord. |
| **Helthjem Return - Service Point, sans étiquette** | Votre client le dépose dans un point relais, avec un code écrit sur le colis au lieu d'une étiquette. |
| **Helthjem Return - Service Point, sans étiquette (repli PostNord)** | Sans étiquette dans un point relais. Sinon, dans un point relais PostNord, avec une étiquette. |

Limites de poids : 5 kg pour la livraison à domicile, l'express, les consignes automatiques et l'enlèvement à domicile ; 20 kg dans un point relais Helthjem ; 90 kg pour une livraison dans un point relais PostNord et 35 kg pour un retour depuis un tel point. Une consigne automatique accepte les colis jusqu'à 59 x 45 x 50 cm.

### Informations supplémentaires et adresses

Chaque offre propose **Format d'étiquette** sous **Informations supplémentaires pour le transporteur** : PDF (par défaut), ou ZPL pour une imprimante d'étiquettes thermique. Les offres de livraison proposent aussi **Message au chauffeur** et **Message au destinataire**. Les retours enlevés à domicile proposent **Date d'enlèvement**.

Indiquez le numéro d'appartement ou d'entrée dans l'adresse postale du destinataire, par exemple `Kongsberggata 18 H0201`. Une deuxième ligne d'adresse qui commence par `c/o` s'imprime comme ligne c/o.

Helthjem envoie les avis de mise à disposition, les codes PIN des consignes automatiques et les codes de retour par SMS ou par e-mail. Toutes les offres, sauf **Helthjem Home** et **Helthjem Express (repli à domicile)**, nécessitent le numéro de téléphone ou l'adresse e-mail du destinataire. Chaque retour nécessite ceux de votre client.

### Points relais et consignes automatiques

**Helthjem Service Point**, **Helthjem Service Point (repli PostNord)** et **Helthjem Parcel Locker** livrent dans un point relais ou une consigne automatique. Choisissez-le dans la section **Point relais** de l'expédition avant l'envoi. Voir [Choisir un point relais](/docs/fr/how-to/pick-a-service-point) et [Points relais](/docs/fr/how-to/drop-point-and-service-points). Lorsqu'une offre à domicile ou express se replie sur une consigne automatique ou un point relais, Helthjem choisit celui le plus proche du destinataire.

### Retours

Un retour achemine un colis de votre client en Norvège jusqu'à votre adresse en Norvège. Vous ne choisissez pas de point relais pour celui-ci. Pour en créer un, voir [Expéditions retour](/docs/fr/how-to/inbound-and-returns).

Pour un retour enlevé à domicile, indiquez le jour dans **Date d'enlèvement**. Si vous laissez ce champ vide, Zippendo demande le premier jour proposé par Helthjem pour l'adresse de votre client. Si Helthjem ne peut pas effectuer l'enlèvement à cette adresse, **Helthjem Return - Home Pickup** n'est pas créé. Les autres offres d'enlèvement à domicile passent à leur solution de repli.

Un retour sans étiquette fournit à votre client un code au lieu d'une étiquette. L'expédition l'affiche comme **Code sans étiquette** sous **Informations de suivi**, avec un bouton de copie. Envoyez le code à votre client : il l'écrit sur le colis et le dépose dans un point relais.

### Étiquettes, enlèvements, suivi et douane

* Helthjem imprime une étiquette de 102 x 192 mm par colis. Si l'étiquette n'arrive pas lors de l'envoi, cliquez sur **Récupérer l'étiquette** sur l'expédition. Voir [Étiquettes](/docs/fr/labels/overview). Une étiquette récupérée à nouveau est toujours au format PDF.
* Helthjem n'est pas disponible sous **Enlèvements**. Voir [Planifier un enlèvement](/docs/fr/how-to/schedule-a-pickup) pour les transporteurs qui le sont. Remettez vos colis à Helthjem comme le prévoit votre contrat.
* Zippendo récupère les mises à jour de suivi de Helthjem environ toutes les heures. Il n'y a rien à configurer. Chaque colis a son propre numéro de suivi, et le lien de suivi ouvre la page de suivi de Helthjem. Voir [Webhooks de suivi des transporteurs](/docs/fr/how-to/tracking-webhooks).
* Helthjem n'expédie qu'en Norvège : aucune expédition ne nécessite donc de documents douaniers.

## Modifier ou supprimer la connexion

Pour la modifier, ouvrez **Transporteurs** → **Mes transporteurs** et cliquez sur **Modifier le transporteur** sur la carte. La page **Modifier le transporteur** comporte deux sections :

* **Général** : **Nom du transporteur**, et **Marque** si votre organisation a des marques.
* **Paramètres du transporteur** : **ID client**, **Secret client**, **ID de boutique** et **Mode test**.

Cliquez sur **Enregistrer**. Vous voyez « Transporteur mis à jour ».

Pour la supprimer, cliquez sur **Supprimer** sur la même page, saisissez le nom du transporteur en majuscules, puis cliquez sur **Supprimer**. Les règles d'expédition qui utilisent ce transporteur sont supprimées avec lui. Les expéditions déjà envoyées conservent leurs étiquettes et leurs numéros de suivi.

## Problèmes courants

| Ce que vous voyez | Que faire |
| - | - |
| « Impossible de connecter le transporteur. Réessayez. » | Vérifiez que chaque champ obligatoire a une valeur, puis réessayez. |
| « Vous avez atteint la limite de votre formule. Changez de formule ou supprimez un élément que vous n'utilisez plus. » ou « Vous dépassez les limites de votre formule. Changez de formule ou supprimez ce que vous n'utilisez plus. » | La limite de transporteurs de votre formule est atteinte. Voir [Facturation et utilisation](/docs/fr/how-to/billing-and-usage). |
| « Le transporteur a refusé vos identifiants. Mettez-les à jour sous Transporteurs. » lors de l'envoi | L'**ID client** ou le **Secret client** est incorrect, ou les identifiants ne correspondent pas à **Mode test**. Corrigez-les dans **Modifier le transporteur**. |
| « Les paramètres du transporteur sont incomplets ou non valides. Vérifiez-les sous Transporteurs. » | L'**ID de boutique** n'est pas un nombre entier, ou ce n'est pas celui que Helthjem a envoyé avec ces identifiants. |
| « Helthjem n'a pas pu créer l'expédition. » | Helthjem a refusé l'expédition, par exemple un colis trop lourd ou trop grand, une adresse que Helthjem ne dessert pas avec cette offre, un numéro de téléphone ou une adresse e-mail manquant, ou une adresse postale trop longue. L'expédition affiche le motif donné par Helthjem. Corrigez-le et envoyez à nouveau. |
| « Helthjem n'a pas pu créer l'expédition. » pour **Helthjem Return - Home Pickup** | Helthjem ne peut pas effectuer l'enlèvement à cette adresse, et rien n'a été créé. Choisissez plutôt une offre de retour qui utilise un point relais. |
| « Cette offre transporteur livre en point relais. Choisissez un point relais avant l'envoi. » | Choisissez un point relais ou une consigne automatique sur l'expédition. |
| « L'offre transporteur choisie ne dessert pas ces pays. Choisissez-en une autre. » | L'expéditeur ou le destinataire se trouve hors de Norvège. Helthjem n'expédie qu'en Norvège. |
| « Le transporteur a accepté l'expédition, mais son étiquette n'a pas pu être téléchargée. Le colis sera tout de même enlevé. Utilisez Récupérer l'étiquette sur l'expédition pour réessayer. » | Cliquez sur **Récupérer l'étiquette** sur l'expédition. |
| « La connexion avec le transporteur a été perdue avant sa réponse. Zippendo n'a aucune confirmation que l'expédition a été créée : vérifiez auprès du transporteur avant de la renvoyer. » | Vérifiez auprès de Helthjem si l'expédition existe avant de la renvoyer. |
| « Le transporteur a refusé la demande. Consultez le motif indiqué par le transporteur, corrigez les informations et réessayez. » | Helthjem a refusé la demande. Lisez le motif sur l'expédition, corrigez les informations et envoyez à nouveau. |
| « Impossible de joindre les transporteurs pour le moment. Réessayez dans un instant. » | Zippendo ne parvient pas à joindre les transporteurs pour le moment. Patientez un instant et envoyez à nouveau. |

Plus d'aide : [Échecs d'authentification auprès des transporteurs](/docs/fr/knowledge-base/carrier-authentication-failures).

## Voir aussi

* [Connecter un transporteur ou une intégration](/docs/fr/how-to/connect-index)
* [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials)
* [Mode test](/docs/fr/how-to/sandbox-mode)
* [Offres transporteur et services](/docs/fr/how-to/carrier-products-and-services)
* [Choisir un point relais](/docs/fr/how-to/pick-a-service-point)
* [Expéditions retour](/docs/fr/how-to/inbound-and-returns)
* [Demander une intégration de transporteur](/docs/fr/how-to/request-carrier-integration)
* [Transporteurs](/docs/fr/tutorials/carriers)


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