W grudniu informowaliśmy o nadchodzących zmianach w API w kontekście zagranicznych serwisów Allegro. Chcemy, abyście mogli przetestować nowe możliwości, dlatego zmiany dotyczące oferty będą widoczne wcześniej na Sandbox (dotyczy tylko API).

Jakich zasobów dotyczy wdrożenie na Sandbox?

• 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,
• PUT /sale/offers/{offerId} - uzupełnij szkic oferty,
• GET /sale/offers/{offerId} - pobierz dane szczegółowe oferty,
• GET /sale/offers - pobierz listę ofert,
• GET /marketplaces - pobierz informacje o serwisach dodatkowych.

Nowy zasób GET /marketplaces będzie wymagał “Content-Type: application/vnd.allegro.public.v1+json”, pozostałe “Content-Type: application/vnd.allegro.beta.v1+json” (wersja beta będzie tylko do testowania na Sandbox).

Jakie zmiany wprowadzimy?

Zaplanowaliśmy dwa etapy wdrożenia na Sandbox.

1. ETAP I - od dziś, zobaczysz informacje dotyczące serwisu bazowego i serwisów dodatkowych. Zadeklarujesz chęć widoczności oferty w innym serwisie, jednak na tym etapie nie uruchomimy procesu kwalifikacji, dlatego nie będzie znany jego status. Dodamy:

   • nowe pola:
     • publication.marketplaces.base - serwis bazowy oferty,
     • publication.marketplaces.additional - serwis dodatkowy oferty,
   • nowy endpoint GET /marketplaces, dzięki któremu pobierzesz m.in. informacje o dostępnych serwisach dodatkowych.

2. ETAP II - 28.02.2023, określisz cenę dla serwisu dodatkowego i sprawdzisz, czy oferta zakwalifikowała się do wyświetlenia w dodatkowym serwisie. Oferta będzie widoczna tylko w serwisie bazowym na allegro.pl.allegrosandbox.pl. W zasobach do zarządzania ofertami dodamy nową sekcję additionalMarketplaces.{marketplaceId}, z polami:

   • publication.state - status widoczności oferty,
   • sellingMode.price - deklaracja ceny w walucie odpowiedniej dla serwisu dodatkowego.

Przygotowaliśmy dla Was dedykowaną stronę, na której znajdziecie szczegółowe informacje dotyczące zmian w API Allegro. Opisujemy tam szczegółowo oba etapy oraz inne zmiany w naszym API pod kątem serwisów zagranicznych Allegro. Ważnym elementem jest udostępniony tam harmonogram. Stworzony specjalnie dla Was, byście mogli zaplanować swoje prace. Wszelkie dane będziemy aktualizować na bieżąco. Konkretne daty mogą ulec drobnym korektom.

Jeśli macie pytania zapraszamy na nasze forum GitHub.

Dotychczasowe newsy:

• 26.01.2023 Serwisy zagraniczne Allegro - dodaliśmy nowe parametry i pole w GET /payments/payment-operations
• 29.12.2022 GET /sale/offer-events - nowy typ zdarzenia
• 22.12.2022 Umożliwiamy wyszukiwanie i pobieranie danych produktów w różnych językach
• 8.12.2022 Zmiany w wystawianiu ofert - dodamy możliwość wyświetlania ofert w zagranicznych domenach serwisu Allegro