Befüllhilfe CSV-Import (für Partner)

Diese Seite bietet dir eine umfassende Referenz für alle Spalten im Partner-Inserate-CSV-Format. Nutze diese Anleitung, um die Datentypen, Validierungsregeln und Beispiele für jedes Feld zu verstehen.

So funktioniert der CSV-Import

Das CSV-Import-System ermöglicht es dir, alle deine PianoHub-Inserate effizient über Tabellendateien zu verwalten:

Exportiere deine aktuellen PianoHub-Inserate als CSV-Datei, um den aktuellen Datenstand zu erhalten.
Bearbeite oder ergänze die CSV-Datei mit Änderungen, Aktualisierungen oder neuen Inseraten.
Wichtig: Alle bestehenden Inserate, die du behalten möchtest, müssen in der CSV enthalten bleiben. Fehlende Inserate werden vom Import-Tool als zum Löschen markiert betrachtet.
Um neue Inserate hinzuzufügen (z. B. per KI-Konvertierung), musst du deine Bestandsdaten mit den neuen Inseraten in einer einzigen CSV-Datei zusammenführen, bevor du importierst.

Schnellreferenz

Übersicht aller Spalten im CSV-Format:

CSV-Spaltenreferenztabelle mit Spaltennamen, Typen und Anforderungsstatus
Column Name	Type	Required
`public_id`	automatisch erzeugt (read-only)	No
`summary`	Text	Yes
`instrument_type`	vordefinierte Werte	Yes
`brand`	Text	Yes
`model`	Text	No
`acquisition_type`	vordefinierte Werte	Yes
`currency`	vordefinierte Werte	No
`price_on_request`	boolean	No
`price`	Zahl	No
`price_type`	vordefinierte Werte	No
`rent_price`	Zahl	No
`color`	vordefinierte Werte	Yes
`year_built`	Zahl	No
`production_country`	Text	No
`serial_number`	Text	No
`condition`	vordefinierte Werte	Yes
`description`	Text	Yes
`number_of_keys`	Zahl	Yes
`height`	Zahl	No
`width`	Zahl	No
`depth`	Zahl	No
`weight`	Zahl	No
`moderator_pedal`	boolean	No
`sostenuto_pedal`	boolean	No
`silent_system`	boolean	No
`player_system`	boolean	No
`humidity_control`	boolean	No
`provider_transport`	boolean	No
`transport_price_included`	boolean	No
`email`	E-Mail-Adresse	Yes
`image_urls`	Text	No
`video_urls`	Text	No

Detaillierte Spaltenbeschreibungen

`public_id` - ID

Required: No | Type: automatisch erzeugt (read-only)

Die ID des Inserats. Dieses Feld wird automatisch zugewiesen, wenn du ein Inserat erstellst und kann nicht geändert werden. Lass es bei neuen Inseraten leer.

Bei Änderungen an bestehenden Inseraten muss die CSV-Zeile die von PianoHub zuvor vergebene public_id enthalten. Inserate werden anhand dieser ID identifiziert, nicht anhand des Titels oder anderer Felder.

Example: 12345

`summary` - Titel

Required: Yes | Type: Text

Ein kurzer, beschreibender Titel für das Klavier. Dieser erscheint in den Suchergebnissen und sollte prägnant, aber informativ sein.

Example: Yamaha U1 Klavier Schwarz

Max length: 80 characters

`instrument_type` - Instrumententyp

Required: Yes | Type: vordefinierte Werte

Die Art des Instruments. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

UPRIGHT_PIANO - Klavier
GRAND_PIANO - Flügel
DIGITAL_PIANO - Digitalpiano
OTHER - Sonstiges

`brand` - Marke

Required: Yes | Type: Text

Hersteller- oder Markenname.

