---
title: "Importation de données – Importer des données d'emplacement"
description: "Un guide complet sur l'importation de données d'emplacement, qui permet d'importer en masse des emplacements ainsi que des alias pour les intégrations externes et des configurations de préremplissage des arrêts."
url: https://help.qargo.com/fr/articles/413082-importation-de-donnees-importer-des-donnees-d-emplacement
locale: fr
updated: 2026-05-28
---

# Importation de données – Importer des données d'emplacement

La fonctionnalité d'importation d'emplacements est un outil efficace pour alimenter en masse un tenant Qargo avec les informations essentielles sur les emplacements. Ce guide présente le processus, de la façon de compléter le modèle fourni jusqu'aux différentes sections configurables.

* * *

## 📖 Terminologie clé {#h_fe40a72b59}

-   **Emplacement :** une adresse physique ou une entreprise.
-   **Alias d'importation de commande :** un identifiant unique d'un emplacement, utilisé pour le relier à un système externe lors des importations et des exportations.
-   **Préremplissage des arrêts :** une section qui permet de préremplir certains détails pour tous les arrêts effectués à un emplacement, comme la durée ou les plages horaires.


* * *

## ✅ Exigences et limites essentielles de l'importation {#h_91da1d6fa9}

-   **Champs obligatoires :** pour qu'une importation réussisse, toutes les colonnes obligatoires doivent être complétées. Cela comprend **address**, **city**, **country**, **name** et **postal\_code**.
-   **Identifiants uniques :**

    -   **row\_id :** il s'agit de l'identifiant principal. Si un **row\_id** est fourni, le système l'utilise pour faire correspondre et mettre à jour un emplacement existant, et il prime sur tout autre identifiant.
    -   **order\_import\_alias\_\_location\_identifier :** en l'absence de **row\_id**, ce champ sert à identifier l'emplacement. Il n'est pertinent que lorsqu'un **alias** est ajouté ou mis à jour.
    -   **address :** il s'agit de l'identifiant unique par défaut et du **cas d'utilisation le plus courant**. Si ni **row\_id** ni **order\_import\_alias\_\_location\_identifier** n'est fourni, le système utilise l'adresse pour identifier ou créer l'emplacement.

        -   Lorsque l'**address** sert d'identifiant unique, le système crée un nouvel emplacement si l'adresse importée ne correspond pas exactement à une adresse existante. Cela peut entraîner la création d'emplacements en double.
-   **Configuration du préremplissage des arrêts :** les champs de préremplissage des arrêts ne sont utilisés que si la colonne **stop\_prefill\_\_type** est complétée.


* * *

## 🛠️ Processus d'importation des données étape par étape {#h_03235693c7}

## Étape 1 : télécharger le modèle {#h_e7d1626a7f}

Un modèle de feuille de calcul spécifique est disponible pour téléverser les données d'emplacement. **Pour pouvoir modifier et téléverser les données, il faut télécharger une copie du modèle :**

