CSV-invulgids (voor partners)

Deze pagina biedt een uitgebreide referentie voor alle kolommen in het CSV-formaat voor partnervermeldingen. Gebruik deze gids om de gegevenstypen, validatieregels en voorbeelden voor elk veld te begrijpen.

Hoe CSV-import werkt

Het CSV-importsysteem stelt u in staat om al uw PianoHub-vermeldingen efficiënt te beheren met behulp van spreadsheetbestanden:

Exporteer uw huidige PianoHub-vermeldingen als een CSV-bestand om de huidige gegevensstatus te verkrijgen.
Bewerk of vul het CSV-bestand aan met wijzigingen, updates of nieuwe vermeldingen.
Belangrijk: Alle bestaande vermeldingen die u wilt behouden, moeten in de CSV blijven staan. Ontbrekende vermeldingen worden door de importtool gemarkeerd voor verwijdering.
Om nieuwe vermeldingen toe te voegen (bijv. via AI-conversie), voegt u uw bestaande gegevens samen met de nieuwe vermeldingen in één enkel CSV-bestand voordat u deze importeert.

Snelreferentie

Overzicht van alle kolommen in het CSV-formaat:

CSV-kolomreferentietabel met kolomnamen, typen en vereiste status
Column Name	Type	Required
`public_id`	automatisch toegewezen (alleen-lezen)	No
`summary`	tekst	Yes
`instrument_type`	vooraf gedefinieerde waarden	Yes
`brand`	tekst	Yes
`model`	tekst	No
`acquisition_type`	vooraf gedefinieerde waarden	Yes
`currency`	vooraf gedefinieerde waarden	No
`price_on_request`	boolean	No
`price`	getal	No
`price_type`	vooraf gedefinieerde waarden	No
`rent_price`	getal	No
`color`	vooraf gedefinieerde waarden	Yes
`year_built`	getal	No
`production_country`	tekst	No
`serial_number`	tekst	No
`condition`	vooraf gedefinieerde waarden	Yes
`description`	tekst	Yes
`number_of_keys`	getal	Yes
`height`	getal	No
`width`	getal	No
`depth`	getal	No
`weight`	getal	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-mailadres	Yes
`image_urls`	tekst	No
`video_urls`	tekst	No

Gedetailleerde kolombeschrijvingen

`public_id` - ID

Required: No | Type: automatisch toegewezen (alleen-lezen)

De ID van de vermelding. Dit veld wordt automatisch toegewezen wanneer u een vermelding aanmaakt en kan niet worden gewijzigd. Laat dit veld leeg voor nieuwe vermeldingen.

Bij het bijwerken van bestaande vermeldingen moet de CSV-rij de public_id bevatten die eerder door PianoHub is toegewezen. Vermeldingen worden geïdentificeerd door deze ID, niet door de titel of andere velden.

Example: 12345

`summary` - Titel

Required: Yes | Type: tekst

Een korte, beschrijvende titel voor de piano. Deze verschijnt in de zoekresultaten en moet beknopt maar informatief zijn.

Example: Yamaha U1 Upright Piano Zwart

Max length: 80 characters

`instrument_type` - Instrumenttype

Required: Yes | Type: vooraf gedefinieerde waarden

Het type instrument. Moet een van de hieronder vermelde vooraf gedefinieerde waarden zijn.

Toegestane waarden:

UPRIGHT_PIANO - Piano
GRAND_PIANO - Vleugel
DIGITAL_PIANO - Digitale piano
OTHER - Overige

`brand` - Merk

Required: Yes | Type: tekst

Naam van de fabrikant of het merk.

