Guida alla compilazione CSV (per i Partner)

Questa pagina fornisce un riferimento completo per tutte le colonne nel formato CSV per gli annunci dei partner. Utilizza questa guida per comprendere i tipi di dati, le regole di validazione e gli esempi per ogni campo.

Come funziona l'importazione CSV

Il sistema di importazione CSV ti consente di gestire tutti i tuoi annunci su PianoHub in modo efficiente utilizzando file di fogli di calcolo:

Esporta i tuoi attuali annunci PianoHub come file CSV per ottenere lo stato attuale dei dati.
Modifica o integra il file CSV con cambiamenti, aggiornamenti o nuovi annunci.
Importante: tutti gli annunci esistenti che desideri mantenere devono rimanere nel CSV. Gli annunci mancanti saranno contrassegnati per l'eliminazione dallo strumento di importazione.
Per aggiungere nuovi annunci (ad es. tramite conversione IA), unisci i tuoi dati esistenti con i nuovi annunci in un unico file CSV prima dell'importazione.

Riferimento rapido

Panoramica di tutte le colonne nel formato CSV:

Tabella di riferimento delle colonne CSV con nomi delle colonne, tipi e stato di obbligatorietà
Column Name	Type	Required
`public_id`	assegnato automaticamente (sola lettura)	No
`summary`	testo	Yes
`instrument_type`	valori predefiniti	Yes
`brand`	testo	Yes
`model`	testo	No
`acquisition_type`	valori predefiniti	Yes
`currency`	valori predefiniti	No
`price_on_request`	booleano	No
`price`	numero	No
`price_type`	valori predefiniti	No
`rent_price`	numero	No
`color`	valori predefiniti	Yes
`year_built`	numero	No
`production_country`	testo	No
`serial_number`	testo	No
`condition`	valori predefiniti	Yes
`description`	testo	Yes
`number_of_keys`	numero	Yes
`height`	numero	No
`width`	numero	No
`depth`	numero	No
`weight`	numero	No
`moderator_pedal`	booleano	No
`sostenuto_pedal`	booleano	No
`silent_system`	booleano	No
`player_system`	booleano	No
`humidity_control`	booleano	No
`provider_transport`	booleano	No
`transport_price_included`	booleano	No
`email`	indirizzo email	Yes
`image_urls`	testo	No
`video_urls`	testo	No

Descrizioni dettagliate delle colonne

`public_id` - ID

Required: No | Type: assegnato automaticamente (sola lettura)

L'ID dell'annuncio. Questo campo viene assegnato automaticamente quando crei un annuncio e non può essere modificato. Lascia vuoto per i nuovi annunci.

Quando si aggiornano annunci esistenti, la riga CSV deve contenere il public_id precedentemente assegnato da PianoHub. Gli annunci sono identificati da questo ID, non dal titolo o da altri campi.

Example: 12345

`summary` - Titolo

Required: Yes | Type: testo

Un titolo breve e descrittivo per il pianoforte. Questo appare nei risultati di ricerca e dovrebbe essere conciso ma informativo.

Example: Pianoforte verticale Yamaha U1 Nero

Max length: 80 characters

`instrument_type` - Tipo di strumento

Required: Yes | Type: valori predefiniti

Il tipo di strumento. Deve essere uno dei valori predefiniti elencati di seguito.

Valori ammessi:

UPRIGHT_PIANO - Pianoforte verticale
GRAND_PIANO - Pianoforte a coda
DIGITAL_PIANO - Pianoforte digitale
OTHER - Altro

`brand` - Marca

Required: Yes | Type: testo

Produttore o nome della marca.

Importante: se stai inserendo un pianoforte di una delle marche particolarmente popolari elencate di seguito, usa l'ortografia qui documentata. Grafie diverse (ad es. "C. Bechstein" invece di "Bechstein") faranno sì che gli utenti non trovino il tuo annuncio quando filtrano per marca utilizzando la funzione di ricerca su 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` - Modello

Required: No | Type: testo

Designazione o nome del modello. Campo opzionale.

Example: U1

Max length: 30 characters

`acquisition_type` - Tipo di acquisizione

Required: Yes | Type: valori predefiniti

Specifica come lo strumento può essere acquisito. Usa BUY solo per la vendita, RENT solo per il noleggio, o BOTH se lo strumento può essere acquistato o noleggiato.