1.  Cliquer sur le lien : [Modèle d'importation de données d'emplacement](https://docs.google.com/spreadsheets/d/1NQKMJ5fgt1Xwq4mqfDmu-qa1zLS-QVl86T-vW2zTzgE/edit?usp=sharing)
2.  Une fois le modèle ouvert, aller dans **Fichier** et sélectionner **Télécharger**
3.  Enregistrer le modèle **(au format .xlsx ou .csv)** sur l'ordinateur et commencer à saisir les données de l'entreprise.

![](https://help.qargo.com/media/e17504cb3083-image.png)

:::callout{tone="info"}
📚 Toujours utiliser un modèle vierge téléchargé directement depuis cet article ou fourni par l'équipe Qargo. La réutilisation d'un ancien modèle peut entraîner des erreurs d'importation.
:::

## Étape 2 : compléter le modèle Excel {#h_86a0876bc7}

Ouvrir le modèle et le compléter avec les données requises. Le modèle contient des en-têtes de colonnes qui correspondent aux champs de Qargo.

-   **Champs obligatoires :** veiller à compléter tous les champs obligatoires (la liste complète des champs obligatoires figure dans la section suivante de cet article). Une importation échoue si ces champs sont laissés vides.
-   **Mise en forme :** une attention particulière doit être portée au format de données indiqué (par ex. dates, nombres, texte).\
    ​

## Étape 3 : soumettre pour téléversement {#h_23ce7e0d65}

1.  **Pendant l'intégration :** travailler directement avec le **responsable de l'intégration** pour téléverser les données initiales de l'entreprise. Il accompagne tout le processus et veille à la réussite de l'importation.
2.  **Après l'intégration :** pour toutes les futures mises à jour et importations de données, contacter le **responsable de compte**. Il aide lors du téléversement et apporte une assistance continue.


* * *

**📝 Détails du modèle d'importation d'emplacements**

Le tableau suivant explique en détail, champ par champ, le modèle Excel d'importation d'emplacements, qui se divise en trois parties : **Détails de l'emplacement**, **Alias d'importation de commande** et **Configuration du préremplissage des arrêts**. Cette explication comprend les formats de données, les champs obligatoires et les bonnes pratiques pour compléter chaque colonne :

### Détails de l'emplacement {#h_12fea01632}

| **Nom de colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| name | Obligatoire | Le nom usuel du lieu ou de l'entreprise. | Googleplex |
| address | Obligatoire | L'adresse principale (rue) de l'emplacement. | 1600 Amphitheatre Parkway |
| address\_second\_line |  | Une deuxième ligne facultative pour des détails d'adresse supplémentaires, comme un numéro d'appartement ou de bureau. | Suite 201 |
| city | Obligatoire | La ville ou la localité | Mountain View |
| postal\_code | Obligatoire | Le code postal | 94043 |
| state |  | L'État, la province ou la région. | California |
| country | Obligatoire | Le pays où se trouve l'emplacement. | United States |
| description |  | Description détaillée du lieu, de sa fonction ou de ses caractéristiques. | Un beau parc avec des sentiers de promenade et une grande aire de jeux. |
| latitude |  | coordonnée géographique (nord-sud) | 51.21049 |
| longitude |  | coordonnée géographique (est-ouest) | 3.808144 |
| place\_id |  | Un identifiant unique du lieu, issu de Google Places | ChIJ2e6n95nFwoAR0pG9C-PTBOM |
| display\_name |  | Le code et le nom affiché de l'emplacement | ABC-12345 |
| row\_id |  | ID interne Qargo (pour forcer une mise à jour) |  |
| selectable\_on\_customer\_portal |  | Indique quels emplacements sont visibles dans le portail client.\
Visibilité limitée à ALL (tous les clients) ou NONE (aucun client). | ALL |

### Alias d'importation de commande {#h_105aa957bc}

| **Nom de colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| order\_import\_alias\_\_location\_identifier | Obligatoire si l'exportation ou l'importation est à true. | Alias d'importation de commande provenant du système externe.\
Lorsqu'il est complété, ce champ sert à faire correspondre les emplacements existants ; si l'importation ou l'exportation est à true, il crée également un nouvel alias d'importation de commande pour cet emplacement s'il s'agit d'un nouvel alias | LOC12345 |
| order\_import\_alias\_\_export |  | Définir sur TRUE si l'alias doit être utilisé pour exporter les commandes. | TRUE |
| order\_import\_alias\_\_import |  | Définir sur TRUE si l'alias doit être utilisé pour importer les commandes. | TRUE |
| order\_import\_alias\_\_name |  | À utiliser lorsque l'identifiant est un code technique. | Entrepôt principal |
| order\_import\_alias\_\_integration\_partner |  | Le partenaire d'intégration pour l'exportation. À demander à l'équipe Services professionnels | MORETMS |

### Configuration du préremplissage des arrêts {#h_21a3dd7962}

| **Nom de colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| stop\_prefill\_\_type |  | Définit le type de préremplissage de l'arrêt ; les exceptions ne sont pas prises en charge par l'importation en masse\
Valeurs prises en charge : PICKUP , DELIVERY , OTHER ou ALL. Une seule valeur est prise en charge par emplacement | PICKUP |
| stop\_prefill\_\_duration |  | Valeur de remplacement pour la durée de l'arrêt. Elle remplace toute durée par défaut. | 6000 _(secondes)_ |
| stop\_prefill\_\_reference\_number |  | Numéro de référence à compléter sur les arrêts. | REC-011 |
| stop\_prefill\_\_notes |  | Informations supplémentaires | Sonner deux fois |
| stop\_prefill\_\_time\_start |  | Plage horaire de cet emplacement. Format :\
HH:MM, où MM doit être 00 ou 30. | 09:00 |
| stop\_prefill\_\_time\_end |  | Plage horaire de cet emplacement. Format :\
HH:MM, où MM doit être 00 ou 30. | 17:30 |
| stop\_prefill\_\_time\_window |  | Nom de la plage horaire. Cette plage doit exister et son nom doit être correctement orthographié ; les plages doivent être fournies par l'équipe Services professionnels. | Journée complète |
| stop\_prefill\_\_extras |  | Liste d'extras séparés par ;\
Cet extra doit exister et son nom ou son code doit être correctement orthographié ; les extras doivent être fournis par l'équipe Services professionnels. | Nouvelle livraison ; Première livraison |
| stop\_prefill\_\_custom\_fields\_\_\<custom\_field> |  | Nom du champ personnalisé.\
Ce champ doit exister et son identifiant doit être correctement orthographié ; les champs doivent être fournis par l'équipe Services professionnels. |  |

### Horaires d'ouverture (espaces et chiffres uniques non autorisés) {#h_bd4d23936c}

| **Nom de colonne** | **Obligatoire/facultatif** | **Remarques** | **Exemple** |
| --- | --- | --- | --- |
| opening\_hours\_\_monday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |
| opening\_hours\_\_tuesday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |
| opening\_hours\_\_wednesday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |
| opening\_hours\_\_thursday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |
| opening\_hours\_\_friday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |
| opening\_hours\_\_saturday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |
| opening\_hours\_\_sunday |  | Liste d'intervalles horaires séparés par ; | 08:30-9:30;13:00-14:00 |

* * *

## 🔎 Résolution des erreurs courantes d'importation d'emplacements {#h_0b55b40201}

-   **Champs obligatoires manquants :** l'importation échoue si l'un des champs obligatoires (**address**, **city**, **country**, **name** ou **postal\_code**) est laissé vide.
-   **Création d'emplacements en double :** cette erreur se produit lorsque l'**address** sert d'identifiant unique et que l'adresse importée ne correspond pas exactement à un enregistrement existant. Dans ce cas, le système crée un nouvel emplacement au lieu de mettre à jour l'emplacement existant. Vérifier que l'adresse correspond exactement, ou utiliser le **row\_id** ou l'**order\_import\_alias\_\_location\_identifier** pour mettre à jour l'enregistrement.
-   **Format de données incorrect :** vérifier que les données des champs comme **country** (le champ pays exige un code à deux lettres, par ex. GB et non « UK » ; consulter cette [liste](https://www.iban.com/country-codes) pour les codes pays Alpha-2) et **time\_start** (HH:MM) sont correctement mises en forme.
-   **Nom de la feuille :** la feuille du fichier modèle Excel doit s'appeler exactement **'Import'**. Tout autre nom provoque une erreur lors du téléversement du fichier.
-   **Valeur de préremplissage d'arrêt non valide :** l'importation échoue si la valeur de **stop\_prefill\_\_type** ne fait pas partie des valeurs prises en charge.
-   **Erreur de validation d'adresse :** une erreur se produit si l'**address** ne peut pas être validée par l'API Google Places et que les coordonnées **latitude** et **longitude** sont également absentes. Pour résoudre ce problème, vérifier que l'adresse est correcte ou saisir manuellement les coordonnées **latitude** et **longitude**.
-   **En-têtes de colonnes sensibles à la casse :** les en-têtes de colonnes doivent être saisis avec la bonne casse (par ex. `vat_number` et non `VAT_number`). Avec une casse incorrecte, les données de cette colonne sont ignorées sans avertissement et ne sont pas importées, car le système ne reconnaît pas l'en-tête.
-   **Erreurs dues à une apostrophe initiale :** les données d'une cellule ne peuvent pas commencer par une apostrophe ('). Si une apostrophe est utilisée, le système ne reconnaît pas la valeur et une erreur peut se produire. **Cette règle ne s'applique pas uniquement si l'article indique explicitement qu'une apostrophe doit être utilisée pour un champ précis.**
-   **Pourquoi Qargo sélectionne-t-il la mauvaise adresse lors d'une importation ?**\
    La cause la plus probable est un alias d'importation incorrect sur la fiche de l'emplacement. Si un emplacement possède un alias qui correspond à un nom du fichier d'importation, Qargo associe l'importation à cet emplacement, même s'il s'agit du mauvais. Ouvrir l'emplacement dans Qargo, accéder à ses paramètres et vérifier la section **Alias** dans l'onglet **Emplacements**. Utiliser l'icône en forme de crayon pour corriger l'alias, ou le retirer complètement s'il n'a pas lieu d'être.

-   **Pourquoi le système d'IA/OCR sélectionne-t-il le mauvais emplacement à partir d'un document ?**\
    Cela se produit généralement lorsque les données d'emplacement dans Qargo ne correspondent pas assez précisément aux termes du document. Vérifier que le nom, l'adresse et le nom affiché de l'emplacement correspondent à leur présentation dans le PDF ou le document importé. Plus la correspondance est étroite, plus l'IA identifie précisément le bon emplacement.

-   **Comment éviter une sélection d'adresse incorrecte à l'avenir ?**\
    Trois mesures sont utiles : tenir les alias à jour et ne les définir qu'en cas de réel besoin, utiliser des conventions de nommage cohérentes pour les emplacements dans tout Qargo, et tester les nouvelles configurations d'importation avec des données d'exemple avant de les exécuter en totalité.


* * *

## ✨ Bonnes pratiques pour l'importation d'emplacements {#h_de7326035d}

-   **Utiliser un nouveau modèle :** toujours utiliser un modèle vierge téléchargé directement depuis la plateforme Qargo pour chaque nouvelle importation.
-   **Nettoyer les données :** avant toute importation, vérifier que les données du fichier source sont propres, cohérentes et correctement mises en forme afin de limiter les erreurs.
-   **Tenir compte de la taille du fichier :** le traitement des feuilles plus longues peut prendre un temps considérable.


* * *

## ➡️ Étapes suivantes {#h_566125a9b1}

Une fois importés, les emplacements peuvent être utilisés pour la création de commandes. Ils apparaissent comme points d'enlèvement et de livraison disponibles lors de la création d'une nouvelle commande.

* * *

## 📈 Cas d'utilisation de l'importation d'emplacements {#h_ebe7877e3c}

L'importation d'emplacements est un outil précieux pour plusieurs processus métier clés :

-   **Configuration initiale du tenant :** alimenter un nouveau tenant Qargo avec la liste complète des emplacements habituels des clients, des fournisseurs ou des entrepôts.
-   **Ajout de nouveaux emplacements :** ajouter en masse de nouveaux sites de l'entreprise ou de nouveaux points d'enlèvement et de livraison après une expansion de l'entreprise.
-   **Configuration des intégrations :** créer ou mettre à jour les alias d'importation de commande d'un emplacement pour le relier à un système externe.


## Articles connexes

- [Import de données : importer des données de contacts d'emplacement](https://help.qargo.com/fr/articles/494334-import-de-donnees-importer-des-donnees-de-contacts-d-emplacement.md)
- [Import de données : importer des données de contact](https://help.qargo.com/fr/articles/410121-import-de-donnees-importer-des-donnees-de-contact.md)
- [Import de données : importer les données des chauffeurs](https://help.qargo.com/fr/articles/410123-import-de-donnees-importer-les-donnees-des-chauffeurs.md)
- [Import de données : importer les données des entreprises](https://help.qargo.com/fr/articles/410118-import-de-donnees-importer-les-donnees-des-entreprises.md)
- [Import de données – Importer des données de conteneurs](https://help.qargo.com/fr/articles/410131-import-de-donnees-importer-des-donnees-de-conteneurs.md)