Wichtig: Falls du ein Klavier einer der unten aufgeführten, besonders beliebten Marken inserierst, verwende die hier dokumentierte Schreibweise. Abweichende Schreibweisen (z. B. "C. Bechstein" statt "Bechstein") führen dazu, dass Nutzer dein Inserat nicht finden, wenn sie auf PianoHub per Suchfunktion nach der Marke filtern.

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` - Modell

Required: No | Type: Text

Modellbezeichnung oder -name. Optionales Feld.

Example: U1

Max length: 30 characters

`acquisition_type` - Erwerbstyp

Required: Yes | Type: vordefinierte Werte

Gibt an, wie das Instrument erworben werden kann. Verwende BUY für reinen Verkauf, RENT für reine Vermietung oder BOTH, wenn das Instrument gekauft oder gemietet werden kann.

Erlaubte Werte:

BUY
RENT
BOTH

`currency` - Währung

Required: No | Type: vordefinierte Werte

Währungscode. Muss einer der unten aufgeführten vordefinierten Werte sein. Pflichtfeld, wenn acquisition_type BUY oder BOTH ist und price_on_request false ist, oder wenn acquisition_type RENT oder BOTH ist (für die Mietpreisanzeige). Nur leer lassen, wenn acquisition_type BUY und price_on_request true ist.

Erlaubte Werte:

CHF
EUR
GBP
USD

`price_on_request` - Preis auf Anfrage

Required: No | Type: boolean

Gibt an, ob kein Kaufpreis angezeigt werden soll. Wenn true, werden die Felder price und price_type ignoriert und das Inserat wird mit "Preis auf Anfrage" angezeigt. Hat keinen Einfluss auf rent_price. Leer lassen, wenn acquisition_type RENT ist (in diesem Fall nicht relevant).

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`price` - Kaufpreis

Required: No | Type: Zahl

Kaufpreis als Zahl ohne Währungssymbol. Pflichtfeld, wenn acquisition_type BUY oder BOTH ist und price_on_request false ist. Leer lassen, wenn price_on_request true ist oder acquisition_type RENT ist.

Example: 3500

Min: 0 | Max: 9999999

`price_type` - Preistyp

Required: No | Type: vordefinierte Werte

Art des Preises. Pflichtfeld, wenn acquisition_type BUY oder BOTH ist und price_on_request false ist. Leer lassen, wenn price_on_request true ist oder acquisition_type RENT ist.

Erlaubte Werte:

FIXED - Festpreis
NEGOTIABLE - Verhandlungsbasis

`rent_price` - Monatliche Mindestmiete

Required: No | Type: Zahl

Minimaler monatlicher Mietpreis als Zahl ohne Währungssymbol. Pflichtfeld, wenn acquisition_type RENT oder BOTH ist. Leer lassen, wenn acquisition_type BUY ist.

Example: 149

Min: 0 | Max: 9999999

`color` - Farbe

Required: Yes | Type: vordefinierte Werte

Hauptfarbe des Instruments. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

BLACK - Schwarz
WHITE - Weiß
WOOD - Holz
OTHER - Andere Farbe

`year_built` - Baujahr

Required: No | Type: Zahl

Herstellungsjahr. Optionales Feld.

Example: 2005

Min: 1800 | Max: 2026

`production_country` - Herstellungsland

Required: No | Type: Text

Land, in dem das Instrument hergestellt wurde. Optionales Feld.

Example: Japan

Max length: 30 characters

`serial_number` - Seriennummer

Required: No | Type: Text

Seriennummer des Herstellers. Optionales Feld.

Example: 5678901

Max length: 15 characters

`condition` - Zustand

Required: Yes | Type: vordefinierte Werte

Zustand des Instruments. Muss einer der unten aufgeführten vordefinierten Werte sein.

Erlaubte Werte:

NEW - Neues Instrument
USED - Gebrauchtes Instrument

`description` - Beschreibung

Required: Yes | Type: Text

Detaillierte Beschreibung des Instruments. Füge wichtige Details, Zustandshinweise und besondere Merkmale hinzu.

Example: Gut gepflegtes Yamaha U1 in ausgezeichnetem Zustand. Regelmäßige Stimmung, Resonanzboden neu versiegelt.

Max length: 4000 characters

`number_of_keys` - Anzahl der Tasten

Required: Yes | Type: Zahl

Anzahl der Tasten des Instruments. Pflichtfeld.

Example: 88

Min: 1 | Max: 100

`height` - Höhe

Required: No | Type: Zahl

Höhe des Instruments in Zentimetern. Optionales Feld.

Example: 121

Min: 1 | Max: 999

`width` - Breite

Required: No | Type: Zahl

Breite des Instruments in Zentimetern. Optionales Feld.

Example: 153

Min: 1 | Max: 999

`depth` - Tiefe

Required: No | Type: Zahl

Tiefe des Instruments in Zentimetern. Optionales Feld.

Example: 65

Min: 1 | Max: 999

`weight` - Gewicht

Required: No | Type: Zahl

Gewicht des Instruments in Kilogramm. Optionales Feld.

Example: 230

Min: 1 | Max: 9999

`moderator_pedal` - Moderator-Pedal

Required: No | Type: boolean

Gibt an, ob das Instrument ein Moderator-Pedal hat. Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`sostenuto_pedal` - Sostenuto-Pedal

Required: No | Type: boolean

Gibt an, ob das Instrument ein Sostenuto-Pedal hat. Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`silent_system` - Silent-System

Required: No | Type: boolean

Gibt an, ob das Instrument ein Silent-System hat. Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`player_system` - Selbstspielsystem

Required: No | Type: boolean

Gibt an, ob das Instrument über ein Selbstspielsystem verfügt (z.B. Steinway Spirio). Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`humidity_control` - Feuchtigkeitskontrollsystem

Required: No | Type: boolean

Gibt an, ob das Instrument ein Feuchtigkeitskontrollsystem hat. Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`provider_transport` - Anlieferung möglich (Erdgeschoss)

Required: No | Type: boolean

Gibt an, ob der Verkäufer einen Transportservice für das Instrument bis ins Erdgeschoss anbietet. Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`transport_price_included` - Transport im Preis enthalten

Required: No | Type: boolean

Gibt an, ob der Transport bereits im angegebenen Preis enthalten ist. Optionales Feld.

Erlaubte Werte:

true
false

Wichtig: Es sind nur die exakten Werte "true" oder "false" (ohne Anführungszeichen in der CSV) erlaubt.

`email` - E-Mail

Required: Yes | Type: E-Mail-Adresse

Kontakt-E-Mail für Anfragen zu diesem Inserat. Diese kann sich von deiner Partner-Konto-E-Mail unterscheiden.

Example: partner@example.com

Max length: 255 characters

`image_urls` - Bild-URLs

Required: No | Type: Text

URLs zu Bildern des Instruments. Trenne mehrere URLs mit Kommas. Alle Bilder müssen öffentlich zugänglich sein. Optionales Feld.

Bilder von deiner eigenen Website wiederverwenden:

Wenn du bereits Inserate auf deiner eigenen Website hast und diese zusätzlich auf PianoHub schalten möchtest, kannst du die Bild-URLs deiner Website direkt verwenden. So musst du Bilder nicht doppelt hochladen oder speichern.

Tipp: Klicke mit der rechten Maustaste auf ein Bild in deinem Browser und wähle "Bildadresse kopieren", um die URL zu erhalten.

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

`video_urls` - Video-URLs

Required: No | Type: Text

YouTube- oder Vimeo-URLs zu Videos des Instruments. Trenne mehrere URLs mit Kommas. Andere Videoanbieter werden nicht unterstützt. Videos werden auf der Inseratsseite mit Datenschutz-Vorschau eingebettet – der eigentliche Player lädt erst beim Klick auf "Abspielen". Optionales Feld.

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

Befüllhilfe CSV-Import (für Partner)

So funktioniert der CSV-Import

Schnellreferenz

Detaillierte Spaltenbeschreibungen

public_id - ID

summary - Titel

instrument_type - Instrumententyp

brand - Marke

model - Modell

acquisition_type - Erwerbstyp

currency - Währung

price_on_request - Preis auf Anfrage

price - Kaufpreis

price_type - Preistyp

rent_price - Monatliche Mindestmiete

color - Farbe

year_built - Baujahr

production_country - Herstellungsland

serial_number - Seriennummer

condition - Zustand

description - Beschreibung

number_of_keys - Anzahl der Tasten

height - Höhe

width - Breite

depth - Tiefe

weight - Gewicht

moderator_pedal - Moderator-Pedal

sostenuto_pedal - Sostenuto-Pedal

silent_system - Silent-System

player_system - Selbstspielsystem

humidity_control - Feuchtigkeitskontrollsystem

provider_transport - Anlieferung möglich (Erdgeschoss)

transport_price_included - Transport im Preis enthalten

email - E-Mail

image_urls - Bild-URLs

video_urls - Video-URLs

`public_id` - ID

`summary` - Titel

`instrument_type` - Instrumententyp

`brand` - Marke

`model` - Modell

`acquisition_type` - Erwerbstyp

`currency` - Währung

`price_on_request` - Preis auf Anfrage

`price` - Kaufpreis

`price_type` - Preistyp

`rent_price` - Monatliche Mindestmiete

`color` - Farbe

`year_built` - Baujahr

`production_country` - Herstellungsland

`serial_number` - Seriennummer

`condition` - Zustand

`description` - Beschreibung

`number_of_keys` - Anzahl der Tasten

`height` - Höhe

`width` - Breite

`depth` - Tiefe

`weight` - Gewicht

`moderator_pedal` - Moderator-Pedal

`sostenuto_pedal` - Sostenuto-Pedal

`silent_system` - Silent-System

`player_system` - Selbstspielsystem

`humidity_control` - Feuchtigkeitskontrollsystem

`provider_transport` - Anlieferung möglich (Erdgeschoss)

`transport_price_included` - Transport im Preis enthalten

`email` - E-Mail

`image_urls` - Bild-URLs

`video_urls` - Video-URLs