Valori ammessi:

BUY
RENT
BOTH

`currency` - Valuta

Required: No | Type: valori predefiniti

Codice valuta. Deve essere uno dei valori predefiniti elencati di seguito. Obbligatorio quando acquisition_type è BUY o BOTH e price_on_request è false, oppure quando acquisition_type è RENT o BOTH (per il prezzo di affitto). Lascia vuoto solo se acquisition_type è BUY e price_on_request è true.

Valori ammessi:

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

`price_on_request` - Prezzo su richiesta

Required: No | Type: booleano

Indica se non deve essere visualizzato alcun prezzo di acquisto. Se true, i campi price e price_type vengono ignorati e l'annuncio viene visualizzato con "Prezzo su richiesta". Non influisce su rent_price. Lascia vuoto quando acquisition_type è RENT (non applicabile in quel caso).

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`price` - Prezzo d'acquisto

Required: No | Type: numero

Prezzo di acquisto come numero senza simbolo di valuta. Obbligatorio quando acquisition_type è BUY o BOTH e price_on_request è false. Lascia vuoto se price_on_request è true o acquisition_type è RENT.

Example: 3500

Min: 0 | Max: 9999999

`price_type` - Tipo di prezzo

Required: No | Type: valori predefiniti

Tipo di prezzo. Obbligatorio quando acquisition_type è BUY o BOTH e price_on_request è false. Lascia vuoto se price_on_request è true o acquisition_type è RENT.

Valori ammessi:

FIXED - Fisso
NEGOTIABLE - Trattabile

`rent_price` - Canone mensile minimo

Required: No | Type: numero

Prezzo minimo del canone mensile come numero senza simbolo di valuta. Obbligatorio quando acquisition_type è RENT o BOTH. Lascia vuoto se acquisition_type è BUY.

Example: 149

Min: 0 | Max: 9999999

`color` - Colore

Required: Yes | Type: valori predefiniti

Colore primario dello strumento. Deve essere uno dei valori predefiniti elencati di seguito.

Valori ammessi:

BLACK - Nero
WHITE - Bianco
WOOD - Legno
OTHER - Altro colore

`year_built` - Anno di costruzione

Required: No | Type: numero

Anno di fabbricazione. Campo opzionale.

Example: 2005

Min: 1800 | Max: 2026

`production_country` - Paese di produzione

Required: No | Type: testo

Paese in cui lo strumento è stato fabbricato. Campo opzionale.

Example: Giappone

Max length: 30 characters

`serial_number` - Numero di serie

Required: No | Type: testo

Numero di serie del produttore. Campo opzionale.

Example: 5678901

Max length: 15 characters

`condition` - Condizione

Required: Yes | Type: valori predefiniti

Condizione dello strumento. Deve essere uno dei valori predefiniti elencati di seguito.

Valori ammessi:

NEW - Strumento nuovo
USED - Strumento usato

`description` - Descrizione

Required: Yes | Type: testo

Descrizione dettagliata dello strumento. Includi dettagli importanti, note sulle condizioni e qualsiasi caratteristica speciale.

Example: Yamaha U1 ben tenuto in eccellenti condizioni. Manutenzione regolare, nuove corde installate nel 2020.

Max length: 4000 characters

`number_of_keys` - Numero di tasti

Required: Yes | Type: numero

Numero di tasti dello strumento. Campo obbligatorio.

Example: 88

Min: 1 | Max: 100

`height` - Altezza

Required: No | Type: numero

Altezza dello strumento in centimetri. Campo opzionale.

Example: 121

Min: 1 | Max: 999

`width` - Larghezza

Required: No | Type: numero

Larghezza dello strumento in centimetri. Campo opzionale.

Example: 153

Min: 1 | Max: 999

`depth` - Profondità

Required: No | Type: numero

Profondità dello strumento in centimetri. Campo opzionale.

Example: 65

Min: 1 | Max: 999

`weight` - Peso

Required: No | Type: numero

Peso dello strumento in chilogrammi. Campo opzionale.

Example: 230

Min: 1 | Max: 9999

`moderator_pedal` - Pedale moderatore

Required: No | Type: booleano

Indica se lo strumento ha un pedale moderatore. Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`sostenuto_pedal` - Pedale sostenuto

Required: No | Type: booleano

Indica se lo strumento ha un pedale tonale (sostenuto). Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`silent_system` - Sistema Silent

