allegro / allegro-api

Issue tracker and wiki for Allegro REST API
https://developer.allegro.pl/
217 stars 39 forks source link

[NEWS] Wielowariantowość - automatycznie łączymy oferty wg koloru/wzoru #1285

Open PawelTaberski opened 5 years ago

PawelTaberski commented 5 years ago

Zmiana została przesunięta w czasie jak tylko będę miał więcej informacji poinformuję o tym.

Od 12.03.2019, gdy łączysz oferty po parametrze color/pattern, nie podawaj wartości dla tego parametru w tablicy z ofertami. Wartość tego pola będziemy ustalali automatycznie w oparciu o miniaturkę oferty.

Ważne! Pamiętaj, że oferty, które chcesz połączyć po parametrze color/pattern, muszą zawierać identyczną miniaturkę (zdjęcie główne).

Przykładowy request jak połączyć oferty po parametrze kolor/wzór:

curl -X PUT \
‘https://api.allegro.pl/sale/offer-variants/{setId}’
-H 'Accept: application/vnd.allegro.beta.v1+json’ \
-H 'Content-type: application/vnd.allegro.beta.v1+json' \
-H ‘Accept-Language: pl' \
-H 'Authorization: Bearer {token}' \
-d  ‘{
  "offers": [                                -- tablica z ofertami, które chcesz
                                                 połączyć w ofertę wielowariantową
    {
      "id": "7436547561",                    -- identyfikator oferty
    },
    {
      "id": "7436547336",
    },
    {
      "id": "7436547004",
    }
  ],
  "name": "Koszulki",                        -- wewnętrzna nazwa oferty wielowariantowej, 
                                                 pole string, maks. 50 znaków 
  "parameters": [                              -- tablica z parametrami, którymi
                                                 łączysz oferty. Możesz podać
                                                 maksymalnie 2 parametry.
       {
         "id": "54"                             -- identyfikator parametru,   
                                                 po którym chcesz połączyć oferty.  
                                                 Identyfikator parametru dla  
                                                 wybranej  kategorii możesz pobrać     
                                                 przy pomocy metody GET z zasobu 
                                                 /sale/categories/{categoryId}/parameters 
    },
     {    
        "id": "color/pattern                   -- parametr, po którym łączysz oferty -  
                                                  kolor/wzór
    }
   ]
}'
pietrach commented 5 years ago

Masakra, chyba sobie jaja robicie :-) Dosłownie klika dni temu doprowadziłem warianty obuwia dla jednego z klientów do przyzwoitej struktury i tam napewno nie ma tak, że color/pattern mają te same miniaturki, trochę się różnią. Ten color/pattern był super pomocny

pietrach commented 5 years ago

