Dokumentacja techniczna Warianty DHL Parcel Europe All You Need, shopping powered by DHL Stan z dnia: 01.10.2014 ; v 1.0
Spis treści 1 Co to są warianty produktu?...3 2 Warianty produktu...4 2.1 Definiowanie grupy...5 2.2 Definiowanie konfiguracji...5 3 Przykłady konfiguracji 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 4 Przegląd konfiguracji internetowy Pasaż handlowy...12 4.1 Powszechnie stosowane konfiguracje...12 4.2 Konfiguracje dla asortymentów Książka, Film i Gry...13 4.3 Konfiguracje soczewek kontaktowych...13 4.4 Konfiguracje dla asortymentu Moda...14 5 Kontakt...15
1 Co to są warianty produktu? Od zaraz masz możliwość ustawiania na sklep internetowy 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 produktu. Dodatkowo podajemy obrazowe przykłady stosowania udostępnionych konfiguracji dla Twoich różnych rodzajów asortymentu. W załączniku znajdziesz przejrzyste zestawienie wszystkich konfiguracji na sklep internetowy. Warianty produktu istnieją wtedy, gdy jeden i ten sam produkt istnieje w różnych odmianach. Na przykład TShirt, 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.
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 Konfiguracja 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, aby ujednolicić tworzenie 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 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 pasują do Twojego produktu. 2. Definiowanie grupy Grupa odzwierciedla wszystkie warianty produktu dostępne w pasażu handlowym. Po określeniu w etapie 1, jakie konfiguracje pasują do Twojego produktu, proszę teraz utworzyć grupę. 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ę 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 Teraz możesz ustawiać i oferować w pasażu handlowym warianty produktu tak jak zwykłe produkty, przy czym tylko grupa utworzona przez Ciebie w etapie 2 musi mieć odniesienie i muszą zostać podane atrybuty. Poniższy diagram obrazuje wysyłanie danych produktu na internetowy Pasaż handlowy jeszcze raz:
2.1 Definiowanie grupy Poniższe dane są niezbędne do tworzenia grup produktu. Tabela zawiera atrybuty, które korespondują z opisem technicznym w następnym rozdziale i każdorazowo krótki opis zawartości. Grupa Nazwa Atrybut Typ Długość Grupa code string 100 tak Kod konfiguracji configuration string 100 tak Tytuł grupy title string 4000 nie Pole obowiązkowe Opis Unikalna identyfikacja grupy, np. "Levis501" Unikalny nr referencyjny istniejącej konfiguracji Tytuł grupy, np. "Levis Jeans 501" 2.2 Definiowanie konfiguracji Poniższe dane są niezbędne do opisu produktu z wariantami. Chodzi tu o opis. rozszerzony o grupę. Tabela zawiera wartości, które korespondują z opisem technicznym w następnym rozdziale i każdorazowo krótki opis zawartości.
Nazwa Atrybut Typ Długość ID produktu Sprzedającego Pasaż handlowy ID produktu European article number Pole obowiązkowe productid string 100 tak Wewnętrzny i unikalny numer artykułu Sprzedającego meinpaketid string 100 nie Unikalny numer artykułu internetowy Pasaż handlowy ean string 13 nie Producent manufacturername string 100 nie Nazwa producenta* Numer artykułu producenta Grupa manufacturerpn string 100 nie Numer artykułu producenta variantgroupcode string 100 nie Grupa Nazwa produktu name string 100 tak Nazwa produktu Krótki opis produktu Długi opis produktu Zdjęcie Kategoria w pasażu handlowym Kategoria w sklepie Sprzedającego shortdescription string 200 tak Krótki opis produktu longdescription string 4000 nie Szczegółowy opis produktu image imag e 512 nie Opis European Article Number, EAN produktu; w przypadku książek ISBN13 URL do zdjęcia produktu Sprzedającego. Maksymalna wielkość 2 MB marketplacecategorie string 100 tak Kategoria produktu w pasażu handlowym 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
Nazwa Atrybut Typ Długość Pole obowiązkowe Sprzedającego każdy atrybut **Nazwa atrybutu name string 100 nie Określone cechy produktu jak wymiary, kolory itp. Opis ** atrybutu **Jednostka atrybutu value string 100 nie 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 jak i dodatkowe atrybuty produktu. *** Jeżeli ten identyfikator jest wysyłany dla więcej niż jednego produktu danej grupy, wtedy jest on zawsze nadpisywany.
3 Przykłady konfiguracji różnych asortymentów 3.1 Market budowlany Przykład: Sprzedajesz "gwoździe z łbem wpuszczanym w trzech wymiarach: 3,8 x 100 mm, 4,2 x 120 mm i 4,6 x 130 mm Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas konfiguracji konfigurację "Wymiary". Tu możesz wpisać w polu tekstowym swoje wymiary, np. właśnie "3,8 x 100". Nazwą Twojej grupy powinna być po prostu nazwa produktu: "Gwoździe z łbem wpuszczanym", bez dopisków wymiarów poszczególnych artykułów. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Wymiar Wymiar 3,8 x 100 4,2 x 120 4,6 x 130 Jedn.: mm mm mm 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 konfigurację "Format książki". "Format książki" podaje Ci wartości atrybutu, z których po prostu wybierasz właściwą. Nazwą Twojej grupy powinna być prosta nazwa produktu: "Władca Pierścieni", bez dodatkowych danych poszczególnych wydań. Konfiguracja Atrybut atrybutu 1 atrybutu 2 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 podwójną konfigurację "KolorWielkość". "Kolor" wpisujesz w wolnym polu tekstowym, np. "czarny".
"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 powinna być po prostu nazwa produktu: "Apple ipod Nano", bez dopisków jak kolor lub pamięć poszczególnych artykułów. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Kolor Kolor czarny niebieski srebrny Wielkość Format 8 16 16 Jedn. GB GB GB 3.4 Filmy Przykład: Oferujesz film "Alicja w Krainie Czarów" w różnych formatach, jako "DVD", "Bluray" i "Bluray 3D". Postępujesz w następujący sposób: Wybierasz z przeglądu udostępnionych przez nas konfiguracji konfigurację "Format filmu". "Format filmu" podaje Ci wartości atrybutu, z których po prostu wybierasz właściwą. Nazwą Twojej grupy powinna być prosta nazwa produktu: "Alicja w Krainie Czarów, bez dodatkowych danych poszczególnych wydań. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Format filmu Format DVD Bluray Bluray 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 konfigurację "Platforma gry". "Platforma gry" podaje Ci wartości atrybutu, z których po prostu wybierasz właściwą. Nazwą grupy powinna być prosta nazwa produktu: "FIFA12", bez dodatkowych danych poszczególnych artykułów. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Platforma gier Platforma PC Playstation 3 Wii
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 podwójną konfigurację "KolorWielkość". "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 powinna być prosta nazwa produktu, bez dopisków jak dane o kolorze lub pojemności poszczególnych artykułów. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Kolor Kolor czarny srebrny srebrny Wielkość Format 0.35 1.0 1.5 Jedn. l l l 3.7 Artykuły spożywcze Przykład: Prowadzisz sklep z artykułami spożywczymi i oferujesz "Steki Tbone" 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 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 powinna być po prostu nazwa produktu: "Steki Tbone", bez dopisków jak ilość, które charakteryzują poszczególne artykuły. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Wielkość Wielkość 2 3 5 Jedn. Szt. Szt. Szt.
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 "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 powinna być po prostu nazwa produktu: "soczewki kontaktowe Richter 30 AS UV", bez dopisków, które charakteryzują poszczególne artykuły. Konfiguracja Atrybut atrybutu 1 atrybutu 2 atrybutu 3 Promień krzywizny 8.6 8.6 8.6 Jedn. mm mm mm Soczewki kontaktowe 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 internetowy Pasaż handlowy 4.1 Powszechnie stosowane konfiguracje Konfiguracja Atrybut Typ Wstępnie zdefiniowane wartości Kolor Kolor Tekst Wielkość Wielkość Liczba Wymiar Wymiar Tekst KolorWielkość KolorWymiar Kolor Tekst Wielkość Liczba Kolor Tekst Wymiar Tekst mm, cm, m Styl Styl Tekst StylWielkość Styl Wielkość Tekst Liczba Jednostki opcjonalne ml, l, g, kg, mm, cm, m, m2, m3, MB, GB,TB, megapiksele, cale, szt., W mm, cm, m ml, l, g, kg, mm, cm, m, m2, m3, MB, GB,TB, megapiksele, cale, szt., W ml, l, g, kg, szt., cl, dl Materiał Materiał Tekst MateriałWymiar MateriałWielkość Materiał Tekst Wymiar Tekst Materiał Tekst Wielkość Liczba Model Model Tekst mm, cm, m ml, l, g, kg, mm, cm, m, m2, m3, MB, GB,TB, megapiksele, cale, szt., W
4.2 Konfiguracje dla asortymentów Książka, Film i Gry Konfiguracja Atrybut Typ Format książki Format Tekst Format filmu Format Tekst Platforma gier Platforma Tekst Wstępnie zdefiniowane wartości wydanie zszywane wydanie kieszonkowe, broszura, audiobook CD kaseta audio DVD Bluray, Bluray 3D, Bluray + DVD, DVD + CD, HDDVD, UMD wideo PC Mac, PlayStation, PlayStation 2, PlayStation 3, PlayStation Portable, Wii, Xbox, Xbox 360, Nintendo 3DS, Nintendo DS, Game Boy, Game Boy Advance, Game Cube, Nintendo 64, NGage, Sega Dreamcast, Sega Saturn Jednostki opcjonalne 4.3 Konfiguracje soczewek kontaktowych Konfiguracja Atrybut Typ Soczewki kontaktowe Promień krzywizny Liczba Wstępnie zdefiniowane wartości Jednostki opcjonalne mm Moc Liczba dpt Średnica Liczba mm
4.4 Konfiguracje dla asortymentu Moda Konfiguracja Atrybut Typ Wstępnie zdefiniowane wartości Ubrania z UE Ubrania z USA Skarpety Kolor Tekst Rozmiar Liczb a Kolor Tekst Rozmiar Tekst XXS, XS, S, M, L, XL, XXL, XXXL, 4XL, 5XL, 6XL, 7XL Kolor Tekst Rozmiar Tekst 1518, 1922, 2326, 1922, 2326, 2730, 3134, 3538, 3942, 4346, 4748, 4850 Jednostki opcjonalne Jeans Biustonosze Kolor Tekst Długość Szerokość Liczb a Liczb a 28, 30, 32, 34, 36, 38, 40, 42 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60 Kolor Tekst Obwód biustu Miseczka Liczb a Tekst 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, 100, 105, 110, 115, 120, 125, 130, 135, 140, 145, 150 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, 02823 Warszawa Email: sklep@ayn.com Telefon: +48 42 6 345 310 (Pn Pt od 9 do 17:30) Online: http://
Historia zmian Wersja Data Zmiana 1.0 20140625 Opracowanie dla Polski 2.0 20141001 new Layout