2014 V5 1 CSV przesylanie produktow

Dokumentacja techniczna
Interfejs CSV – przesyłanie produktów DHL PARCEL
ALL YOU NEED
Stan z dnia: 16 czerwca 2014; V5.1
portal.ayn.pl
Spis treści
1
Wstęp ................................................................................................................................3
1.1
Wymagany dostęp .....................................................................................................3
2
Podstawy merytoryczne i przegląd interfejsu....................................................................4
3
Oferty produktów Sprzedającego......................................................................................5
3.1
Opis merytoryczny .....................................................................................................5
3.2
Budowa pliku..............................................................................................................7
3.3
Informacja zwrotna w pliku raportu ..........................................................................12
4
Odbieranie CSV-Feed.....................................................................................................13
5
Produkty z wariantami.....................................................................................................16
5.1
Opis merytoryczny ...................................................................................................16
5.2
Tworzenie wariantów ...............................................................................................16
5.2.1
Identyfikacja konfiguracji wariantów .............................................................................. 17
5.2.2
Definiowanie grupy wariantów....................................................................................... 17
5.2.3
Dodawanie produktów do grupy wariantów................................................................... 18
5.3
Informacja zwrotna...................................................................................................18
5.4
Usuwanie wariantu...................................................................................................19
6
Usuwanie produktów.......................................................................................................20
7
Optymalizacja cen – getBestPrice via CSV ....................................................................21
8
Kontakt ............................................................................................................................22
Załącznik A.............................................................................................................................23
portal.ayn.pl
1
Wstęp
Witamy na All You Need, w Pasażu Handlowym do zakupów on-line firmy wspieranym przez
DHL. Niniejszy dokument ma służyć pomocą podczas oferowania produktów do sprzedaży w
Pasażu Handlowym ew. przy projektowaniu własnego sklepu online. Zawiera on
merytoryczny i techniczny opis interfejsu CSV.
Przez ten interfejs możesz w Pasażu Handlowym i w sklepie Sprzedającego oferować
produkty, aktualizować je, ustawiać offline i w razie potrzeby usuwać je. Tym samym każdy
Sprzedający może rozszerzać swoją ofertę produktową i utrzymywać ją w aktualnym stanie.
W przypadku plików CSV musi być stosowane kodowanie UTF-8
Ważne:
Aby zagwarantować, że Klient końcowy odniesie pozytywne wrażenie i przekonanie o
najwyższej jakości All You Need, proszę przestrzegać poniższych kryteriów jakości i
informacji:

Przyporządkowanie do kategorii
Proszę zawsze przyporządkowywać swoje artykuły do najniższej płaszczyzny drzewa
kategorii. Postępuj uważnie i zapewnij właściwe przyporządkowanie (Mapping).

Prezentacja zdjęć produktów
Prezentacja Twoich zdjęć produktów może mieć przesunięcie do 24 godzin po wysłaniu
na serwer. W tym czasie Twoje zdjęcia produktów będą w tle opracowywane dla portalu.
Jeżeli nie będziesz przestrzegać wymienionych punktów, All You Need zastrzega
sobie prawo do dezaktywacji Twojego konta do momentu właściwego ustawienia
Twoich produktów!
1.1
Wymagany dostęp
Aby korzystać z interfejsu, musisz potwierdzić swoją autentyczność wobec All You Need.
Do tego celu potrzebne są


