Zakończyliśmy okres testowy dla zasobów /sale/product-offers, dzięki którym:

• za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem,
• edytujesz dowolne pole oferty,
• utworzysz zestaw produktowy.

Wersję beta będziemy wspierać do 28.02.2022. W tym okresie przejdź na wersję public.

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ć automatyczne wznowienia.
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. Aktualnie możesz w nim przekazać dane wyłącznie jednego produktu.
• 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”.

Na jakie zasoby wpływa zmiana?

Poniżej znajdziesz listę zasobów, które wystawiliśmy w wersji public:

• POST /sale/product-offers - utwórz ofertę powiązaną z produktem,
• GET /sale/product-offers/{offerId}/operations/{operationId} - sprawdź status publikacji / edycji oferty,
• GET /sale/product-offers/{offerId} - pobierz szczegóły oferty,
• PATCH /sale/product-offers/{offerId} - edytuj ofertę.