Zgodnie z naszą wcześniejszą zapowiedzią informujemy, że 28 lutego 2022 wyłączymy wersje beta zasobów /sale/product-offers.

Jak przeprowadzić migrację do wersji public?

Zależy od tego, której wersji beta używasz. Jeśli korzystasz z:

• beta.v3 - wystarczy, że zmienisz wartość w nagłówkach Content-Type oraz Accept z “application/vnd.allegro.beta.v3+json” na “application/vnd.allegro.public.v1+json”,
• beta.v2 - wprowadź zmiany, które wprowadziliśmy w wersji beta.v3 - pole “product” zastąpiliśmy polem “productSet”, które jest tablicą obiektów. Zmień także wartość w nagłówkach Content-Type oraz Accept z “application/vnd.allegro.beta.v2+json” na “application/vnd.allegro.public.v1+json”.

Jakie zmiany wprowadziliśmy w wersji public?

1. Dodaliśmy obsługę nowych pól, które możesz zadeklarować w strukturze żądania POST /sale/product-offers oraz PATCH /sale/product-offers/{offerId}:
   • “attachments” - załączniki,
   • “additionalServices” - usługi dodatkowe,
   • “b2b” - czy oferta dostępna jest do zakupu tylko dla kupujących z kontem firmowym,
   • “delivery.shipmentDate” - wysyłka od, np. dla przedsprzedaży,
   • “fundraisingCampaign” - identyfikator organizacji charytatywnej,
   • “publication.republish” - czy oferta ma zostać automatycznie wznowiona,
   • “compatibilityList” - sekcja pasuje do.
2. Zaktualizowaliśmy response dla:
   • POST /sale/product-offers,
   • PATCH /sale/product-offers/{offerId},
   • GET /sale/product-offers/{offerId}. Parametry produktowe, czyli te, które opisują produkt (w odpowiedzi dla GET /sale/categories/{categoryId}/parameters są oznaczone flagą “options.describesProduct”: true), zwracamy teraz w sekcji “productSet.product.parameters”. Parametry ofertowe związane z indywidualną ofertą, np. stan, data ważności, etc. zwrócimy w polu “parameters”.

Wersja public uwzględnia również zmiany, które wprowadziliśmy w wersji beta.v3:

• dla POST /sale/product-offers i GET /sale/product-offers/{offerId} - pole “product” zastąpiliśmy polem “productSet”, które jest tablicą obiektów.
• dla PATCH /sale/product-offers/{offerId} - jeśli oferta jest zakończona i zaktualizujesz dla niej liczbę przedmiotów na większą niż 0, nie aktywujemy oferty - w tej sytuacji pozostanie w statusie “ENDED”.