‘Username’ (nazwa użytkownika)
‘Password’ (hasło)
Wysyłanie pliku CSV jest możliwe po zarejestrowaniu się na koncie Sprzedającego.
portal.ayn.pl
2 Podstawy merytoryczne i przegląd interfejsu
All You Need jest podzielony na dwa zakresy. Centralnym zakresem jest pasaż handlowy do
zakupów online, zwany dalej pasażem handlowym. Drugi zakres składa się ze sklepów
„Shop in Shop“ poszczególnych podłączonych Sprzedających. Każdy produkt, który
ustawiasz jako Sprzedający, będzie pokazywany zarówno w Pasażu Handlowym jak i w
Twoim sklepie Shop in Shop.
portal.ayn.pl
3 Oferty produktów Sprzedającego
3.1
Opis merytoryczny
Każdy Sprzedający może oferować dowolnie dużą liczbę produktów, do tego celu wystarczy
jedynie wpisać swoje specyficzne informacje handlowe do tych produktów. Aby Ci ułatwić
ustawianie produktów, All You Need udostępnia bezpłatnie ponad 7 milionów ich opisów.
Oprócz tego, oprócz kodu EAN lub MeinPaketId, muszą być zawarte w tym pliku minimalne
informacje: cena, dostępność (ilość sztuk), VAT i termin dostawy. Wszystkie pozostałe
informacje są opcjonalne. Jeżeli chcesz oferować artykuł, dla którego All You Need nie może
Ci udostępnić żadnych danych produktu, musisz dodatkowo podać nazwę produktu oraz
krótki opis.
W przypadku pewnego asortymentu sensowne jest wprowadzanie produktów jako
wariantów. Na przykład T-Shirt w trzech rozmiarach (S, M, L) i dwóch kolorach (niebieski,
czerwony). Przez plik CSV można wysłać produkty z maksymalnie trzema różnymi
atrybutami (w naszym przykładzie rozmiar i kolor). Szczegółowe informacje na ten temat
znajdują się w Rozdziale 0.
Prawidłowo wysłane na serwer dane produktów są tak długo aktywne do sprzedaży w
sklepie Sprzedającego, dopóki spełniony jest jeden z dwóch poniższych warunków:

podana liczba produktów została sprzedana lub ustawiona przez Sprzedającego na 0

