Guía de cumplimentación de CSV (para socios)

Esta página ofrece una referencia exhaustiva de todas las columnas del formato CSV para anuncios de socios. Utilice esta guía para comprender los tipos de datos, las reglas de validación y los ejemplos de cada campo.

Cómo funciona la importación de CSV

El sistema de importación de CSV le permite gestionar todos sus anuncios de PianoHub de forma eficiente mediante archivos de hojas de cálculo:

Exporte sus anuncios actuales de PianoHub como archivo CSV para obtener el estado actual de los datos.
Edite o complete el archivo CSV con cambios, actualizaciones o nuevos anuncios.
Importante: Todos los anuncios existentes que desee conservar deben permanecer en el CSV. Los anuncios que falten serán marcados para su eliminación por la herramienta de importación.
Para añadir nuevos anuncios (por ejemplo, mediante conversión por IA), combine sus datos existentes con los nuevos anuncios en un único archivo CSV antes de importarlo.

Referencia rápida

Resumen de todas las columnas en el formato CSV:

Tabla de referencia de columnas CSV con nombres de columna, tipos y estado de obligatoriedad
Column Name	Type	Required
`public_id`	asignado automáticamente (solo lectura)	No
`summary`	texto	Yes
`instrument_type`	valores predefinidos	Yes
`brand`	texto	Yes
`model`	texto	No
`acquisition_type`	valores predefinidos	Yes
`currency`	valores predefinidos	No
`price_on_request`	booleano	No
`price`	número	No
`price_type`	valores predefinidos	No
`rent_price`	número	No
`color`	valores predefinidos	Yes
`year_built`	número	No
`production_country`	texto	No
`serial_number`	texto	No
`condition`	valores predefinidos	Yes
`description`	texto	Yes
`number_of_keys`	número	Yes
`height`	número	No
`width`	número	No
`depth`	número	No
`weight`	número	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`	dirección de correo electrónico	Yes
`image_urls`	texto	No
`video_urls`	texto	No

Descripciones detalladas de las columnas

`public_id` - ID

Required: No | Type: asignado automáticamente (solo lectura)

El ID del anuncio. Este campo se asigna automáticamente al crear un anuncio y no se puede cambiar. Déjelo vacío para anuncios nuevos.

Al actualizar anuncios existentes, la fila del CSV debe contener el public_id asignado previamente por PianoHub. Los anuncios se identifican por este ID, no por el título u otros campos.

Example: 12345

`summary` - Título

Required: Yes | Type: texto

Un título corto y descriptivo para el piano. Aparece en los resultados de búsqueda y debe ser conciso pero informativo.

Example: Piano de pared Yamaha U1 Negro

Max length: 80 characters

`instrument_type` - Tipo de instrumento

Required: Yes | Type: valores predefinidos

El tipo de instrumento. Debe ser uno de los valores predefinidos que se enumeran a continuación.

Valores permitidos:

UPRIGHT_PIANO - Piano vertical
GRAND_PIANO - Piano de cola
DIGITAL_PIANO - Piano digital
OTHER - Otros

`brand` - Marca

Required: Yes | Type: texto

Nombre del fabricante o de la marca.

Importante: Si va a publicar un piano de una de las marcas especialmente populares que figuran a continuación, utilice la ortografía aquí documentada. Las variaciones en la escritura (por ejemplo, "C. Bechstein" en lugar de "Bechstein") harán que los usuarios no encuentren su anuncio cuando filtren por marca mediante la función de búsqueda en 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` - Modelo

Required: No | Type: texto

Designación o nombre del modelo. Campo opcional.

Example: U1

Max length: 30 characters

`acquisition_type` - Tipo de adquisición

Required: Yes | Type: valores predefinidos

Especifica cómo se puede adquirir el instrumento. Utilice BUY solo para venta, RENT solo para alquiler, o BOTH si el instrumento se puede comprar o alquilar.

Valores permitidos:

BUY
RENT
BOTH

`currency` - Moneda

Required: No | Type: valores predefinidos

