Przewodnik wypełniania CSV (dla Partnerów)

Niniejsza strona zawiera kompleksowy opis wszystkich kolumn w formacie CSV dla ofert partnerskich. Skorzystaj z tego przewodnika, aby zrozumieć typy danych, reguły walidacji i przykłady dla każdego pola.

Jak działa import CSV

System importu CSV pozwala efektywnie zarządzać wszystkimi ofertami PianoHub za pomocą plików arkusza kalkulacyjnego:

Wyeksportuj swoje aktualne oferty PianoHub jako plik CSV, aby uzyskać bieżący stan danych.
Edytuj lub uzupełnij plik CSV o zmiany, aktualizacje lub nowe oferty.
Ważne: Wszystkie istniejące oferty, które chcesz zachować, muszą pozostać w pliku CSV. Brakujące oferty zostaną oznaczone do usunięcia przez narzędzie do importu.
Aby dodać nowe oferty (np. poprzez konwersję AI), połącz istniejące dane z nowymi ofertami w jednym pliku CSV przed importem.

Szybka referencja

Przegląd wszystkich kolumn w formacie CSV:

Tabela referencyjna kolumn CSV z nazwami kolumn, typami i statusem wymagalności
Column Name	Type	Required
`public_id`	przypisane automatycznie (tylko do odczytu)	No
`summary`	tekst	Yes
`instrument_type`	zdefiniowane wartości	Yes
`brand`	tekst	Yes
`model`	tekst	No
`acquisition_type`	zdefiniowane wartości	Yes
`currency`	zdefiniowane wartości	No
`price_on_request`	wartość logiczna (boolean)	No
`price`	liczba	No
`price_type`	zdefiniowane wartości	No
`rent_price`	liczba	No
`color`	zdefiniowane wartości	Yes
`year_built`	liczba	No
`production_country`	tekst	No
`serial_number`	tekst	No
`condition`	zdefiniowane wartości	Yes
`description`	tekst	Yes
`number_of_keys`	liczba	Yes
`height`	liczba	No
`width`	liczba	No
`depth`	liczba	No
`weight`	liczba	No
`moderator_pedal`	wartość logiczna (boolean)	No
`sostenuto_pedal`	wartość logiczna (boolean)	No
`silent_system`	wartość logiczna (boolean)	No
`player_system`	wartość logiczna (boolean)	No
`humidity_control`	wartość logiczna (boolean)	No
`provider_transport`	wartość logiczna (boolean)	No
`transport_price_included`	wartość logiczna (boolean)	No
`email`	adres e-mail	Yes
`image_urls`	tekst	No
`video_urls`	tekst	No

Szczegółowe opisy kolumn

`public_id` - ID

Required: No | Type: przypisane automatycznie (tylko do odczytu)

Identyfikator oferty. To pole jest przypisywane automatycznie podczas tworzenia oferty i nie może być zmienione. Pozostaw puste dla nowych ofert.

Podczas aktualizacji istniejących ofert, wiersz CSV musi zawierać public_id przypisany wcześniej przez PianoHub. Oferty są identyfikowane na podstawie tego ID, a nie tytułu czy innych pól.

Example: 12345

`summary` - Tytuł

Required: Yes | Type: tekst

Krótki, opisowy tytuł pianina lub fortepianu. Pojawia się w wynikach wyszukiwania i powinien być zwięzły, ale informacyjny.

Example: Pianino cyfrowe Yamaha U1 czarne

Max length: 80 characters

`instrument_type` - Typ instrumentu

Required: Yes | Type: zdefiniowane wartości

Typ instrumentu. Musi być jedną ze zdefiniowanych wartości wymienionych poniżej.

Dozwolone wartości:

UPRIGHT_PIANO - Pianino
GRAND_PIANO - Fortepian
DIGITAL_PIANO - Pianino cyfrowe
OTHER - Inne

`brand` - Marka

Required: Yes | Type: tekst

Nazwa producenta lub marki.

Ważne: Jeśli wystawiasz instrument jednej z popularnych marek wymienionych poniżej, użyj udokumentowanej tutaj pisowni. Odstępstwa w pisowni (np. „C. Bechstein” zamiast „Bechstein”) spowodują, że użytkownicy nie znajdą Twojej oferty podczas filtrowania według marki w wyszukiwarce 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

Oznaczenie lub nazwa modelu. Pole opcjonalne.

Example: U1

Max length: 30 characters

`acquisition_type` - Typ pozyskania

Required: Yes | Type: zdefiniowane wartości

Określa, jak można wejść w posiadanie instrumentu. Użyj BUY tylko dla sprzedaży, RENT tylko dla wynajmu lub BOTH, jeśli instrument można kupić lub wynająć.

