Onixarts
commented
2 years ago Czy obecnie da radę jakoś wyfiltrować parametr specyficzny w kategorii, w którym jest MPN, tak jak np dla GTIN są podane identyfikatory tych parametrów?
Open PrzemyslawLukanowski opened 2 years ago
Onixarts
commented
2 years ago Czy obecnie da radę jakoś wyfiltrować parametr specyficzny w kategorii, w którym jest MPN, tak jak np dla GTIN są podane identyfikatory tych parametrów?
PrzemyslawLukanowski
commented
2 years ago Takiego dedykowanego sposobu filtrowania nie ma, ale poniżej przesyłam listę parametrów MPN wraz z identyfikatorami:
Onixarts
commented
2 years ago I listę tę można uznać za stałą i zahardkodować w aplikacji? Czy może się zdarzyć, że w parametrach będzie wiecej niż jeden taki parametr? Przykładowo Kod producenta i Numer produktu.
Oraz, czy np Kod Produktu (219809) również liczy się jako parametr MPN?
PrzemyslawLukanowski
commented
2 years ago Konsultuję jeszcze wcześniejsze dwa pytania. W międzyczasie możesz tylko doprecyzować, jaką kategorię masz na myśli w kontekście Kodu Produktu (219809)? Wstępnie nie mogę potwierdzić, aby taki parametr u nas występował.
Onixarts
commented
2 years ago Dom i Ogród > Ogród > Doniczki i pojemniki > Doniczki (126202). Chyba, że mam nieaktualne drzewo kategorii :)
PrzemyslawLukanowski
commented
2 years ago Tak, zgadza się, aktualnie nie ma takiego parametru w tej kategorii, jest za to:
"id": "224017",
"name": "Kod producenta",Po konsultacji wrócę z odpowiedzią na pozostałe dwa pytania.
PrzemyslawLukanowski
commented
2 years ago I listę tę można uznać za stałą i zahardkodować w aplikacji?
Dla Numeru katalogowego występuje jeszcze jedno ID - 237226 (ale tylko w jednej kategorii - Kolekcje i sztuka > Kolekcje > Modelarstwo > Materiały modelarskie > Farby). Te identyfikatory powinny być stałe, chociaż nie można wykluczyć, że w może kiedyś nastąpić zmiana w wyniku scalania kategorii (jednak takie operacje nie zachodzą często) lub zdecydujemy się połączyć dwa ID parametru np. Numer produktu w jeden.
Czy może się zdarzyć, że w parametrach będzie wiecej niż jeden taki parametr? Przykładowo Kod producenta i Numer produktu.
Aktualnie nie mamy kategorii, w której występowałaby taka sytuacja.
tomasz-grzesik
commented
2 years ago @PrzemyslawLukanowski Mam pytanie co do wyszkukania po ean. Na sandboxie w przeglądarce podczas zapisu formularze edycji oferty pojawia się podpowiedź z połączeniem produktu. Niestety po API zwracana jest pusta lista:
"curl -X GET -H 'Accept: application/vnd.allegro.public.v1+json' -H "
"'Authorization: Bearer "
" "
"-H 'Connection: keep-alive' -H 'Content-Type: "
"application/vnd.allegro.public.v1+json' -H 'User-Agent: "
"python-requests/2.25.1' "
"'https://api.allegro.pl.allegrosandbox.pl/sale/products?phrase=5904017036777'"
)Odpowiedź:
{'products': [], 'categories': {'subcategories': [{'id': '5', 'name': 'Dom i Ogród', 'count': 0}, {'id': '11763', 'name': 'Dziecko', 'count': 0}, {'id': '42540aec-367a-4e5e-b411-17c09b08e41f', 'name': 'Elektronika', 'count': 0}, {'id': '4bd97d96-f0ff-46cb-a52c-2992bd972bb1', 'name': 'Firma i usługi', 'count': 0}, {'id': 'a408e75a-cede-4587-8526-54e9be600d9f', 'name': 'Kolekcje i sztuka', 'count': 0}, {'id': '38d588fd-7e9c-4c42-a4ae-6831775eca45', 'name': 'Kultura i rozrywka', 'count': 0}, {'id': 'ea5b98dd-4b6f-4bd0-8c80-22c2629132d0', 'name': 'Moda', 'count': 0}, {'id': '3', 'name': 'Motoryzacja', 'count': 0}, {'id': '20782', 'name': 'Nieruchomości', 'count': 0}, {'id': '3919', 'name': 'Sport i turystyka', 'count': 0}, {'id': '258832', 'name': 'Supermarket', 'count': 0}, {'id': '1429', 'name': 'Uroda', 'count': 0}, {'id': '121882', 'name': 'Zdrowie', 'count': 0}], 'path': [{'id': '954b95b6-43cf-4104-8354-dea4d9b10ddf', 'name': 'Allegro'}]}, 'filters': [], 'nextPage': None}
Czy to normalne, że nawet po eanie nie można przeszukać produktów? Próbowałem również z ustawionym mode.
PrzemyslawLukanowski
commented
2 years ago Widzę, że produkt nie jest również zwracany przez wyszukiwarkę na stronie internetowej (a jej odpowiednikiem jest GET /sale/products). Taka sytuacja może mieć miejsce, gdy produkt jest "słaby" jakościowo, czyli np. nie posiada uzupełnionych wszystkich parametrów obowiązkowych.
tomasz-grzesik
commented
2 years ago Dobrze. Dziękuję za wyjaśnienie.
Wprowadziliśmy dziś zmiany w:
dzięki którym precyzyjniej wyszukasz i wskażesz produkt, którego ofertę sprzedaży chcesz wystawić.
Co zmieniliśmy?
W zasobie /sale/products dodaliśmy nowy parametr wyszukiwania - mode, dzięki któremu, w połączeniu z parametrem phrase, możesz doprecyzować, czy podana przez Ciebie fraza to GTIN lub MPN (numer katalogowy nadany przez producenta). Pozwoli nam to lepiej dopasować wynik wyszukiwania. Wskaż w takim przypadku odpowiednią wartość:
Jeśli w parametrze phrase wskazujesz nazwę produktu, pozostaw mode puste.
Jeśli do tej pory wyszukiwałeś produkty za pomocą parametru EAN w następujący sposób: GET /sale/products?ean={EAN}, zmień wywołanie na GET /sale/products?phrase={EAN}&mode=GTIN.
W zasobach /sale/product-offers i /sale/product-offers/{offerId} dodaliśmy nowe pole - productSet.product.idType. Ma ono zbliżone zastosowanie do parametru mode - sprecyzujesz w nim, czy podana przez Ciebie wartość w polu productSet.product.id to GTIN lub MPN, dzięki czemu przypiszemy do oferty najbardziej odpowiedni produkt. Wartości, które możesz przekazać, to:
Jeśli w polu productSet.product.id wprowadzisz:
Dlaczego wprowadziliśmy zmianę?
Zależy nam na tym, aby oferty były połączone z właściwymi produktami. Dzięki nowym funkcjom znacznie zminimalizujesz sytuacje, w których błędnie połączymy ofertę. Za pomocą parametru mode i pola idType doprecyzujesz, jakiego dokładnie produktu szukasz i tym samym w odpowiedzi uzyskasz najbardziej trafny wynik z naszego Katalogu.
Jakie planujemy kolejne zmiany?
Na początku sierpnia 2022 usuniemy parametr ean z zasobu /sale/products. Analogiczne wyniki uzyskasz, jeśli skorzystasz z parametru phrase. Zaimplementuj w swojej aplikacji obsługę parametru mode, aby użytkownicy mogli jak najprecyzyjniej wyszukać odpowiednie produkty.
Today we have introduced changes in:
thanks to which you can more precisely search and indicate the product you want to list for sale.
What changes have we made?
We have added a new query parameter in the /sale/products resource - mode, owing to which, in combination with the phrase, you can specify whether the phrase you provided is GTIN or MPN (Catalog number given by the manufacturer). It will allow us to find more precise results. Provide in the parameter one of the following values:
If you indicate a product name in the phrase parameter, leave the mode empty.
If so far you have searched for products using construction, e.g GET /sale/products?ean={GTIN}, change it to GET /sale/products?phrase={GTIN}&mode=GTIN.
In the /sale/product-offers and /sale/product-offers/{offerId} we have added a new field - productSet.product.idType. You can use it for a similar purpose to the mode parameter - specify whether the value entered in productSet.product.id is a GTIN or MPN. Owing to it, we will assign the most accurate product to an offer. Provide in the field one of the following values:
If in the productSet.product.id you provide:
This will allow us to match the product to the offer more precisely if the product already exists in our catalog.
Why did we make the change?
We want the offers to be connected with the right products. Thanks to new features you will significantly minimize the situations in which we incorrectly assign a product. By using the mode parameter and the idType field, you can clarify the exact product you are looking for and thus you will get the most relevant result from our catalog.
What will be the next changes?
At the beginning of August 2022, we will remove the ean parameter from /sale/products resource. You will get the same results if you use the phrase parameter. Implement support for the mode parameter in your application so users will be able to find products as precisely as possible.