dla produktu Sprzedający podał datę zakończenia i ten dzień właśnie nadszedł
Produkt można ustawić offline na koncie Sprzedającego, ale może to także nastąpić przez
wysłanie CSV, w którym produkt wysyła się na serwer z „datą zakończenia“ w przeszłości lub
dostępną liczbą sztuk 0.
Do zmiany lub aktualizacji produktów wysłanych już przez interfejs CSV wystarczy podać te
pola, które chcesz zmienić. Kolumny nie wykorzystane muszą zostać pominięte.
Link do wysyłania produktów znajduje się na koncie Sprzedającego w „Produkty“ 
„Przegląd“:
portal.ayn.pl
Ten link daje możliwość wysłania do sklepu Sprzedającego pliku CSV, który ma budowę
zdefiniowaną w Rozdziale 3.2.
W „przeszukaj“ można określić plik CSV, który ma być wysłany oraz następnie za pomocą
„wyślij“ można go umieścić na koncie Sprzedającego.
Po „wysłaniu“ na serwer plik jest przetwarzany przez nasz system. Gdy tylko plik zostanie
przetworzony, otrzymasz wiadomość mailową z informacją, że pomyślnie zakończono
przetwarzanie pliku. Teraz możesz zalogować się na koncie Sprzedającego i w „Produkty“
pobrać odpowiedź. Ten plik zawiera dla każdego produktu zawartego z pliku „Upload“
[wysłania] potwierdzenie, że produkt został poprawnie wysłany lub zawiera odpowiedni
komunikat o błędzie. Informacje o możliwych komunikatach o błędzie znajdziesz w rozdziale
3.3.
portal.ayn.pl
3.2
Budowa pliku
Poniższa tabela zawiera atrybuty, które można wysłać w postaci pliku CSV oraz krótki opis
treści. Pola, które są bezwzględnie wymagane, mają w kolumnie „Pole obowiązkowe“ „tak“.
Pola, które nie są polami obowiązkowymi, muszą zostać pominięte, ale nie mogą być puste.
Kolejność wypełniania kolumn jest dowolna. Ważne jest tylko to, że pierwsza linia zawiera
nagłówek (np. „productId“). Każda linia (productID, meinPaketId, etc.) tabeli musi w pliku
CSV być oddzielona średnikiem.
Możesz aktualizować takie dane jak dostępność lub cena za pomocą wersji uproszczonej.
Dzięki temu osiągniesz znaczny wzrost wydajności działania i Twoje dane mogą być jeszcze
aktualniejsze. Przykład znajdziesz w pliku mp_example_40_03_offer.csv.
portal.ayn.pl
Atrybut
Typ
Długość
Nazwa
Pole
obowiązkowe
Opis
ID produktu Sprzedającego productID
string
100
tak
Wewnętrzny i unikalny numer artykułu Sprzedającego. Każdy produkt
wymaga numeru artykułu i ten musi być unikalny.
ID produktu MeinPaket.de
meinPaketId
string
100
nie
Unikalny numer artykułu ALL YOU NEED. Może zostać podany, jeżeli jest
znany. Ten ID nadaje ALL YOU NEED.
ID produktu standardowy
ean
string
13
nie
„European Article Number“, EAN produktu.
Dla książek ISBN-13
Nazwa produktu
name
string
100
tak****
Nazwa produktu
Krótki opis produktu
shortDescription string
200
tak****
Krótki opis produktu
Długi opis produktu
longDescription
string
4000
nie
Szczegółowy opis produktu
Zdjęcie1
image1Url
image
512
nie
Odsyłacz w postaci URL do serwera Sprzedającego do wysłania zdjęcia.
Maksymalna wielkość 2MB
Zdjęcie Tekst1
Image2Caption
string
100
nie
Opis do zdjęcia1
Zdjęcie2
Image2Url
image
512
nie
Odsyłacz w postaci URL do serwera Sprzedającego do wysłania zdjęcia.
Maksymalna wielkość 2MB
Zdjęcie Tekst2
Image2Caption
string
100
nie
Opis do zdjęcia2
Zdjęcie3*****
Image3Url
image
512
nie
Odsyłacz w postaci URL do serwera Sprzedającego do wysłania zdjęcia.
Maksymalna wielkość 2MB
Zdjęcie Tekst3*****
Image3Caption
string
100
nie
Opis do zdjęcia3
Kategoria w Pasażu
Handlowym
marketplaceCat string
egory
100
tak
Kategoria produktu w Pasażu Handlowym**
Kategoria w sklepie
Sprzedającego
shopCategory
string
100
nie
Kategoria produktu we własnym sklepie Sprzedającego***
Cena sprzedaży
price
double
tak
Cena jednostkowa włącznie z ustawowym VAT z maksymalnie dwoma
miejscami po przecinku.
Dostępność
availability
integer
tak
dostępna liczba sztuk (liczba bez miejsc po przecinku i większa od 0) dla
tego produktu. Liczba sztuk przy każdej sprzedaży jest automatycznie
portal.ayn.pl
Atrybut
Typ
Długość
Nazwa
Pole
obowiązkowe
Opis
obniżana. Jeżeli liczba sztuk wynosi 0 wtedy produkt jest wyświetlany
jako już niedostępny.
Data początkowa
startDate
dateTime
nie
Data, od kiedy produkt jest dostępny dla zamówień Klienta, tzn. jest
widoczny w Pasażu Handlowym u tego Sprzedającego. Data musi być
wysłana w następującym formacie: YYYY-MM-DDThh:mm:ss *
Data zakończenia
endDate
dateTime
nie
Data, od której produkt nie jest już dostępny, tzn. nie jest ani widoczny,
ani nie można go wybrać i zamówić. Data musi być wysłana w
następującym formacie: YYYY-MM-DDThh:mm:ss *
Termin dostawy
deliverytime
integer
tak
Termin dostawy do Klienta w dniach, termin dostawy musi być większy
niż 1 i mniejszy od 30.
Koszty przesyłki
deliveryCost
double
nie
Informacja na temat specyficznych kosztów przesyłki tego produktu
Stałe koszty przesyłki
fixedCost
boolean
nie
Informacja, czy koszty przesyłki tego produktu zawsze są doliczane w
całości, niezależnie od stopniowego różnicowania kosztów itd.
Wymagane „dispatchType“ BULK_GOODS lub FORWARDING_AGENCY
Rodzaj dostawy
dispatchType
String
nie
Rodzaj dostawy produktu. Możliwe są poniższe wartości:
BULK_GOODS – ładunek przestrzenny
FORWARDING_AGENCY – towar spedycyjny******
BOOK_RATE – Przesyłka książek
CONSIGNMENT_OF_GOODS – Przesyłka towarowa
Cena jednostkowa
unitPrice
double
nie
Cena na każdą jednostkę
Jednostka
unit
string
100
nie
Sztuka = “per_piece”
Kilogram = “per_1kg“
Litr =”per_1l”
Metr sześcienny =”per_1m3”
Metr =“per_1m“
Metr kwadratowy =”per_1m2”
Gram =”per_100g”
Mililitr =”per_100ml”
Nazwa producenta
manufacturerNa string
me
100
nie
Nazwa producenta
portal.ayn.pl
Atrybut
Typ
Długość
Nazwa
Pole
obowiązkowe
Opis
PN producenta
manufacturerPN string
100
nie
PN producenta
Grupa wariantów
variantGroup
string
100
nie
Grupa wariantów
Kod konfiguracji
variantConfig
string
100
tak
Unikalne oznaczenie referencyjne w odniesieniu do istniejącej konfiguracji
MeinPaket.de, np. „Dżinsy“
Fixed Product
useAsFixedProd boolean
uct
nie
Produkt prezentowany jako wynik wyszukiwania
Standardowo = brak wartości, w pozostałych przypadkach wpisać „x“
Atrybut 1 Nazwa
attribute1Name
string
100
nie
Określone cechy produktu jak wymiary, kolory itp.
Atrybut 1 Wartość
attribute1Value
string
100
nie
Wartość atrybutu
Atrybut 1 Jednostka
attribute1Unit
string
100
nie
Jednostka wartości atrybutu
Atrybut 2 Nazwa
attribute2Name
string
100
nie
Określone cechy produktu jak wymiary, kolory itp.
Atrybut 2 Wartość
attribute2Value
string
100
nie
Wartość atrybutu
Atrybut 2 Jednostka
attribute2Unit
string
100
nie
Jednostka wartości atrybutu
Atrybut 3 Nazwa
attribute3Name
string
100
nie
Określone cechy produktu jak wymiary, kolory itp.
Atrybut 3 Wartość
attribute3Value
string
100
nie
Wartość atrybutu
Atrybut 3 Jednostka
attribute3Unit
string
100
nie
Jednostka wartości atrybutu
Usuń
deletion
string
100
nie
W celu usunięcia tego produktu z konta Sprzedającego, kolumnę
wypełnia się „DELETE“ [usuń].
Format dateTime ma następującą specyfikację „YYYY-MM-DDThh:mm:ss“ przy czym: YYYY rok; MM miesiąc; DD dzień; T oznaczenie, że od tego miejsca zaczyna się format czasu; hh godziny; mm minuty; ss sekundy
**
Przegląd kategorii znajdziesz tu http://portal.ayn.pl/wsparcie/pliki-do-pobrania.html
***
W przypadku oznaczenia referencyjnego do kategorii sklepu Sprzedającego należy zwrócić uwagę na to, czy jest ono już utworzone przez XML. Utworzenie przy użyciu CSV jest niemożliwe. Patrz Dokumentacja
techniczna – Wysyłanie danych produktów, Rozdział 4
****
Pole jest wtedy obowiązkowe, jeżeli nie podano kodu EAN ew. w Katalogu MeinPaket nie jest dostępny żaden produkt z podanym kodem EAN
***** Możesz przekazać ponad 3 URL do zdjęć. W tym celu wystarczy jedynie rozszerzyć nazwę kolumny o numer (image4Url, imague5Url itd. i image4Caption, image5Caption, itd…)
****** W przypadku towaru spedycyjnego jest zapytanie o numer telefonu Klienta i później jest on Ci pokazany, aby umożliwić zaplanowanie dostaw
portal.ayn.pl
Przykład: Opis i oferta produktu
Wśród plików z przykładami znajdziesz plik mp_example_40_01_complete_product.csv.
Poniższy obraz pokazuje wynik tego przykładu w Pasażu Handlowym:
Możesz aktualizować takie dane jak dostępność lub cena za pomocą wersji uproszczonej.
Dzięki temu osiągniesz znaczny wzrost wydajności działania i Twoje dane mogą być jeszcze
aktualniejsze. Przykład znajdziesz w pliku mp_example_40_03_offer.csv.
portal.ayn.pl
3.3
Informacja zwrotna w pliku raportu
Po systematycznym przetworzeniu wysłanych produktów otrzymujesz do dyspozycji w
„Produkty“  „Przegląd“ do pobrania plik raportu (reports.csv, patrz Fehler! Verweisquelle
konnte nicht gefunden werden.). Ten plik ma następującą budowę:
Nazwa
ID produktu
Atrybut
productID
Typ
Długo
Pole
ść
obowiązko
we
Opis
string
100
tak
Wewnętrzny i unikalny numer
artykułu Sprzedającego. Każdy
produkt wymaga numeru artykułu
i ten musi być unikalny.
ID
produktu meinPaketId
MeinPaket.de
string
100
tak
Unikalny numer artykułu
ALL YOU NEED
ID
produktu ean
standardowy
string
13
nie
„European Article Number“, EAN
produktu.
Dla książek ISBN-13
Status
status
string
100
tak
Status wysłania danych produktu
„OK“ dla bezbłędnie wysłanych
produktów ew. odpowiedni kod
błędu (patrz Załącznik)
Komunikat o
błędzie
message
string
100
nie
Krótki opis błędu
Sprzedającego
Listę komunikatów o błędzie zawiera Załącznik A.
portal.ayn.pl
4 Odbieranie CSV-Feed
Po kliknięciu na zakładkę ,,Produkty“, najedź myszką na pole w lewym rogu ,,Źródła
pobierania CSV”. W tym miejscu możesz określić adres URL, gdzie przechowywany jest plik
CSV, który systematycznie będzie przez nasz system importowany.
W punkcie "Konfiguracja" masz możliwość wybrania odpowieniej usługi. W polu poniżej
należy wpisać URL razem z protokołem (obsługiwane protokoły to: HTTP, HTTPS, FTP i
SFTP), np.: http://www.youshop.pl/all_you_need.csv lub
ftp://yourshop.de/files/ all_you_need.csv . W kolejnym polu wybierz seperator, którego użyłeś
w CSV. Jeżeli dostęp do Twojego pliku jest możliwy jedynie przy podaniu nazwy użytkownika
i hasła, możesz wpisać odpowiednie dane w określone pola.
W rozwijanym menu "Odstęp pomiędzy aktualizacjami" określasz czas, w którym plik
powinien być regularnie aktualizowany (pierwsza aktualizacja odbywa się bezpośrednio po
skonfigurowaniu).
Menu „Status” służy do włączania lub wyłączania usługi. W przypadku wystąpienia błędów
podczas odbioru, następuje automatyczna próba odebrania pliku jeszcze dwa razy. Jeśli
portal.ayn.pl
nadal będą pojawiać się błędy, usługa zostanie przestawiona w stan "Błąd", o czym
zostaniesz poinformowany drogą mailową.
E-Mail otrzymają tylko te osoby do kontaktów, które ustawiły w „Zarządzanie“ > „Dane
użytkownika“ > „Osoba do kontaktów“ > „usługa“ usługę „Zarządzanie CSV“
Poza tym masz możliwość aktualizacji już umieszczonych produktów za pomocą pliku
porównywarki cen. Tu oferujemy Ci do wyboru różnych dostawców.
Aktualnymi usługodawcami są:
- Idealo
- Google Shopping
Należy tu zauważyć, że nie istnieje standardowy format plików, więc ograniczyliśmy się do
ustalonego formatu. Tutaj wyłącznie pliki są obsługiwane utworzone za pośrednictwem
modułu eksportu dla sklepów XT-commerce (i ich pochodnych osCommerce, xtcModified i
gambio GX2).
W ten sposób nie musisz uaktualniać kilku plików CSV, aby mieć stale aktualne ceny i
dostępność na All You Need. Ponieważ większość portali nie ma jednolitego sposobu
postępowania odnośnie dostępności, nasz system interpretuje poszczególne dane na
podstawie tabeli specyficznej dla każdego odbioru pliku CSV.
Na Idealo rozpoznajemy produkty należące do All You Need na podstawie pola "Numer
artykułu_w_Shop" lub "Model Shop". Dostępność oraz czas dostawy dostosowujemy
zgodnie z poniższą tabelą:
Idealo – czas dostawy
Mapowanie All You Need
Natychmiast, w magazynie, 1 dzień
Dostępność AYN: 5 szt.
Czas dostawy AYN: bez zmian
2 – 6 dni
Dostępność AYN: 3 szt.
Czas dostawy AYN: bez zmian
1 tydzień
Dostępność AYN: 3 szt.
Czas dostawy AYN: 7 dni
2 tygodnie
Dostępność AYN: 3 szt.
Czas dostawy AYN: 14 dni
Na żądanie
Dostępność AYN: 1 szt.
Czas dostawy AYN: bez zmian
Nierozpoznane informacje
Dostępność AYN: 0 szt.
Czas dostawy AYN: bez zmian
portal.ayn.pl
Na Google Shopping produkty należące do All You Need rozpoznawane są na podstawie
pola ,,ID”. Dostępność oraz czas dostawy dostosowujemy zgodnie z poniższą tabelą:
Google – czas dostawy
Mapowanie All You Need
Na magazynie
Dostępność AYN: 5 szt.
Czas dostawy AYN: bez zmian
Dostępne do zamówienia
Dostępność AYN: 3 szt.
Czas dostawy AYN: 7
Brak na magazynie
Dostępność AYN: 0 szt.
Czas dostawy AYN: bez zmian
Zarezerwowane
Dostępność AYN: 0 szt.
Czas dostawy AYN: bez zmian
portal.ayn.pl
5 Produkty z wariantami
5.1
Opis merytoryczny
Warianty produktu są to produkty z identycznym opisem ale w różnych odmianach, np. buty
w różnych rozmiarach, T-Shirty w różnych rozmiarach i różnych kolorach itd. Produkt, który
występuje w różnych wariantach, może być połączony w grupę wariantów. To zapewnia
Klientowi lepszy przegląd i przejrzystość ofert.
5.2
Tworzenie wariantów
Gdy tylko Sprzedający utworzył grupę wariantów, może rozszerzać produkty o warianty jak
opisano to w Rozdziale 3 i wysyłać je do pasażu handlowego. Do zdefiniowania grupy
wariantów i rozszerzenia opisu produktu niezbędne są następujące trzy kroki.
1. Identyfikacja konfiguracji wariantów
2. Definiowanie grupy wariantów
3. Rozszerzenie opisu produktów
portal.ayn.pl
5.2.1
Identyfikacja konfiguracji wariantów
All You Need udostępnia różne konfiguracje dla wariantów. W przypadku tych konfiguracji
chodzi np. o rozmiary i dodatkowe atrybuty jak np. kolory. Te konfiguracje tworzą podstawę
dla grup wariantów i są ustawione domyślnie przez All You Need jak również utworzone w
portalu Sprzedających (http://portal.ayn.pl/wsparcie/pliki-do-pobrania.html).
5.2.2
Definiowanie grupy wariantów
Kupujący może sam zdefiniować grupy wariantów dla swoich własnych produktów. Grupa
wariantów musi odnosić się do konfiguracji ustawionej domyślnie przez All You Need. Po
utworzeniu grupy nie można już zmienić nazwy i konfiguracji wybranej dla tej grupy.
Poniższe dane są niezbędne do tworzenia grup wariantów produktu:
Nazwa
Atrybut
Typ
Długo
Pole
ść
obowiązko
we
Opis
Nazwa grupy
name
string
4000
tak
Nazwa grupy, np. "Levis
Dżinsy 501"
Grupa
wariantów
variantGroup
string
100
tak
Unikalna identyfikacja grupy
wariantów, np. "Levis501"
Kod konfiguracji variantConfig
string
100
tak
Unikalne oznaczenie
referencyjne w odniesieniu do
istniejącej konfiguracji ALL
YOU NEED, np. „Dżinsy“
Sprzedający definiuje grupę wariantów dla swoich produktów (np. Levis Dżinsy 501) i łączy
ją przy tym z domyślną konfiguracją (np. SpodnieRozmiarKolor).
Aby utworzyć grupę wariantów musi zostać nadana unikalna nazwa grupy (np. Levis Dżinsy
501) i kod dla grypy wariantów (variantGroup) (np. Levis501).
Następnie Sprzedający może wysłać produkty z wariantami na All You Need oferować je w
Pasażu Handlowym. Wysłanie produktów odbywa się, jak to opisano w Rozdziale 3 i przy
tym następuje jeszcze uzupełnienie o informacje o wariantach.
Przykład
utworzenia
grupy
mp_example_40_02_VariantGroup.csv.
portal.ayn.pl
wariantów
znajduje
się
pod
5.2.3
Dodawanie produktów do grupy wariantów
Aby dodać produkt do grupy wariantów, w kolumnie produktu i w polu „variantGroup“ musi
być wpisana przypisana grupa (np. Levis501). W pozostałych polach (attribute1Name,
attribute1Value, itd.…) wpisuje się następnie odpowiednie atrybuty konfiguracji (np. Dżinsy).
W tym przykładzie „kolor“ w „attribute1Name“ i „niebieski“ w „attribute1Value“. Jeżeli
konfiguracja All You Need zawiera kilka atrybutów, wtedy muszą one zostać odpowiednio
wypełnione. np. attribute2Name „długość“, attribute2Value „32“ i attribute3Name „szerokość“,
attribute3Value „34“)
Dla grupy wariantów można wybrać na stałe jeden produkt jako produkt prezentowany
(fixedProduct). Podczas wyszukiwania będzie on pokazywany w Pasażu Handlowym. Jeżeli
kilka produktów zdefiniowano jako produkt prezentowany, wtedy zawsze uwzględnia się
ostatnią aktualizację.
Produkt można z kolei usunąć z grupy wariantów. W tym celu produkt musi być wysłany bez
informacji o wariantach.
W poniższym pliku znajdziesz przykład,
mp_example_40_03_product_variant.csv.
5.3
jak
można
tworzyć
warianty
produktu
Informacja zwrotna
Wysłanie na serwer grup wariantów automatycznie powoduje pobranie pliku informacji
zwrotnej . Ten plik ma identyczną budowę jak plik wysłania produktów na serwer (p. Rozdział
3.3), jedynie treść poszczególnych pól jest różna:
Nazwa
Atrybut
ID
produktu productID
Sprzedającego
Typ
Długo
Pole
ść
obowiązko
we
Opis
string
100
tak
Grupa wariantów, np. „Dżinsy“
meinPaketId
string
100
nie
nie stosuje się
ean
string
13
nie
nie stosuje się
Status
status
string
100
tak
Status wysłania danych
produktu
„OK“ dla bezbłędnie wysłanych
produktów ew. odpowiedni kod
błędu (patrz Załącznik)
Komunikat o
błędzie
message
string
100
nie
Krótki opis błędu
Listę komunikatów o błędzie zawiera Załącznik A
portal.ayn.pl
5.4
Usuwanie wariantu
Jeżeli jakiś produkt ma być usunięty z kolei z grupy wariantów, to musi on zostać jeszcze raz
wysłany ze wszystkimi danymi oprócz informacji o wariantach.
Odnośnie korzystania z poszczególnych pól, które są konieczne do tworzenia wariantów
produktów, skorzystaj z przeglądu pól od strony 8.
portal.ayn.pl
6 Usuwanie produktów
Produkty, których dane Sprzedający wysłał na All You Need, można także znowu usunąć.
Jednocześnie są przy tym usuwane oferty tego Sprzedającego na te produkty. W tym celu
musisz wypełnić w swoim pliku CSV pole „deletion“ o wartości „DELETE“ i następnie go
wysłać. Wystarczy, jeżeli ten plik zawiera tylko te produkty, które mają być usunięte. W tym
przypadku istotnymi polami są pola „productId“ i „deletion“. Pozostałe pola mogą być puste.
W
poniższym
pliku
znajdziesz
przykład,
mp_example_40_02_delete_product.csv.
jak
można
usuwać
produkty
Zasadniczo można usunąć wszystkie opisy produktu i oferty produktu. Jeżeli opisy
produktów i oferty produktów odnoszą się do jeszcze nie zakończonego zamówienia
(anulowanego lub nadanego jako przesyłka), wtedy nie mogą one zostać usunięte. Dopiero
po zakończeniu realizacji zamówienia możliwe jest usunięcie odnośnych opisów produktów i
ofert produktów.
Proszę zwrócić uwagę na to, że mogą istnieć zamówienia, nawet jeżeli nie pojawiają się one
na Twoim koncie. Chodzi tu o zamówienia jeszcze nie przetworzone przez All You Need lub
o zamówienia, za które ma być pobrana zapłata z góry.
portal.ayn.pl
7 Optymalizacja cen – getBestPrice via CSV
Dzięki raportom z All You Need masz możliwość polepszenia swoich cen.
Na koncie Sprzedającego znajdziesz w zakładce „usługi“ raporty. Wśród wskaźników jakości
znajdziesz współczynnik Best Price Quote. Za pomocą znajdującego się tu linku „polepsz
ceny“ możesz zażądać pliku CSV, w którym będziesz miał pokazane, które z Twoich
produktów w Pasażu Handlowym sprzedają inni Sprzedający po lepszych cenach.
Poniższe informacje znajdziesz w tym pliku:
Nazwa
Atrybut
Opis
ID
produktu productID
Sprzedającego
Wewnętrzny i unikalny numer artykułu
Sprzedającego.
Każdy produkt wymaga numeru artykułu i ten musi
być unikalny
.
ID
produktu meinPaketId
MeinPaket.de
Unikalny numer artykułu Polka.de. Może zostać
podany, jeżeli jest znany. Ten ID nadaje Polka.de.
Cena sprzedaży
price
Cena jednostkowa włącznie z ustawowym VAT z
maksymalnie dwoma miejscami po przecinku. To jest
najlepsza cena w Pasażu Handlowym
Koszty dostawy
deliveryCost
Koszty dostawy do tej oferty
Posiadacz
Ownership
Tu tylko „foreign“, tzn. w pliku znajdują się tylko
produkty, w przypadku których „obcy“ Sprzedający
mają najkorzystniejszą cenę.
Wszystkie produkty na tej liście są oferowane na All You Need przez innych Sprzedających
po podanej cenie. Ceny podane na tej liście są najkorzystniejszymi dostępnymi cenami na
All You Need (włącznie z kosztami przesyłki).
Teraz możesz wykorzystać bezpośrednio ten plik, aby dopasować ceny danych produktów.
Usuń po prostu ostatnie dwie kolumny „deliveryCost“ i „ownership“ i dopasuj ceny jak chcesz
i ponownie wyślij ten plik na serwer. Ceny zostaną wtedy dopasowane.
Za pomocą Best Price Quote możesz w dalszym ciągu uzyskiwać aktualne informacje o
stanie swoich cen danego dnia.
portal.ayn.pl
8 Kontakt
Czy masz pytania, na które nie było odpowiedzi w tym dokumencie lub sugestie i wskazówki
dla nas? Dalsze informacje i pomoc znajdziesz na naszym portalu Sprzedającego pod:
http://portal.ayn.pl
Do dyspozycji jest także nasz dział wsparcia dla Sprzedającego od poniedziałku do piątku od
godziny 9 do 17.30.
Naszą pomoc uzyskasz pod adresem:
E-Mail: [email protected]
Telefon: +48 42 634 5 310
portal.ayn.pl
Załącznik A
Poniższa lista zawiera możliwe komunikaty o błędzie dla wysyłania na serwer pliku CSV:
Kod błędu
Opis
SERVER_ERROR
Wewnętrzny błąd serwera.
INVALID_DATA
Przesłane dane są nieprawidłowe.
INVALID_MODIFICATION
Wybrana zmiana jest niedopuszczalna. W razie pytań
proszę skontaktować się z zespołem wsparcia ALL YOU
NEED(patrz Informacja zwrotna i wsparcie).
NO_CATEGORIZATION
Produkt nie może zostać wysłany, ponieważ nie można
przyporządkować kategorii.
NO_CLASSIFICATION
Produkt nie może zostać wysłany, ponieważ nie można go
sklasyfikować. Proszę sprawdzić przyporządkowania
PRODUCT_NOT_FOUND
Nie można przyporządkować produktu.
AVAILABILITY_NEGATIVE
Dostępność nie może być mniejsza od zera.
PRODUCT_NOT_SELLABLE
Produktu nie można oferować, musi być udostępniony
opis.
MARKETPLACE_CATEGORY_ Podana kategoria pasażu handlowego jest nieważna.
NOT_FOUND
SHOP_CATEGORY_NOT_FO
UND
portal.ayn.pl
Podana kategoria sklepu jest nieważna.
Historia zmian
Wersja
Data
Zmiana
1.0 to 5.1
2014
Opracowanie dla Polski
portal.ayn.pl