Import en masse
Importez des expéditions en masse via fichier modèle XLSX.
Import en masse
L'import en masse vous permet de créer plusieurs expéditions en une seule opération à partir d'un fichier modèle.
Modèle d'import
Téléchargez le modèle officiel via GET /api/v1/shipments/import-template. Il s'agit d'un fichier XLSX (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet) nommé modele_import_swaloo.xlsx.
Le modèle contient trois lignes d'en-tête : la clé de colonne (ligne 1), une description / valeurs autorisées (ligne 2) et un exemple (ligne 3). Les colonnes priority et package_size, ainsi que pickup_point (si votre organisation a des points de collecte permanents), sont proposées sous forme de listes déroulantes.
Colonnes du modèle
| Colonne | Obligatoire | Description |
|---|---|---|
recipient_last_name | Oui | Nom du destinataire |
recipient_first_name | Non | Prénom du destinataire |
recipient_phone | Oui | Téléphone du destinataire |
delivery_street | Oui | Adresse de livraison |
delivery_city | Oui | Ville de livraison |
delivery_postal_code | Non | Code postal |
delivery_latitude | Non | Latitude (renseignée par géocodage automatique) |
delivery_longitude | Non | Longitude (renseignée par géocodage automatique) |
priority | Non | low, normal (défaut), high, urgent |
package_size | Non | small, medium (défaut), large, pallet |
weight_kg | Non | Poids en kg |
cod_amount | Non | Montant du contre-remboursement |
external_reference | Non | Référence de commande client |
notes | Non | Notes pour le livreur |
deliver_after | Non | Livrer après (format YYYY-MM-DD HH:MM) |
deliver_before | Non | Livrer avant (format YYYY-MM-DD HH:MM) |
pickup_point | Non | Point de collecte permanent |
Processus d'import
- Téléchargement du modèle — Récupérez le fichier XLSX et remplissez vos lignes
- Dépôt — Importez le fichier complété
- Traitement — Chaque ligne est créée individuellement ; le rapport indique le nombre de colis créés et en échec, avec le motif d'erreur ligne par ligne
- Quota — La création est soumise au quota de livraisons de votre abonnement
Chaque expédition importée est enregistrée avec un événement de création et, le cas échéant, rattachée automatiquement au marchand associé à votre compte.
Voir aussi : Créer une expédition | Référence API