Belangrijk: Als u een piano vermeldt van een van de bijzonder populaire merken die hieronder worden genoemd, gebruik dan de hier gedocumenteerde spelling. Afwijkende spellingen (bijv. "C. Bechstein" in plaats van "Bechstein") zorgen ervoor dat gebruikers uw vermelding niet vinden wanneer ze op merk filteren via de zoekfunctie op 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` - Model

Required: No | Type: tekst

Modelnaam of aanduiding. Optioneel veld.

Example: U1

Max length: 30 characters

`acquisition_type` - Type verwerving

Required: Yes | Type: vooraf gedefinieerde waarden

Specificeert hoe het instrument kan worden verkregen. Gebruik BUY voor alleen verkoop, RENT voor alleen verhuur, of BOTH als het instrument zowel gekocht als gehuurd kan worden.

Toegestane waarden:

BUY
RENT
BOTH

`currency` - Valuta

Required: No | Type: vooraf gedefinieerde waarden

Valutacode. Moet een van de hieronder vermelde vooraf gedefinieerde waarden zijn. Vereist wanneer acquisition_type BUY of BOTH is en price_on_request false is, of wanneer acquisition_type RENT of BOTH is (voor de huurprijs). Alleen leeg laten als acquisition_type BUY is en price_on_request true is.

Toegestane waarden:

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

`price_on_request` - Prijs op aanvraag

Required: No | Type: boolean

Geeft aan of er geen koopprijs moet worden weergegeven. Indien true, worden de velden price en price_type genegeerd en wordt de vermelding getoond met "Prijs op aanvraag". Heeft geen invloed op rent_price. Laat leeg wanneer acquisition_type RENT is (niet van toepassing in dat geval).

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`price` - Koopprijs

Required: No | Type: getal

Koopprijs als getal zonder valutasymbool. Vereist wanneer acquisition_type BUY of BOTH is en price_on_request false is. Laat leeg als price_on_request true is of acquisition_type RENT is.

Example: 3500

Min: 0 | Max: 9999999

`price_type` - Prijstype

Required: No | Type: vooraf gedefinieerde waarden

Type prijs. Vereist wanneer acquisition_type BUY of BOTH is en price_on_request false is. Laat leeg als price_on_request true is of acquisition_type RENT is.

Toegestane waarden:

FIXED - Vaste prijs
NEGOTIABLE - Vraagprijs (onderhandelbaar)

`rent_price` - Minimale maandelijkse huur

Required: No | Type: getal

Minimale maandelijkse huurprijs als getal zonder valutasymbool. Vereist wanneer acquisition_type RENT of BOTH is. Laat leeg als acquisition_type BUY is.

Example: 149

Min: 0 | Max: 9999999

`color` - Kleur

Required: Yes | Type: vooraf gedefinieerde waarden

Primaire kleur van het instrument. Moet een van de hieronder vermelde vooraf gedefinieerde waarden zijn.

Toegestane waarden:

BLACK - Zwart
WHITE - Wit
WOOD - Hout
OTHER - Andere kleur

`year_built` - Bouwjaar

Required: No | Type: getal

Fabricagejaar. Optioneel veld.

Example: 2005

Min: 1800 | Max: 2026

`production_country` - Land van productie

Required: No | Type: tekst

Land waar het instrument is vervaardigd. Optioneel veld.

Example: Japan

Max length: 30 characters

`serial_number` - Serienummer

Required: No | Type: tekst

Serienummer van de fabrikant. Optioneel veld.

Example: 5678901

Max length: 15 characters

`condition` - Conditie

Required: Yes | Type: vooraf gedefinieerde waarden

Staat van het instrument. Moet een van de hieronder vermelde vooraf gedefinieerde waarden zijn.

Toegestane waarden:

NEW - Nieuw instrument
USED - Gebruikt instrument

`description` - Beschrijving

Required: Yes | Type: tekst

Gedetailleerde beschrijving van het instrument. Voeg belangrijke details, conditienotities en eventuele speciale kenmerken toe.

Example: Goed onderhouden Yamaha U1 in uitstekende staat. Regelmatig onderhoud gehad, nieuwe snaren geïnstalleerd in 2020.

Max length: 4000 characters

`number_of_keys` - Aantal toetsen

Required: Yes | Type: getal

Aantal toetsen op het instrument. Verplicht veld.

Example: 88

Min: 1 | Max: 100

`height` - Hoogte

Required: No | Type: getal

Hoogte van het instrument in centimeters. Optioneel veld.

Example: 121

Min: 1 | Max: 999

`width` - Breedte

Required: No | Type: getal

Breedte van het instrument in centimeters. Optioneel veld.

Example: 153

Min: 1 | Max: 999

`depth` - Diepte

Required: No | Type: getal

Diepte van het instrument in centimeters. Optioneel veld.

Example: 65

Min: 1 | Max: 999

`weight` - Gewicht

Required: No | Type: getal

Gewicht van het instrument in kilogram. Optioneel veld.

Example: 230

Min: 1 | Max: 9999

`moderator_pedal` - Moderatorpedaal

Required: No | Type: boolean

Geeft aan of het instrument een moderatorpedaal heeft. Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`sostenuto_pedal` - Sostenutopedaal

Required: No | Type: boolean

Geeft aan of het instrument een sostenutopedaal heeft. Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`silent_system` - Silent System

Required: No | Type: boolean

Geeft aan of het instrument een silent-systeem heeft. Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`player_system` - Player System

Required: No | Type: boolean

Geeft aan of het instrument een player-systeem (zelfspelend systeem) heeft. Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`humidity_control` - Luchtvochtigheidsregelsysteem

Required: No | Type: boolean

Geeft aan of het instrument een systeem voor luchtvochtigheidsregeling heeft. Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`provider_transport` - Levering mogelijk (begane grond)

Required: No | Type: boolean

Geeft aan of de verkoper een transportservice aanbiedt voor het instrument (begane grond). Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`transport_price_included` - Transport inbegrepen in de prijs

Required: No | Type: boolean

Geeft aan of de transportprijs al is inbegrepen in de vermelde prijs. Optioneel veld.

Toegestane waarden:

true
false

Belangrijk: Alleen de exacte waarden "true" of "false" (zonder aanhalingstekens in de CSV) zijn toegestaan.

`email` - E-mail

Required: Yes | Type: e-mailadres

Contact e-mailadres voor vragen over deze vermelding. Dit kan afwijken van het e-mailadres van uw partneraccount.

Example: partner@example.com

Max length: 255 characters

`image_urls` - Afbeeldings-URL's

Required: No | Type: tekst

URL's naar afbeeldingen van het instrument. Scheid meerdere URL's met komma's. Alle afbeeldingen moeten publiekelijk toegankelijk zijn. Optioneel veld.

Afbeeldingen van uw eigen website hergebruiken:

Als u al vermeldingen op uw eigen website heeft en deze ook op PianoHub wilt plaatsen, kunt u de afbeeldings-URL's van uw website direct gebruiken. Op deze manier hoeft u afbeeldingen niet twee keer te uploaden of op te slaan.

Tip: Klik met de rechtermuisknop op een afbeelding in uw browser en selecteer "Adres van afbeelding kopiëren" om de URL te verkrijgen.

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

`video_urls` - Video-URL's

Required: No | Type: tekst

YouTube- of Vimeo-URL's voor video's van het instrument. Scheid meerdere URL's met komma's. Andere video-aanbieders worden niet ondersteund. Video's worden op de pagina van de vermelding ingesloten met een privacy-voorbeeld – de eigenlijke speler wordt pas geladen wanneer de gebruiker op "Afspelen" klikt. Optioneel veld.

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

CSV-invulgids (voor partners)

Hoe CSV-import werkt

Snelreferentie

Gedetailleerde kolombeschrijvingen

public_id - ID

summary - Titel

instrument_type - Instrumenttype

brand - Merk

model - Model

acquisition_type - Type verwerving

currency - Valuta

price_on_request - Prijs op aanvraag

price - Koopprijs

price_type - Prijstype

rent_price - Minimale maandelijkse huur

color - Kleur

year_built - Bouwjaar

production_country - Land van productie

serial_number - Serienummer

condition - Conditie

description - Beschrijving

number_of_keys - Aantal toetsen

height - Hoogte

width - Breedte

depth - Diepte

weight - Gewicht

moderator_pedal - Moderatorpedaal

sostenuto_pedal - Sostenutopedaal

silent_system - Silent System

player_system - Player System

humidity_control - Luchtvochtigheidsregelsysteem

provider_transport - Levering mogelijk (begane grond)

transport_price_included - Transport inbegrepen in de prijs

email - E-mail

image_urls - Afbeeldings-URL's

video_urls - Video-URL's

`public_id` - ID

`summary` - Titel

`instrument_type` - Instrumenttype

`brand` - Merk

`model` - Model

`acquisition_type` - Type verwerving

`currency` - Valuta

`price_on_request` - Prijs op aanvraag

`price` - Koopprijs

`price_type` - Prijstype

`rent_price` - Minimale maandelijkse huur

`color` - Kleur

`year_built` - Bouwjaar

`production_country` - Land van productie

`serial_number` - Serienummer

`condition` - Conditie

`description` - Beschrijving

`number_of_keys` - Aantal toetsen

`height` - Hoogte

`width` - Breedte

`depth` - Diepte

`weight` - Gewicht

`moderator_pedal` - Moderatorpedaal

`sostenuto_pedal` - Sostenutopedaal

`silent_system` - Silent System

`player_system` - Player System

`humidity_control` - Luchtvochtigheidsregelsysteem

`provider_transport` - Levering mogelijk (begane grond)

`transport_price_included` - Transport inbegrepen in de prijs

`email` - E-mail

`image_urls` - Afbeeldings-URL's

`video_urls` - Video-URL's