Código de moneda. Debe ser uno de los valores predefinidos que se enumeran a continuación. Obligatorio cuando acquisition_type es BUY o BOTH y price_on_request es false, o cuando acquisition_type es RENT o BOTH (para el precio de alquiler). Dejar vacío solo si acquisition_type es BUY y price_on_request es true.

Valores permitidos:

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

`price_on_request` - Precio a consultar

Required: No | Type: booleano

Indica si no debe mostrarse ningún precio de compra. Si es true, los campos price y price_type se ignoran y el anuncio se muestra con "Precio a consultar". No afecta a rent_price. Dejar vacío cuando acquisition_type sea RENT (no aplicable en ese caso).

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`price` - Precio de compra

Required: No | Type: número

Precio de compra como número sin símbolo de moneda. Obligatorio cuando acquisition_type es BUY o BOTH y price_on_request es false. Dejar vacío si price_on_request es true o acquisition_type es RENT.

Example: 3500

Min: 0 | Max: 9999999

`price_type` - Tipo de precio

Required: No | Type: valores predefinidos

Tipo de precio. Obligatorio cuando acquisition_type es BUY o BOTH y price_on_request es false. Dejar vacío si price_on_request es true o acquisition_type es RENT.

Valores permitidos:

FIXED - Fijo
NEGOTIABLE - Negociable

`rent_price` - Alquiler mensual mínimo

Required: No | Type: número

Precio mínimo de alquiler mensual como número sin símbolo de moneda. Obligatorio cuando acquisition_type es RENT o BOTH. Dejar vacío si acquisition_type es BUY.

Example: 149

Min: 0 | Max: 9999999

`color` - Color

Required: Yes | Type: valores predefinidos

Color principal del instrumento. Debe ser uno de los valores predefinidos que se enumeran a continuación.

Valores permitidos:

BLACK - Negro
WHITE - Blanco
WOOD - Madera
OTHER - Otro color

`year_built` - Año de construcción

Required: No | Type: número

Año de fabricación. Campo opcional.

Example: 2005

Min: 1800 | Max: 2026

`production_country` - País de producción

Required: No | Type: texto

País donde se fabricó el instrumento. Campo opcional.

Example: Japón

Max length: 30 characters

`serial_number` - Número de serie

Required: No | Type: texto

Número de serie del fabricante. Campo opcional.

Example: 5678901

Max length: 15 characters

`condition` - Estado

Required: Yes | Type: valores predefinidos

Estado del instrumento. Debe ser uno de los valores predefinidos que se enumeran a continuación.

Valores permitidos:

NEW - Instrumento nuevo
USED - Instrumento usado

`description` - Descripción

Required: Yes | Type: texto

Descripción detallada del instrumento. Incluya detalles importantes, notas sobre el estado y cualquier característica especial.

Example: Yamaha U1 bien mantenido en excelentes condiciones. Mantenimiento regular, cuerdas nuevas instaladas en 2020.

Max length: 4000 characters

`number_of_keys` - Número de teclas

Required: Yes | Type: número

Número de teclas del instrumento. Campo obligatorio.

Example: 88

Min: 1 | Max: 100

`height` - Altura

Required: No | Type: número

Altura del instrumento en centímetros. Campo opcional.

Example: 121

Min: 1 | Max: 999

`width` - Anchura

Required: No | Type: número

Anchura del instrumento en centímetros. Campo opcional.

Example: 153

Min: 1 | Max: 999

`depth` - Profundidad

Required: No | Type: número

Profundidad del instrumento en centímetros. Campo opcional.

Example: 65

Min: 1 | Max: 999

`weight` - Peso

Required: No | Type: número

Peso del instrumento en kilogramos. Campo opcional.

Example: 230

Min: 1 | Max: 9999

`moderator_pedal` - Pedal moderador

Required: No | Type: booleano

Indica si el instrumento tiene un pedal moderador. Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`sostenuto_pedal` - Pedal de sostenuto

Required: No | Type: booleano

Indica si el instrumento tiene un pedal de sostenuto. Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`silent_system` - Sistema Silent

Required: No | Type: booleano

Indica si el instrumento dispone de un sistema silencioso (silent system). Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`player_system` - Sistema Player

Required: No | Type: booleano

