📄 Guide d’import d’annonces (Cocolis)

📝 Préambule (à lire avant import)

Chaque annonce ne peut comporter qu’un seul type d’objet.
Le fichier d’import doit être en .csv, et encodé en UTF-8.
Il doit utiliser la virgule “,” comme séparateur de champs.
Les noms de colonnes doivent être strictement identiques à ceux du template fourni.
Les champs obligatoires doivent être renseignés.
Pour les booléens, deux valeurs possibles peuvent être renseignées : TRUE / FALSE.
Les URLs doivent être publiques si vous importez des photos.

📦 Explication des champs du fichier d’import

Le tableau qui suit précise pour chaque colonne de l’import :

Une description du champ
Son caractère obligatoire ou facultatif
Le format attendu
Un exemple

Colonnes	Description	Obligatoire	Format	Exemple
external_id	Identifiant unique du côté client (évite les doublons)	Oui	Texte	`101testO.200005`
title	Titre de l’annonce	Oui	Texte	`Clavier`
external_price	Valeur des biens à livrer (en centimes)	Non	Nombre (centimes)	`20000`
with_insurance	Indique si l’envoi doit être assuré.	Non	Booléen (`TRUE` / `FALSE`)	`TRUE`
ride_delivery_information_attributes.from_address	Adresse de départ	Oui	Texte	`7 passage des Taillandiers`
ride_delivery_information_attributes.from_extra_information	Infos complémentaires (départ)	Non	Texte	`Batiment B`
ride_delivery_information_attributes.from_postal_code	Code postal (départ)	Oui	Texte	`75011`
ride_delivery_information_attributes.from_city	Ville (départ)	Oui	Texte	`Paris`
ride_delivery_information_attributes.from_country	Pays ISO (départ)	Oui	Texte	`FR`
ride_delivery_information_attributes.from_contact_phone	Téléphone du contact expéditeur	Oui	Texte	`33612345678`
ride_delivery_information_attributes.from_contact_email	Email du contact expéditeur	Oui	Texte	`[email protected]`
ride_delivery_information_attributes.from_contact_name	Nom du contact expéditeur	Oui	Texte	`Robert Tlersa`
ride_delivery_information_attributes.to_address	Adresse de livraison	Oui	Texte	`77 rue de Bretagne`
ride_delivery_information_attributes.to_extra_information	Infos complémentaires (arrivée)	Non	Texte	`—`
ride_delivery_information_attributes.to_postal_code	Code postal (arrivée)	Oui	Texte	`69009`
ride_delivery_information_attributes.to_city	Ville (arrivée)	Oui	Texte	`Lyon`
ride_delivery_information_attributes.to_country	Pays ISO (arrivée)	Oui	Texte	`FR`
ride_delivery_information_attributes.to_contact_phone	Téléphone du destinataire	Oui	Texte	`33612345678`
ride_delivery_information_attributes.to_contact_email	Email du destinataire	Oui	Texte	`[email protected]`
ride_delivery_information_attributes.to_contact_name	Nom du destinataire	Oui	Texte	`Michel Zoger`
ride_objects_attributes[0].qty	Quantité d’objets	Oui	Nombre (entier)	`1`
ride_objects_attributes[0].length	Longueur de l’objet (cm)	Oui	Nombre (cm)	`100`
ride_objects_attributes[0].width	Largeur de l’objet (cm)	Oui	Nombre (cm)	`50`
ride_objects_attributes[0].height	Hauteur de l’objet (cm)	Oui	Nombre (cm)	`250`
ride_objects_attributes[0].exact_weight	Poids de l’objet (kg)	Oui	Nombre (cm)	`10`
ride_objects_attributes[0].photo_urls[0]	URL publique d’une photo (jpg/png)	Non	Texte (URL)	`https://…/63w.jpg`