Dozwolone wartości:

BUY
RENT
BOTH

`currency` - Waluta

Required: No | Type: zdefiniowane wartości

Kod waluty. Musi być jedną ze zdefiniowanych wartości wymienionych poniżej. Wymagana, gdy acquisition_type to BUY lub BOTH, a price_on_request to false, lub gdy acquisition_type to RENT lub BOTH (dla ceny najmu). Pozostaw puste tylko jeśli acquisition_type to BUY, a price_on_request to true.

Dozwolone wartości:

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

`price_on_request` - Cena na zapytanie

Required: No | Type: wartość logiczna (boolean)

Określa, czy cena zakupu ma nie być wyświetlana. Jeśli true, pola price i price_type są ignorowane, a oferta wyświetla się z informacją „Cena na zapytanie”. Nie wpływa na rent_price. Pozostaw puste, gdy acquisition_type to RENT (nie dotyczy w tym przypadku).

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`price` - Cena zakupu

Required: No | Type: liczba

Cena zakupu jako liczba bez symbolu waluty. Wymagana, gdy acquisition_type to BUY lub BOTH, a price_on_request ma wartość false. Pozostaw puste, jeśli price_on_request to true lub acquisition_type to RENT.

Example: 3500

Min: 0 | Max: 9999999

`price_type` - Typ ceny

Required: No | Type: zdefiniowane wartości

Typ ceny. Wymagany, gdy acquisition_type to BUY lub BOTH, a price_on_request ma wartość false. Pozostaw puste, jeśli price_on_request to true lub acquisition_type to RENT.

Dozwolone wartości:

FIXED - Stała
NEGOTIABLE - Do negocjacji

`rent_price` - Minimalny miesięczny czynsz

Required: No | Type: liczba

Minimalna cena miesięcznego wynajmu jako liczba bez symbolu waluty. Wymagana, gdy acquisition_type to RENT lub BOTH. Pozostaw puste, jeśli acquisition_type to BUY.

Example: 149

Min: 0 | Max: 9999999

`color` - Kolor

Required: Yes | Type: zdefiniowane wartości

Główny kolor instrumentu. Musi być jedną ze zdefiniowanych wartości wymienionych poniżej.

Dozwolone wartości:

BLACK - Czarny
WHITE - Biały
WOOD - Drewno
OTHER - Inny kolor

`year_built` - Rok budowy

Required: No | Type: liczba

Rok produkcji. Pole opcjonalne.

Example: 2005

Min: 1800 | Max: 2026

`production_country` - Kraj produkcji

Required: No | Type: tekst

Kraj, w którym instrument został wyprodukowany. Pole opcjonalne.

Example: Japonia

Max length: 30 characters

`serial_number` - Numer seryjny

Required: No | Type: tekst

Numer seryjny producenta. Pole opcjonalne.

Example: 5678901

Max length: 15 characters

`condition` - Stan

Required: Yes | Type: zdefiniowane wartości

Stan instrumentu. Musi być jedną ze zdefiniowanych wartości wymienionych poniżej.

Dozwolone wartości:

NEW - Instrument nowy
USED - Instrument używany

`description` - Opis

Required: Yes | Type: tekst

Szczegółowy opis instrumentu. Zawrzyj ważne detale, uwagi o stanie i wszelkie cechy specjalne.

Example: Zadbana Yamaha U1 w doskonałym stanie. Regularnie serwisowana, nowe struny założone w 2020 r.

Max length: 4000 characters

`number_of_keys` - Liczba klawiszy

Required: Yes | Type: liczba

Liczba klawiszy instrumentu. Pole wymagane.

Example: 88

Min: 1 | Max: 100

`height` - Wysokość

Required: No | Type: liczba

Wysokość instrumentu w centymetrach. Pole opcjonalne.

Example: 121

Min: 1 | Max: 999

`width` - Szerokość

Required: No | Type: liczba

Szerokość instrumentu w centymetrach. Pole opcjonalne.

Example: 153

Min: 1 | Max: 999

`depth` - Głębokość

Required: No | Type: liczba

Głębokość instrumentu w centymetrach. Pole opcjonalne.

Example: 65

Min: 1 | Max: 999

`weight` - Waga

Required: No | Type: liczba

Waga instrumentu w kilogramach. Pole opcjonalne.

Example: 230

Min: 1 | Max: 9999

`moderator_pedal` - Pedał moderatora

Required: No | Type: wartość logiczna (boolean)

Określa, czy instrument posiada pedał moderatora. Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`sostenuto_pedal` - Pedał sostenuto

Required: No | Type: wartość logiczna (boolean)