Indica si el instrumento tiene un sistema de auto-reproducción (player system). Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`humidity_control` - Sistema de control de humedad

Required: No | Type: booleano

Indica si el instrumento tiene un sistema de control de humedad. Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`provider_transport` - Entrega disponible (planta baja)

Required: No | Type: booleano

Indica si el vendedor ofrece un servicio de transporte para el instrumento (planta baja). Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`transport_price_included` - Transporte incluido en el precio

Required: No | Type: booleano

Indica si el precio del transporte ya está incluido en el precio indicado. Campo opcional.

Valores permitidos:

true
false

Importante: Solo se permiten los valores exactos "true" o "false" (sin comillas en el CSV).

`email` - Correo electrónico

Required: Yes | Type: dirección de correo electrónico

Correo electrónico de contacto para consultas sobre este anuncio. Puede ser diferente del correo de su cuenta de socio.

Example: socio@example.com

Max length: 255 characters

`image_urls` - URLs de imágenes

Required: No | Type: texto

URLs de las imágenes del instrumento. Separe varias URLs con comas. Todas las imágenes deben ser accesibles públicamente. Campo opcional.

Reutilización de imágenes de su propio sitio web:

Si ya tiene anuncios en su propio sitio web y desea publicarlos también en PianoHub, puede utilizar directamente las URLs de las imágenes de su sitio web. De este modo, no tendrá que subir ni almacenar las imágenes dos veces.

Consejo: Haga clic con el botón derecho del ratón sobre una imagen en su navegador y seleccione "Copiar dirección de imagen" para obtener la URL.

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

`video_urls` - URLs de vídeo

Required: No | Type: texto

URLs de YouTube o Vimeo para vídeos del instrumento. Separe varias URLs con comas. No se admiten otros proveedores de vídeo. Los vídeos se insertan en la página del anuncio con una vista previa de privacidad; el reproductor real solo se carga cuando el usuario hace clic en "Reproducir". Campo opcional.

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

Guía de cumplimentación de CSV (para socios)

Cómo funciona la importación de CSV

Referencia rápida

Descripciones detalladas de las columnas

public_id - ID

summary - Título

instrument_type - Tipo de instrumento

brand - Marca

model - Modelo

acquisition_type - Tipo de adquisición

currency - Moneda

price_on_request - Precio a consultar

price - Precio de compra

price_type - Tipo de precio

rent_price - Alquiler mensual mínimo

color - Color

year_built - Año de construcción

production_country - País de producción

serial_number - Número de serie

condition - Estado

description - Descripción

number_of_keys - Número de teclas

height - Altura

width - Anchura

depth - Profundidad

weight - Peso

moderator_pedal - Pedal moderador

sostenuto_pedal - Pedal de sostenuto

silent_system - Sistema Silent

player_system - Sistema Player

humidity_control - Sistema de control de humedad

provider_transport - Entrega disponible (planta baja)

transport_price_included - Transporte incluido en el precio

email - Correo electrónico

image_urls - URLs de imágenes

video_urls - URLs de vídeo

`public_id` - ID

`summary` - Título

`instrument_type` - Tipo de instrumento

`brand` - Marca

`model` - Modelo

`acquisition_type` - Tipo de adquisición

`currency` - Moneda

`price_on_request` - Precio a consultar

`price` - Precio de compra

`price_type` - Tipo de precio

`rent_price` - Alquiler mensual mínimo

`color` - Color

`year_built` - Año de construcción

`production_country` - País de producción

`serial_number` - Número de serie

`condition` - Estado

`description` - Descripción

`number_of_keys` - Número de teclas

`height` - Altura

`width` - Anchura

`depth` - Profundidad

`weight` - Peso

`moderator_pedal` - Pedal moderador

`sostenuto_pedal` - Pedal de sostenuto

`silent_system` - Sistema Silent

`player_system` - Sistema Player

`humidity_control` - Sistema de control de humedad

`provider_transport` - Entrega disponible (planta baja)

`transport_price_included` - Transporte incluido en el precio

`email` - Correo electrónico

`image_urls` - URLs de imágenes

`video_urls` - URLs de vídeo