Miałem super podwarianty potworzone :-(

pietrach commented 5 years ago

A jakbym chciał sobie dzisiaj to potestować to mogę już teraz nie podawać color/pattern w tablicy z identyfikatorami ofert ? Czy to dopiero zadziała od 12 marca ?

pietrach commented 5 years ago

W jaki sposób będziecie rozpoznawać, że jest to samo zdjęcie ? Rozumiem, że macie do tego algorytm bo chyba nie po linku do zdjęcia ?

FromAnyHole commented 5 years ago

@PawelTaberski - STOP !! STOP !! STOP !! JAK !?! GDZIE ?!? Czy Wy w ogóle wiecie jak działa ten Cyrk nazywany Allegro ??? Jakie tam znowu "identyczne zdjęcie" dla przedmiotów z zestawu ?!? Jeśli każdy przedmiot ma inny kolor, wzór materiałowy lub sposób wykończenia - to trzeba będzie klienta wprowadzać w błąd i dawać teraz to samo zdjęcie, aby móc stworzyć kretyński wariant nowego typu ???

PawelTaberski commented 5 years ago

@pietrach Dopiero edycja takiej oferty spowoduje, że będziesz musiał dokonać zmian. Wartość parametru color/pattern będziemy wyliczali automatycznie na podstawie miniaturki. @FromAnyHole Chyba nie mówimy o tym samym. Ciągle możesz połączyć oferty w jedną dużą z wieloma wariantami kolorów np. żółtą, zieloną i niebieską koszulkę w różnych rozmiarach. Tylko na podstawie miniaturki zgrupujemy razem żółtą, zielone i niebieskie koszulki. I jak user wybierze w takiej ofercie koszulkę żółtą to pod spodem jak dotychczas będzie miał dostępne rozmiary dla tego wariantu. A nie jak dotychczas ręcznie podawałeś które mają identyczny kolor, co nie zawsze zgadzało się z prawdą.

pietrach commented 5 years ago

@PawelTaberski ok, ale mogę już teraz, dzisiaj przesyłać warianty z identyfikatorami ofert bez wypełnionego color/pattern ?

FromAnyHole commented 5 years ago

@PawelTaberski - tak czy inaczej, pomysł z weryfikacją zdjęcia jest do Kitu !! Co jeśli ktoś jest na tyle rzetelny, albo specyfika towaru jest oto taka, że konieczne jest realistyczne oddanie różnic w poszczególnych rozmiarach (lub wymiarach) ?? Wycofajcie to z projektu natychmiast, bo kiedy rzeczona koszulka w rozmiarze S będzie wyglądała identycznie jak koszulka XXL, to parodia jakaś !!

pietrach commented 5 years ago

@PawelTaberski - Szczerze mówiąc lepiej by było jakby to zostało jak teraz bo się namnoży ikonek wariantów w ofertach a tak się tworzyły podwarianty i było ok

PawelTaberski commented 5 years ago

@pietrach Zmianę, tak jak pisałem wdrożymy 12.03. @FromAnyHole Dotyczy to tylko miniaturek reszta zdjęć może jak najbardziej się różnić. Miniaturka musi być identyczna, aby w sekcji kolor/wzór na widoku oferty przedstawić dany wariant, a po wejściu już w niego i wybraniu rozmiaru oczywiście reszta zdjęć może się różnić. Ponadto dzięki identycznym miniaturką jesteśmy w stanie automatycznie łączyć takie oferty.

FromAnyHole commented 5 years ago

@pietrach - dokładnie tak !! Teraz w ofercie wielowariantowej z koszulkami będzie tak:

pietrach commented 5 years ago

@FromAnyHole - zgadza się @PawelTaberski - to rozwiązanie, które jest teraz jest dobre i nic nie trzeba zmieniać, zróbcie po prostu tak, że jak ktoś nie prześle color/pattern z identyfikatorem aukcji to sami po zdjęciu stworzycie a jak ktoś prześle to niech to działa tak jak teraz

PawelTaberski commented 5 years ago

Kupujący wybierają w pierwszej kolejności kolor potem rozmiar. Dlatego to bardzo ważne, aby miniaturka była taka sama dla każdego z rozmiarów. W przeciwnym razie kupujący widziałby na stronie oferty trzy razy każdy kolor. Sprawdzał kolejne kolory i dowiadywał się o tym, że nie ma tam jego rozmiaru. Jeśli jest potrzeba zaprezentowania większego rozmiaru na zdjęciu można dodać kolejne zdjęcia do galerii. Miniaturka powinna być reprezentatywna dla wariantu kolorystycznego.

czerwa commented 5 years ago

Otrzymałem w dniu wczorajszym od klienta informacje o podzieleniu Jego ofert wielowariantowych (Wszystkie parametry produktów były identyczne). Proszę o zdradzenie tajemnicy na jakiej zasadzie działa wasz magiczny algorytm, który z oferty w której znajdował się 1 model obuwia, ale w 2 wariantach kolorystycznych zrobił 2 osobne oferty i nawet nie podzielił ich kolorystycznie tylko w jednej i drugiej nowej ofercie zrobił mix. Liczę na szybką odpowiedź, bo chce znać logikę działania, zanim zacznę sprzątanie.

PawelTaberski commented 5 years ago

@czerwa Co prawda ta sprawa nie dotyczy API, ale skontaktowałem się z zespołem odpowiedzialnym za ten podział i otrzymałem informacje, że: Aby oferty były uznane za warianty tego samego produktu, wartości parametru walidującego powinny być zgodne. Proszę podaj nr ofert, sprawdzimy szczegóły i wrócimy z odpowiedzią.

FromAnyHole commented 5 years ago

@PawelTaberski - przecież to Pan pisze głupoty: "(...) W przeciwnym razie kupujący widziałby na stronie oferty trzy razy każdy kolor. Sprawdzał kolejne kolory..." - tak właśnie będzie po tej absurdalnej zmianie ! Teraz nie ma takich sytuacji (proszę o przykłady ?!?), o ile tego sam ktoś nie wymusi i nie zrobi powtórzeń koloru - ale nikt tak nie robi, a najgorszy będzie całkowity brak możliwości wyboru !!

Po drugie ustalmy też terminologię - chyba nie "na stronie oferty", a w górnej sekcji "karty przedmiotu". A wracając do planowanej i niepotrzebnej zmiany dla wariantów:

czerwa commented 5 years ago

@PawelTaberski Wyjaśniam kwestie z klientem i prawdopodobnie wystawiał nowe aukcje uzupełniając parametry, ale nie aktualizował już parametrów dla aukcji tego samego produktu wcześniej wystawionych. Dzięki za szybką odpowiedź.

PawelTaberski commented 5 years ago

@FromAnyHole Nie bardzo Ciebie rozumiem czerwone koszulki będą razem w takim wypadku od XXS-XXXL a zielone w takich wymiarach razem zgrupowane, także będą 2 grupy z pod rozmiarami.

FromAnyHole commented 5 years ago

@PawelTaberski - przecież Pan tylko udaje, że nie wie o co chodzi... Chcecie zwyczajnie wymusić na sprzedających, aby stosowali oto nagle to samo zdjęcie Nr 1 - do wszystkich rozmiarów ! A co jeśli ktoś nie zamierza robić takich kuriozalnych zmian w galerii przedmiotów, czyli chce mieć po prostu wiarygodne zdjęcia swoich przedmiotów w każdym z rozmiarów - dla każdego dostępnego koloru/wzoru ??? Sknociliście kolejną rzecz, a wystarczyło przecież pomyśleć wcześniej - no i zarezerwować na przykład niewidoczne w galerii i tym samym w opisie - specjalne (uśrednione) zdjęcie do tworzenia wariantów. Na jego podstawie powstawały by wyłącznie zestawy "ikonek" w sekcji wariantów, a w galerii każdego przedmiotu z osobna - wszystkie zdjęcia (włącznie z pierwszym) były by prawdziwe, a nie udawane...

PawelTaberski commented 5 years ago

Tak, jak już wcześniej pisałem Kupujący wybierają w pierwszej kolejności kolor potem rozmiar. Dlatego to bardzo ważne, aby miniaturka była taka sama dla każdego z rozmiarów. Jednakże przekazałem Twoją sugestię, aby była możliwość odznaczenia widoczności pierwszego zdjęcia w galerii.

pietrach commented 5 years ago

Czy ta zmiana już weszła w życie ? Czy teraz jak będę przekazywał pole colorPattern to system będzie je brał pod uwagę czy już nie ?

PawelTaberski commented 5 years ago

Zmiana została przesunięta w czasie jak tylko będę miał więcej informacji poinformuję o tym.

pietrach commented 5 years ago

Dzisiaj od jednego z naszych klientów otrzymałem maila od Was:

Od wczoraj rozłączamy oferty wielowariantowe, które nie są połączone w optymalny sposób, np. sprzedający za pomocą miniaturki (kolor/wzór) połączył oferty, które nie są wariantami tego samego produktu (np. różne modele sukienek). Modyfikujemy oferty wielowariantowe - tam, gdzie będzie to możliwe rozłączone oferty zmodyfikujemy - połączymy w nowy, optymalny sposób.

Nie powinno być żadnej ingerencji ze strony Allegro w tworzenie wariantów. Nasz system został stworzony w taki sposób, że nie nie pobieramy wariantów z Allegro tylko zapisane jest podczas tworzenia lub aktualizacji jakie oferty wchodzą w ramach danego wariantu. Teraz dochodzi do sytuacji, że my sobie tworzymy warianty. Wy sobie sami zmieniacie i jest totalny rozjazd. W takim razie po co ten cały moduł do wielowariantowości. Trzeba to usunąć całkowicie i Wy będziecie łączyć ręcznie wedle uznania. To jak klient połączył to jest jego sprawa. A że jest błąd jakiś to trudno. Ewentualnie możecie to zgłosić do klienta, że wydaje się Wam, że coś jest nie tak z tym wariantem a nie zmieniać wedle uznania.

PawelTaberski commented 5 years ago

Tutaj zajmujemy się sprawami dotyczącymi API Allegro, w sprawie mailingu napisz proszę przez formularz kontaktowy.

PawelTaberski commented 5 years ago

@pietrach Widzę, że umknęło mi Twoje pytanie :-) Jedyny sposób na teraz, aby sprawdzić i porównać czy masz wszystko zgodnie z tym jak jest u nas to pobranie wszystkich wielowariantowych ofert przez /sale/offer-variants?user.id=user.id i następnie /sale/offer-variants/{setId} pobranie każdej po kolej i porównanie. Więcej na temat tych metod znajdziesz w naszym poradniku.

