Udostępniliśmy dziś wersję beta.v3 zasobów /sale/product-offers i wprowadziliśmy przy tym następujące zmiany:

• 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.

Przykładowa struktura requestu:

{
        "productSet": [{
                   "product":
                    {
                    "id": "bca3791d-a9f8-43e6-885f-c563b7fb30ee"
                    }
        }],
        "sellingMode": {
            "price": {
                "amount": "220.85",
                "currency": "PLN"
            }
        },
        "stock": {
            "available": 10
        }
}

• 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”.

Aby skorzystać z wersji beta.v3, przekaż w nagłówkach Content-Type oraz Accept wartość “application/vnd.allegro.beta.v3+json”.

Dlaczego udostępniliśmy nową wersję zasobów?

W najbliższych miesiącach planujemy udostępnić możliwość definiowania zestawów produktowych, czyli ofert złożonych z wielu produktów. Przykładem takiego zestawu może być oferta, w której przedmiotem sprzedaży jest konsola oraz dodatkowa gra. W takim przypadku, za pomocą POST /sale/product-offers, zdefiniujesz dwa różne produkty w ramach jednej oferty. Zmianę w PATCH /sale/product-offers/{offerId} wdrożyliśmy w odpowiedzi na Wasze sugestie, tak aby ułatwić zarządzanie ofertami.

Ważne! Możliwość definiowania zestawów planujemy udostępnić wyłącznie w zasobach /sale/product-offers. W momencie wdrożenia funkcjonalności w strukturze requestu dodamy także możliwość określenia liczby sztuk każdego z produktów, który wchodzi w skład zestawu.

Dzięki zasobom /sale/product-offers możesz w łatwy sposób:

• wystawić ofertę powiązaną z produktem - wystarczy, że w requeście wskażesz nam identyfikator produktu z naszej bazy lub numer EAN, cenę oraz liczbę sztuk. Możesz również stworzyć swój własny produkt. Jeśli na podstawie przekazanych danych rozpoznamy, że produkt istnieje w naszej bazie, to weźmiemy jego dane i uwzględnimy w ofercie, a pozostałe pola uzupełnimy wartościami domyślnymi,
• zaktualizować dane w ofercie - nie musisz przy tym przekazywać całej jej struktury, wystarczy pole, które chcesz edytować.

Więcej informacji o obsłudze zasobów znajdziesz w naszym poradniku.