Required: No | Type: booleano

Indica se lo strumento ha un sistema silent. Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`player_system` - Sistema Player

Required: No | Type: booleano

Indica se lo strumento ha un sistema player (sistema di auto-esecuzione). Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`humidity_control` - Sistema di controllo umidità

Required: No | Type: booleano

Indica se lo strumento ha un sistema di controllo dell'umidità. Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`provider_transport` - Consegna possibile (Piano terra)

Required: No | Type: booleano

Indica se il venditore offre un servizio di trasporto per lo strumento (piano terra). Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`transport_price_included` - Trasporto incluso nel prezzo

Required: No | Type: booleano

Indica se il prezzo del trasporto è già incluso nel prezzo indicato. Campo opzionale.

Valori ammessi:

true
false

Importante: sono ammessi solo i valori esatti "true" o "false" (senza virgolette nel CSV).

`email` - Email

Required: Yes | Type: indirizzo email

Email di contatto per richieste su questo annuncio. Può differire dall'email del tuo account partner.

Example: partner@example.com

Max length: 255 characters

`image_urls` - URL Immagini

Required: No | Type: testo

URL delle immagini dello strumento. Separa più URL con virgole. Tutte le immagini devono essere accessibili pubblicamente. Campo opzionale.

Riutilizzo delle immagini dal proprio sito web:

Se hai già degli annunci sul tuo sito web e vuoi pubblicarli anche su PianoHub, puoi usare direttamente gli URL delle immagini del tuo sito. In questo modo, non è necessario caricare o archiviare le immagini due volte.

Suggerimento: fai clic con il tasto destro su un'immagine nel tuo browser e seleziona "Copia indirizzo immagine" per ottenere l'URL.

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

`video_urls` - URL Video

Required: No | Type: testo

URL YouTube o Vimeo per i video dello strumento. Separa più URL con virgole. Altri fornitori di video non sono supportati. I video sono incorporati nella pagina dell'annuncio con un'anteprima per la privacy: il player effettivo si carica solo quando l'utente clicca su "Play". Campo opzionale.

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

Guida alla compilazione CSV (per i Partner)

Come funziona l'importazione CSV

Riferimento rapido

Descrizioni dettagliate delle colonne

public_id - ID

summary - Titolo

instrument_type - Tipo di strumento

brand - Marca

model - Modello

acquisition_type - Tipo di acquisizione

currency - Valuta

price_on_request - Prezzo su richiesta

price - Prezzo d'acquisto

price_type - Tipo di prezzo

rent_price - Canone mensile minimo

color - Colore

year_built - Anno di costruzione

production_country - Paese di produzione

serial_number - Numero di serie

condition - Condizione

description - Descrizione

number_of_keys - Numero di tasti

height - Altezza

width - Larghezza

depth - Profondità

weight - Peso

moderator_pedal - Pedale moderatore

sostenuto_pedal - Pedale sostenuto

silent_system - Sistema Silent

player_system - Sistema Player

humidity_control - Sistema di controllo umidità

provider_transport - Consegna possibile (Piano terra)

transport_price_included - Trasporto incluso nel prezzo

email - Email

image_urls - URL Immagini

video_urls - URL Video

`public_id` - ID

`summary` - Titolo

`instrument_type` - Tipo di strumento

`brand` - Marca

`model` - Modello

`acquisition_type` - Tipo di acquisizione

`currency` - Valuta

`price_on_request` - Prezzo su richiesta

`price` - Prezzo d'acquisto

`price_type` - Tipo di prezzo

`rent_price` - Canone mensile minimo

`color` - Colore

`year_built` - Anno di costruzione

`production_country` - Paese di produzione

`serial_number` - Numero di serie

`condition` - Condizione

`description` - Descrizione

`number_of_keys` - Numero di tasti

`height` - Altezza

`width` - Larghezza

`depth` - Profondità

`weight` - Peso

`moderator_pedal` - Pedale moderatore

`sostenuto_pedal` - Pedale sostenuto

`silent_system` - Sistema Silent

`player_system` - Sistema Player

`humidity_control` - Sistema di controllo umidità

`provider_transport` - Consegna possibile (Piano terra)

`transport_price_included` - Trasporto incluso nel prezzo

`email` - Email

`image_urls` - URL Immagini

`video_urls` - URL Video