Guide de remplissage CSV (pour les partenaires)

Cette page fournit une référence complète pour toutes les colonnes du format CSV d'annonce partenaire. Utilisez ce guide pour comprendre les types de données, les règles de validation et les exemples pour chaque champ.

Comment fonctionne l'importation CSV

Le système d'importation CSV vous permet de gérer efficacement toutes vos annonces PianoHub à l'aide de fichiers tableurs :

Exportez vos annonces PianoHub actuelles sous forme de fichier CSV pour obtenir l'état actuel des données.
Modifiez ou complétez le fichier CSV avec des changements, des mises à jour ou de nouvelles annonces.
Important : Toutes les annonces existantes que vous souhaitez conserver doivent rester dans le CSV. Les annonces manquantes seront marquées pour suppression par l'outil d'importation.
Pour ajouter de nouvelles annonces (par exemple, via la conversion IA), fusionnez vos données existantes avec les nouvelles annonces dans un seul fichier CSV avant l'importation.

Référence rapide

Aperçu de toutes les colonnes au format CSV :

Tableau de référence des colonnes CSV avec noms, types et statut d'obligation
Column Name	Type	Required
`public_id`	attribué automatiquement (lecture seule)	No
`summary`	texte	Yes
`instrument_type`	valeurs prédéfinies	Yes
`brand`	texte	Yes
`model`	texte	No
`acquisition_type`	valeurs prédéfinies	Yes
`currency`	valeurs prédéfinies	No
`price_on_request`	booléen	No
`price`	nombre	No
`price_type`	valeurs prédéfinies	No
`rent_price`	nombre	No
`color`	valeurs prédéfinies	Yes
`year_built`	nombre	No
`production_country`	texte	No
`serial_number`	texte	No
`condition`	valeurs prédéfinies	Yes
`description`	texte	Yes
`number_of_keys`	nombre	Yes
`height`	nombre	No
`width`	nombre	No
`depth`	nombre	No
`weight`	nombre	No
`moderator_pedal`	booléen	No
`sostenuto_pedal`	booléen	No
`silent_system`	booléen	No
`player_system`	booléen	No
`humidity_control`	booléen	No
`provider_transport`	booléen	No
`transport_price_included`	booléen	No
`email`	adresse e-mail	Yes
`image_urls`	texte	No
`video_urls`	texte	No

Descriptions détaillées des colonnes

`public_id` - ID

Required: No | Type: attribué automatiquement (lecture seule)

L'ID de l'annonce. Ce champ est attribué automatiquement lors de la création d'une annonce et ne peut pas être modifié. Laissez vide pour les nouvelles annonces.

Lors de la mise à jour d'annonces existantes, la ligne CSV doit contenir le public_id précédemment attribué par PianoHub. Les annonces sont identifiées par cet ID, et non par le titre ou d'autres champs.

Example: 12345

`summary` - Titre

Required: Yes | Type: texte

Un titre court et descriptif pour le piano. Il apparaît dans les résultats de recherche et doit être concis mais informatif.

Example: Piano droit Yamaha U1 Noir

Max length: 80 characters

`instrument_type` - Type d'instrument

Required: Yes | Type: valeurs prédéfinies

Le type d'instrument. Doit être l'une des valeurs prédéfinies listées ci-dessous.

Valeurs autorisées :

UPRIGHT_PIANO - Piano droit
GRAND_PIANO - Piano à queue
DIGITAL_PIANO - Piano numérique
OTHER - Autre

`brand` - Marque

Required: Yes | Type: texte

Fabricant ou nom de la marque.

Important : Si vous listez un piano de l'une des marques particulièrement populaires listées ci-dessous, utilisez l'orthographe documentée ici. Des orthographes divergentes (par ex. "C. Bechstein" au lieu de "Bechstein") empêcheront les utilisateurs de trouver votre annonce lorsqu'ils filtrent par marque via la fonction de recherche sur PianoHub.

August Förster
Baldwin
Blüthner
Bösendorfer
Boston
C. Bechstein
Essex
Fazioli
Feurich
Grotrian-Steinweg
Haessler
Ibach
Irmler
Kawai
Mason & Hamlin
Petrof
Pfeiffer
Samick
Sauter
Schimmel
Seiler
Steingraeber & Söhne
Steinway & Sons
W. Hoffmann
Yamaha
Zimmermann

Example: Yamaha

Max length: 30 characters

`model` - Modèle

Required: No | Type: texte

Désignation du modèle ou nom. Champ optionnel.

Example: U1

Max length: 30 characters

`acquisition_type` - Type d'acquisition