pietrach commented 5 years ago

Ale ja nie chcę nic pobierać. Po to sobie konfiguruje warianty i takie mają być i tyle.

From: PawelTaberski [mailto:notifications@github.com] Sent: Thursday, March 21, 2019 2:41 PM To: allegro/allegro-api Cc: pietrach; Mention Subject: Re: [allegro/allegro-api] [NEWS] Wielowariantowość - automatycznie łączymy oferty wg koloru/wzoru (#1285)

@pietrach https://github.com/pietrach Widzę, że umknęło mi Twoje pytanie :-) Jedyny sposób na teraz, aby sprawdzić i porównać czy masz wszystko zgodnie z tym jak jest u nas to pobranie wszystkich wielowariantowych ofert przez /sale/offer-variants?user.id=user.id i następnie /sale/offer-variants/{setId} pobranie każdej po kolej i porównanie. Więcej na temat tych metod znajdziesz w naszym poradniku https://developer.allegro.pl/multi_variant_offers/ .

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/allegro/allegro-api/issues/1285#issuecomment-475232436 , or mute the thread https://github.com/notifications/unsubscribe-auth/AFK3fCVyikTB2xGYd0n3AfWXkEd6GNouks5vY4vegaJpZM4beLiz .Obraz usunięty przez nadawcę.

PawelTaberski commented 5 years ago

Rozumiem, zmiany wprowadzamy jeśli jest to niezbędne.

avello commented 5 years ago

Mam pytanie które było już wcześniej ale nie widzę odpowiedzi. W jaki sposób będziecie rozpoznawać, że jest to samo zdjęcie? Czy jak w aukcjach dam to samo zdjęcie jako główne, ale zdjęcia będą fizycznie innymi plikami (inny adres url zdjęcia) to będzie to uznane za identyczne zdjęcia czy nie?

PawelTaberski commented 5 years ago

Zawartość pliku musi być identyczna, nazwa pliku nie ma znaczenia.

avello commented 5 years ago

W poradniku jest informacja że "Oferta wielowariantowa może składać się maksymalnie z 500 ofert" Czy jest możliwość zwiększenia tego limitu np. do 1000?

PawelTaberski commented 5 years ago

A powiedz mi co byś chciał oferować do jakiego asortymentu potrzebujesz aż tyle wariantów.

avello commented 5 years ago

Kabiny prysznicowe. Przykładowo posiadam kabinę w 42 rozmiarach (liczę już razem dłuższy i krótszy bok) i 16 kolorów szkła, razem daje 672 wariantów. Limit do 1000 by wystarczył, raczej tego nie przekroczymy

PawelTaberski commented 5 years ago

Rozumiem przekazałem Twoją sugestię do odpowiedniego zespołu. Jeśli zdecydujemy się zwiększyć ten limit poinformujemy o tym w dedykowanym komunikacie.

avello commented 5 years ago

Testuję warianty na sandboxie. Mam taki błąd "Każda oferta musi mieć ustawioną wartość "colorPattern".", wg. dokumentacji ten parametr nie powinien już być wymagany

avello commented 5 years ago

Jeszcze dodatkowe pytanie o ilość parametrów którymi łączymy oferty, obecnie mogę użyć tylko 2. Czy jest możliwość zwiększenia ilości?

PawelTaberski commented 5 years ago

@avello Zmiana zgodnie z komunikatem #1285 została wstrzymana. Odnośnie większej ilości parametrów, czy mógłbyś podać jakiś przykład jak byś je zastosował?

avello commented 5 years ago

Kabiny prysznicowe. Kolor/wzór - kolor szkła, Dłuższy bok, Krótszy bok - wymiary kabiny. Te 3 parametry są niezbędne aby prawidłowo utworzyć warianty dla tego typu asortymentu, aby klient mógł w łatwy sposób przełączać się pomiędzy ofertami.

PawelTaberski commented 5 years ago

@avello Rozumiem sugestię oczywiście przekazałem, jeśli zdecydujemy się na wprowadzenie takiej zmiany to poinformujemy o tym w dedykowanym komunikacie.