Dokumentacja techniczna Warianty

Dokumentacja techniczna
Warianty
DHL Parcel Europe
All You Need, shopping powered by DHL
Stan z dnia: 01.10.2014 ; v 1.0
portal.ayn.pl
Spis treści
1
Co to są warianty produktu? .............................................................................................3
2
Warianty produktu .............................................................................................................4
3
4
5
2.1
Definiowanie grupy wariantów ..................................................................................5
2.2
Definiowanie konfiguracji wariantów........................................................................5
Przykłady konfiguracji wariantów różnych asortymentów .................................................8
3.1
Market budowlany ....................................................................................................8
3.2
Książki ......................................................................................................................8
3.3
Sprzęt elektroniczny powszechnego użytku .............................................................8
3.4
Filmy .........................................................................................................................9
3.5
Gry ............................................................................................................................9
3.6
Sprzęt AGD ............................................................................................................10
3.7
Artykuły spożywcze ................................................................................................10
3.8
Soczewki kontaktowe .............................................................................................11
Przegląd konfiguracji wariantów „internetowy Pasaż handlowy“.....................................12
4.1
Powszechnie stosowane konfiguracje wariantów...................................................12
4.2
Konfiguracje wariantów dla asortymentów Książka, Film i Gry ..............................13
4.3
Konfiguracje wariantów soczewek kontaktowych ...................................................13
4.4
Konfiguracje wariantów dla asortymentu Moda ......................................................14
Kontakt ............................................................................................................................15
portal.ayn.pl
1 Co to są warianty produktu?
Od zaraz masz możliwość ustawiania na sklep internetowy wariantów produktu. Dzięki temu
zapewniasz swoim Klientom jeszcze lepszy przegląd swoich produktów i umożliwiasz
ukierunkowany zakup specyficznego wariantu. Ten dokument, jako uzupełnienie do
dokumentacji API, wyjaśni Ci trzy proste kroki do wysłania na serwer wariantów produktu.
Dodatkowo podajemy obrazowe przykłady stosowania udostępnionych konfiguracji
wariantów dla Twoich różnych rodzajów asortymentu. W załączniku znajdziesz przejrzyste
zestawienie wszystkich konfiguracji wariantów na sklep internetowy.
Warianty produktu istnieją wtedy, gdy jeden i ten sam produkt istnieje w różnych odmianach.
Na przykład T-Shirt, który jest dostępny w różnych rozmiarach (S, M, L, XL) i kolorach (biały,
czarny, czerwony). Podczas zakupu Klient musi zdecydować się na konkretny wariant
produktu.
portal.ayn.pl
2 Warianty produktu
Aby ustawić produkt w różnych wariantach na „internetowy Pasaż handlowy“, należy
przeprowadzić następujące trzy etapy:
1.
Identyfikacja konfiguracji wariantów
Konfiguracja wariantów określa cechy, którymi różnią się warianty produktu.
„internetowy Pasaż handlowy“ udostępnia dla różnych zakresów asortymentów
wstępnie zdefiniowane konfiguracje wariantów, aby ujednolicić tworzenie wariantów w
pasażu handlowym. „internetowy Pasaż handlowy“ definiuje z reguły wartości
domyślne atrybutów. Jednakże w określonych przypadkach wartości wariantów nie są
podane
przez
„internetowy
Pasaż
handlowy“
jako
obligatoryjne.
I tak, Sprzedający mogą przykładowo określić atrybut "Kolor" po prostu
wprowadzeniem opcji bez tekstu. Inne wartości są, zależnie od naszej definicji, albo
wartościami tekstowymi albo liczbowymi. Teraz proszę określić, jakie konfiguracje
wariantów pasują do Twojego produktu.
2. Definiowanie grupy wariantów
Grupa wariantów odzwierciedla wszystkie warianty produktu dostępne w pasażu
handlowym. Po określeniu w etapie 1, jakie konfiguracje wariantów pasują do
Twojego produktu, proszę teraz utworzyć grupę wariantów.
Przykład: Chcesz oferować produkt "Koszula Boss z nadrukiem XY" w różnych
rozmiarach. W etapie 1 określiłeś w tym celu konfigurację udostępnioną przez
„internetowy Pasaż handlowy“ (w przykładzie "Ubranie z USA"). Teraz proszę
utworzyć dla produktu odpowiednią grupę wariantów przydzielić jej unikalny kod do
własnego użytku (np. "Koszula Boss 001") i nazwę jako opis grupy produktów (np.
"Koszula Boss z nadrukiem XY"). Uwaga: Nazwa, którą nadajesz grupie produktów,
pojawia się na liście wyników wyszukiwania – jako przedstawiciel konkretnych
pojedynczych
artykułów
danej
grupy
produktów.
3. Wysyłanie wariantów
Teraz możesz ustawiać i oferować w pasażu handlowym warianty produktu tak jak
zwykłe produkty, przy czym tylko grupa wariantów utworzona przez Ciebie w etapie 2
musi mieć odniesienie i muszą zostać podane atrybuty wariantów.
Poniższy diagram obrazuje wysyłanie danych wariantów produktu na „internetowy
Pasaż handlowy“ jeszcze raz:
portal.ayn.pl
2.1
Definiowanie grupy wariantów
Poniższe dane są niezbędne do tworzenia grup wariantów produktu. Tabela zawiera
atrybuty, które korespondują z opisem technicznym w następnym rozdziale i każdorazowo
krótki opis zawartości.
Grupa wariantów
Długość
Pole
obowiązkowe
string
100
tak
Unikalna identyfikacja grupy
wariantów, np. "Levis501"
Kod konfiguracji configuration
string
100
tak
Unikalny
nr
referencyjny
istniejącej konfiguracji
Tytuł grupy
string
4000
nie
Tytuł grupy, np. "Levis Jeans
501"
Nazwa
Grupa
wariantów
2.2
Atrybut
code
title
Typ
Opis
Definiowanie konfiguracji wariantów
Poniższe dane są niezbędne do opisu produktu z wariantami. Chodzi tu o opis. rozszerzony
o grupę wariantów. Tabela zawiera wartości, które korespondują z opisem technicznym w
następnym rozdziale i każdorazowo krótki opis zawartości.
portal.ayn.pl
Nazwa
Atrybut
Typ
Długość
Pole
obowiązkowe
Opis
ID produktu
Sprzedającego
productId
string 100
tak
Wewnętrzny i unikalny numer artykułu Sprzedającego
Pasaż
handlowy ID
produktu
meinPaketId
string 100
nie
Unikalny numer artykułu „internetowy Pasaż handlowy“
European
article number
ean
string 13
nie
„European Article Number“, EAN produktu; w przypadku
książek ISBN-13
Producent
manufacturerName
string 100
nie
Nazwa producenta*
Numer artykułu
manufacturerPN
producenta
string 100
nie
Numer artykułu producenta
Grupa
wariantów
string 100
nie
Grupa wariantów
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ęcie
image
imag
e
512
nie
URL do zdjęcia
wielkość 2 MB
Kategoria w
pasażu
handlowym
marketplaceCategorie string 100
tak
Kategoria produktu w pasażu handlowym
Kategoria w
sklepie
Sprzedającego
shopCategorie
string 100
nie
Kategoria produktu we własnym sklepie Sprzedającego
Kod atrybutu
code
string 100
tak
Unikalny ID atrybutu. Ten kod identyfikuje dla każdego
portal.ayn.pl
variantGroupCode
produktu
Sprzedającego.
Maksymalna
Nazwa
Atrybut
Typ
Długość
Pole
obowiązkowe
Opis
Sprzedającego każdy atrybut
**Nazwa
atrybutu
name
string 100
nie
Określone cechy produktu jak wymiary, kolory itp.
**Wartość
atrybutu
value
string 100
nie
Wartość atrybutu
**Jednostka
atrybutu
unit
string 100
nie
Jednostka wartości atrybutu
* Jeżeli chcesz podać numer artykułu producenta, wtedy wymagane jest także podanie nazwy producenta.
**Mogą to być zarówno atrybuty wariantów jak i dodatkowe atrybuty produktu.
*** Jeżeli ten identyfikator jest wysyłany dla więcej niż jednego produktu danej grupy wariantów, wtedy jest on zawsze nadpisywany.
portal.ayn.pl
3 Przykłady konfiguracji wariantów różnych asortymentów
3.1 Market budowlany
Przykład: Sprzedajesz "gwoździe z łbem
3,8 x 100 mm, 4,2 x 120 mm i 4,6 x 130 mm
wpuszczanym”
w
trzech
wymiarach:
Postępujesz w następujący sposób:
Wybierasz z przeglądu udostępnionych przez nas konfiguracji wariantów konfigurację
"Wymiary". Tu możesz wpisać w polu tekstowym swoje wymiary, np. właśnie "3,8 x 100".
Nazwą Twojej grupy wariantów powinna być po prostu nazwa produktu: "Gwoździe z łbem
wpuszczanym", bez dopisków wymiarów poszczególnych artykułów.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Wymiar
3,8 x 100
4,2 x 120
4,6 x 130
Jedn.:
mm
mm
mm
Wymiar
3.2 Książki
Przykład: Prowadzisz księgarnię i sprzedajesz książkę Johna R. R. Tolkiena "Władca
Pierścieni" w różnych formatach: jako wydanie zszywane, jako wydanie kieszonkowe i jako
audiobook na CD.
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji wariantów konfigurację "Format książki". "Format książki" podaje Ci wartości
atrybutu, z których po prostu wybierasz właściwą. Nazwą Twojej grupy wariantów powinna
być prosta nazwa produktu: "Władca Pierścieni", bez dodatkowych danych poszczególnych
wydań.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Format książki
Format
wydanie
zszywane
wydanie
kieszonkowe
audiobook
CD
na
3.3 Sprzęt elektroniczny powszechnego użytku
Przykład: Prowadzisz sklep ze sprzętem elektronicznym i sprzedajesz "Apple iPod Nano" w
różnych kolorach i z pamięcią o różnej wielkości.
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji wariantów podwójną konfigurację "Kolor-Wielkość". "Kolor" wpisujesz w wolnym
polu tekstowym, np. "czarny".
portal.ayn.pl
"Wielkość" pamięci podajesz jako liczbę i możesz dodatkowo z podanych jednostek wybrać
"GB", co oznacza gigabajty. Z tego wynika dla parametru "Wielkość", np. dana: 16 GB
Nazwą Twojej grupy wariantów powinna być po prostu nazwa produktu: "Apple iPod Nano",
bez dopisków jak kolor lub pamięć poszczególnych artykułów.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Kolor
Kolor
czarny
niebieski
srebrny
Format
8
16
16
Jedn.
GB
GB
GB
Wielkość
3.4 Filmy
Przykład: Oferujesz film "Alicja w Krainie Czarów" w różnych formatach, jako "DVD", "Bluray" i "Blu-ray 3D".
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji wariantów konfigurację "Format filmu". "Format filmu" podaje Ci wartości
atrybutu, z których po prostu wybierasz właściwą. Nazwą Twojej grupy wariantów powinna
być prosta nazwa produktu: "Alicja w Krainie Czarów”, bez dodatkowych danych
poszczególnych wydań.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Format filmu
Format
DVD
Blu-ray
Blu-ray 3D
3.5 Gry
Przykład: Oferujesz grę "FIFA 12" w różnych formatach: na PC, Playstation 3 i Wii.
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji wariantów konfigurację "Platforma gry". "Platforma gry" podaje Ci wartości
atrybutu, z których po prostu wybierasz właściwą. Nazwą grupy wariantów powinna być
prosta nazwa produktu: "FIFA12", bez dodatkowych danych poszczególnych artykułów.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Platforma gier
Platforma
PC
Playstation 3
Wii
portal.ayn.pl
3.6 Sprzęt AGD
Przykład: Oferujesz "Kawiarkę Bodum Chambord" w dwóch kolorach "srebrnym" i "czarnym"
i w trzech wielkościach 0,35 l, 1 l i 1,5 l.
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji wariantów podwójną konfigurację "Kolor-Wielkość". "Kolor" wpisujesz w wolnym
polu tekstowym, np. "czarny". "Wielkość", w tym przypadku daną w litrach, podajesz jako
liczbę i możesz dodatkowo wybrać jednostkę np. "l" dla litra. Z tego wynika dla parametru
"Wielkość", np. dana: "1,5 l". Nazwą grupy wariantów powinna być prosta nazwa produktu,
bez dopisków jak dane o kolorze lub pojemności poszczególnych artykułów.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Kolor
Kolor
czarny
srebrny
srebrny
Format
0.35
1.0
1.5
Jedn.
l
l
l
Wielkość
3.7 Artykuły spożywcze
Przykład: Prowadzisz sklep z artykułami spożywczymi i oferujesz "Steki T-bone" w różnych
ilościach: 2, 3 lub 5 sztuk.
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji
wariantów
podwójną
konfigurację
"Wielkość".
"Wielkość" to w tym przypadku "ilość sztuk", podaj liczbę i wybierz jedną jednostkę
dowolnego wyboru, jak np. szt. Z tego wynika dla parametru "Wielkość", np. dana "5 szt.".
Nazwą Twojej grupy wariantów powinna być po prostu nazwa produktu: "Steki T-bone", bez
dopisków jak ilość, które charakteryzują poszczególne artykuły.
Konfiguracja
wariantów
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Wielkość
2
3
5
Jedn.
Szt.
Szt.
Szt.
Wielkość
portal.ayn.pl
3.8 Soczewki kontaktowe
Przykład: Oferujesz soczewki kontaktowe o promieniu krzywizny 8,6 mm, o mocy -6,50, 6,00 i -5,50 dioptrii i średnicy 14,2 mm.
Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas
konfiguracji wariantów "Soczewki kontaktowe". Atrybuty "Promień krzywizny", "Moc" i
"Średnica" można podać wraz z pasującymi jednostkami: mm dla "Promienia krzywizny",
dioptrie dla "Mocy" i mm dla "Średnicy".
Nazwą Twojej grupy wariantów powinna być po prostu nazwa produktu: "soczewki
kontaktowe Richter 30 AS UV", bez dopisków, które charakteryzują poszczególne artykuły.
Konfiguracja
wariantów
Soczewki
kontaktowe
portal.ayn.pl
Atrybut
Wartość
atrybutu 1
Wartość
atrybutu 2
Wartość
atrybutu 3
Promień
krzywizny
8.6
8.6
8.6
Jedn.
mm
mm
mm
Moc
-6.50
-6.00
-5.50
Jedn.
dpt
dpt
dpt
Średnica
14.2
14.2
14.2
Jedn.
mm
mm
mm
4 Przegląd konfiguracji wariantów „internetowy Pasaż
handlowy“
4.1 Powszechnie stosowane konfiguracje wariantów
Konfiguracja
Atrybut
Typ
Wstępnie
zdefiniowane
wartości
Jednostki opcjonalne
Kolor
Kolor
Tekst
-
ml, l, g, kg, mm, cm, m,
m2, m3, MB, GB,TB,
megapiksele, cale, szt.,
W
Wielkość
Wielkość
Liczba
-
Wymiar
Wymiar
Tekst
-
Kolor
Tekst
-
-
Kolor-Wielkość
Kolor-Wymiar
Styl
Materiał-Wymiar
Materiał-Wielkość
Model
portal.ayn.pl
cm,
Wielkość
Liczba
-
ml, l, g, kg, mm, cm, m,
m2, m3, MB, GB,TB,
megapiksele, cale, szt.,
W
Kolor
Tekst
-
-
Wymiar
Tekst
-
mm, cm, m
Styl
Tekst
-
-
Styl
Tekst
-
-
Wielkość
Liczba
-
ml, l, g, kg, szt., cl, dl
Materiał
Tekst
-
-
Materiał
Tekst
-
-
Wymiar
Tekst
-
Materiał
Tekst
-
-
Styl-Wielkość
Materiał
mm,
mm,
cm,
Wielkość
Liczba
-
ml, l, g, kg, mm, cm, m,
m2, m3, MB, GB,TB,
megapiksele, cale, szt.,
W
Model
Tekst
-
-
m
m
4.2 Konfiguracje wariantów dla asortymentów Książka, Film i Gry
Konfiguracja
Format książki
Format filmu
Platforma gier
Wstępnie
zdefiniowane
wartości
Jednostki opcjonalne
Atrybut
Typ
Format
wydanie zszywane
wydanie kieszonkowe,
Tekst broszura,
audiobook CD
kaseta audio
Format
DVD
Blu-ray,
Blu-ray 3D,
Tekst Blu-ray + DVD,
DVD + CD,
HD-DVD,
UMD wideo
-
Platforma
PC
Mac,
PlayStation,
PlayStation 2,
PlayStation 3,
PlayStation Portable,
Wii,
Xbox,
Xbox 360,
Tekst
Nintendo 3DS,
Nintendo DS,
Game Boy,
Game Boy Advance,
Game Cube,
Nintendo 64,
N-Gage,
Sega Dreamcast,
Sega Saturn
-
4.3 Konfiguracje wariantów soczewek kontaktowych
Konfiguracja
Soczewki
kontaktowe
portal.ayn.pl
Wstępnie
zdefiniowane
wartości
Atrybut
Typ
Jednostki opcjonalne
Promień
krzywizny
Liczba -
mm
Moc
Liczba -
dpt
Średnica
Liczba -
mm
4.4 Konfiguracje wariantów dla asortymentu Moda
Konfiguracja
Ubrania z UE
Atrybut
Typ
Kolor
Tekst -
-
Rozmiar
Liczb
a
-
Kolor
Tekst -
-
Rozmiar
XXS, XS, S, M, L, XL,
Tekst XXL, XXXL, 4XL, 5XL, 6XL, 7XL
Kolor
Tekst -
Ubrania z USA
Skarpety
Rozmiar
portal.ayn.pl
Jednostki opcjonalne
-
15-18,
19-22,
Tekst 31-34,
43-46,
19-22,
23-26,
35-38,
47-48,
23-26,
27-30,
39-42, 48-50
Kolor
Tekst -
Długość
Liczb 28, 30, 32, 34, 36, 38,
a
40, 42
Szerokość
24,
30,
36,
Liczb
42,
a
48,
54,
60
Kolor
Tekst -
Obwód
biustu
45, 50, 55, 60, 65, 70,
75, 80, 85, 90, 95,
Liczb
100, 105, 110, 115, a
120, 125, 130, 135,
140, 145, 150
Miseczka
Tekst
Jeans
Biustonosze
Wstępnie
zdefiniowane
wartości
-
25,
31,
37,
43,
49,
55,
26,
32,
38,
44,
50,
56,
27,
33,
39,
45,
51,
57,
28,
34,
40,
46,
52,
58,
29,
35,
41,
47, 53,
59,
-
AA, A, B, C, D, DD, E,
EE, F, FF, G, GG, H
5 Kontakt
Czy masz pytania, na które nie było odpowiedzi w tym dokumencie lub sugestie albo
wskazówki dla nas? Dalsze informacje i pomoc znajdziesz na naszym portalu Sprzedających
pod:
DHL Express (Poland) Sp. z o.o., ul. Osmańska 2, 02-823 Warszawa
E-mail:
Telefon:
Online:
portal.ayn.pl
[email protected]
+48 42 6 345 310 (Pn - Pt od 9 do 17:30)
http://portal.ayn.pl
Historia zmian
Wersja
Data
Zmiana
1.0
2.0
2014-06-25
2014-10-01
Opracowanie dla Polski
new Layout
portal.ayn.pl