Strona główna/Instrukcja aktualizacji ofert przez FTP

Instrukcja aktualizacji ofert przez FTP

Promotee Group

Instrukcja dla Dostawców — aktualizacja ofert przez FTP

Jak poprawnie przekazać ofertę produktowo-cenową (wariant podstawowy i promocyjny), gdzie wgrać plik CSV i jak bezpiecznie korzystać z danych dostępowych.

Pobierz przykładowy plik CSV Dane FTP

1. Cel dokumentu

Instrukcja opisuje zasady przekazywania bieżących ofert (ceny, stany, promocje) do ekosystemu Promotee poprzez wgrywanie pliku CSV na serwer FTP.

2. Warianty aktualizacji

Wariant podstawowy — ceny regularne i stany

Wymagane kolumny w pliku CSV (UTF-8, separator , lub ;):

Kolumna	Opis	Wymagane
`EAN`	Kod produktu EAN-13	Tak
`Kod_dodatkowy`	Kod własny dostawcy (jeśli używany)	Nie
`Nazwa_produktu`	Pełna nazwa produktu	Tak
`Cena_netto`	Cena jednostkowa netto (szt./kg/opak.)	Tak
`VAT`	Stawka VAT w % (np. 23, 8, 5)	Tak
`Stan`	Aktualny stan magazynowy lub wartość domyślna (np. 9999)	Tak

Wariant promocyjny — ceny zależne od progu ilościowego

W tym wariancie dodajemy kolumny dla ceny promocyjnej i ograniczeń ilościowych:

Kolumna	Opis	Wymagane
`Cena_netto_promo`	Cena netto w promocji	Tak
`Minimalna_ilość`	Minimalna ilość uprawniająca do ceny promocyjnej	Tak
`Wielokrotność`	Wielokrotność zamówienia (np. 10 ⇒ możliwe: 10, 20, 30…). Puste = dowolna ilość ≥ minimalnej.	Nie

3. Zasady przekazywania plików

Dedykowany folder: każdy dostawca ma indywidualny katalog. Wgrywaj pliki wyłącznie do przypisanego folderu danego klienta sieciowego.
Stała nazwa pliku: nowa wersja nadpisuje poprzednią. Nie dodawaj dat/numerów do nazwy.
Format CSV: kodowanie UTF-8, separator , lub ;. Bez arkuszowych formuł/makr.
Częstotliwość: rekomendacja – min. 1× dziennie, częściej przy dynamicznych zmianach.

Tip: przed pierwszym uploadem pobierz i uzupełnij przykładowy CSV (przycisk u góry strony), aby uniknąć błędów formatów/kolumn.

4. Struktura folderów i przypisanie ofert

Każdy Dostawca posiada na serwerze swój główny katalog, odpowiadający nazwie jego firmy (np. SPECJAL, FOODTRADE, MAKPOL). Wewnątrz tego katalogu znajdują się podfoldery odpowiadające poszczególnym sieciom detalicznym lub klientom, z którymi Dostawca współpracuje.

Przykład struktury katalogów:

/home/pricevendorb2bpl/www/
├── SPECJAL/
│   ├── CHATA_POLSKA/
│   │   └── cennik.csv
│   ├── WITAJ/
│   │   └── cennik.csv
│   └── MOKPOL/
│       └── cennik.csv

Dostawca ma jedno konto FTP (np. pricevendorb2bpl_NAZWAVENDORA).
Każda sieć detaliczna (np. Chata Polska, Witaj, Pokusa) ma w tym koncie swój dedykowany folder.
Dostawca wgrywa do odpowiedniego folderu plik cennika w formacie CSV, przeznaczony tylko dla tej konkretnej sieci.

Uwaga: Jeśli Dostawca obsługuje kilka sieci na rożnych cennikach, musi wgrywać oddzielny plik do każdego z przypisanych folderów.

5. Dane dostępowe do FTP

Dane przykładowe — każdy dostawca otrzymuje indywidualny login i folder, w którym zamiast NAZWA_VENDORA widnieje jego identyfikator.

Host

decloud2130.zahid.host

Port

30301

Użytkownik

pricevendorb2bpl_NAZWA_VENDORA

Hasło

Przesyłane osobno (bezpieczeństwo)

Ścieżka katalogu

/home/pricevendorb2bpl/www/NAZWA_VENDORA

Bezpieczeństwo: dane logowania są poufne. Nie udostępniaj ich dalej. Zmieniaj hasło w razie podejrzenia naruszenia.

6. Szybka checklista przed wgraniem

Kolumny i ich nazwy zgodne z tabelą (wariant podstawowy/promocyjny).
Kodowanie pliku: UTF-8; brak makr i formuł.
Stała nazwa pliku (nadpisywanie poprzedniej wersji).
Wgrywasz do właściwego katalogu klienta sieciowego.

7. Kontakt techniczny

Zespół Promotee – wsparcie dla Dostawców
biuro@promotee.pl