12 kwietnia 2023
Serwisy zagraniczne Allegro - wdrożyliśmy zmiany w ofercie na produkcji
Od 12.04.2023 nasi sprzedający mogą korzystać z nowych narzędzi na stronie allegro.pl do zarządzania widocznością oferty w czeskim serwisie. Oferty, które kwalifikują się na rynek czeski, odpowiednio oznaczyliśmy w zakładce Mój asortyment. Sprzedający mogą je dostosować do swoich potrzeb, aby być gotowym na uruchomienie czeskiego serwisu zagranicznego w maju 2023.
W związku z tym wdrożyliśmy:
- zmiany w ofercie, które do tej pory były dostępne tylko na Sandbox,
- grupową edycję zmiany chęci widoczności oferty w serwisach dodatkowych,
- grupową zmianę ceny w serwisach dodatkowych,
- do listy ofert statystyki odwiedzin i obserwowanych oraz liczbę sprzedanych produktów w ciągu 30 dni dla serwisów dodatkowych.
Jakich zasobów dotyczy wdrożenie?
- POST /sale/product-offers - wystaw ofertę z produktem w jednym requeście,
- PATCH /sale/product-offers/{offerId} - edytuj oferty z produktem,
- GET /sale/product-offers/{offerId} - pobierz ofertę z produktem,
- POST /sale/offers - dodaj szkic oferty lub edytuj ofertę,
- PUT /sale/offers/{offerId} - uzupełnij szkic oferty,
- GET /sale/offers/{offerId} - pobierz dane szczegółowe oferty,
- GET /sale/offers - pobierz listę ofert,
- PUT /sale/offer-modification-commands/{commandId} - edytuj wiele ofert jednocześnie,
- PUT /sale/offer-price-change-commands/{commandId} - edytuj cenę w wielu ofertach jednocześnie,
- GET /marketplaces - pobierz informacje o serwisach dodatkowych.
Wszystkie zasoby na produkcji oraz środowisku testowym Sandbox obsłużysz z nagłówkiem “Content-Type”: “application/vnd.allegro.public.v1+json”.
Jakie zmiany wprowadziliśmy?
Po tym wdrożeniu możesz przejść proces widoczności oferty w serwisach dodatkowych, czyli:
- zobaczysz informacje dotyczące serwisu bazowego i serwisów dodatkowych,
- zadeklarujesz chęć widoczności oferty w serwisie dodatkowym,
- określisz cenę i walutę dla serwisu dodatkowego,
- sprawdzisz, czy oferta zakwalifikowała się do wyświetlenia w dodatkowym serwisie.
Do momentu uruchomienia czeskiego serwisu oferta będzie widoczna tylko w serwisie bazowym na allegro.pl.
Wdrożyliśmy:
- nowe pola:
- publication.marketplaces.base - serwis bazowy oferty,
- publication.marketplaces.additional - serwis dodatkowy oferty.
- nową sekcję additionalMarketplaces.{marketplaceId}, z polami:
- publication.state - status widoczności oferty,
- sellingMode.price - deklaracja ceny w walucie odpowiedniej dla serwisu dodatkowego.
- nowy endpoint GET /marketplaces, dzięki któremu pobierzesz m.in. informacje o dostępnych serwisach dodatkowych.
- dodaliśmy możliwość grupowej edycji chęci widoczności w serwisach dodatkowych.
- dodaliśmy pole marketplaceId dla grupowej edycji ceny.
- dla GET /sale/offers dla danego serwisu dodatkowego zwrócimy statystyki:
- additionalMarketplaces.{marketplaceId}.stats.visitsCount - liczba odwiedzin,
- additionalMarketplaces.{marketplaceId}.stats.watchersCount - liczba obserwujących użytkowników,
- oraz liczbę sprzedanych przedmiotów w ofercie z ostatnich 30 dni w polu additionalMarketplaces.{marketplaceId}stock.sold.
- “Content-Type”: “application/vnd.allegro.beta.v1+json” na środowisku testowym Sandbox dla zmian w ofercie dla serwisów zagranicznych Allegro nie będzie już dostępny. Skorzystaj z “Content-Type”: “application/vnd.allegro.public.v1+json”, aby testować zmiany.
Zachęcamy do odwiedzenia dedykowanej strony, na której znajdziecie szczegółowe informacje dotyczące zmian w API Allegro pod kątem serwisów zagranicznych Allegro.
Jeśli macie pytania, zapraszamy na nasze forum GitHub.