Required: Yes | Type: valeurs prédéfinies

Spécifie comment l'instrument peut être acquis. Utilisez BUY pour la vente uniquement, RENT pour la location uniquement, ou BOTH si l'instrument peut être acheté ou loué.

Valeurs autorisées :

BUY
RENT
BOTH

`currency` - Devise

Required: No | Type: valeurs prédéfinies

Code de devise. Doit être l'une des valeurs prédéfinies listées ci-dessous. Requis lorsque acquisition_type est BUY ou BOTH et que price_on_request est false, ou lorsque acquisition_type est RENT ou BOTH (pour le prix de location). Laissez vide uniquement si acquisition_type est BUY et que price_on_request est true.

Valeurs autorisées :

AUD
CAD
CHF
CZK
DKK
EUR
GBP
HUF
NOK
NZD
PLN
SEK
USD

`price_on_request` - Prix sur demande

Required: No | Type: booléen

Indique si aucun prix d'achat ne doit être affiché. Si true, les champs price et price_type sont ignorés et l'annonce est affichée avec "Prix sur demande". N'affecte pas rent_price. Laissez vide lorsque acquisition_type est RENT (non applicable dans ce cas).

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`price` - Prix d'achat

Required: No | Type: nombre

Prix d'achat sous forme de nombre sans symbole monétaire. Requis lorsque acquisition_type est BUY ou BOTH et que price_on_request est false. Laissez vide si price_on_request est true ou si acquisition_type est RENT.

Example: 3500

Min: 0 | Max: 9999999

`price_type` - Type de prix

Required: No | Type: valeurs prédéfinies

Type de prix. Requis lorsque acquisition_type est BUY ou BOTH et que price_on_request est false. Laissez vide si price_on_request est true ou si acquisition_type est RENT.

Valeurs autorisées :

FIXED - Fixe
NEGOTIABLE - Négociable

`rent_price` - Loyer mensuel minimum

Required: No | Type: nombre

Prix du loyer mensuel minimum sous forme de nombre sans symbole monétaire. Requis lorsque acquisition_type est RENT ou BOTH. Laissez vide si acquisition_type est BUY.

Example: 149

Min: 0 | Max: 9999999

`color` - Couleur

Required: Yes | Type: valeurs prédéfinies

Couleur primaire de l'instrument. Doit être l'une des valeurs prédéfinies listées ci-dessous.

Valeurs autorisées :

BLACK - Noir
WHITE - Blanc
WOOD - Bois
OTHER - Autre couleur

`year_built` - Année de fabrication

Required: No | Type: nombre

Année de fabrication. Champ optionnel.

Example: 2005

Min: 1800 | Max: 2026

`production_country` - Pays de production

Required: No | Type: texte

Pays où l'instrument a été fabriqué. Champ optionnel.

Example: Japon

Max length: 30 characters

`serial_number` - Numéro de série

Required: No | Type: texte

Numéro de série du fabricant. Champ optionnel.

Example: 5678901

Max length: 15 characters

`condition` - État

Required: Yes | Type: valeurs prédéfinies

État de l'instrument. Doit être l'une des valeurs prédéfinies listées ci-dessous.

Valeurs autorisées :

NEW - Instrument neuf
USED - Instrument d'occasion

`description` - Description

Required: Yes | Type: texte

Description détaillée de l'instrument. Incluez les détails importants, les notes sur l'état et toute caractéristique spéciale.

Example: Yamaha U1 bien entretenu en excellent état. Entretien régulier, nouvelles cordes installées en 2020.

Max length: 4000 characters

`number_of_keys` - Nombre de touches

Required: Yes | Type: nombre

Nombre de touches sur l'instrument. Champ requis.

Example: 88

Min: 1 | Max: 100

`height` - Hauteur

Required: No | Type: nombre

Hauteur de l'instrument en centimètres. Champ optionnel.

Example: 121

Min: 1 | Max: 999

`width` - Largeur

Required: No | Type: nombre

Largeur de l'instrument en centimètres. Champ optionnel.

Example: 153

Min: 1 | Max: 999

`depth` - Profondeur

Required: No | Type: nombre

Profondeur de l'instrument en centimètres. Champ optionnel.

Example: 65

Min: 1 | Max: 999

`weight` - Poids

Required: No | Type: nombre

Poids de l'instrument en kilogrammes. Champ optionnel.

Example: 230

Min: 1 | Max: 9999

`moderator_pedal` - Pédale de sourdine

Required: No | Type: booléen

Indique si l'instrument possède une pédale de sourdine (modérateur). Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`sostenuto_pedal` - Pédale tonale