Określa, czy instrument posiada pedał sostenuto. Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`silent_system` - System Silent

Required: No | Type: wartość logiczna (boolean)

Określa, czy instrument posiada system silent. Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`player_system` - System samogrający

Required: No | Type: wartość logiczna (boolean)

Określa, czy instrument posiada system samogrający (player system). Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`humidity_control` - System kontroli wilgotności

Required: No | Type: wartość logiczna (boolean)

Określa, czy instrument posiada system kontroli wilgotności. Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`provider_transport` - Dostawa możliwa (parter)

Required: No | Type: wartość logiczna (boolean)

Określa, czy sprzedawca oferuje usługę transportu instrumentu (parter). Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`transport_price_included` - Transport wliczony w cenę

Required: No | Type: wartość logiczna (boolean)

Określa, czy koszt transportu jest już wliczony w podaną cenę. Pole opcjonalne.

Dozwolone wartości:

true
false

Ważne: Dozwolone są tylko dokładne wartości „true” lub „false” (bez cudzysłowu w pliku CSV).

`email` - E-mail

Required: Yes | Type: adres e-mail

Adres e-mail do zapytań o tę ofertę. Może być inny niż e-mail konta partnera.

Example: partner@example.com

Max length: 255 characters

`image_urls` - Adresy URL zdjęć

Required: No | Type: tekst

Adresy URL do zdjęć instrumentu. Rozdziel wiele adresów przecinkami. Wszystkie zdjęcia muszą być publicznie dostępne. Pole opcjonalne.

Używanie zdjęć z własnej strony internetowej:

Jeśli masz już oferty na własnej stronie i chcesz je dodatkowo wystawić na PianoHub, możesz bezpośrednio użyć adresów URL zdjęć ze swojej strony. Dzięki temu nie musisz przesyłać ani przechowywać zdjęć dwukrotnie.

Wskazówka: Kliknij prawym przyciskiem myszy na zdjęcie w przeglądarce i wybierz „Kopiuj adres obrazu”, aby uzyskać adres URL.

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

`video_urls` - Adresy URL wideo

Required: No | Type: tekst

Adresy URL YouTube lub Vimeo z filmami instrumentu. Rozdziel wiele adresów przecinkami. Inni dostawcy wideo nie są obsługiwani. Filmy są osadzane na stronie oferty z podglądem prywatności – właściwy odtwarzacz ładuje się dopiero po kliknięciu „Odtwórz”. Pole opcjonalne.

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

Przewodnik wypełniania CSV (dla Partnerów)

Jak działa import CSV

Szybka referencja

Szczegółowe opisy kolumn

public_id - ID

summary - Tytuł

instrument_type - Typ instrumentu

brand - Marka

model - Model

acquisition_type - Typ pozyskania

currency - Waluta

price_on_request - Cena na zapytanie

price - Cena zakupu

price_type - Typ ceny

rent_price - Minimalny miesięczny czynsz

color - Kolor

year_built - Rok budowy

production_country - Kraj produkcji

serial_number - Numer seryjny

condition - Stan

description - Opis

number_of_keys - Liczba klawiszy

height - Wysokość

width - Szerokość

depth - Głębokość

weight - Waga

moderator_pedal - Pedał moderatora

sostenuto_pedal - Pedał sostenuto

silent_system - System Silent

player_system - System samogrający

humidity_control - System kontroli wilgotności

provider_transport - Dostawa możliwa (parter)

transport_price_included - Transport wliczony w cenę

email - E-mail

image_urls - Adresy URL zdjęć

video_urls - Adresy URL wideo

`public_id` - ID

`summary` - Tytuł

`instrument_type` - Typ instrumentu

`brand` - Marka

`model` - Model

`acquisition_type` - Typ pozyskania

`currency` - Waluta

`price_on_request` - Cena na zapytanie

`price` - Cena zakupu

`price_type` - Typ ceny

`rent_price` - Minimalny miesięczny czynsz

`color` - Kolor

`year_built` - Rok budowy

`production_country` - Kraj produkcji

`serial_number` - Numer seryjny

`condition` - Stan

`description` - Opis

`number_of_keys` - Liczba klawiszy

`height` - Wysokość

`width` - Szerokość

`depth` - Głębokość

`weight` - Waga

`moderator_pedal` - Pedał moderatora

`sostenuto_pedal` - Pedał sostenuto

`silent_system` - System Silent

`player_system` - System samogrający

`humidity_control` - System kontroli wilgotności

`provider_transport` - Dostawa możliwa (parter)

`transport_price_included` - Transport wliczony w cenę

`email` - E-mail

`image_urls` - Adresy URL zdjęć

`video_urls` - Adresy URL wideo