Required: No | Type: booléen

Indique si l'instrument possède une pédale sostenuto. Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`silent_system` - Système Silent

Required: No | Type: booléen

Indique si l'instrument possède un système silencieux. Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`player_system` - Système Player

Required: No | Type: booléen

Indique si l'instrument possède un système de lecture automatique (système auto-joueur). Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`humidity_control` - Système de contrôle d'humidité

Required: No | Type: booléen

Indique si l'instrument possède un système de contrôle de l'humidité. Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`provider_transport` - Livraison possible (RDC)

Required: No | Type: booléen

Indique si le vendeur propose un service de transport pour l'instrument (rez-de-chaussée). Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`transport_price_included` - Transport inclus dans le prix

Required: No | Type: booléen

Indique si le prix du transport est déjà inclus dans le prix indiqué. Champ optionnel.

Valeurs autorisées :

true
false

Important : Seules les valeurs exactes "true" ou "false" (sans guillemets dans le CSV) sont autorisées.

`email` - E-mail

Required: Yes | Type: adresse e-mail

E-mail de contact pour les demandes concernant cette annonce. Cela peut différer de l'e-mail de votre compte partenaire.

Example: partner@example.com

Max length: 255 characters

`image_urls` - URL des images

Required: No | Type: texte

URLs vers les images de l'instrument. Séparez plusieurs URLs par des virgules. Toutes les images doivent être publiquement accessibles. Champ optionnel.

Réutilisation d'images de votre propre site web :

Si vous avez déjà des annonces sur votre propre site web et que vous souhaitez également les lister sur PianoHub, vous pouvez utiliser directement les URLs des images de votre site. De cette façon, vous n'avez pas besoin de télécharger ou de stocker les images deux fois.

Conseil : Faites un clic droit sur une image dans votre navigateur et sélectionnez "Copier l'adresse de l'image" pour obtenir l'URL.

Example: https://example.com/img1.jpg,https://example.com/img2.jpg

`video_urls` - URL des vidéos

Required: No | Type: texte

URLs YouTube ou Vimeo pour les vidéos de l'instrument. Séparez plusieurs URLs par des virgules. Les autres fournisseurs de vidéos ne sont pas pris en charge. Les vidéos sont intégrées sur la page de l'annonce avec un aperçu de confidentialité – le lecteur réel ne se charge que lorsque l'utilisateur clique sur "Lecture". Champ optionnel.

Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ,https://vimeo.com/123456789

Guide de remplissage CSV (pour les partenaires)

Comment fonctionne l'importation CSV

Référence rapide

Descriptions détaillées des colonnes

public_id - ID

summary - Titre

instrument_type - Type d'instrument

brand - Marque

model - Modèle

acquisition_type - Type d'acquisition

currency - Devise

price_on_request - Prix sur demande

price - Prix d'achat

price_type - Type de prix

rent_price - Loyer mensuel minimum

color - Couleur

year_built - Année de fabrication

production_country - Pays de production

serial_number - Numéro de série

condition - État

description - Description

number_of_keys - Nombre de touches

height - Hauteur

width - Largeur

depth - Profondeur

weight - Poids

moderator_pedal - Pédale de sourdine

sostenuto_pedal - Pédale tonale

silent_system - Système Silent

player_system - Système Player

humidity_control - Système de contrôle d'humidité

provider_transport - Livraison possible (RDC)

transport_price_included - Transport inclus dans le prix

email - E-mail

image_urls - URL des images

video_urls - URL des vidéos

`public_id` - ID

`summary` - Titre

`instrument_type` - Type d'instrument

`brand` - Marque

`model` - Modèle

`acquisition_type` - Type d'acquisition

`currency` - Devise

`price_on_request` - Prix sur demande

`price` - Prix d'achat

`price_type` - Type de prix

`rent_price` - Loyer mensuel minimum

`color` - Couleur

`year_built` - Année de fabrication

`production_country` - Pays de production

`serial_number` - Numéro de série

`condition` - État

`description` - Description

`number_of_keys` - Nombre de touches

`height` - Hauteur

`width` - Largeur

`depth` - Profondeur

`weight` - Poids

`moderator_pedal` - Pédale de sourdine

`sostenuto_pedal` - Pédale tonale

`silent_system` - Système Silent

`player_system` - Système Player

`humidity_control` - Système de contrôle d'humidité

`provider_transport` - Livraison possible (RDC)

`transport_price_included` - Transport inclus dans le prix

`email` - E-mail

`image_urls` - URL des images

`video_urls` - URL des vidéos