W 2019 roku wprowadziliśmy Katalog produktów Allegro w wybranych kategoriach serwisu. W ramach Katalogu produktów Allegro chcemy zebrać i opisać wszystkie produkty, jakie są dostępne w ofertach wystawianych przez wszystkich sprzedawców. Katalogujemy pojedyncze produkty jako reprezentatywne, które odróżniają się od innych swoimi właściwościami, np. modelem, kodem producenta, numerem GTIN, czy innymi parametrami podstawowymi.
15 lutego 2021 zwiększymy wymóg ofert połączonych z Katalogiem produktów z 1% do 10% w kategoriach:
Planujemy do końca 2021 roku skatalogować wszystkie oferty tam, gdzie to możliwe. W tym celu od 1 września 2020 roku wprowadziliśmy wymóg % ofert połączonych z produktem w kolejnych działach. Już teraz wymagamy, aby 1% ofert był powiązany z Katalogiem produktów w kategoriach:
Zapowiedzieliśmy również zmianę na 18 stycznia 2021, w ramach której:
Chcemy umożliwić powiązanie ofert w jak największej liczbie kategorii Allegro, jednak specyfika sprzedawanych przedmiotów nie zawsze na to pozwala. Zapoznaj się z tym plikiem, aby sprawdzić, w jakich kategoriach działów Elektronika, Zdrowie oraz Sport i turystyka będziemy wymagać 10% ofert powiązanych z Katalogiem produktów Allegro.
Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to będzie mógł wystawić nową, podobną lub wznowić zakończoną ofertę, jeśli wskaże produkt dostępny w Katalogu lub doda nowy produkt na podstawie swojej oferty.
Więcej o tym, jak skatalogować ofertę, przeczytasz w naszym poradniku. Zapoznaj się także z zasobem /sale/product-offers, dzięki któremu za pomocą jednego żądania POST wystawisz aktywną ofertę powiązaną z produktem:
Aby sprawdzić, które z ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers i parametru product.id.empty=true.
Więcej informacji na temat tej zmiany znajdziesz na stronie dla sprzedających.
Dodaliśmy dziś obsługę dwóch atrybutów oferty, które możesz zadeklarować w strukturze żądania POST /sale/product-offers i PATCH /sale/product-offers/{offerId}:
Więcej informacji o tym, jak przekazać pola w żądaniu, znajdziesz w naszym poradniku.
Dzisiaj udostępniliśmy nową metodę dostawy dostępną obecnie na terenie Warszawy. Identyfikator nowej metody możesz uzyskać zasobem GET /sale/delivery-methods:
Więcej informacji na ten temat znajdziesz tutaj.
Udostępniliśmy dziś dwa nowe zasoby, które pozwolą ci śledzić zmiany w kategoriach i parametrach na naszej platformie:
curl -X GET
‘https://api.allegro.pl/sale/category-events’/
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’
{
…
{
“id”: “MTEzMjQzODU3NA”, – ID zdarzenia
“occurredAt”: “2021-01-12T15:26:43.891Z”, – czas wystąpienia zdarzenia
“type”: “CATEGORY_CREATED”, – typ zdarzenia
“category”: { – dane kategorii, której dotyczy
zdarzenie
“id”: “165”, – ID kategorii
“name”: “Smartphones and Cell Phones”, – nazwa kategorii
“parent”: {
“id”: “4” – ID kategorii nadrzędnej
},
“leaf”: false – czy dana kategoria jest kategorią
najniższego rzędu
}
}
…
}
Uwaga! W wyjątkowych sytuacjach możemy zdecydować, aby nie wdrażać wybranych zaplanowanych zmian - np. jeżeli zrezygnujemy z oznaczenia danego parametru jako obowiązkowy. W takiej sytuacji dane zdarzenie usuniemy z odpowiedzi.
Możesz także wyfiltrować wyniki na podstawie daty, kiedy zaplanowaliśmy zmianę. Skorzystaj z poniższych filtrów, gdy chcesz sprawdzić, jakie zmiany zaplanowaliśmy w ostatnim czasie:
np. żeby sprawdzić, jakie zmiany zaplanowaliśmy do dzisiaj, użyj żądania GET /sale/category-parameters-scheduled-changes?scheduledAt.lte=2021-01-13T23:59:59
Jeżeli chcesz sprawdzić, które parametry oznaczymy jako obowiązkowe w najbliższym czasie, użyj filtrów:
np. żeby sprawdzić, które parametry oznaczymy jako obowiązkowe do końca lutego 2021, musisz sformułować żądanie GET /sale/category-parameters-scheduled-changes?scheduledFor.lte=2021-02-28T23:59:59Z.
curl -X GET
‘https://api.allegro.pl/sale/category-parameters-scheduled-changes’/
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’
{
…
{
“scheduledAt”: “2021-01-12T15:26:43.891Z”, – data z przeszłości, kiedy
zaplanowaliśmy zmianę
“scheduledFor”: “2021-02-14T15:26:43.891Z”, – data z przyszłości, na kiedy
planujemy wdrożyć zmianę
“type”: “REQUIREMENT_CHANGE”, – rodzaj zmiany
“category”: {
“id”: “165” – ID kategorii, w której znajduje się
parametr, którego dotyczy zmiana
},
“parameter”: {
“id”: “11323” – ID parametru, którego dotyczy
zmiana
}
}
…
}
Więcej informacji o nowych zasobach znajdziesz w naszym poradniku.
15.02.2021 usuniemy pole options.productEanRequired w odpowiedzi dla:
Zwracamy w nim informację, czy w danej kategorii musisz przekazać parametr GTIN, gdy tworzysz propozycję nowego produktu.
Od teraz korzystaj z pola requiredForProduct dla parametru GTIN, który otrzymasz w odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Parametr GTIN w zależności od kategorii to:
Zwiększyliśmy dzisiaj limit dla jednorazowej zmiany ceny w ofercie.
Jeśli:
Ograniczenia dotyczą pojedynczej zmiany ceny Kup Teraz w aktywnych ofertach.
Zgodnie z wcześniejszą zapowiedzią informujemy, że 29 marca 2021 usuniemy:
Proces usunięcia tych obiektów podzieliliśmy na 3 kroki.
zignorujemy je i nie będziemy go walidować.
Gdy będziesz pobierać:
ustawimy trwale jako null - jej zmiana nie będzie możliwa.
To spowoduje, że nie otrzymasz i nie prześlesz już:
Przypominamy, że od 29.06.2020 udostępniliśmy parametr globalny numer jednostki handlowej tzw. GTIN. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru.
Za pomocą GET /sale/offers/unfilled-parameters sprawdzisz brakujące parametry w ofertach. Zgodnie z wcześniejszą zapowiedzią dodaliśmy dziś filtr parameterType, dzięki któremu sprecyzujesz, jaki typ parametrów chcesz otrzymasz w odpowiedzi:
Informację o nowym filtrze dodaliśmy także w naszym poradniku.
Zgodnie z wcześniejszą zapowiedzią przypominamy, że od 12.01.2021 nie skorzystasz z mapowania numerów aktów zakupowych za pomocą GET /order/line-item-id-mappings.
Zasób może generować opóźnienia z uwagi na wzmożony ruch, dlatego zrezygnuj z niego możliwie najszybciej.
Zgodnie z wcześniejszą zapowiedzią przypominamy, że w dniu 11.01.2021 na środowisku produkcyjnym udostępnimy funkcjonalność tzw. scope’ów, czyli zakresów, które określają poziom uprawnień aplikacji do korzystania z API Allegro.
Aby ograniczyć dostęp aplikacji tylko do wybranych zasobów, podczas uzyskiwania autoryzacji musisz przekazać odpowiednie scope’y - każdy kolejny scope oddziel od siebie spacją (“%20”). Listę dostępnych scope’ów znajdziesz tu.
Od 11.01.2021 na środowisku produkcyjnym uzyskasz dostęp tylko do zasobów, których scope’y przekażesz w żądaniu. Jeśli na liście scope’ów w tokenie nie znajdzie się wymagany scope, to twoje zapytanie zostanie odrzucone z kodem błędu 403. Jeżeli nie podejmiesz żadnych kroków, to twoja aplikacja będzie za każdym razem autoryzować się z pełną listą scope’ów.
Dzięki wdrożeniu obsługi scope’ów zapewnisz wzrost bezpieczeństwa użytkowników, którzy korzystają z API Allegro oraz aplikacjom, które używają naszego API.
Więcej informacji o scope’ach znajdziesz w naszym poradniku.
5 stycznia 2021 przeprowadzimy kolejną aktualizację listy kategorii i parametrów na Sandboxie. Dzięki temu zadbamy o spójność między środowiskiem testowym i produkcyjnym.
Ważne! W związku z aktualizacją usuniemy wszystkie oferty z Sandboxa.
W 2019 roku wprowadziliśmy Katalog produktów Allegro w wybranych kategoriach serwisu. W ramach Katalogu produktów Allegro chcemy zebrać i opisać wszystkie produkty, jakie są dostępne w ofertach wystawianych przez wszystkich sprzedawców. Katalogujemy pojedyncze produkty jako reprezentatywne, które odróżniają się od innych swoimi właściwościami, np. modelem, kodem producenta, numerem GTIN, czy innymi parametrami podstawowymi.
Planujemy do końca 2021 roku skatalogować wszystkie oferty tam, gdzie to możliwe. W tym celu od 1 września 2020 roku wprowadziliśmy wymóg % ofert połączonych z produktem w kolejnych działach. Już teraz wymagamy, aby 1% ofert był powiązany z produktami w kategoriach:
W części powyższych kategorii sprzedawca nie musi wiązać oferty z produktem - ich listę znajdziesz w tym pliku.
Od 18 stycznia 2021 roku:
Chcemy umożliwić powiązanie ofert w jak największej liczbie kategorii Allegro, jednak specyfika sprzedawanych przedmiotów nie zawsze na to pozwala. Zapoznaj się z tym plikiem, aby sprawdzić, w jakich kategoriach działu Dziecko, Firma i usługi oraz Motoryzacja włączymy obowiązek 1% ofert połączonych z Katalogiem produktów Allegro.
Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to będzie mógł wystawić nową, podobną lub wznowić zakończoną ofertę, jeśli wskaże produkt dostępny w Katalogu lub doda nowy produkt na podstawie swojej oferty.
Więcej o tym, jak powiązać ofertę z produktem, przeczytasz w naszym poradniku. Zapoznaj się także z zasobem /sale/product-offers, dzięki któremu za pomocą jednego żądania POST wystawisz aktywną ofertę powiązaną z produktem:
Aby sprawdzić, które z ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers i parametru product.id.empty=true.
Więcej informacji na temat tej zmiany znajdziesz na stronie dla sprzedających.
Dzisiaj udostępniliśmy dwie nowe metody dostawy związane z odbiorem zużytego akumulatora. Identyfikatory nowych metod możesz uzyskać zasobem GET /sale/delivery-methods:
Więcej informacji na ten temat znajdziesz tutaj.
Usunęliśmy dzisiaj zasób /sale/categories/parameters/required-changes, dzięki któremu mogliście sprawdzić przyszłe uobowiązkowienia w parametrach. Zdecydowaliśmy się na taki krok, ponieważ chcemy, aby był spójny z istniejącymi dziennikami. W najbliższym czasie udostępnimy nowy zasób, o czym poinformujemy w osobnym komunikacie.
12.01.2021 wprowadzimy dodatkową walidację nagłówka Authorization. Jeżeli w swoich żądaniach:
w odpowiedzi zwrócimy kod 401 Unauthorized.
Upewnij się, że w swojej aplikacji prawidłowo przekazujesz ten nagłówek.
Od dziś, gdy skorzystasz z PATCH /sale/product-offers/{offer-id}, automatycznie zaktualizujemy w ofercie pola tecdocSpecification i compatibilityList, zgodnie z danymi występującymi w powiązanym produkcie.
Zmianę wprowadzamy po to, aby dane prezentowane w ofercie były najbardziej aktualne, a samo aktualizowanie oferty było możliwe najprostsze.
Jest to także pierwszy krok do zapowiadanej przez nas automatycznej aktualizacji danych w ofercie powiązanej z produktem. Dążymy do tego, że gdy zaktualizujemy dane produktu w katalogu, nie będzie konieczne kopiowanie czy akceptowanie zmian w ofercie, jeśli nie przekażesz własnych wartości.
Więcej o PATCH /sale/product-offers/{offer-id} przeczytasz w naszym poradniku.
18 stycznia 2021 roku zmienimy maksymalną długość parametrów GTIN z dotychczasowych 18 na 14 znaków.
W zależności od kategorii, zmiana będzie dotyczyć parametrów:
Gdy skorzystasz z GET /sale/categories/{categoryId}/parameters i GET /sale/categories/{categoryId}/product-parameters, dla każdego z parametrów GTIN zwrócimy inną niż dotychczas informację w polu restrictions.maxLength:
{
…
“restrictions”: {
“minLength”: 8,
“maxLength”: 14,
…
}
…
}
Dzięki tej zmianie uspójnimy maksymalną i rzeczywiście walidowaną przez nas długość parametru GTIN. Dopuszczalna długość GTIN to 8, 10, 12, 13 lub 14 znaków.
Zgodnie z wcześniejszą zapowiedzią przypominamy, że od 12 grudnia 2020 przestaniemy wspierać wersję beta.v1 zasobów:
Od 12 listopada 2020 możesz skorzystać z wersji beta.v2 tych zasobów. Wystarczy, że przekażesz w nagłówkach Content-Type oraz Accept wartość “application/vnd.allegro.beta.v2+json”.
W wersji beta.v2 wdrożyliśmy wzorzec asynchronicznego API - upewnij się, czy dobrze go obsługujesz. Więcej informacji o sposobie działania zasobów /sale/product-offers w nowej wersji znajdziesz w naszym poradniku:
Od 12.01.2021 nie skorzystasz z mapowania numerów aktów zakupowych za pomocą GET /order/line-item-id-mappings. Umożliwia on mapowanie dealId i lineItemId pomiędzy WebAPI oraz REST API Allegro.
Wyłączymy ten zasób ze względu na całkowite wygaszenie WebAPI Allegro. Ostatnie metody, które korzystały z dealId wyłączyliśmy 13 stycznia 2020 roku.
Zasób aktualnie może generować opóźnienia z uwagi na wzmożony ruch, dlatego zrezygnuj z niego możliwie najszybciej.
Wprowadziliśmy zmianę, dzięki której w trakcie wystawiania lub edycji oferty możesz zasugerować własne parametry wraz z wartościami we wszystkich kategoriach serwisu. Dodatkowo, możesz dodać własne wartości wybranych parametrów, które wyświetlimy na stronie oferty. Tę opcję udostępniamy dla wybranych parametrów, których listę znajdziesz tutaj.
Zadbaj o obsługę własnych parametrów i wartości w swojej aplikacji - będzie to mieć istotny wpływ na kształt filtrów w Allegro. Propozycje własnych parametrów zbierzemy i zweryfikujemy, a w wybranych przypadkach przeniesiemy je do standardowych parametrów, które są widoczne na filtrach. Sprzedającym często zależy też, aby ich marki były widoczne w filtrach wyszukiwania, dlatego najbardziej popularne własne wartości dodamy do listy dostępnych wartości w filtrze.
Własne parametry, wraz z określoną wartością, dodasz, gdy wystawiasz lub edytujesz ofertę. Funkcjonalność udostępniliśmy we wszystkich kategoriach.
Przykładowa struktura, jak dodać własny parametr:
{
…
“parameters”: […],
“customParameters”: [
{
“name”: “Nazwa twojego własnego parametru”,
“values”: [
“Wartość własnego parametru”
]
}
],
“description”: {…},
…
}
Własne wartości wprowadzisz dla wybranych parametrów posiadających wartość niejednoznaczną. Wartości niejednoznaczne parametru to np. “inne”, “pozostałe”. Identyfikator takiej wartości zwracamy w polu ambiguousValueId w sekcji options w odpowiedzi dla GET /sale/categories/{categoryId}/parameters.
Na ten moment możesz wprowadzić własną wartość w wybranych parametrach. Informację o tym, czy dany parametr obsługuje tę funkcjonalność, sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters w polu customValuesEnabled w sekcji options.
Skorzystaj z tej opcji, gdy wystawiasz lub edytujesz ofertę i jako wartość parametru wybierasz np. “Inny”. Dzięki temu na ofercie (w nawiasie) widoczna będzie prawidłowa, wpisana przez Ciebie wartość parametru, która – jeśli zyska popularność – będzie mogła znaleźć się też na filtrach.
W przyszłości uzupełnienie wartości będzie obowiązkowe, jeśli wybierzesz wartość niejednoznaczną w ramach danego parametru. W przypadku, gdy tworzysz nowy produkt i wybierzesz wartość niejednoznaczną zawsze wymagamy wprowadzenia własnej wartości.
Przykładowa struktura, jak dodać własną wartość parametru:
{
…
{
“id”: “129033”, – ID parametru
“valuesIds”: [
“129033_13” – ID wartości niejednoznacznej
],
“values”: [ “Nazwa brakującej marki” ], – wartość, którą chcesz przekazać,
uzupełnij to pole.
“rangeValue”: null
}
…
}
Więcej informacji o własnych parametrach i wartościach znajdziesz w naszym poradniku:
oraz na stronie dla sprzedających.
W odpowiedzi na wasze sugestie dodaliśmy dzisiaj dwa nowe zasoby, które ułatwią sprzedającym zarządzanie ofertami:
curl -X GET
‘https://api.allegro.pl/sale/offers/unfilled-parameters?offer.id=123456789
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
{
“offers”: [
{
“id”: “123456789”, – ID oferty
“parameters”: [ – informacje o nieuzupełnionych parametrach
{
“id”: “14228” – ID parametru
}
],
“category”: {
“id”: “257931” – ID kategorii, w której występuje parametr
}
}
],
“count”: 1, – liczba wyświetlanych wyników
“totalCount”: 1 – łączna liczba wyników
}
curl -X GET
‘https://api.allegro.pl/sale/categories/parameters/required-changes
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
{
“changes”: [
{
“category”: {
“id”: “1521” – ID kategorii, w której włączymy
obowiązkowość parametru
},
“parameter”: {
“id”: “219809” – ID parametru, który oznaczymy
jako obowiązkowy
},
“scheduledAt”: “2021-02-19T23:00:00Z” – data, kiedy parametr oznaczymy
jako obowiązkowy
},
…
]
“count”: 10, – liczba wyświetlanych wyników
“totalCount”: 10 – łączna liczba wyników
}
Dzięki wprowadzonym zasobom sprzedawca będzie mógł szybciej zareagować na zmiany na naszej platformie, dzięki czemu uniknie problemów związanych np. ze zmianą liczby sztuk w ofertach, w których nie są uzupełnione obowiązkowe parametry.
Informacje o nowych zasobach dodaliśmy także w naszym poradniku.
Zgodnie z zapowiedzią na stronie dla sprzedających wprowadziliśmy dzisiaj zmiany w opcjach promowania ofert:
Dzięki temu sprzedawca może łatwiej zarządzać opcjami promowania ofert - szybciej zareaguje na zmiany w sprzedaży, a swoje oferty wypromuje tylko wtedy, gdy uzna to za opłacalne. Więcej informacji o zmianach w promowaniu ofert znajdziesz na naszej stronie dla sprzedających.
W związku ze zmianami udostępniliśmy nowe zasoby API do zarządzania promowaniem:
Poniżej znajdziesz nazwy pakietów promowania w API, które przygotowaliśmy dla nowych zasobów. Są to trzy pakiety wyróżnień oraz jedna opcja dodatkowa:
Zmiany nie mają wpływu na model oferty. Nadal zmienisz opcję promowania za pomocą dotychczasowego API - tak jak do tej pory, zmianę wykonamy natychmiast.
Więcej informacji o tym, jak zarządzać promowaniem, znajdziesz w naszym poradniku.
Od dzisiaj łatwiej dodasz numer przesyłki do zamówienia. Już nie musisz podawać kolejnych lineItems.id wchodzących w skład zamówienia. Wystarczy, że skorzystasz z POST /order/checkout-forms/{id}/shipments i przekażesz w żądaniu wymagane wartości (carrierId oraz waybill), a my przypiszemy numer przesyłki do każdego lineItem.id z zamówienia.
Przykładowy request:
curl -X POST \
https://api.allegro.pl/order/checkout-forms/31896452-2de1-11e9-bced-352ab82ad9cd/shipments
-H ‘Authorization: Bearer {token}’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
-H ‘Accept: application/vnd.allegro.public.v1+json’
-d ‘{
“waybill”: “12345678910PL”,
“carrierId”: “DHL”
}’Przykładowy response:
{
“waybill”: “12345678910PL”,
“carrierId”: “DHL”,
“lineItems”: [
{
“id”: “31896450-2de1-11e9-bced-352ab82ad9cd”
},
{
“id”: “5b1f4a62-6969-11e8-b090-8b2d9f391430”
}
],
“createdAt”: “2020-10-27T11:46:48.264Z”,
“id”: “REhMOjEyMzQ1Njc4OTEwUEw=”
}
Od dziś możesz skorzystać z wersji beta.v2 zasobów:
W wersji beta.v2 wdrożyliśmy wzorzec asynchronicznego API ze względu na dłuższy czas wykonania niektórych operacji po stronie platformy Allegro, takich jak np. zmiany statusu publikacji oferty.
Ważne! Wersję beta.v1 wyłączymy 12 grudnia 2020 roku.
Aby skorzystać z wersji beta.v2 wystarczy, że przekażesz w nagłówkach Content-Type oraz Accept wartość “application/vnd.allegro.beta.v2+json”.
W wersji beta.v2 w odpowiedzi na prawidłowe żądanie na zasobie /sale/product-offers otrzymasz jeden z trzech statusów:
Wraz ze statusem 202 Accepted zwrócimy w odpowiedzi nagłówek Location, w którym znajdziesz odnośnik do nowego zasobu w postaci: /sale/product-offers/{offerId}/operations/{operationId}. Odpytaj go metodą GET, aby sprawdzić status zadania. W odpowiedzi zwrócimy jeden z dwóch statusów:
Więcej informacji o nowym sposobie działania zasobów /sale/product-offers znajdziesz w naszym poradniku:
Od dziś dodasz rabat na duże zamówienie do swoich ofert. Dzięki niemu zaoferujesz kupującym rabat podczas transakcji B2B (firma - firma). Aby dodać rabat, skorzystaj z POST /sale/loyalty/promotions i określ progi wartościowe pojedynczego zamówienia oraz przypadający dla nich rabat procentowy. Rabatem zostaną objęte wszystkie twoje oferty.
Przykładowy request:
curl -X POST
‘https://api.allegro.pl/sale/loyalty/promotions'
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
-H ‘Authorization: Bearer {token}’
-d ‘{
“benefits”: [
{
“specification”: {
“type”: “LARGE_ORDER_DISCOUNT”, – typ promocji (lista dostępnych wartości
znajduje się w dokumentacji zasobu)
“thresholds”: [ – progi rabatowe
{
“orderValue”: {
“lowerBound”: {
“amount”: “1000.00”, – wartość zamówienia
“currency”: “PLN”
}
},
“discount”: {
“percentage”: “5” – wysokość rabatu (%)
}
},
{
“orderValue”: {
“lowerBound”: {
“amount”: “1500.00”,
“currency”: “PLN”
}
},
“discount”: {
“percentage”: “8”
}
}
]
}
}
],
“offerCriteria”: [
{
“type”: “ALL_OFFERS” – rabatem zostaną objęte
} wszystkie oferty
]
}’W odpowiedzi otrzymasz identyfikator utworzonego rabatu.
Przykładowy response:
{
“id”: “ba01f101-c9ef-4e5d-a88f-efb721bdbb9a”, – identyfikator rabatu
“createdAt”: “2020-10-27T06:31:29.36Z”, – data utworzenia
“benefits”: [
{
“specification”: {
“thresholds”: [
{
“orderValue”: {
“lowerBound”: {
“amount”: “1000.00”,
“currency”: “PLN”
}
},
“discount”: {
“percentage”: “5”
}
},
{
“orderValue”: {
“lowerBound”: {
“amount”: “1500.00”,
“currency”: “PLN”
}
},
“discount”: {
“percentage”: “8”
}
}
],
“type”: “LARGE_ORDER_DISCOUNT”
}
}
],
“offerCriteria”: [
{
“type”: “ALL_OFFERS”
}
]
“status”: “ACTIVE”
}Więcej informacji o rabacie na duże zamówienie i zasobach do zarządzania nim znajdziesz w naszym poradniku.
W nawiązaniu do wcześniejszej zapowiedzi, opcję edycji adresu dostawy w zamówieniu udostępnimy kupującym w styczniu 2021. Decyzję o zmianie terminu wdrożenia podjęliśmy z uwagi na wydłużenie czasu niezbędnego na implementację rozwiązania w integracjach.
W odpowiedzi na wasze sugestie dodaliśmy w:
obsługę dwóch kolejnych atrybutów oferty: wysokość stawki podatku VAT i czas trwania oferty. Atrybuty te ustawisz w ofercie, jeśli w strukturze żądania zadeklarujesz pola:
Więcej informacji na temat nowych pól znajdziesz w naszym poradniku.
W dniu dzisiejszym dodaliśmy sekcję sizeTable w strukturze żądania POST /sale/product-offers oraz PATCH /sale/product-offers/{offerId}. Dzięki niej dodasz do oferty zdefiniowaną tabelę rozmiarów. Tak jak w przypadku pozostałych pól w tych zasobach - możesz wskazać nazwę lub identyfikator tabeli rozmiarów.
Więcej informacji na temat nowej sekcji znajdziesz w naszym poradniku.
16.11.2020 planujemy wdrożyć kolejny etap obsługi parametrów zależnych - warunkową obowiązkowość i wyświetlanie. Więcej o parametrach zależnych przeczytacie w naszym wcześniejszym komunikacie. Dzięki parametrom zależnym uprościmy nawigację, a kupujący będą mogli porównywać między sobą oferty znajdujące się dotąd w różnych kategoriach. Dodatkowo sprzedawcy będą mogli dodawać do ofert kompletne i adekwatne informacje, które będą odpowiadały charakterowi sprzedawanego produktu. Dzięki temu kupujący skuteczniej znajdzie dobrze opisane oferty.
Warunkowa obowiązkowość oznacza, że wymagalność danego parametru uzależniona jest od wartości wybranej dla parametru warunkującego np. jeżeli sprzedawca wybierze w parametrze “Stan” wartość “Nowy”, wtedy powinien też wiedzieć, jaka jest wartość parametru “Kod producenta”, dlatego oznaczymy go jako obowiązkowy. Jeżeli wybierze wartość “Używany”, wtedy parametr “Kod producenta” będzie opcjonalny, na wypadek gdyby produkt miał np. wytartą metkę.
Warunkowa widoczność oznacza, że wyświetlenie danego parametru uzależnione jest od wartości wybranej dla parametru warunkującego np. jeżeli w kategorii “Mydła” (258383) sprzedawca wybierze w parametrze “Rodzaj” wartość “Kostka”, wyświetlimy wtedy parametr “Waga”, a “Pojemność” ukryjemy. Z kolei, gdyby wybrał wartość “Płyn” lub “Pasta”, wtedy nastąpi odwrotna sytuacja - ukryjemy parametr “Waga”, a pokażemy “Pojemność”.
W związku z tym, dla GET /sale/categories/{categoryId}/parameters dodaliśmy nowe pola:
Na stronie dla sprzedających znajdziesz listę pierwszych kategorii i parametrów, dla których wprowadzimy warunkową obowiązkowość i wyświetlanie.
Przykładowa struktura odpowiedzi:
{
“parameters”: [
{
“id”: “202877”,
“name”: “Liczba rdzeni procesora”,
“type”: “integer”,
“required”: false,
“requiredForProduct”: false,
“unit”: null,
“options”: {
“variantsAllowed”: true,
“variantsEqual”: false,
“ambiguousValueId”: null,
“dependsOnParameterId”: “202870”,
“requiredDependsOnValueIds”: [
“202870_1”
],
“displayDependsOnValueIds”: [
“202870_1”,
“202870_2”
],
“describesProduct”: false
},
“restrictions”: {
“min”: 0,
“max”: 1000000,
“range”: false
}
}
]
}
W dniu dzisiejszym, obok wcześniej zaprezentowanego przez nas zasobu POST /sale/product-offers, udostępniliśmy nowy zasób PATCH /sale/product-offers/{offer-id}, dzięki któremu edytujesz swoją ofertę w prosty sposób - zmienisz dowolne pole oferty, a jednocześnie nie musisz przekazywać całego jej modelu.
Jeżeli skorzystasz z PATCH /sale/product-offers/{offer-id} i nie podasz wartości pola - w ofercie pozostawimy dotychczasową jego wartość i zmienimy tylko te, w których przekażesz wartość inną niż dotychczas. Z kolei, gdy przekażesz wartość null - usuniemy z oferty wartość pola, o ile pole nie jest wymagane.
Dzięki takiemu podejściu edytujesz niezależnie dowolne pole w ofercie, m.in:
Przy edycji chcieliśmy zapewnić te same udogodnienia, które przy tworzeniu ofert daje POST /sale/product-offers, dlatego dzięki PATCH /sale/product-offers/{offer-id} m.in. możesz zmienić status oferty bez konieczności wywoływać osobnej komendy publikacji, czy też dodać do oferty zdjęcia bezpośrednio z zewnętrznych serwerów.
Więcej informacji na temat PATCH /sale/product-offers/{offer-id} znajdziesz w naszym poradniku.
Dzisiaj w modelu oferty udostępniliśmy nową sekcję discounts, w której zwracamy informacje o zniżkach przypisanych do oferty. Obecnie, w sekcji znajdziesz identyfikator cennika hurtowego dodanego do oferty. W przypadku jego braku zwrócimy wartość null.
Model oferty po zmianie:
…
“discounts”: {
“wholesalePriceList”: {
“id”: “5637592a-0a24-4771-b527-d89b2767d821”
}
},
…Dzięki zmianie możesz w prosty sposób dodać cennik hurtowy podczas wystawiania lub edycji oferty.
Więcej informacji o cennikach hurtowych znajdziesz w naszym poradniku.
Dzisiaj na środowisku testowym (allegro.pl.allegrosandbox.pl) udostępniliśmy funkcjonalność tzw. scope’ów, czyli zakresów określających poziom uprawnień aplikacji do korzystania z API Allegro. Każdy scope ma przypisany zestaw uprawnień, który definiuje:
Dotychczas, każda z aplikacji zarejestrowanych na stronie Zarządzanie aplikacjami Allegro Sandbox prosiła o dostęp do wszystkich dostępnych w API Allegro scope’ów. Od dzisiaj możesz wystąpić tylko o te scope’y, które faktycznie są niezbędne do prawidłowego funkcjonowania aplikacji. Aby ograniczyć dostęp aplikacji tylko do wybranych zasobów, podczas uzyskiwania autoryzacji musisz przekazać odpowiednie scope’y - każdy kolejny scope oddziel od siebie spacją (“%20”). Listę dostępnych scope’ów znajdziesz tu.
Przykładowy request pozwalający na dostęp aplikacji tylko do zasobów do zarządzania ofertami oraz odczytu zamówień:Od dnia 11.01.2021 na środowisku produkcyjnym uzyskasz dostęp tylko do zasobów, których scope’y przekażesz w żądaniu. Jeśli na liście scope’ów w tokenie nie znajdzie się wymagany scope, to twoje zapytanie zostanie odrzucone z kodem błędu 403.
Dlatego już dzisiaj rozpocznij prace nad prawidłową obsługą scope przez twoje oprogramowanie. Jeżeli nie podejmiesz żadnych kroków, to twoja aplikacja będzie za każdym razem autoryzować się z pełną listą scope’ów - wyświetlimy je użytkownikowi na ekranie zgody (consent screen) podczas potwierdzania połączenia aplikacji z kontem użytkownika oraz na liście aplikacji w zakładce Powiązane aplikacje. Korzystaj wyłącznie z niezbędnych scope’ów - dzięki temu ograniczysz liczbę pytań od użytkowników oraz odrzuconych powiązań aplikacji. Dzięki wdrożeniu obsługi scope’ów zapewnisz wzrost bezpieczeństwa użytkowników, którzy korzystają z API Allegro oraz aplikacjom, które używają naszego API.
Więcej informacji o scope’ach znajdziesz w naszym poradniku.
Do tej pory, tworząc ofertę z produktu, łączyliśmy przekazany w żądaniu opis z opisem produktowym. W odpowiedzi na wasze sugestie, od teraz opis produktowy zaprezentujemy w ofercie, tylko gdy nie podasz własnego opisu w sekcji description.
Więcej informacji na temat POST /sale/product-offers znajdziesz w naszym poradniku.
06.10.2020 o godzinie 07:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 1 godziny. Przepraszamy za niedogodności.
W drugiej połowie października udostępnimy kupującym możliwość zmiany adresu dostawy w zamówieniu. Klient będzie mógł zmienić dane dla zamówienia w statusie READY FOR PROCESSING, jeśli np. wcześniej podał nieprawidłowe informacje. Podobnie jak w przypadku anulowania zamówienia, będą musiały zostać spełnione odpowiednie warunki:
Funkcjonalność udostępniliśmy już dzisiaj w naszym środowisku testowym. W związku z tym dla:
Aby zmienić adres dostawy jako kupujący, wejdź w szczegóły zakupu w zakładce Kupione i wybierz “Zmień” pod danymi odbiorcy.
Dzisiaj w Allegro udostępniliśmy nowe zgody, którymi możesz zarządzać w zakładce Zgody na powiadomienia. Dzięki temu zdecydujesz, które powiadomienia o twoich ofertach są ci potrzebne do pracy. Nowe zgody:
są domyślnie wyłączone na koncie firmowym. Możesz to zmienić w zakładce Zgody na powiadomienia.
Szczegółowe informacje o zmianie znajdziesz w aktualnościach Allegro.
24.09.2020 o godzinie 07:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 1 godziny. Przepraszamy za niedogodności.
Od początku 2019 roku tworzymy rozwiązania, które pomagają powiązać przedmioty z ofert na Allegro z produktami w naszej bazie. Dzięki temu możesz wystawiać swoje oferty szybciej, a kupujący łatwiej odnajdują interesujące ich przedmioty. Planujemy, aby w 2021 roku wszystkie oferty w wybranych kategoriach były połączone z naszą bazą.
Już teraz wymagamy, aby 1% ofert był powiązany z produktami w:
Od 14 października zaczniemy wymagać 1% ofert powiązanych z produktami w kolejnych działach:
W części kategorii nie będziemy tego wymagać - ich listę znajdziesz w tym pliku.
Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to w tych kategoriach (z wyłączeniem kategorii z pliku) nie będzie mógł wystawić nowej oferty, jeśli obecnych nie powiąże z produktem.
Więcej o tym, jak powiązać ofertę z produktem, przeczytasz w naszym poradniku. Zapoznaj się także z nowym zasobem POST /sale/product-offers, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:
Udostępniliśmy dziś nowy zasób GET /sale/matching-categories, za pomocą którego po podaniu frazy pobierzesz sugerowaną listę kategorii, w których możesz wystawić swój przedmiot. Dzięki temu łatwiej i szybciej zidentyfikujesz odpowiednią kategorię.
W żądaniu przekaż parametr name i podaj w nim wyszukiwaną frazę, np. name=bmw x3. W odpowiedzi otrzymasz listę sugerowanych kategorii.
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/sale/matching-categories?name=bmw x3’
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
Przykładowy response:
{
“matching_categories”: [
{
“id”: “250885”, – identyfikator sugerowanej kategorii.
“name”: “Wahacze”, – nazwa sugerowanej kategorii.
“parent”: { – kategoria nadrzędna w stosunku do
sugerowanej kategorii:
dzięki tej strukturze poznasz dokładną
ścieżkę sugerowanej kategorii.
“id”: “250882”, – identyfikator kategorii nadrzędnej.
“name”: “Wahacze i elementy”, – nazwa kategorii nadrzędnej.
“parent”: {
“id”: “8683”,
“name”: “Układ zawieszenia”,
“parent”: {
“id”: “620”,
“name”: “Części samochodowe”,
“parent”: {
“id”: “3”,
“name”: “Motoryzacja”,
“parent”: null
}
}
}
}
},
…
{
“id”: “255100”,
“name”: “Lampy przeciwmgielne”,
“parent”: {
“id”: “255098”,
“name”: “Lampy przednie i elementy”,
“parent”: {
“id”: “623”,
“name”: “Oświetlenie”,
“parent”: {
“id”: “620”,
“name”: “Części samochodowe”,
“parent”: {
“id”: “3”,
“name”: “Motoryzacja”,
“parent”: null
}
}
}
}
}
]
}Udostępniliśmy dziś nowy zasób GET /sale/compatibility-list-suggestions, za pomocą którego pobierzesz sugerowaną sekcję Pasuje do. Skorzystaj z tego zasobu, gdy nie posiadasz listy kompatybilności w ofercie. Dzięki uzupełnionej sekcji kupujący łatwiej odnajdzie interesujący go produkt. Sugestie tworzymy na podstawie list komptybilności ofert innych sprzedających. Listę możesz modyfikować według własnych potrzeb, np. usunąć lub dodać niektóre z pozycji.
Przekaż w żądaniu jeden z parametrów, na podstawie którego zwrócimy sugerowaną sekcję Pasuje do:
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/sale/compatibility-list-suggestions?offer.id=6505550901'
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
Przykładowy response:
{
“type”: “MANUAL”,
“items”: [
{
“type”: “ID”,
“id”: “73ff4bae-958d-4b75-a49c-d0c11fdd233c”,
“text”: “Toyota AVENSIS (T22) 2.0 VVT-i (AZT220_) (1AZ-FSE) 1998ccm 150KM/110kW 2000⁄10-2003⁄02”,
“additionalInfo”: []
},
{
“type”: “ID”,
“id”: “de7a2247-78fa-4a12-94f1-f43b5f33ac7e”,
“text”: “Toyota AVENSIS (T22) 2.0 TD (CT220_) (2C-TE) 1975ccm 90KM/66kW 1997⁄09-2003⁄02”,
“additionalInfo”: []
}
]
}
Listę, którą otrzymasz, możesz następnie przekazać, gdy wystawiasz lub edytujesz ofertę.
Od dziś dodasz cenniki hurtowe do ofert. Dzięki nim zaoferujesz rabat podczas transakcji B2B (firma - firma). Aby utworzyć cennik hurtowy, skorzystaj z POST /sale/loyalty/promotions i określ progi ilościowe oraz przypadający dla nich rabat procentowy.
Przykładowy request:
curl -X POST
‘https://api.allegro.pl/sale/loyalty/promotions'
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
-H ‘Authorization: Bearer {token}’
-d ‘{
“benefits”: [
{
“specification”: {
“type”: “WHOLESALE_PRICE_LIST”, – typ promocji (lista dostępnych
wartości znajduje się w dokumentacji zasobu)
“name”: “Cennik hurtowy nr 1”, – nazwa cennika
“thresholds”: [ – progi rabatowe
{
“quantity”: { – minimalna liczba
“lowerBound”: 5 zakupionych przedmiotów
},
“discount”: { – wysokość rabatu (%)
“percentage”: “5”
}
},
{
“quantity”: {
“lowerBound”: 10
},
“discount”: {
“percentage”: “8”
}
}
]
}
}
],
“offerCriteria”: [
{
“type”: “OFFERS_ASSIGNED_EXTERNALLY” – oferty przypiszesz za pomocą
} PUT /sale/offer-modification-commands/{commandId}
]
}’
W odpowiedzi otrzymasz identyfikator utworzonego cennika.
Przykładowy response:
{
“id”: “9de4be5d-9c60-48aa-8711-363625c9d793”, – identyfikator cennika
“createdAt”: “2020-08-13T06:08:06.011Z”, – data utworzenia
“benefits”: [
{
“specification”: {
“name”: “Cennik hurtowy nr 1”,
“thresholds”: [
{
“quantity”: {
“lowerBound”: 5
},
“discount”: {
“percentage”: “5”
}
},
{
“quantity”: {
“lowerBound”: 10
},
“discount”: {
“percentage”: “8”
}
}
],
“type”: “WHOLESALE_PRICE_LIST”
}
}
],
“offerCriteria”: [
{
“type”: “OFFERS_ASSIGNED_EXTERNALLY”
}
],
“status”: “ACTIVE”
}
Utworzony cennik hurtowy przypiszesz do wybranych ofert za pomocą zasobu do grupowych zmian w ofercie - PUT /sale/offer-modification-commands/{commandId}.
Przykładowy request:
curl -X PUT
‘https://api.allegro.pl/sale/offer-modification-commands/daccd266-fa5e-4a6b-a10b-d24836c411e1'
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
-d ‘{
“modification”: {
“discounts”: { – typ zmiany
“wholesalePriceList”: {
“id”: “9de4be5d-9c60-48aa-8711-363625c9d793” – identyfikator cennika
}
}
},
“offerCriteria”: [
{
“offers”: [
{
“id”: “9292002929” – identyfikator oferty
},
{
“id”: “9876543210”
}
],
“type”: “CONTAINS_OFFERS”
}
]
}’
Ważne! Obecnie informacji o przypisanym cenniku hurtowym do oferty nie otrzymasz w odpowiedzi dla GET /sale/offers/{offerId}.
Więcej informacji o cennikach hurtowych i zasobach do zarządzania nimi znajdziesz w naszym poradniku.
Dzisiaj dla GET /sale/offers udostępniliśmy nowe opcje filtrowania według:
Przykładowo, jeśli chcesz wyszukać oferty, które należą do kategorii 260660, nie posiadają przypisanego produktu, a muszą spełnić wymaganie powiązania z produktem, wystarczy, że wywołasz:
GET /sale/offers?category.id=260660&product.id.empty=true&productizationRequired=true
Zgodnie z waszymi sugestiami od dzisiaj podczas wywoływania poniższych zasobów nie musicie już przekazywać parametru:
Jeżeli w swoim wywołaniu nadal przekażesz parametr user.id lub seller.id, to zwrócimy również poprawną odpowiedź.
Udostępniliśmy dziś nowe, bezpłatne narzędzie, które ułatwia zarządzanie przesyłkami - Wysyłam z Allegro. Sprzedawcy mogą utworzyć w nim i wydrukować etykiety oraz zamówić odbiór paczek przez przewoźników ze wskazanego adresu. Numery przesyłek automatycznie dodamy do odpowiednich zamówień. Więcej na temat tego narzędzia przeczytasz na stronie dla sprzedających.
Na potrzeby nowej funkcjonalności przygotowaliśmy poradnik, w którym znajdziesz więcej szczegółów o zasobach API.
Ważne! Zanim skorzystasz z API Wysyłam z Allegro, powiąż swoje konto na stronie:
Udostępniliśmy dziś nowe pole customValuesEnabled w sekcji options odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Sprawdzisz w nim, czy dla parametru z wartością niejednoznaczną możesz przekazać własną wartość.
Wartości niejednoznaczne parametru to wartości typu: “inne”, “pozostałe”, etc. np. “inna” w parametrze “Marka”. Identyfikator takiej wartości zwracamy w polu ‘ambiguousValueId’ w sekcji options w odpowiedzi dla GET /sale/categories/{categoryId}/parameters.
W naszym poradniku znajdziesz wskazówki, jak dodać własną wartość dla parametru z wartością niejednoznaczną.
Zgodnie z waszymi sugestiami od dziś w GET /offers/listing możecie wyszukać oferty danego sprzedawcy po jego loginie. Dotychczas można było wyszukać oferty danego sprzedawcy tylko po jego identyfikatorze.
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/offers/listing?seller.login=Allegro'
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
03.09.2020 o godzinie 19:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 1 godziny. Przepraszamy za niedogodności.
Zgodnie z wcześniejszą zapowiedzią usunęliśmy dziś metody dostawy:
Udostępniliśmy nowy sposób autoryzacji - Dynamic Client Registration. Jest to rozszerzenie standardu OAuth2 umożliwiające tworzenie instancji twojej aplikacji w sposób zautomatyzowany. Jeżeli klient bezpośrednio instaluje kopię twojego oprogramowania (np. instancję platformy sklepowej we własnej infrastrukturze), to ten typ autoryzacji jest właśnie dla ciebie. Zapewnia on pełne bezpieczeństwo autoryzacji danych, a jednocześnie nie wymusza na każdym kliencie ręcznego generowania osobnych danych dostępowych (client ID oraz client secret).
Szczegółowe informacje o DCR znajdziesz w naszym poradniku.
W odpowiedzi dla POST /sale/offers dodaliśmy nowe pole “warnings” w sekcji validation. Informujemy w nim, czy w opisie oferty znajdują się treści, które mogą naruszać zasady obowiązujące w Allegro. Frazy, które mogą spowodować, że wyświetlimy komunikat, to np.:
Ważne! Nadal prawidłowo wystawisz ofertę, dla której zwrócimy informacje w polu warnings.
Wprowadziliśmy to pole, ponieważ zależy nam, aby sprzedawcy już na pierwszym etapie, gdy tworzą nową ofertę, mogli zwrócić uwagę na problematyczne treści. Komunikat pozwoli sprzedawcom uniknąć dalszych sankcji podejmowanych przez Allegro, jeśli wystawią nieregulaminową ofertę - wystarczy, że wykonają w niej stosowne zmiany.
Przykładowa struktura odpowiedzi:
{
“validation”: {
“errors”: [],
“warnings”: [
{
“code”: “VALIDATION_WARNING”,
“message”: “Wystawiany przedmiot znajduje się w wykazie produktów leczniczych, środków spożywczych specjalnego przeznaczenia żywieniowego oraz wyrobów medycznych zagrożonych brakiem dostępności na terytorium Rzeczypospolitej Polskiej. Jeżeli zdecydujesz się wysłać go za granicę masz obowiązek powiadomienia o tym fakcie Główny Inspektorat Farmaceutyczny. Musi to nastąpić przed zamiarem wywozu lub zbycia produktu poza terytorium Rzeczypospolitej Polskiej.”,
“details”: “”,
“path”: “”,
“userMessage”: “Wystawiany przedmiot znajduje się w wykazie produktów leczniczych, środków spożywczych specjalnego przeznaczenia żywieniowego oraz wyrobów medycznych zagrożonych brakiem dostępności na terytorium Rzeczypospolitej Polskiej. Jeżeli zdecydujesz się wysłać go za granicę masz obowiązek powiadomienia o tym fakcie Główny Inspektorat Farmaceutyczny. Musi to nastąpić przed zamiarem wywozu lub zbycia produktu poza terytorium Rzeczypospolitej Polskiej.”
}
],
“validatedAt”: “2017-11-08T18:03:39.68Z”
}
}Od dziś, gdy wystawiasz lub edytujesz ofertę, dodasz swój własny parametr. Dzięki temu opisy ofert będą bardziej precyzyjne, a kupujący łatwiej podejmie decyzję o zakupie. Propozycje własnych parametrów zbierzemy i zweryfikujemy, a w przyszłości przeniesiemy je do standardowych parametrów.
{
…
“parameters”: […],
“customParameters”: [
{
“name”: “Nazwa twojego własnego parametru”,
“values”: [
“Wartość własnego parametru”
]
}
],
“description”: {…},
…
}
{
…
“parameters”: […],
“customParameters”: [
{
“name”: “Nazwa twojego własnego parametru”,
“values”: [
“Wartość własnego parametru”
]
}
],
“description”: {…},
…
}
Wyłączymy WebAPI:
Terminy zaktualizowaliśmy, ponieważ od października w WebAPI nie pozostaną już żadne metody, które uzasadniałyby jego dłuższe utrzymywanie.
26.10.2020 wyłączymy także metody do:
Z powodu niskiego użycia, nie będziemy dodawać ich odpowiedników w REST API. Aktualne ustawienia danych do wypłat możesz sprawdzić w Moim Allegro. Jeśli chcesz otrzymywać codziennie wypłaty, wystarczy, że ustawisz automatyczny sposób wypłat.
30.07.2020 o godzinie 9:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 2 godzin. Przepraszamy za niedogodności.
Wypełnij ankietę o produktyzacji w Allegro. Chcemy dowiedzieć się, na jakim etapie wdrożenia produktyzacji jesteś oraz które kwestie są dla Ciebie najbardziej problematyczne. Na końcu ankiety znajdziesz pytanie otwarte, w którym możesz podzielić się swoimi sugestiami na temat tej funkcjonalności.
Link do ankiety - kliknij tu.
18.08.2020 usuniemy metody dostawy:
Od 04.08.2020, gdy stworzysz lub zmienisz cennik dostawy, który zawiera jedną z tych metod, otrzymasz status 422 wraz z odpowiednią treścią błędu:
“errors”: [
{
“code”: “DEPRECATED_DELIVERY_METHOD”,
“message”: “Kurier wieczór pobranie is deprecated.”,
“details”: null,
“path”: “rates[5].deliveryMethod.id”,
“userMessage”: “Metoda dostawy \“Kurier wieczór pobranie\” nie jest już dostępna.”
},
{
“code”: “DEPRECATED_DELIVERY_METHOD”,
“message”: “Kurier wieczór is deprecated.”,
“details”: null,
“path”: “rates[10].deliveryMethod.id”,
“userMessage”: “Metoda dostawy \“Kurier wieczór\” nie jest już dostępna.”
}
]
Od dziś możesz przekazać wiele wartości dla filtrów w GET /order/checkout-forms:
Więcej informacji o filtrach dla zamówień znajdziesz w naszym poradniku.
Umożliwiliśmy grupową edycję stawki podatku VAT w ofertach. Aby ją zmienić skorzystaj z PUT /sale/offer-modification-commands/{commandId} i podczas grupowej zmiany podaj w polu:
Przykładowy request:
curl -X PUT
‘https://api.allegro.pl/sale/offer-modification-commands/{commandId}’
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
-d ‘{
“modification”: {
“payments”: {
“invoice”: “VAT”,
“tax”: {
“percentage”: “23.00”
}
},
},
“offerCriteria”:[
{
“type”:“CONTAINS_OFFERS”,
“offers”:[
{
“id”:“7531636067”
},
{
“id”:“7512439587”
}
]
}
]
}’
Dzięki zmianie w przyszłości zaprezentujemy kupującym w ofertach stawkę VAT i cenę netto produktu.
Ważne! Pamiętaj, że transakcję z kupującym zawierasz na podstawie ceny brutto. Obecnie cenę netto zwracamy w celach informacyjnych.
Parametry zależne na tę chwilę udostępniliśmy tylko w jednej kategorii - Klipsy (123428). Jeśli jako wartość parametru głównego (Materiał) wybierzesz:
20 lipca 2020 włączymy walidację parametrów zależnych. Oznacza to, że udostępnimy:
W przypadku, gdy wybierzesz błędny parametr zależny, zwrócimy stosowny błąd, przykładowo:
“Parametr zależny Próba złota nie może przyjąć wartości [999], gdy parametr Materiał ma wartości [Szkło, Stal].”Więcej informacji o parametrach zależnych znajdziesz w naszym komunikacie.
10.07.2020 o godzinie 9:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 2 godzin. Przepraszamy za niedogodności.
30.09.2020 wyłączymy następujące metody WebAPI:
Nie udostępnimy odpowiedników tych metod w REST API. Dotychczas dowolny podmiot, np. dowolny sprzedawca mógł pobierać i analizować dane o jakichkolwiek transakcjach zawieranych w serwisie przez każdego innego sprzedawcę. Przede wszystkim ze względu na wrażliwość tych informacji, zdecydowaliśmy się zmienić nasze podejście – od 1 października 2020 roku dane transakcyjne nie będą publicznie dostępne.
Ważne! Każdy sprzedawca na Allegro nadal będzie miał dostęp do danych o swojej sprzedaży - zarówno w narzędziach udostępnianych przez Allegro, jak i w zasobach API Allegro.
Informacje na temat ograniczenia dostępu do wrażliwych danych o transakcjach znajdziesz też na stronie dla sprzedających.
Zgodnie z wcześniejszą zapowiedzią dzisiaj udostępniliśmy parametr globalny numer jednostki handlowej tzw. GTIN. W większości kategorii oznaczyliśmy go jako parametr podstawowy, czyli taki, który identyfikuje produkt w ofercie. Jeżeli chcesz określić lub zmienić GTIN, w zależności od kategorii, skorzystaj z dostępnych parametrów:
Pamiętaj, że parametry dostępne w danej kategorii sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters.
GTIN w ofertach
W ofertach parametr GTIN jest nadrzędny wobec pola “ean”, którego wartości przenieśliśmy do nowego parametru. Wartość EAN, ISBN lub ISSN możesz uzupełnić jedynie w parametrze GTIN, aby to zrobić pobierz aktualny stan oferty poprzez GET /sale/offers/{offerId}, a następnie edytuj poprzez PUT /sale/offers/{offerId}. Jeśli spróbujesz zmienić wartość pola “ean” w ofercie, otrzymasz komunikat błędu: “Pole ean jest tylko do odczytu. Wartość z pola ean podaj w parametrze o id: {id}.”
Jeżeli dotychczas w integracji używasz pola “ean” by rozpoznać swoje oferty (jako sygnaturę), wykorzystaj w tym celu dedykowane dla sygnatury pole “external.id”.
GTIN w produktach
Parametr GTIN dla produktów funkcjonuje równolegle z dotychczasową tablicą “eans”. Aktualne wartości “eans” przenieśliśmy do nowego parametru. Zgłaszając propozycję produktu przez POST /sale/product-proposals możesz przekazać wartość EAN, ISBN lub ISSN tylko w parametrze GTIN.
Parametr GTIN zyskał flagę “isGTIN” w strukturze “options” parametrów produktu. Dzięki temu podczas dodawania oferty na podstawie produktu rozpoznasz, że jeśli parametr ma wiele wartości, to możesz przekazać tylko jedną z nich.
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/sale/products/0ca14fc3-7084-4fa2-83da-d04104e8b162’
-H ‘Accept: application/vnd.allegro.public.v1+json’Przykładowy response:
…
“parameters”: [
{
“id”: “225693”,
“name”: “EAN”,
“valuesLabels”: [
“0901362561720”
],
“values”: [
“0901362561720”
],
“unit”: null,
“options”: {
“identifiesProduct”: true,
“isGTIN”: true
}
}
],
…Ważne! W przyszłości pole “ean” w ofercie oraz tablicę “eans” w produkcie usuniemy. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru, dlatego już dzisiaj rozpocznij prace nad ich poprawną obsługą w swojej aplikacji.
W odpowiedzi na wasze sugestie dodaliśmy trzy nowe pola, które możecie przekazać w strukturze żądania POST /sale/product-offers:
Więcej informacji na temat zasobu znajdziecie w naszym poradniku - jak jednym requestem wystawić ofertę powiązaną z produktem.
Od początku 2019 roku wprowadzamy elementy produktyzacji w serwisie. Grupujemy oferty z tym samym produktem, dzięki czemu klient szybciej znajdzie ofertę, która spełnia jego oczekiwania. Ofertę powiązaną z produktem wyświetlimy także w nowych miejscach - np. na stronach produktu.
Planujemy sproduktyzować cały serwis Allegro do połowy 2021 roku, dlatego od 01.08.2020 będziemy wymagać co najmniej 1% ofert powiązanych z produktem w kategoriach:
Jeżeli sprzedawca nie spełni tego wymagania, to w tych kategoriach nie będzie mógł wystawić nowej oferty, jeśli obecnych nie powiąże z produktem.
Więcej o tym, jak powiązać ofertę z produktem, przeczytasz w naszym poradniku. W ostatnim czasie udostępniliśmy także nowy zasób POST /sale/product-offers, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:
Na stronie dla sprzedających znajdziesz informację o innych korzyściach, które aktualnie sprzedawca uzyska dzięki produktyzacji. W wybranych kategoriach, gdy sprzedawca stworzy nowy produkt w procesie wystawiania lub edycji oferty - zwrócimy mu połowę bazowej prowizji od sprzedaży w ofercie powiązanej z produktem.
17.06.2020 o godzinie 7:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 2 godzin. Przepraszamy za niedogodności.
Parametry zależne to parametry:
Zgodnie z naszą wcześniejszą zapowiedzią wprowadziliśmy parametry zależne w kategorii Klipsy (123428). Jeśli jako wartość parametru głównego (Materiał) wybierzesz:
Więcej informacji o parametrach zależnych znajdziesz w naszym newsie. O kolejnych dostępnych parametrach zależnych nie będziemy już informować na stronie Allegro API.
Od 15.06.2020 wystawisz oferty charytatywne na Allegro. Już dzisiaj wdrożyliśmy nowy zasób GET /charity/fundraising-campaigns, dzięki któremu wyszukasz organizacje charytatywne.
Natomiast w modelu oferty dodaliśmy nowe pole “fundraisingCampaign”. Aby wystawić ofertę charytatywną skorzystaj z POST /sale/offers i w polu “fundraisingCampaign” przekaż identyfikator wybranej organizacji charytatywnej.
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/charity/fundraising-campaigns?limit=10&phrase=Zbieramy’
-H ‘Accept: application/vnd.allegro.public.v1+json’Przykładowy response:
{
“campaigns”: [
{
“id”: “4ed5aebc-a916-4144-b9e9-45f9408a9fe7”,
“name”: “Zbieramy na karmę dla zwierząt ze schroniska”,
“organization”: {
“name”: “Platforma Charytatywna”
}
}
]
} Dzisiaj udostępniliśmy zasób GET /billing/billing-types, którym pobierzesz listę typów opłat billingowych. Możesz go wykorzystać do pełnej identyfikacji wartości zwracanych w polu “type.id” dla zasobu GET /billing/billing-entries.
Dzisiaj w modelu oferty udostępniliśmy dwa nowe pola:
Model oferty po zmianie:
…
“sellingMode”: {
“format”: “BUY_NOW”,
“price”: {
“amount”: “2460”,
“currency”: “PLN”
},
“netPrice”: {
“amount”: “2000”,
“currency”: “PLN”
},
“startingPrice”: null,
“minimalPrice”: null
},
“tax”: {
“percentage”: “23.00”
},
…Dzięki zmianie w przyszłości zaprezentujemy kupującym w ofertach stawkę VAT i cenę netto produktu.
Ważne! Pamiętaj, że transakcję z kupującym zawierasz na podstawie ceny brutto. Obecnie cenę netto zwracamy w celach informacyjnych.
Do tej pory, gdy za pomocą POST /sale/product-offers wystawiasz ofertę powiązaną z produktem i chcesz otrzymać dwa różne zbiory dla parametrów ofertowych i produktowych, musisz skorzystać z dwóch osobnych zasobów. Uprościliśmy ten proces - w odpowiedzi dla GET /sale/categories/{categoryId}/parameters dodaliśmy nowe pola:
Więcej informacji o tym, jak w łatwy sposób wystawić ofertę powiązaną z produktem, znajdziesz w naszym poradniku.
Przykładowy response:{
“id”: “10563”,
“name”: “Marka”,
“type”: “dictionary”,
“required”: true,
“requiredForProduct”: true
“unit”: null,
“options”: {
“variantsAllowed”: false,
“variantsEqual”: true,
“ambiguousValueId”: “10563_40”,
“dependsOnParameterId”: null
“describesProduct”: true
},
…
}
8 czerwca 2020 zaktualizujemy listę kategorii i parametrów na Sandboxie. Dzięki temu zadbamy o spójność między środowiskiem testowym i produkcyjnym.
Ważne! W związku z aktualizacją usuniemy wszystkie oferty z Sandboxa.
Podobne działania planujemy przeprowadzać raz na kwartał. Będziemy o nich informować z odpowiednim wyprzedzeniem.
Od 29.06.2020 udostępnimy parametr globalny numer jednostki handlowej tzw. GTIN. W większości kategorii oznaczymy go jako parametr podstawowy, czyli taki, który identyfikuje produkt w ofercie. Jeżeli chcesz określić lub zmienić GTIN, w zależności od kategorii, skorzystaj z dostępnych parametrów:
Pamiętaj, że parametry dostępne w danej kategorii sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters.
GTIN w ofertach
W ofertach parametr GTIN będzie nadrzędny wobec pola “ean”, którego wartości automatycznie przeniesiemy do nowego parametru. Wartość EAN, ISBN lub ISSN możesz uzupełnić jedynie w parametrze GTIN, aby to zrobić pobierz aktualny stan oferty poprzez GET /sale/offers/{offerId}, a następnie edytuj poprzez PUT /sale/offers/{offerId}. Jeśli spróbujesz zmienić wartość pola “ean” w ofercie, otrzymasz komunikat błędu: “Pole ean jest tylko do odczytu. Wartość z pola ean podaj w parametrze o id: {id}.”
Jeżeli dotychczas w integracji używasz pola “ean” by rozpoznać swoje oferty (jako sygnaturę), wykorzystaj w tym celu dedykowane dla sygnatury pole “external.id”.
GTIN w produktach
Nowy parametr GTIN dla produktów będzie funkcjonować równolegle z dotychczasową tablicą “eans”. Aktualne wartości “eans” przeniesiemy do nowego parametru. Zgłaszając propozycję produktu przez POST /sale/product-proposals możesz przekazać wartość EAN, ISBN lub ISSN tylko w parametrze GTIN.
Parametr GTIN zyska flagę “isGTIN” w strukturze “options” parametrów produktu. Dzięki temu podczas dodawania oferty na podstawie produktu rozpoznasz, że jeśli parametr ma wiele wartości, to możesz przekazać tylko jedną z nich.
Ważne! W przyszłości pole “ean” w ofercie oraz tablicę “eans” w produkcie usuniemy. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru, dlatego już dzisiaj rozpocznij prace nad ich poprawną obsługą w swojej aplikacji.
Tydzień przed wdrożeniem zmiany udostępnimy na Sandbox kategorię oraz produkt z nowym parametrem GTIN, co pozwoli Wam przetestować jego działanie. O szczegółach poinformujemy w komunikacie na naszym forum.
Od 10.06.2020 zasoby przeznaczone do obsługi zamówień:
dostępne będą tylko w wersji public. Zmianę z wyprzedzeniem zapowiadaliśmy w komunikacie GitHub #2220.
Wykonaj niezbędną zmianę w swoim oprogramowaniu - aby przejść na nową wersję wystarczy, że w nagłówku ‘accept’ oraz ‘content-type’ wywołania zmienisz wartość:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’.
POST /sale/product-offers to nowy zasób, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:
Więcej informacji o tym zasobie znajdziesz w naszym poradniku.
W strukturze odpowiedzi, w ramach danych produktowych, w sekcji publication dodaliśmy nowe pole status, w którym informujemy, czy na podstawie danych z żądania:
{
“product”:{
“id”: “0cb89863-9bd0-4f92-x364-16ec3908201x”, – id zgłoszonego produktu
“publication”: {
“status”: “PROPOSED”
},
}
…
}{
“product”:{
“id”: “0cb89863-9xd0-4f92-x364-16ec3908201x”, – id produktu z naszej bazy
“publication”: {
“status”: “LISTED”
},
}
…
}{
“product”:{
“id”: null
“publication”: {
“status”: “NOT_LISTED”
},
},
}
…
}W odpowiedzi na wasze sugestie, dodaliśmy dwa nowe pola w odpowiedzi dla GET /me:
Za pomocą GET /me pobierzesz dane użytkownika, którego token przesyłasz w requeście.
Przykładowy request:curl -X GET
‘https://api.allegro.pl/me’
-H ‘Accept: application/vnd.allegro.public.v1+json’
{
“id”: “12345678”,
“login”: “example_login”,
“firstName”: “Jan”,
“lastName”: “Nowak”,
“email”: “example_login@allegro.pl”,
“company”: {
“name”: “Allegro.pl”,
“taxId”: “525-267-47-98”
}
}
O wartościach niejednoznacznych i o tym, jak możesz dodać własną wartość w wybranych kategoriach, informowaliśmy we wcześniejszym komunikacie. Od dzisiaj możesz zdefiniować własną wartość, również gdy tworzysz nowy produkt za pomocą POST /sale/product-proposals.
Identyfikator wartości niejednoznacznej parametru sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters w polu ambiguousValueId. Więcej informacji na temat tego pola znajdziesz w naszym komunikacie. Na stronie dla sprzedających znajdziesz aktualną listę parametrów, do których możesz dodać własną wartość.
Podczas, gdy dodajesz produkt, przekaż poniższą strukturę w sekcji parameters, aby dodać własną wartość. Jeżeli w polu valuesIds przekażesz identyfikator wartości niejednoznacznej ambiguousValueId, to uzupełnienie własnej wartości w polu values będzie obowiązkowe.
{
“id”: “129033”, – id parametru
“valuesIds”: [
“129033_13” – id wartości niejednoznacznej
],
“values”: [ “Nazwa brakującej marki” ], – wartość, którą chcesz przekazać,
uzupełnij to pole.
“rangeValue”: null
}
Aktualnie, jeśli chcesz wystawić ofertę i powiązać ją z produktem, musisz przejść złożony proces, który wymaga wykonania wielu zapytań do różnych zasobów. Dążymy do tego, aby ten proces usprawnić - chcemy ograniczyć liczbę operacji potrzebnych do wystawienia oferty powiązanej z produktem.
W związku z tym udostępniliśmy nowy, dodatkowy zasób POST /sale/product-offers w wersji beta, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:
Pozostałe dane wymagane do poprawnego wystawienia oferty uzupełnimy wartościami domyślnymi.
Więcej informacji na temat nowego zasobu znajdziesz w naszym poradniku.
W przyszłości, gdy skorzystasz z tego zasobu, w twoich ofertach zaprezentujemy najbardziej aktualne dane z naszego katalogu produktów. Gdy zaktualizujemy dane produktu w katalogu, nie będzie konieczne kopiowanie czy akceptowanie zmian w ofercie, jeśli nie przekażesz własnych wartości. Pozwoli to nam także automatycznie uzupełnić parametry, których aktualnie wymagamy przy edycji oferty.
Udostępniliśmy dziś nowe pole “revision” dla zasobów:
Zwracamy w nim informację o wersji zamówienia. Dzięki niemu będziesz pewien, że zmieniasz status realizacji zamówienia (“fulfillment.status”) w zamówieniu, którego dokładnie ta sama kopia znajduje się w Allegro. Wartość pola “revision” zmienia się w momencie, kiedy kupujący wykona zmianę, która ma wpływ na dane zamówienia (np. zmiana statusu zamówienia, płatności, danych adresowych, danych do faktury, itp.).
Tokeny aktualnie mogą zawierać maksymalnie do 2048 bajtów. Jeżeli w swoim oprogramowaniu ustawiłeś mniejszy limit, to zwiększ go, aby operacje przez API mogły wykonać się prawidłowo. Przepraszamy za problemy techniczne spowodowane tą niezapowiedzianą zmianą.
Od 08.05.2020 nie skorzystasz z mapowania płatności za pomocą GET payments/payment-id-mappings. Zasób umożliwia mapowanie wartości transactionId na wartość payment.id i odwrotnie. Ostatnie metody WebAPI, które korzystały z transactionId wyłączyliśmy 13.01.2020.
Wartości niejednoznaczne parametru to wartości typu: “inne”, “pozostałe”, etc. np. “inna” w parametrze “Marka”. Identyfikator takiej wartości zwracamy w polu ‘ambiguousValueId’ w sekcji options w odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Informowaliśmy o tym we wcześniejszym komunikacie.
Od dziś w wybranych kategoriach w API możesz zdefiniować własną wartość dla parametru z wartością niejednoznaczną. Możesz skorzystać z tej opcji, gdy wystawiasz bądź edytujesz ofertę i nie znajdziesz odpowiedniej wartości parametru. Dzięki temu zbierzemy propozycje brakujących wartości, zweryfikujemy je i uzupełnimy listę wartości danego parametru. W przyszłości uzupełnienie wartości będzie obowiązkowe, jeśli wybierzesz wartość niejednoznaczną parametru.
Na stronie dla sprzedających znajdziesz aktualną listę parametrów, do których możesz dodać własną wartość. Własne wartości parametrów na tę chwilę możesz dodać tylko przez API.
Aby dodać własną wartość, sprawdź wartość pola ambiguousValueId w wybranej kategorii za pomocą GET /sale/categories/{categoryId}/parameters:
{
“parameters”: [
{
“id”: “129033”,
“name”: “Marka”,
“type”: “dictionary”,
“required”:true,
“unit”: null,
“options”: {
“variantsAllowed”: false,
“variantsEqual”: false,
“ambiguousValueId”: “129033_13” – id wartości niejednoznacznej,
w tym przypadku jest to wartość “inna”
},
…
}
Następnie, gdy tworzysz draft lub edytujesz ofertę, w sekcji parameters przekaż poniższą strukturę:
{
“id”: “129033”, – id parametru
“valuesIds”: [
“129033_13” – id wartości niejednoznacznej
],
“values”: [ “Nazwa brakującej marki” ], – wartość, którą chcesz przekazać,
uzupełnij to pole.
“rangeValue”: null
}
W przyszłości dodamy możliwość definiowania własnych wartości dla propozycji produktów - o wdrożeniu poinformujemy w osobnym komunikacie.
Od 06.05.2020 dla GET /offers/listing w odpowiedzi zwrócimy maksymalnie 60 ofert. Już teraz wprowadź niezbędne zmiany w swoim oprogramowaniu - jeżeli tego nie zrobisz, to domyślnie w odpowiedzi otrzymasz 60 ofert.
Od 05.05.2020 kupujący będą mogli anulować zamówienie w ciągu 3 dni od daty zakupu. Udostępnimy taką opcję, gdy:
W związku z tym dla zasobów:
Ważne! Zdarzenie “BUYER_CANCELLED” może pojawić się przed lub po READY_FOR_PROCESSING.
Jeżeli kupujący anulował zamówienie już opłacone, możesz zwrócić otrzymaną wpłatę za pomocą POST /payments/refunds. Dla niezrealizowanych zamówień możesz wystąpić o rabat transakcyjny przy użyciu POST /order/refund-claims.
Więcej informacji o anulowaniu zamówień znajdziesz na stronie dla sprzedających.
Zgodnie z wcześniejszą zapowiedzią przypominamy, że od 27.04.2020 przestaniemy wspierać wersję beta zasobów, dzięki którym połączysz oferty w ofertę wielowariantową.
W wersji public wprowadziliśmy zmiany, dzięki którym łatwiej obsłużysz oferty wielowariantowe:
Więcej na temat nowego modelu wielowariantowości znajdziesz w naszym poradniku.
Lista zasobów, które udostępniliśmy w wersji public:
Udostępniliśmy dziś nowe zasoby, dzięki którym możesz zarządzać:
Więcej informacji na ten temat znajdziesz w naszym poradniku.
Zgodnie z komunikatem 6 kwietnia 2020 w większości kategorii Allegro planowaliśmy wprowadzić obowiązkowość parametrów Kod producenta, Marka i Model. Jednak w związku z obecną sytuacją, która dotyka zarówno konsumentów, jak i przedsiębiorców, postanowiliśmy, że dla większości kategorii przesuniemy termin oznaczenia parametrów jako obowiązkowych z 6 kwietnia na 6 maja.
Więcej informacji znajdziesz na stronie dla sprzedających.
Od dziś możesz pobrać nazwy kategorii i parametrów także w języku angielskim. Wystarczy, że w wywołaniu zasobów:
dodasz nagłówek:
-H ‘Accept-Language: en-US’
Więcej informacji o parametrach i kategoriach znajdziesz w naszym poradniku.
Parametry zależne to parametry:
Aktualnie skupiamy się na zależnościach między wybranym parametrem, a zbiorem dostępnych wartości parametru zależnego.
Parametry zależne planujemy stopniowo wdrażać w wybranych kategoriach, w najbliższym czasie wprowadzimy je w kategorii Klipsy (123428). O kolejnych kategoriach i parametrach będziemy informować na stronie dla sprzedających. Parametry mogą być obowiązkowe, sprawdzisz to w polu required w odpowiedzi dla GET /sale/categories/{categoryId}/parameters.
Za pomocą tej funkcjonalności w przyszłości ograniczymy liczbę dostępnych podkategorii, dzięki czemu uprościmy nawigację, np. Sprzedający wystawi przedmiot “Nokia 8” już w kategorii nadrzędnej “Smartfony i telefony komórkowe” - wystarczy, że odpowiednio określi Markę i Model.
W związku z tym udostępniliśmy nowe pola w odpowiedzi dla GET /sale/categories/{categoryId}/parameters:
Po tym, jak wprowadzimy pierwsze parametry zależne, nowe pola pomogą ci sprawdzić, czy próbujesz wystawić ofertę z poprawną kombinacją wartości parametrów, np. czy Nokia produkuje model, który przekazujesz w żądaniu.
Początkowo nie będziemy zwracać błędów, jeśli nie powiążesz poprawnie parametrów zależnych. Jeżeli parametr oznaczymy jako obowiązkowy, będziesz musiał uzupełnić wartość, jednak zignorujemy zależność między parametrami. Gdy zdecydujemy się wprowadzić walidację, poinformujemy o tym z odpowiednim wyprzedzeniem.
Poniżej znajdziesz przykład struktury, który tłumaczy mechanizm parametrów zależnych:
{
“id”: “1254”,
“name”: “Model”,
“type”: “dictionary”,
“required”: false,
“unit”: null,
“options”: {
“variantsAllowed”: true,
“variantsEqual”: false,
“ambiguousValueId”: “1254_17231”,
“dependsOnParameterId”: “202689” – identyfikator parametru, który
definiuje, jakich wartości można użyć
dla tego parametru.
W tym przypadku oznacza to, że
wartości parametru Model są zależne
od wartości parametru
Marka.
},
“dictionary”: [
{
“id”: “1254_1”,
“value”: “Galaxy S20”,
“dependsOnValueIds”: [
“202689_213101” – identyfikator wartości, od której
zależna jest wartość tego parametru.
W tym przypadku wskazuje na markę
Samsung.
]
},
{
“id”: “1254_2”,
“value”: “Galaxy S20+”,
“dependsOnValueIds”: [
“202689_213101”
]
},
{…},
{
“id”: “1254_3”,
“value”: “520 Lumia”,
“dependsOnValueIds”: [
“202689_213102” – w tym przypadku wartość wskazuje
na markę Nokia
]
},
{…},
{
“id”: “1254_4”,
“value”: “Mi Note 10”,
“dependsOnValueIds”: [
“202689_213103” – w tym przypadku wartość wskazuje
na markę Xiaomi
]
},
{
“id”: “1254_5”,
“value”: “Mi Note 10 Pro”,
“dependsOnValueIds”: [
“202689_213103”
]
}
]
}
Aktualnie pracujemy nad nowym, dodatkowym zasobem, który ułatwi proces zarządzania ofertą - chcemy ograniczyć liczbę operacji koniecznych do wystawienia oferty i powiązania jej z produktem. Przygotowaliśmy też ankietę, jej wyniki pozwolą nam lepiej zrozumieć Wasze potrzeby i obrać odpowiedni kierunek rozwoju tego zasobu. Możecie w niej wskazać najważniejsze funkcjonalności, które pomogą w zarządzaniu ofertami.
Listę zebraliśmy na podstawie zgłoszeń, sugestii oraz odpowiedzi z ostatniej ankiety - link.
Udostępniliśmy dziś nowe zasoby, dzięki którym możesz zarządzać rabatami transakcyjnymi (zwrotami prowizji):
Jako sprzedawca możesz wystąpić o rabat transakcyjny, jeśli sprzedasz przedmiot, ale transakcja nie dojdzie do skutku. Więcej o przyznawaniu rabatów znajdziesz w naszym artykule.
Przez REST API możesz utworzyć wniosek dla prowizji, które pobraliśmy w ciągu ostatnich 45 dni.
Więcej informacji znajdziesz w naszym poradniku.
Od 2 kwietnia dodamy dwie nowe metody dostawy - identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:
Więcej na ten temat znajdziesz tutaj.
Zakończyliśmy okres testowy dla zasobów, dzięki którym połączysz oferty w ofertę wielowariantową. Wersję beta będziemy wspierać do 27.04.2020. W tym okresie możesz systematycznie przechodzić na wersję public.
W wersji public wprowadziliśmy zmiany, dzięki którym łatwiej obsłużysz oferty wielowariantowe:
Więcej na temat nowego modelu wielowariantowości znajdziesz w naszym poradniku.
Lista zasobów, które wystawiliśmy w wersji public:
Zgodnie z zapowiedzią 6 kwietnia 2020 w większości kategorii Allegro wprowadzimy obowiązkowość dla parametrów Kod producenta, Marka i Model, dlatego już teraz udostępniamy plik - zawiera listę wszystkich parametrów (ze wskazaniem na kategorie, w których występują), które oznaczymy jako obowiązkowe 6 kwietnia. Dzięki wykorzystaniu tych danych sprzedający będą mogli uzupełnić ich wartości przed wdrożeniem obowiązkowości w serwisie.
Od 19.03.2020 wprowadzimy zmiany w identyfikatorach metod dostawy:
Pod obecnymi identyfikatorami tych metod dostawy będą dostępne nowe metody dostawy:
Ważne! Jeśli w swoim cenniku dostawy miałeś dostępną metodę dostawy:
Więcej na temat tej zmiany znajdziesz tutaj.
Od dzisiaj podczas próby aktywacji oferty posiadającej w tytule słowa (COVID-19, SARS-CoV-2, koronawirus, itp.) zwrócimy komunikat błędu:
{
“userMessage”: “Zabronione jest odwoływanie się w tytule oferty do koronawirusa (COVID-19,
SARS-CoV-2, koronawirus, itp). W obecnej sytuacji zagrożenia epidemiologicznego i powszechnego lęku
przed zarażeniem wirusem, może to w istotny sposób zaburzać percepcję konsumentów w trakcie
dokonywania wyboru oferty oraz prowadzić do dezinformacji.”
}
Więcej informacji na temat zakazu znajdziesz na stronie dla sprzedających.
Udostępniliśmy nowe pole ‘ambiguousValueId’ w sekcji options w odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Zwracamy w nim informację o identyfikatorze wartości niejednoznacznej dla parametru. Wartością niejednoznaczną nazywamy wartość typu: “inne”, “pozostałe”, “inny wzór”, etc. np. “inna” w parametrze “Marka”. W takiej sytuacji odpowiedź będzie wyglądała jak poniżej:
{
“parameters”: [
{
“id”: “2929”,
“name”: “Marka”,
“type”: “dictionary”,
“required”:true,
“unit”: null,
“options”: {
“variantsAllowed”: false,
“variantsEqual”: false,
“ambiguousValueId”: “25929_41” – id wartości niejednoznacznej,
w tym przypadku jest to wartość “inna”
},
“dictionary”: [
{“id”: “25929_416381”, “value”: “2skin”},
{“id”: “25929_31”, “value”: “4F”},
…
{“id”: “25929_41”, “value”: “inna”}
],
“restrictions”: {“multipleChoices”: false}
}
]
}
Wartość w nowym polu zwracamy tylko dla parametrów słownikowych, dla których możesz wybrać wartość niejednoznaczną. W pozostałych sytuacjach otrzymasz null.
Ważne! W przyszłości będziesz mógł zdefiniować nowe wartości dla wartości niejednoznacznych. O szczegółach poinformujemy w osobnym komunikacie.
Udostępniliśmy dziś nowy zasób GET /order/carriers, dzięki któremu pobierzesz identyfikatory dostępnych przewoźników - które są potrzebne, aby dodać numer przesyłki do zamówienia.
Więcej na ten temat znajdziesz w naszym poradniku.
Przykładowy request:curl -X GET
https://api.allegro.pl/order/carriers
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’{
“carriers”: [
{
“id”: “UPS”, – identyfikator przewoźnika
“name”: “UPS” – nazwa przewoźnika
},
{
“id”: “INPOST”,
“name”: “InPost”
},
…
{
“id”: “OTHER”
}
]
}W dniu 18 marca 2020 o godz. 19 rozpoczniemy przerwę techniczną dla środowiska Sandbox. Potrwa ona ok. 5 godzin. Sandbox będzie ponownie dostępny od północy 19 marca 2020.
Przepraszamy za niedogodności.
Udostępniliśmy dziś nowy zasób GET /sale/offers/{offerId}/rating, dzięki któremu pobierzesz oceny produktów przypisanych do swoich ofert.
Przykładowy request:curl -X GET
https://api.allegro.pl/sale/offers/{offerId}/rating
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’{
“averageScore”: “3.00”, – średnia ocena produktu
“scoreDistribution”: [ – rozkład ocen produktu
{
“name”: “5”, – wysokość oceny
“count”: 1 – liczba ocen
},
{
“name”: “4”,
“count”: 0
},
{
“name”: “3”,
“count”: 1
},
{
“name”: “2”,
“count”: 0
},
{
“name”: “1”,
“count”: 1
}
],
“totalResponses”: 3, – łączna liczba ocen
“sizeFeedback”: [ – opinie o rozmiarach
{
“name”: “BIGGER”, – klienci uznali wybrany rozmiar za większy od oczekiwanego
“count”: 0 – liczba opinii
},
{
“name”: “FIT”, – klienci uznali wybrany rozmiar za zgodny z oczekiwanym
“count”: 1
},
{
“name”: “SMALLER”, – klienci uznali wybrany rozmiar za mniejszy od oczekiwanego
“count”: 2
}
]
}Zakończyliśmy okres testowy dla zasobu, który zwraca informacje o zdarzeniach w ofertach zalogowanego sprzedawcy z ostatnich 24 godzin. Wersję beta będziemy wspierali do 30.03.2020. W tym okresie możesz systematycznie przechodzić na wersję public. Aby przejść na nową wersję wystarczy zmienić w nagłówku:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’.
Wypełnij ankietę na temat naszego API oraz strony Allegro REST API. Uzyskane odpowiedzi pozwolą nam dowiedzieć się, jakie są twoje potrzeby i wskazać kierunek dalszego rozwoju.
Ankieta nie zajmie ci więcej niż kilka minut. Link do ankiety - kliknij tu.
Od 01.03.2020 dla zamówień, w których dostawa jest realizowana w ramach Allegro Smart! z kurierem w polu “cost.amount” zwracamy koszt dostawy współfinansowany przez Allegro.
Szczegóły dotyczące współfinansowania przesyłek znajdziesz na stronie dla sprzedających.
Udostępniliśmy nowe pole shipmentSummary.lineItemsSent w:
W sekcji fulfillment, oprócz aktualnego statusu realizacji zamówienia, znajdziesz informację, czy do przedmiotów w zamówieniu dołączono numery przesyłek. Dostępne wartości określają przypisane numery przesyłek do:
Ważne! Wartość w polu shipmentSummary.lineItemsSent zwracamy dla zamówień utworzonych po 15.01.2020.
Możesz filtrować zamówienia według załączonych numerów przesyłek, w tym celu przekaż w requeście parametr fulfillment.shipmentSummary.lineItemsSent wraz z wybraną wartością, np.
GET /order/checkout-forms?fulfillment.shipmentSummary.lineItemsSent=NONEGET /order/checkout-forms?fulfillment.shipmentSummary.lineItemsSent=ALL&fulfillment.shipmentSummary.lineItemsSent=SOMEJeśli używasz na serwerze protokołu szyfrowania danych jedynie w wersji TLS 1.1.
TLS (ang. Transport Layer Security) zapewnia poufność i integralność transmisji danych. Wersja 1.1 powstała w 2006 roku i nie spełnia już dzisiejszych standardów bezpieczeństwa.
Zaktualizuj oprogramowanie na serwerze i połącz się z Allegro za pomocą protokołu TLS w wersji 1.2 lub nowszej. Więcej na ten temat znajdziesz tutaj.
Ważne! Jeżeli nie zaktualizujesz oprogramowania na serwerze, wówczas po 31 marca nie będziesz mógł nawiązać połączenia z API Allegro.
Wydłużamy termin, do którego dostępne będzie WebAPI - nowa data to koniec roku. Z tego powodu zaktualizowaliśmy nasz harmonogram.
W harmonogramie dodaliśmy informację na temat metody doGetSiteJournal - w kwietniu wyłączymy możliwość skorzystania z wartości 0 dla parametru wejściowego infoType.
Zgodnie z wcześniejszą zapowiedzią, wdrożyliśmy nowy zasób, dzięki któremu zmienisz status realizacji zamówienia widoczny w polu fulfillment.status:
Przykładowy request:curl -X PUT
‘https://api.allegro.pl/order/checkout-forms/{checkoutFormId}/fulfillment'
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
-d ‘{
“status”: “SENT” – przykładowe wartości: NEW (nowe),
PROCESSING (w realizacji), etc.
Pełną listę znajdziesz w naszej dokumentacji
}’
Wprowadzamy zmiany w adresach przekierowań (redirect_uri):
Aby przygotować się do zmiany przejdź do “Zarządzanie aplikacjami Allegro” i zmień Adresy przekierowań, które nie są już wspierane. Pamiętaj, że poprawny adres przekierowań:
Pamiętaj, że możesz podać wiele adresów redirect_uri (podawaj je wtedy od nowej linii).
Jeśli nie wprowadzisz odpowiednich zmian, Twoi użytkownicy nie będą mogli zalogować się do aplikacji.
Ważne! Wartość w polu fulfillment.status zwracamy dla zamówień utworzonych po 15.01.2020 lub w sytuacji, kiedy sprzedawca zmienił status po tej dacie.
Zgodnie z zapowiedzią usunęliśmy metody WebAPI odpowiedzialne za obsługę zamówień. Tym samym obsługa zamówień w WebAPI jest już niemożliwa.
Przejdź na REST API i korzystaj z zasobów do obsługi zamówień. Szczegółowe informacje znajdziesz w naszym poradniku. W REST API udostępniliśmy mapowania dla wybranych wartości WebAPI, dzięki czemu zachowasz ciągłość w obsłudze zamówień, więcej informacji na ten temat znajdziesz tutaj.
Udostępniliśmy dziś dwa nowe zasoby do zarządzania ocenami sprzedaży:
Szczegółowe informacje o zasadach znajdziesz w Pomocy Allegro.
Udostępniliśmy mechanizm PKCE (Proof Key for Code Exchange), który możesz użyć podczas autoryzacji użytkownika. Dzięki niemu zabezpieczysz swoją aplikację przed wykorzystaniem kodu autoryzacyjnego (authorization code) przez złośliwe oprogramowanie.
Aby z niego skorzystać, wygeneruj we własnym zakresie code_verifier - musi to być losowy ciąg znaków o długości pomiędzy 43 a 128 znaków, użyjesz go podczas żądania o token. Następnie w procesie autoryzacji dodaj dwa parametry:
Poniżej znajdziesz przykłady żądań HTTP dla code_verifier = KnAijeNvdSeloYlVcOh3HRmgZX57wDeVHiwRFQKO2F9DdBI.
Dla code_challenge_method=S256:
https://allegro.pl/auth/oauth/authorize?response_type=code&client_id=a21...6be&redirect_uri=http://exemplary.redirect.uri&code_challenge_method=S256&code_challenge=a69se03ZmsPhTLYQKHpGUH7m5waf-U8D-5pTwFRgLI4https://allegro.pl/auth/oauth/authorize?response_type=code&client_id=a21...6be&redirect_uri=http://exemplary.redirect.uri&code_challenge_method=plain&code_challenge=KnAijeNvdSeloYlVcOh3HRmgZX57wDeVHiwRFQKO2F9DdBIcurl -X POST -H ‘Authorization: Basic YTI…Hg=’ ‘https://allegro.pl/auth/oauth/token?grant_type=authorization_code&code=pOPEy9Tq94aEss540azzC7xL6nCJDWto&redirect_uri=http://exemplary.redirect.uri&code_verifier=KnAijeNvdSeloYlVcOh3HRmgZX57wDeVHiwRFQKO2F9DdBI'Od dziś za pomocą POST/order/checkout-forms/{id}/shipments, możesz dodać nowych przewoźników w polu carrier.id:
Więcej informacji na temat, jak obsługiwać zamówienia, znajdziesz w naszym poradniku.
Od 13.01.2020 wprowadzamy limit 20 000 draftów na jednym koncie - dotyczy to ofert ze statusem “INACTIVE”.
Kiedy przekroczysz ten limit, nie będziesz mógł tworzyć nowych draftów oraz otrzymasz komunikat - “You cannot create new drafts - your account has exceeded the maximum number {maxInactiveOffers} of drafts.”
Aby uniknąć tej sytuacji:
Więcej informacji o tworzeniu draftów ofert znajdziesz w naszym poradniku oraz dokumentacji.
Dzisiaj dla GET /sale/offers udostępniliśmy nową opcję filtrowania według delivery.shippingRates.id.empty, dzięki temu możesz znaleźć oferty, które nie mają cennika dostawy.
Przykładowe wywołanie ofert bez przypisanego cennika dostawy:
GET sale/offers?delivery.shippingRates.id.empty=true
Dzisiaj dla GET /order/checkout-forms udostępniliśmy nowe opcje filtrowania zamówień według:
oraz sortowania zamówień po:
Ważne! Nowe opcje filtrowania i sortowania udostępniliśmy dla zamówień utworzonych po 06.11.2019.
Przykładowe wywołanie zamówień posortowanych wg malejącej daty ostatniej zmiany zamówienia:
GET /order/checkout-forms?sort=-updatedAt
W odpowiedzi na wasze sugestie, dodaliśmy dwa nowe typy eventów dla GET /sale/offer-events:
GET /sale/offer-events to dziennik zdarzeń w ofertach zalogowanego sprzedawcy, który zwraca informacje z ostatnich 24 godzin.
Więcej informacji na jego temat znajdziesz w naszym poradniku.
Od dzisiaj dla zasobów:
udostępniliśmy nowy, opcjonalny obiekt “purchaseConstraints”. Dzięki niemu możesz ograniczyć liczbę sztuk dostępnych dla pojedynczego kupującego w kampanii.
Więcej informacji o zastosowaniu ograniczenia zakupowego znajdziesz w naszym poradniku.
Udostępniliśmy nowe pole ‘unit’ w sekcji parameters w odpowiedzi dla zasobów:
Informujemy w nim, z jaką jednostką powiązana jest wartość danego parametru. Jeśli dany parametr nie ma jednostki, zwracamy wartość null.
Wypełnij ankietę, która dotyczy naszego API. Uzyskane odpowiedzi pozwolą nam dowiedzieć się, jakie są twoje potrzeby i czym powinniśmy zająć się w pierwszej kolejności.
Ankieta nie zajmie ci więcej niż kilka minut. Link do ankiety - kliknij tu.
Udostępniliśmy dziś nowy zasób GET /billing/billing-entries, dzięki któremu pobierzesz historię operacji billingowych oraz saldo zautoryzowanego użytkownika.
Domyślnie w odpowiedzi otrzymasz listę 100 operacji billingowych, gdzie pierwszy wynik jest najnowszy. Możesz skorzystać z sortowania i filtrowania, aby zawęzić wyniki wyszukiwania i uzyskać interesujące cię dane. Więcej na ten temat dowiesz się z naszego poradnika.
Przykładowy request, dla którego otrzymasz informacje o operacjach z 10.10.2019
curl -X GET
https://api.allegro.pl/billing/billing-entries?occurredAt.gte=2019-10-10T00:00:00.000Z&occurredAt.lte=2019-10-10T23:59:59.000Z
-H ‘Authorization: Bearer {token}’ /
-H ‘Accept: application/vnd.allegro.public.v1+json’ /
-H ‘Content-Type: application/vnd.allegro.public.v1+json’
Przykładowy response
{
“billingEntries”: [
{
“id”: “da74ef80-f97a-4b04-a748-4c129cfb94b8”, – identyfikator operacji
“occurredAt”: “2019-10-10T10:27:17.412Z”, – czas wystąpienia operacji
“type”: {
“id”: “LIS”, – trzyliterowy kod typu operacji
“name”: “Wystawienie przedmiotu” – nazwa typu operacji
“offer”: {
“id”: “6206586563”, – identyfikator oferty
“name”: “oferta testowa” – tytuł oferty
},
“value”: {
“amount”: “-1.00”, – cena operacji
“currency”: “PLN”
},
“tax”: {
“percentage”: “0”, – wysokość podatku
“annotation”: “EXEMPT” – pole opcjonalne - dane zwracamy
w przypadku, gdy operacja jest
zwolniona z podatku (“EXEMPT”)
lub podatek nie ma zastosowania
(“NOT_APPLICABLE”)
},
“balance”: {
“amount”: “-737.57”, – saldo po operacji
“currency”: “PLN”
}
}
]
}
Więcej informacji znajdziesz w naszej dokumentacji.
Od 1.11.2019 dla zasobów:
udostępnimy nową wartość pola “payment.type”: “SPLIT_PAYMENT”.
Zmianę wykonujemy, ponieważ 1 listopada w Allegro udostępnimy Podzieloną płatność (z ang. split payment). Split payment polega na tym, że płatność za fakturę jest podzielona na kwotę netto i kwotę podatku VAT, który trafia na osobny rachunek VAT. Ustawa z dnia 9 sierpnia 2019 r. o zmianie ustawy o podatku od towarów i usług oraz niektórych innych ustaw wprowadza od 1.11.2019 roku obowiązek stosowania podzielonej płatności dla określonych transakcji.
Więcej informacji o podzielonej płatności znajdziesz 1 listopada na stronie aktualności Allegro oraz w Pomocy Allegro.
Wprowadziliśmy nową wartość dla czasu trwania licytacji, możesz ją teraz wystawić na 24 godziny. W tym celu przy publikacji oferty w polu publication.duration przekaż “PT24H” lub “P1D”. Wcześniej mogłeś wystawić licytację tylko na 3, 5, 7 lub 10 dni.
Udostępniliśmy nowe pole ‘calculatedNumberOfPackages’ w zasobach:
W sekcji delivery otrzymasz informację o łącznej liczbie wszystkich przesyłek w zamówieniu. Suma jest wyliczona na podstawie:
Dzięki temu dowiesz się, ile paczek w tym zamówieniu zostanie nadanych bezpłatnie przy włączonej opcji Allegro Smart! Nowe pole zwracamy dla zamówień utworzonych po 07.10.2019.
Zakończyliśmy okres testowy dla zasobów, dzięki którym jako sprzedawca możesz powiązać ofertę z produktem lub dodać nowy produkt. Wersję beta będziemy wspierać do 22.10.2019. W tym okresie możesz systematycznie przechodzić na wersję public. Aby przejść na nową wersję wystarczy zmienić w nagłówkach:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’
Więcej informacji o tym, jak powiązać ofertę z produktem lub dodać nowy produkt, znajdziesz w naszym poradniku.
Przypominamy, że 14.10.2019 zgodnie z wcześniejszymi zapowiedziami usuniemy metody WebAPI odpowiedzialne za:
Przejdź na zasoby w REST API Allegro, które pozwolą ci składać oferty w licytacji oraz zarządzać czarną listą.
Zakończyliśmy okres testowy dla zasobów, dzięki którym jako sprzedawca możesz dodać numer przesyłki do przedmiotu w zamówieniu. Wersję beta będziemy wspierać do 21.10.2019. W tym okresie możesz systematycznie przechodzić na wersję public. Aby przejść na nową wersję, wystarczy zmienić w nagłówkach:
‘application/vnd.allegro.beta.v1+json’ na: ‘application/vnd.allegro.public.v1+json’
Ważne! W wersji public nie wspieramy automatycznej zmiany przewoźnika “POCZTEX” na “POCZTA_POLSKA”. Upewnij się, że przekazujesz prawidłową wartość w polu carrierId.
13 stycznia 2020 usuniemy metodę WebAPI doAddPackageInfoToPostBuyForm, oznaczoną jako deprecated.
Więcej informacji o tym, jak dodać numer przesyłki do przedmiotu w zamówienia przez REST API, znajdziesz w naszym poradniku.
Od dziś draft oferty przechowujemy do 60 dni. Po tym okresie usuniemy taki draft. Jeśli zmienisz coś w nim, wydłużymy jego ważność o 60 dni.
Udostępniliśmy dziś nowy zasób, dzięki któremu pobierzesz dane użytkownika, którego token przesyłasz w requeście:
Przykładowy request
curl -X GET
https://api.allegro.pl/me
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’ Przykładowy response
{
“id”: “12345678”,
“login”: “example_login”,
“firstName”: “Jan”,
“lastName”: “Nowak”,
“company”: {
“name”: “Allegro.pl”
}
}Udostępniliśmy dziś opcje, dzięki którym możesz powiązać ofertę z produktem w kategorii Układ hamulcowy:
Więcej informacji o tym, jak powiązać ofertę z produktem znajdziesz w naszym poradniku.
Wdrożyliśmy poprawkę dla GET /offers/listing, która eliminuje wcześniejsze problemy związane z filtrowaniem ofert w kategoriach, gdzie zostały scalone wartości parametrów.
Zmieniliśmy część identyfikatorów wartości dla filtrów, znajdziesz je w obiekcie “filters”, który otrzymasz w odpowiedzi dla GET /offers/listing.
Zgodnie z zapowiedzią zmian w Regulaminie Allegro, 2 października usuniemy “czas wysyłki” z obszarów, które kupujący oceniają po transakcji. Oznacza to, że sprzedawcy od 2 października nie będą otrzymywali oceny za czas wysyłki.
W efekcie dla ocen wystawionych od 2 października w odpowiedzi dla poniższych zasobów:
w polu rates.delivery będziemy zwracać null. Dla ocen wystawionych przed 2 października poprawnie zwrócimy faktycznie wystawioną ocenę czasu wysyłki.Dodatkowo w dokumentacji GET/sale/user-ratings wszystkie pola w obiekcie rates oznaczyliśmy jako nieobowiązkowe.
Zakończyliśmy okres testowy dla zasobów, dzięki którym jako sprzedawca możesz zarządzać zamówieniami. Wersję beta będziemy wspierać do 27.09.2019. W tym okresie możesz systematycznie przechodzić na wersję public. Aby przejść na nową wersję wystarczy zmienić w nagłówkach:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’.
13 stycznia 2020 usuniemy poniższe metody WebAPI, które już dziś oznaczamy jako deprecated:
Więcej informacji o tym w jak obsługiwać zamówienia przez Allegro REST API znajdziesz w naszym poradniku.
Dziś udostępniliśmy w REST API zasoby, które pozwolą ci zarządzać ustawieniami dostawy:
Przykładowy request
curl -X GET
https://api.allegro.pl/delivery-settings
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’ Przykładowy response
{
“freeDelivery”: {
“amount”: 4.04, – minimalna kwota zamówienia
“currency”: “PLN” kwalifikująca się do darmowej dostawy
},
“joinPolicy”: {
“strategy”: “MAX” – sposób obliczania kosztów dostawy
},
“customCost”: {
“allowed”: true – czy klient może wpisać koszt
dostawy ustalony ze sprzedawcą
},
“updatedAt”: “2019-08-21T10:13:40.036Z”
}Więcej informacji na temat nowych zasobów znajdziesz w naszej dokumentacji.
Zgodnie z wcześniejszą zapowiedzią dziś wprowadzamy dwie zmiany w Regulaminie REST API Allegro:
Tym samym opublikowaliśmy anglojęzyczną wersję Regulaminu.
Są to zmiany kosmetyczne, które nie wpływają na korzystających z REST API.
Dodaliśmy nowe pole productEANRequired dla zasobów:
Wartość true dla tego pola oznacza, że w wybranej kategorii, podczas dodawania produktu, musisz podać przynajmniej jeden EAN. EAN jako pole obowiązkowe wprowadzamy na razie w jednej kategorii - Karty pamięci SD.
Dodatkowo od dziś możesz powiązać ofertę z produktem w kolejnych w wybranych podkategoriach należących do poniższych kategorii:
Od dzisiaj w odpowiedzi dla GET sale/offer-events zwracamy nowy typ eventu - “OFFER_ARCHIVED” dla ofert, które są już niedostępne na liście ofert i zostały zarchiwizowane.
Więcej informacji o dzienniku zdarzeń znajdziesz w naszym poradniku.
Rozpoczęliśmy proces scalania parametrów i ich wartości w wybranych kategoriach:
Aktualnie istnieje wiele parametrów i ich wartości przypisanych do kategorii niższego rzędu, które mają podobne lub identyczne znaczenie. Dzięki scaleniu parametrów będziemy mogli je przenieść do kategorii wyższego poziomu i wykorzystać jako filtry - dzięki temu kupującym będzie łatwiej znaleźć interesującą ofertę.
Na przykład - w kategorii Opony ujednoliciliśmy dla wszystkich podkategorii identyfikatory parametrów Średnica. Wcześniej identyfikatory parametrów były różne w każdej z poniższych podkategorii:
Identyfikatory parametrów scaliliśmy i ujednoliciliśmy zgodnie z podkategorią Do samochodów osobowych. Oznacza to, że dla parametru Średnica wspólnym identyfikatorem jest teraz 127088.
Zmiana nie ma wpływu na podkategorię Do samochodów osobowych (ponieważ do tego parametru scaliliśmy pozostałe). W efekcie parametr ma jeden identyfikator i zawiera wartości, które dotychczas były dostępne w każdej z dotychczasowych kategorii.
Pamiętaj, że parametry aktualizujemy na bieżąco, dlatego aby pobrać najnowsze informacje na ich temat, korzystaj z zasobu GET /sale/categories/{categoryId}/parameters.
Jak zmiana wpłynie na oferty:
30 września 2019 usuniemy poniższe metody WebAPI do ponownego wystawienia oferty:
Aby wystawić podobną ofertę przez REST API, wystarczy, że pobierzesz ją za pomocą GET /sale/offers/{offerId}, a następnie prześlesz całą jej strukturę przez POST /sale/offers z wyłączeniem:
Pamiętaj, że musisz być uwierzytelniony i zautoryzowany jako sprzedawca, który wystawił tę ofertę. W ten sposób stworzysz nowy draft oferty na podstawie danych z oferty, którą pobrałeś wcześniej.
Jeśli oferta jest kompletna i poprawnie zwalidowana, to za pomocą metody PUT /sale/offer-publication-commands/{commandId} możesz ją opublikować w serwisie.
Więcej informacji na ten temat znajdziesz w naszym poradniku.
Od 30.08.2019 w odpowiedzi dla zasobu:
usuniemy nadmiarowe pole “publication.endedAt” występujące w zdarzeniu “OFFER_ENDED”. Jednocześnie w polu “occuredAt” będziemy zwracać dla każdego typu zdarzenia czas jego wystąpienia. Już teraz zachęcamy do odczytywania danych z tego pola.
Więcej informacji o dzienniku zdarzeń znajdziesz w naszym poradniku.
W dniu 04.09.2019 wprowadzimy dwie zmiany w Regulaminie REST API Allegro:
Tym samym tego dnia opublikujemy anglojęzyczną wersję Regulaminu. Są to zmiany kosmetyczne i nie wpływają one na korzystających z REST API.
Zakończyliśmy okres testowy dla zasobów, dzięki którym jako sprzedawca możesz zarządzać czarną lista kupujących. Wersję beta będziemy wspierali do 02.09.2019. W tym okresie możesz systematycznie przechodzić na wersję public. Aby przejść na nową wersję wystarczy zmienić w nagłówkach:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’.
14 października 2019 usuniemy poniższe metody WebAPI, które już dziś oznaczamy jako deprecated:
Zmieniamy sposób rozliczania opłat za dostawę w ramach Allegro Smart!. Sprzedający nie będzie już otrzymywał pieniędzy za przesyłkę realizowaną w ramach Allegro Smart!. Otrzyma wpłatę wyłącznie za sprzedany przedmiot.
Aby nadać przesyłkę bezpłatnie, w narzędziu nadawczym przewoźnika sprzedający wprowadza maskowany adres e-mail klienta dokładnie w takiej formie, jaką otrzymuje w zamówieniu. Na etykietach nadawczych adres e-mail klienta musi być pełny - powinien zawierać również ciąg znaków widoczny za “+” - np.: 8awgqyk6a5+cub31c122@allegromail.pl.
Upewnij się, że twój system do zarządzania sprzedażą przekazuje pełny maskowany adres email dla każdego zamówienia.
Jeśli sprzedawca nada paczkę, ale nie wprowadzi pełnego, maskowanego adresu e-mail klienta w domenie @allegromail.pl, wysyłka nie będzie darmowa. Przewoźnik poinformuje o tym w Menedżerze Paczek, a na koniec miesiąca za dostawę tych paczek wystawi sprzedającemu fakturę.
Kiedy wprowadzimy tę zmianę
Zmianę zaczniemy wprowadzać stopniowo dla kolejnych sprzedawców od pierwszego tygodnia września 2019 r. Nowy model rozliczeń wprowadzimy dla wszystkich sprzedających 1 listopada 2019 r.
Więcej informacji na ten temat znajdziesz w pomocy Allegro.
Do tej pory dane o cenniku dostawy zwracaliśmy tylko przez odwołanie się do konkretnej oferty za pomocą GET sale/offers/{offerId}. Od teraz taką informację udostępniamy w odpowiedzi dla GET /sale/offers.
Dodatkowo - w ramach tego zasobu - możesz również filtrować oferty według cennika dostawy.
Przykładowy request:
curl -X GET
https://api.allegro.pl/sale/offers?delivery.shippingRates.id={id}
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.public.v1+json’
-H ‘Content-Type: application/vnd.allegro.public.v1+json’ Od dzisiaj w odpowiedzi dla poniższych zasobów:
otrzymasz informacje o gwarantowanym czasie dostawy w sekcji delivery. Gwarantowany czas dostawy zapewnia metoda dostawy Kurier X-press i Kurier X-press pobranie. Dla pozostałych metod dostawy w polu otrzymasz wartość null.
Metodę stopniowo udostępniamy kolejnym Sprzedawcom - Szybkie dostawy na Allegro - program pilotażowy
Przykład odpowiedzi z rozbudowaną sekcją delivery:
“delivery”: {
“address”: {
“firstName”: “Jan”,
“lastName”: “Kowalski”,
“street”: “Grunwaldzka 182”,
“city”: “Poznań”,
“zipCode”: “60-166”,
“countryCode”: “PL”,
“companyName”: “Moja firma S.A.”,
“phoneNumber”: “222333444”
},
“method”: {
“id”: “04b07522-70e5-4dc3-b13b-7918ea717539”,
“name”: “Kurier X-press”
},
“pickupPoint”: null,
“cost”: {
“amount”: “20.00”,
“currency”: “PLN”
},
“smart”: false,
“time”: {
“guaranteed”: { –– gwarantowany czas dostawy
“from”: “2019-07-31T16:00:00Z”, –– czas dostawy od godz.
“to”: “2019-07-31T18:00:00Z” –– czas dostawy do godz.
}
}
},Więcej informacji o obsłudze zamówień znajdziesz w naszym poradniku.
Od dziś za pomocą PUT /sale/offer-modification-commands/{commandId} zmienisz czas trwania oferty.
Ważne!
Więcej szczegółów wraz z przykładowymi wywołaniami znajdziesz w naszym poradniku - jak zarządzać ofertami.
Zgodnie z zapowiedzią od dziś dla zamówień z metodą dostawy:
Zamiast identyfikatora POCZTEX, w poniższych procesach przekaż identyfikator Poczta Polska:
Zakończyliśmy okres testowy dla zasobu bidding/offers/{offerID}/bid, dzięki któremu złożysz ofertę kupna w trwającej licytacji oraz pobierzesz informację na ten temat. Wersję beta będziemy wspierali do 23.08.2019. W tym okresie możesz systematycznie przechodzić na wersję public. Aby przejść na nową wersję wystarczy zmienić w nagłówku:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’.
Metodę doBidItem już dziś oznaczamy jako deprecated i dodatkowo:
Od dziś w odpowiedzi dla poniższych zasobów:
otrzymasz dodatkowe informacje w sekcji buyer. Dane uzyskasz dla zamówień w statusie BOUGHT, FILLED_IN i READY_FOR_PROCESSING.
Poniżej przykład rozbudowanej sekcji buyer:
“buyer”: {
“id”: “1424041”, – identyfikator kupującego
“email”: “ymu1woaqq+54111a037@user-dev.allegrogroup.pl”,
– adres e-mail kupującego
“login”: “example_login”, – login kupującego
“firstName”: “Tomasz”, – imię
“lastName”: “Nowak”, – nazwisko
“companyName”: null, – nazwa firmy
“guest”: false, – czy kupujący jest zarejestrowanym użytkownikiem
“personalIdentity”: null, – numer PESEL
“phoneNumber”: “+381 11 1111111”, – numer telefonu z ustawień konta kupującego
“address”: { – dane adresowe z ustawień konta
“street”: “Bułgarska 6990”, – ulica
“city”: “Poznań”, – miasto
“postCode”: “18-282”, – kod pocztowy
“countryCode”: “PL”, – kod kraju
}Dodatkowe informacje w sekcji buyer będziemy zwracali dla zamówień utworzonych po 1.08.2019.
Więcej informacji znajdziesz w naszym poradniku - jak obsługiwać zamówienia.
Udostępniliśmy dziś nowe zasoby, dzięki którym wykonasz zwrot płatności do kupującego oraz pobierzesz informację o zwrotach:
Przez REST API możesz zlecić zwrot dla płatności utworzonych po 31.07.2019.
Więcej informacji znajdziesz w naszym poradniku - jak obsługiwać zamówienia.
Udostępniliśmy zasoby do obsługi zgłoszeń ofert do kampanii, programów specjalnych i oznaczeń Allegro:
Więcej informacji, jak obsługiwać zgłoszenia ofert do kampanii, programów specjalnych i oznaczeń Allegro znajdziesz w poradniku Jak przypisać ofertę do kampanii.
Zastąpiliśmy dziś POST /sale/products nowym zasobem POST /sale/product-proposals. Za jego pomocą przesyłasz propozycję produktu. Przesłane dane weryfikujemy, a zaakceptowane przez nas dane produktu są dostępne na platformie. Część danych może być weryfikowana automatycznie, część po pewnym czasie.
Gdy chcesz powiązać produkt z ofertą, skorzystaj z GET /sale/products/{product.id} i sprawdź, które dane produktu zaakceptowaliśmy i czy możesz je wykorzystać w ofercie.
Więcej szczegółów znajdziesz w poradniku Jak powiązać ofertę z produktem.
Udostępniliśmy dziś nowy zasób w wersji beta - GET /sale/offer-events. To dziennik zdarzeń w ofertach zalogowanego sprzedawcy, który zwraca informacje z ostatnich 24 godzin o:
Eventy zwracamy dla ofert w statusach ACTIVE i ACTIVATING. Oznacza to, że nie otrzymasz eventów dla ofert w statusie INACTIVE i ENDED.
W wywołaniu możesz podać parametry wejściowe, które pozwolą ci dopasować odpowiedź do twoich potrzeb:
Przykładowy request - którym uzyskasz 200 zdarzeń o zmianie liczby sztuk, które nastąpiły po evencie o “id”: “MTU2Mzg2NTM5MTU2Mzg0Ng”
curl -X GET \
‘https://api.allegro.pl/sale/offer-events?from=MTU2Mzg2NTM5MTU2Mzg0Ng&limit=200&type=OFFER_STOCK_CHANGED' \
-H ‘Accept: application/vnd.allegro.beta.v1+json’ \
-H ‘Authorization: Bearer {token}’Więcej informacji na temat nowego zasobu znajdziesz w dokumentacji.
Dotychczas datę w polu payment.finishedAt w zasobie GET /order/checkout-forms zwracaliśmy tylko dla zamówień opłaconych z góry. Od teraz jest ona widoczna również dla wszystkich zamówień z płatnością przy odbiorze w statusie READY_FOR_PROCESSING.
Zgodnie z wcześniejszą zapowiedzią przypominamy, że 30 lipca 2019r. wygasimy domenę allegroapi.io. Jeśli nadal korzystasz z allegroapi.io, by łączyć się z REST API, zmień adres domeny na api.allegro.pl w swoim oprogramowaniu.
Aby przejść na domenę api.allegro.pl wystarczy w adresie wywołania zmienić wartość: https://allegroapi.io/ na https://api.allegro.pl/
Więcej informacji o adresach do wywołania metod i procesu autoryzacji znajdziesz w naszym poradniku.
Pod koniec czerwca informowaliśmy o nowych zasobach do zarządzania sekcją Pasuje do. Dziś udostępniliśmy nowy zasób GET /sale/compatibility-list/supported-categories. Sprawdzisz dzięki niemu, czy w danej kategorii możesz dodać sekcję Pasuje do, a jeśli tak - to w jakiej wersji i na jakich zasadach.
Więcej informacji znajdziesz w tym poradniku.
Od 12 sierpnia dla zamówień z metodą dostawy:
Zamiast identyfikatora POCZTEX, w poniższych procesach przekaż identyfikator Poczta Polska:
Udostępniliśmy nowy zasób w wersji beta - POST /sale/products - który pozwala dodać nowy produkt.
Przypominamy, że od początku 2019 roku w wybranych kategoriach grupujemy oferty z tym samym produktem. Więcej informacji na ten temat znajdziesz na stronie dla sprzedających.
Nowy proces opisaliśmy szczegółowo w poradniku Jak powiązać ofertę z produktem.
Od dziś w ramach GET /sale/loyalty/promotions?user.id={Seller_ID} możesz filtrować dane według numeru oferty i rodzaju promocji:
Poniżej przykłady wywołań nowych filtrów:
Ważne! Maksymalna liczba promocji jaką zwrócimy, nawet jeśli skorzystasz z parametrów limit i offset to 50000. Jeśli masz na swoim koncie więcej promocji skorzystaj z filtrowania po rodzaju promocji bądź id oferty, aby pobrać wszystkie dostępne promocje.
Udostępniliśmy zasoby (w wersji beta), dzięki którym jako sprzedawca możesz zarządzać czarną lista kupujących.
Osoba dodana do czarnej listy nie może kupować w twoich ofertach. W każdej chwili możesz usunąć z niej użytkownika, tym samym ponownie pozwolisz mu na zakup w twoich ofertach.
Aby dodać kupującego do czarnej listy, skorzystaj z zasobu POST /sale/blacklisted-users.
Ważne! W strukturze musisz przesłać login lub id kupującego.
Przykładowy request:
curl -X POST
https://api.allegro.pl/sale/blacklisted-users
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.beta.v1+json’
-H ‘Content-Type: application/vnd.allegro.beta.v1+json’
-d ‘{
“user”: {
“id”: 123456, - wymagane (jeśli nie przekazujesz loginu),
id kupującego
“login”: “bad_buyer” - wymagane (jeśli nie przekazujesz id),
login kupującego
},
“note”: “Rude person” - powód dodania do czarnej listy
}’
Przykładowy response:
{
“user”: {
“id”: 123456,
“login”: “bad_buyer”
},
“note”: “Rude person”,
“createdAt”: “2019-05-08T09:45:818Z” - data dodania do czarnej listy
}Aktualną czarną listę pobierzesz za pomocą zasobu GET /sale/blacklisted-users.
Przykładowy response:
{
“blacklistedUsers”: [
{
“user”: {
“id”: 123456,
“login”: “bad_buyer”
},
“note”: “Rude person”,
“createdAt”: “2019-07-04T10:41:31.135Z”
},
{
“user”: {
“id”: 012345,
“login”: “bad_buyer1”
},
“note”: “Rude person”,
“createdAt”: “2019-07-04T10:35:10.013Z”
}
],
“offset”: 0,
“limit”: 25, - limit wyświetlanych wyników przy
pojedynczym zapytaniu
“total”: 2 - liczba użytkowników przypisanych
do czarnej listy
}
Maksymalnie przy zapytaniu możesz wyświetlić do 25 wyników. Aby zwrócić kolejne, użyj parametru “offset”, gdzie jako wartość podaj wielokrotność limitu.
Aby usunąć kupującego z czarnej listy wykorzystaj zasób DELETE /sale/blacklisted-users/{userId}.
Udostępniliśmy zasoby (w wersji beta), dzięki którym złożysz ofertę kupna w trwającej licytacji oraz pobierzesz informację na ten temat:
Aby skorzystać z zasobów, musisz być zalogowany jako użytkownik, który chce złożyć ofertę kupna w licytacji.
Przykładowy request:
curl -X PUT
‘https://api.allegro.pl/bidding/offers/{offerId}/bid'
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.beta.v1+json’
-H ‘Content-Type: application/vnd.allegro.beta.v1+json’
{
“maxAmount”: – maksymalna kwota, za jaką chcesz
zalicytować w ofercie
{
“amount”: “60”,
“currency”: “PLN”
}
}Przykładowy response:
{
“maxAmount”: {
“amount”: “60.00”,
“currency”: “PLN”
},
“highBidder”: true,
“minimalPriceMet”: true,
“auction”: {
“currentPrice”: {
“amount”: “50.00”,
“currency”: “PLN”
}
}
}
Dotychczas przy pomocy GET /sale/delivery-methods można było pobrać tylko identyfikatory i nazwy metod dostawy, które są dostępne w Allegro.
Od teraz w odpowiedzi otrzymasz także warunki dla danych, które możesz wprowadzić dla danej formy dostawy.
Więcej informacji znajdziesz w naszym poradniku.
Udostępniliśmy nowy zasób GET /payments/payment-id-mappings, dzięki któremu możesz uzyskać paymentId podając wartość transactionId lub odwrotnie. Wystarczy wpisać w zapytaniu wartości dla jednego z dwóch parametrów:
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/payments/payment-id-mappings?paymentId=21f96ba2-714f-11e9-a1f2-5b017850bf22'
-H ‘Authorization: Bearer’
-H ‘accept: application/vnd.allegro.public.v1+json’
Przykładowy response:
{
“paymentId”: “21f96ba2-714f-11e9-a1f2-5b017850bf22”,
“transactionId”: “1012284437”
}Zasób zwraca powiązania dla transakcji złożonych w ciągu ostatnich trzech miesięc
Poza tym udostępniliśmy możliwość filtrowania zamówień po:
Szczegóły znajdziesz w dokumentacji.
Od sierpnia w wybranych kategoriach sprzedawcy mogą dodać sekcję Pasuje do, w której wpisują, do jakich modeli będzie pasować sprzedawany produkt. Dotychczas sprzedający wpisywał w niej dane zwykłym tekstem.
Dziś udostępnimy zasoby dla nowej wersji sekcji Pasuje do, która jest zintegrowana z bazą pojazdów TecDoc. Modele pojazdów, które sprzedawca poda w nowej wersji sekcji Pasuje do, zaindeksujemy w naszej wyszukiwarce. Dzięki temu kupujący łatwiej znajdzie ofertę i wygodniej upewni się, czy dana część pasuje do jego samochodu.
Nową wersję sekcji Pasuje do udostępniliśmy w wybranych kategoriach. W danej kategorii możesz uzupełnić tę sekcję tylko w jeden sposób - albo podaj identyfikatory pojazdów, albo wyślij zwykły tekst.
Jeśli w ofercie jest tekstowa wersja sekcji, a w danej kategorii dopuszczamy tylko zintegrowaną z bazą pojazdów:
Więcej informacji znajdziesz w tym poradniku.
Od dziś możesz automatycznie wznowić ofertę i licytację przez REST API:
Jeśli chcesz, aby oferta lub licytacja wznowiła się automatycznie, to prześlij w jej strukturze:
“publication”: {
“republish”: true
}Więcej na temat tego, jak wystawić ofertę znajdziesz w naszym poradniku.
10 lipca zmienimy domyślny zakres danych zwracanych dla GET /sale/offers. Lista ofert bez użycia filtrów będzie zawierać wszystkie typy ofert INACTIVE, ACTIVATING, ACTIVE i ENDED, a nie jak to było dotychczas ACTIVATING, ACTIVE i ENDED.
Poza tym udostępniliśmy możliwość przeszukiwania listy po:
Szczegóły znajdziesz w dokumentacji.
Zgodnie z wcześniejszą zapowiedzią przypominamy, że 30 lipca 2019r. wygasimy domenę allegroapi.io. Jeśli nadal korzystasz z allegroapi.io, by łączyć się z REST API, zmień adres domeny na api.allegro.pl w swoim oprogramowaniu.
Aby przejść na domenę api.allegro.pl wystarczy w adresie wywołania zmienić wartość: https://allegroapi.io/ na https://api.allegro.pl/
Więcej informacji o adresach do wywołania metod i procesu autoryzacji znajdziesz w naszym poradniku.
Udostępniliśmy nowy zasób GET /payments/payment-operations, dzięki któremu pobierzesz historię operacji na saldzie zalogowanego sprzedającego.
Możesz skorzystać z sortowania i filtrowania wyników wyszukiwania, aby uzyskać interesujące cię dane.
Przykładowy request, dla którego otrzymasz wpłaty z dnia 12.06.2019:
GET /payments/payment-operations?occurredAt.gte=2019-06-12T00:00:00.000Z&occurredAt.lte=2019-06-12T23:59:99.999Z&group=INCOME
Więcej na ten temat znajdziesz w naszej dokumentacji.
10 lutego 2020 usuniemy poniższe metody WebAPI, które dziś oznaczamy jako deprecated:
Wdrożyliśmy nowy zasób GET /sale/offers/{offerId}/shipping-rates, dzięki któremu pobierzesz informacje o metodach dostawy w ofercie, w której nie ma przypisanego cennika dostawy. Dzięki temu możesz utworzyć nowy cennik dostawy, przypisać go do oferty i bez przeszkód zarządzać taką ofertą przez REST API Allegro. Więcej informacji na temat cenników dostawy, w jaki sposób je tworzyć i edytować znajdziesz w naszym poradniku.
To zasób którym pobierzesz ręcznie przypisane sposoby dostawy do danej oferty. Musisz być zalogowany jako właściciel danego konta.
Przykładowy request:
curl -X GET
‘https://api.allegro.pl/sale/offers/8151913057/shipping-rates'
-H ‘Accept: application/vnd.allegro.beta.v1+json’Przykładowy response:
{
“rates”: [
{
“deliveryMethod”: {
“id”: “845efe05-0c96-47c3-a8cb-aa4699c158ce” – identyfikator danej
metody dostawy
},
“maxQuantityPerPackage”: 1, – liczba w paczce
“firstItemRate”: { – cena przesyłki
“amount”: “11.00”,
“currency”: “PLN”
},
“nextItemRate”: { – cena kolejnej sztuki
“amount”: “0.00”,
“currency”: “PLN”
},
“shippingTime”: { – czas dostawy
“from”: “PT72H”,
“to”: “PT120H”
}
}
]
}W GET /sale/products wyniki wyszukiwania możesz zawęzić za pomocą filtrów, które zwracamy w odpowiedzi. Więcej informacji znajdziesz w poradniku Jak powiązać ofertę z produktem.
Przypominamy, że od początku 2019 roku w wybranych kategoriach grupujemy oferty z tym samym produktem. Więcej informacji na ten temat znajdziesz na stronie dla sprzedających.
Od sierpnia w wybranych kategoriach sprzedawcy mogą dodać sekcję Pasuje do, w której wpisują, do jakich modeli będzie pasować sprzedawany produkt. Dotychczas sprzedający wpisywał w niej dane zwykłym tekstem.
Na przełomie maja i czerwca 2019 roku udostępnimy wersję beta nowej wersji sekcji Pasuje do, która jest zintegrowana z bazą pojazdów TecDoc. Modele pojazdów, które sprzedawca poda w nowej wersji sekcji Pasuje do, zaindeksujemy w naszej wyszukiwarce. Dzięki temu kupujący łatwiej znajdzie ofertę i wygodniej upewni się, czy dana część pasuje do jego samochodu.
Nowa wersja sekcji Pasuje do będzie dostępna w wybranych kategoriach. W danej kategorii możesz uzupełnić tę sekcję tylko w jeden sposób - albo podaj identyfikatory pojazdów, albo wyślij zwykły tekst.
Jeśli w ofercie jest tekstowa wersja sekcji, a w danej kategorii będziemy dopuszczać tylko zintegrowaną z bazą pojazdów:
Dla GET /offer/listing w wybranych kategoriach, udostępniliśmy nowy filtr Dostawa z Polski - shippingFromPoland. Dotychczas ten filtr był oparty o to, co sprzedawca wypełnił w parametrze 128188 i 129626. Po zmianie filtr ten jest oparty o dane zapisane w lokalizacji sprzedającego w polu Kraj (pole location.countryCode).
Od 20 maja 2019:
Przykłady użycia:
Więcej o wyszukiwaniu ofert i filtrach przeczytasz w naszym poradniku.
Zgodnie z wcześniejszą informacją,
dziś wdrożyliśmy nowy proces wystawiania ogłoszeń.
Więcej informacji na temat nowego procesu znajdziesz w naszym poradniku.
Przypominamy, że zgodnie z zapowiedzią 3 czerwca 2019 usuniemy metody do obsługi i zarządzania ofertami:
Przejdź na zasoby w REST API Allegro, które pozwolą ci wystawiać i zarządzać ofertami - więcej informacji znajdziesz w tym poradniku.
Dziękujemy za wasze uwagi, dzięki nim przywracamy pola publication.startedAt i publication.endedAt w wersji public GET /sale/offers.
30.07.2019 przestaniemy wspierać domenę allegroapi.io.
Jeżeli wykorzystujesz allegroapi.io, by łączyć się z REST API,
zmień adres domeny na api.allegro.pl w swoim oprogramowaniu.
Aby przejść na domenę api.allegro.pl wystarczy w adresie wywołania zmienić wartość:
https://allegroapi.io/ na https://api.allegro.pl/
Więcej informacje o adresach do wywołania metod i procesu autoryzacji znajdziesz w naszym poradniku.
Od 26 marca 2019 adres e-mail kupującego zwracamy jako ciąg znaków w domenie @allegromail.pl, np:
Zmianę wdrożyliśmy ze względów bezpieczeństwa i ochrony danych osobowych. Adresy mailowe maskujemy w całym Allegro. Maskowany adres e-mail składa się z zakodowanej pary sprzedawca-kupujący i informacji o transakcji. Więcej informacji na temat maskowania maili znajdziesz w pomocy Allegro.
W związku z tą zmianą, użytkownik może wysłać do klienta e-mail tylko z takich adresów jakie przypisał do swojego konta. Dlatego przygotowaliśmy zasoby, które pozwolą ci zarządzać dodatkowymi adresami e-mail.
Więcej informacji na temat nowych zasobów znajdziesz w naszym poradniku.
Zakończyliśmy okres testowy dla zasobu GET /sale/offers do zarządzania ofertami i dziś udostępniliśmy go w wersji public. Wersję beta będziemy wspierali do 6.05.2019. W tym okresie możecie systematycznie przechodzić na wersję public.
Aby przejść na nową wersję wystarczy w nagłówku ‘accept’ wywołania zmienić wartość:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’
Ważne! W wersji public nie zwracamy pól publication.startedAt i publication.endedAt.
Aktualizacja:
Dziękujemy za wasze uwagi, dzięki nim przywracamy pola publication.startedAt i publication.endedAt w wersji public GET /sale/offers.
5 sierpnia 2019 usuniemy metody WebAPI do zarządzania listą ofert sprzedającego, które dziś oznaczamy jako deprecated. Dotyczy to metod:
Dlatego już teraz odradzamy użycia tych metod w nowych rozwiązaniach i zalecamy migrację na REST API.
Od dziś w GET /sale/products możesz korzystać z wyszukiwania po frazie i filtra kategorii. Dodatkowo w poradniku “Jak powiązać ofertę z produktem”:
Zgodnie z wcześniejszą informacją
, ponieważ proces migracji starych ogłoszeń na nowe zajmie nam więcej czasu, niż pierwotnie zakładaliśmy,
przesunęliśmy termin wdrożenia nowego procesu.
Więcej informacji na temat nowego procesu znajdziesz w naszym poradniku.
Zgodnie ze wcześniejszą zapowiedzią, usuwamy metodę dostawy “Odbiór osobisty”. Od poniedziałku 8.04.2019 nie dodasz już do swojego cennika dostawy:
Zastąp ją w swoich ofertach nową metodą “Odbiór osobisty w punkcie sprzedawcy”.
Dzięki zmianie:
Ważne! Jeżeli nie określisz punktów odbioru, a klient zdecyduje się na wybór nowej metody, nie wyświetlimy mapy i nie będzie mógł skorzystać z tej metody dostawy. Klient zobaczy Inny sposób dostawy, a niżej okno, w którym będzie mógł wprowadzić dowolny koszt dostawy. Dlatego dodaj do swojego konta punkty odbioru osobistego:
Zgodnie z zapowiedzią wyłączyliśmy dziś metodę doGetItemsList.
Zachęcamy do korzystania na REST API z metody GET /offers/listing
, więcej na jej temat znajdziecie tutaj.
Z powodu problemów technicznych zdecydowaliśmy się przesunąć termin wdrożenia nowego procesu wystawienia ogłoszeń, który wcześniej zapowiadaliśmy.
O nowym terminie wdrożenia poinformujemy z odpowiednim wyprzedzeniem.
Od dziś możesz wskazać produkt w ofercie, dzięki temu zgrupujemy ją z pozostałymi ofertami z danym produktem. To nowa opcja, którą wprowadzamy od początku 2019 roku, na razie w wybranych kategoriach. Jej zasięg planujemy stopniowo rozszerzać, a dzięki niej klient łatwiej znajdzie oferty, które spełniają jego oczekiwania.
Udostępniliśmy nowe zasoby w wersji beta i przygotowaliśmy poradnik, w którym znajdziesz szczegółowe informacje o tym, jak powiązać ofertę z produktem.
Od dziś w metodzie GET /sale/offers/{offerId} zwracamy nowe pole endedBy, w którym pokażemy powód zakończenia oferty.
Od 26 marca przez API Allegro adres e-mail kupującego będziemy zwracali jako ciąg znaków w domenie @allegromail.pl:
Od 31.03 przed opublikowaniem ogłoszenia dodaj do niego przez POST /sale/offer-classifieds-packages/{offer-id}
wybranym pakiet i opcje dodatkowe. Jeśli nie przypiszesz do ogłoszenia żadnego pakietu, to nie będziesz mógł go opublikować w serwisie.
Więcej na informacji o tym, jak wystawić ogłoszenie w serwisie znajdziesz w naszym poradniku.
UWAGA! Od 31.03 nie będziesz już mógł wystawić ogłoszenia przez Allegro WebAPI.
WAŻNE! Zmiana wycofana
UWAGA! Zmianę przesunęliśmy w czasie. Poinformujemy o nowym terminie wdrożenia.
Od 12.03.2019, gdy łączysz oferty po parametrze color/pattern, nie podawaj wartości dla tego parametru w tablicy z ofertami.
Wartość tego pola będziemy ustalali automatycznie w oparciu o miniaturkę oferty.
Ważne! Pamiętaj, że oferty, które chcesz połączyć po parametrze color/pattern, muszą zawierać identyczną miniaturkę (zdjęcie główne).
curl -X PUT
‘https://api.allegro.pl/sale/offer-variants/{setId}’
-H ‘Accept: application/vnd.allegro.beta.v1+json’
-H ‘Content-type: application/vnd.allegro.beta.v1+json’
-H ‘Accept-Language: pl’
-H ‘Authorization: Bearer {token}’
-d ‘{
“offers”: [ – tablica z ofertami, które chcesz
połączyć w ofertę wielowariantową
{
“id”: “7436547561”, – identyfikator oferty
},
{
“id”: “7436547336”,
},
{
“id”: “7436547004”,
}
],
“name”: “Koszulki”, – wewnętrzna nazwa oferty
wielowariantowej, pole
string, maks. 50 znaków
“parameters”: [ – tablica z parametrami, którymi
łączysz oferty. Możesz podać
maksymalnie 2 parametry.
{
“id”: “54” – identyfikator parametru,
po którym chcesz połączyć oferty.
Identyfikator parametru dla
wybranej kategorii możesz pobrać
przy pomocy metody GET z zasobu
/sale/categories/{categoryId}/parameters
},
{
“id”: “color/pattern – parametr, po którym łączysz oferty -
kolor/wzór
}
]
}’
Zgodnie ze wcześniejszą zapowiedzią
usuwamy metodę dostawy “Odbiór osobisty”. Zastąpimy ją w twoich ofertach nową metodą “Odbiór osobisty w punkcie sprzedawcy”.
Migracja potrwa kilka tygodni.
Dzięki zmianie:
Udostępniliśmy nowy zasób w wersji beta GET /order/checkout-forms/{checkoutForm.id}/shipments, dzięki któremu pobierzesz listę numerów przesyłek dla zamówienia.
Udostępniliśmy nowy zasób w wersji beta POST /order/checkout-forms/{checkoutForm.id}/shipments, dzięki któremu dodasz numer przesyłki do zamówienia. Możesz go przypisać do dowolnie wybranych lineItems.id z danego zamówienia.
Pracujemy też nad metodą GET do pobierania numerów przesyłek, które dodałeś do konkretnego zamówienia. Powinna być dostępna w najbliższych tygodniach. Postaramy się opublikować ją jak najwcześniej.
W metodzie GET na zasobie /sale/offers/
zwracamy pole z sygnaturą (external.id). Dodaliśmy również filtr po sygnaturze (external.id).
Przykładowe wywołanie z użyciem filtra - GET /sale/offers?external.id={external_id}.
Od dziś, jeśli chcesz utworzyć nowy kontakt zasobem /sale/offer-contacts,
podaj przynajmniej jeden numer telefonu lub adres email. Inaczej otrzymasz od nas odpowiedź o statusie 422:
“Dodaj do kontaktu przynajmniej jeden numer telefonu lub adres email.”
Wdrożyliśmy dziś nowy widok dokumentacji REST API Allegro. Znajdziesz w nim m.in.informacje, czy dany zasób jest publiczny.
Wdrożyliśmy dziś dwie zmiany w zasobie /offers/listing:
Dzięki temu:
Zmianę wprowadzamy, aby ujednolicić wartości maksymalne dla metod wysyłki w API Allegro.
Wprowadzamy zmianę w kalkulatorze opłat w REST API. Dodaliśmy nowe pole w odpowiedzi “cycleDuration”. W tym polu znajdziecie informacje w jakich cyklach będziemy naliczać daną opłatę. Więcej informacji o opłatach i prowizjach znajdziesz w naszym regulaminie. Zmiana jest kompatybilna wstecz i nie podnosimy wersji zasobu.
{
“quotes”: [
{
“type”: “listingFee”, – typ opłaty początkowej
“name”: “Opłata za wystawienie”, – nazwa opłaty
“fee”: { – kwota w złotówkach
“amount”: “0.00”,
“currency”: “PLN”
},
“cycleDuration”: “PT240H” – informacje w jakich cyklach będziemy
naliczać daną opłatę
},
…
Udostępniliśmy możliwość przesyłania zdjęć za pomocą linku po protokole HTTP i HTTPS (tylko z ważnym certyfikatem) metodą POST na zasobie /sale/images. Zasady dla zdjęć nie zmieniły się:
21.02.2019 r. usuniemy metodę dostawy “Odbiór osobisty”. Do tego czasu zastąp ją nową metodą “Odbiór osobisty w punkcie sprzedawcy”. Dzięki zmianie:
Jak włączyć odbiór osobisty, który klient będzie mógł wybrać z mapy:
REST API
Do swoich cenników dostawy dodaj nową metodę dostawy, przy pomocy zasobu /sale/shipping-rates/{id}. Jednocześnie pamiętaj, aby już nie przesyłać danych dla dotychczasowej metody dostawy
WebAPI
Przy pomocy metody DoChangeItemFields przypisz do swoich ofert nową metodę dostawy. Jednocześnie pamiętaj, aby usunąć fid 35 - “Darmowe opcje przesyłki”.
Ważne! Punkty odbioru osobistego możesz dodać przy pomocy dedykowanego zasobu /points-of-service. Zadbaj o komplet informacji na temat punktu, w którym klient może odebrać przesyłkę.
Udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:
Pamiętaj! Punkty odbioru osobistego dodasz dedykowanym zasobem /points-of-service, więcej informacji na ten temat znajdziesz w naszym poradniku.
Na stronie do zarządzania aplikacjami możesz już usunąć klucze aplikacyjne z których nie korzystasz.
Jeśli chcesz usunąć klucz aplikacyjny kliknij w przycisk “USUŃ” w danym wierszu.
WAŻNE! Jeśli usuniesz klucz aplikacyjny nie będziesz mógł go już przywrócić, a wszystkie powiązane z daną aplikacją konta Allegro stracą połączenie.
Od sierpnia 2016 możesz łączyć się z Allegro za pomocą dwóch protokołów API - REST i SOAP. Podstawowym i rozwijanym interfejsem programistycznym Allegro jest REST API, i tylko w nim udostępniamy wszelkie nowe funkcjonalności. W REST API opublikowaliśmy zestaw zasobów, które pozwalają:
Rozwijamy REST API
Przypominamy, że możesz wystawiać i zarządzać ofertami przez REST API - odpowiednie zasoby są od września 2018 w wersji public.
Harmonogram dla REST API - Luty/Marzec 2019
Wygaszamy WebAPI
WebAPI to stare rozwiązanie, które utrzymujemy głównie z uwagi na kompatybilność wsteczną z istniejącymi aplikacjami. Nie rozwijamy go już i planujemy jego wygaszenie. Nowe funkcjonalności będziemy udostępniać tylko w REST API.
O planach dla innych metod i zasobów w API będziemy informować na bieżąco. W razie pytań zachęcamy do kontaktu.
Zgodnie z zapowiedzią od dziś w metodach POST i PUT na zasobie /points-of-service w strukturze “address” pola:
stają się obowiązkowe. Dokładny opis zasobów do zarządzania punktami odbioru osobistego znajdziesz w naszych aktualnościach.
Dodaliśmy dziś ekran, gdzie użytkownik potwierdza konto, na którym chce uwierzytelnić daną aplikację:
Dzięki temu użytkownik, może upewnić się, że wiąże poprawne konto z aplikacją.
WAŻNE! Jeśli użytkownik nie będzie zalogowany zamiast ekranu potwierdzenia konta, wyświetlimy stronę logowania.
9 stycznia w godzinach od 01:00 do 05:00 będzie miała miejsce przerwa techniczna Allegro.
W tym czasie REST API i WebAPI Allegro mogą być niedostępne.
W ramach Allegro OAuth2 udostępniliśmy ścieżkę, dzięki której możesz autoryzować się bez zgody użytkownika na działanie. Wybierając ten sposób uzyskasz dostęp do zasobów, które nie wymagają kontekstu użytkownika (pobieranie listy kategorii, przeglądanie listingu itp.)
Od 09.01.2019 w metodach POST i PUT na zasobie /points-of-service w strukturze “address” pola:
staną się obowiązkowe. Dokładny opis zasobów do zarządzania punktami odbioru osobistego znajdziesz w naszych aktualnościach.
Udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:
4 grudnia w godzinach od 00:00 do 02:00 będzie miała miejsce przerwa techniczna Allegro.
W tym czasie REST API i WebAPI Allegro mogą być niedostępne.
Dodaliśmy nowe pole external.id w zasobach:
Jeśli w ofercie sprzedawca dodał zewnętrzny identyfikator, pokażemy go w zdarzeniach i zamówieniach utworzonych od dnia 23.11.2018 r.
Udostępniliśmy zasoby, które pozwolą:
1. Zmienić cenę w wielu ofertach jednocześnie:
2. Zmienić liczbę przedmiotów w wielu ofertach jednocześnie:
W zasobie GET /sale/categories/{categoryId}/parameters wdrożyliśmy nowe pole “allowedNumberOfValues” w parametrach typu string (możesz dodać jedną lub wiele wartości). W tym polu możesz sprawdzić, ile wartości możesz podać w danym parametrze.
Przykład dla parametru “Załączone wyposażenie” (identyfikator kategorii: 67480)
{
“id”: “216917”,
“name”: “Załączone wyposażenie”,
“type”: “string”,
“required”: false,
“unit”: null,
“options”: {
“variantsAllowed”: false,
“variantsEqual”: false
},
“restrictions”: {
“minLength”: 1,
“maxLength”: 40,
“allowedNumberOfValues”: 10 – informacja o tym, ile wartości możesz
podać w danym parametrze
}
}Na stronie do zarządzania aplikacjami możesz już zmienić adres przekierowania (redirect URI) w aplikacji, którą wcześniej zarejestrowałeś.
Aby zmienić adres przekierowań, wystarczy, że klikniesz w przycisk “EDYTUJ” pod wybranym adresem. Następnie wprowadź nowy adres w polu “Adres URI do przekierowania” i zapisz zmiany. Adres możesz zmieniać wielokrotnie.
Od dziś w dedykowanej zakładce “Powiązane aplikacje” w “Moim Allegro” użytkownik może:
W ramach rozbudowy możliwości Allegro OAuth przygotowaliśmy nową ścieżkę, dzięki której możesz zautoryzować użytkownika na urządzeniach lub w aplikacjach, które nie posiadają:
Udostępniliśmy nowe zasoby do obsługi i zarządzania płatnymi nowymi specjalnymi oznaczeniami na liście ofert dla rabatów ilościowych na jednej ofercie.
Udostępniliśmy nowe pole ‘smart’. Od teraz w zasobach:
zwracamy wartość true/false, która informuje czy kupujący skorzystał z opcji smart wybierając sposób i metodę dostawy.
Od 8 listopada nie będziemy zwracać wartości kodu EAN w metodach doShowItemInfoExt i doGetItemsInfo. W odpowiedzi wartość pola EAN zawsze będzie pusta.
Wartość kodu EAN będziemy nadal zwracać w metodach i zasobach, które pozwalają pobierać dane o ofertach sprzedawcy, który je wystawił:
Udostępniliśmy nowe pole ‘discounts’. Od teraz w zasobach:
zwracamy wartość, która informuje z jakiej zniżki skorzystał kupujący:
28 października w godzinach od 01:50 czasu letniego do 03:30 czasu zimowego serwis będzie niedostępny.
W tym czasie dostęp przez REST API Allegro będzie niemożliwy.
Wprowadziliśmy nowe pole ‘variantsEqual’ (parametr weryfikujący). Jeśli chcesz połączyć oferty w ramach wielowariantowości, to wszystkie warianty oferty muszą mieć tą samą wartości w parametrach z włączoną opcją ‘variantsEqual’
Udostępniliśmy zasób do pobierania listy wszystkich ofert zautoryzowanego sprzedawcy, który utworzył te oferty (Moje oferty) w wersji beta:
Udostępniliśmy nowy pole “paymentPolicy” (rodzaj płatności) w odpowiedzi w zasobie:
Od dziś w zasobach:
wprowadziliśmy limit dla jednego zapytania. Liczbę ofert, w których możesz za jednym razem dokonać zmian ograniczyliśmy do 1000. Jeśli w tablicy prześlesz więcej identyfikatorów oferty niż 1000 otrzymasz błąd.
{
“errors”: [{
“code”: “VALIDATION_ERROR”,
“message”: “size must be between 0 and 1000”,
“details”: “Invalid value:“,
“path”: “offerCriteria[0].offers”,
“userMessage”: “size must be between 0 and 1000”
}]
}Od dziś metodę doGetItemsList oznaczymy jako deprecated.
Zachęcamy do korzystania na REST API z metody GET na zasobie /offers/listing, więcej na jej temat znajdziecie tutaj.
Udostępniliśmy metodę GET na zasobie /order/line-item-id-mappings, dzięki któremu możesz uzyskać dealId podając wartość lineItemId lub odwrotnie. Nowa metoda pozwoli ci na połączenie nowego i starego dziennika zdarzeń.
Udostępniliśmy nowy zasób do usuwania draftów ofert DELETE /sale/offers/{offerId}. Można nim usunąć tylko oferty o statusie “INACTIVE”.
Poszerzyliśmy możliwości zasobu promotions dla rabatów ilościowych. Od teraz możesz stworzyć promocję dla zakupów w wielu ofertach. Dzięki temu kupujący nie jest już ograniczony do jednej oferty. Przykładowo klient może zakupić przedmioty w trzech różnych ofertach i na najtańszy przedmiot otrzyma określony przez ciebie rabat procentowy.
Wdrożyliśmy dziś dwie zmiany w metodzie GET na zasobie /offers/listing w REST API:
Wprowadzamy zmianę w kalkulatorze opłat w REST API. Dodaliśmy nowy parametr do pola “offer”: “multiVariant” czyli “oferta multiwariantowa”.
Zakończyliśmy okres testowy dla zasobów do wystawiania i edycji ofert i dziś udostępniliśmy je w wersji public. Wersję beta będziemy wspierali do 10.10.2018. W tym okresie możecie systematycznie przechodzić na wersję public.
Aby przejść na wersję public wystarczy, w nagłówkach: ‘accept’ i ‘content-type’ wywołania danego zasobu zmienić wartość:
‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’
Lista zasobów, które wystawiliśmy w wersji public::
Udostępniliśmy zestaw zasobów do zarządzania tagami w ofertach oraz do dodawania załączników. Uzupełniliśmy także o tagi i załączniki nasz poradnik “Jak wystawić ofertę w Allegro REST API”.
Więcej informacji na ten temat znajdziesz w rozwinięciu komunikatu.
Udostępniliśmy zasoby, które pozwolą ci korzystać z dyskusji za pomocą REST API na koncie zautoryzowanego sprzedawcy.
Przygotowaliśmy następujące metody:
24 września wprowadzimy następujące ograniczenia dla jednorazowej zmiany ceny w ofercie:
Przy próbie zmiany ceny powyżej ograniczeń w zasobach:
Sprzedawca może zwiększyć cenę powyżej założonych ograniczeń, najpierw jednak trzeba zakończyć ofertę. Po zmianie ceny może ją wznowić i dzięki temu ponownie udostępnić w serwisie.
Wspólnie z Pocztą Polską, udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:
21 sierpnia w godzinach 02:00 - 05:00 przeprowadzimy prace modernizacyjne w serwisie Allegro.
W tym czasie REST API Allegro może być niedostępne.
W ubiegłym tygodniu opublikowaliśmy zasoby, dzięki którym możesz zarządzać zamówieniami w REST API Allegro. Dzisiaj opublikowaliśmy zasób order/event-stats. Za jego pomocą możesz pobrać ostatnie zdarzenie dla zautoryzowanego sprzedającego wraz z datą wystąpienia tego zdarzenia. Mając takie dane, będziesz mógł odczytywać kolejne zdarzenia począwszy od otrzymanego identyfikatora zdarzenia w ramach tego zasobu.
Dodaliśmy również pole phoneNumber w sekcji buyer w odpowiedzi metody GET dla zasobu order/checkout-forms dla każdego ze statusów.
Do istniejących zasobów, które pozwalają pobrać dane o cennikach:
Dodaliśmy zasoby, które pozwolą tworzyć i edytować cennik dostawy:
Zasoby do wystawiania i edycji ofert będą w wersji beta do końca sierpnia 2018. Zdecydowaliśmy się wydłużyć okres bety, ponieważ chcemy dostosować REST API ofert do waszych uwag i wymagań.
Zasoby udostępnimy w wersji public od września, gdy:
16 sierpnia w godzinach 02:00 - 05:00 przeprowadzimy prace modernizacyjne w serwisie Allegro.
W tym czasie REST API Allegro będzie niedostępne.
W metodach:
wdrożyliśmy nową sekcję. Jeśli sprzedajesz w jednej z wybranych podkategorii Części samochodowych:
Udostępniliśmy dziś nowe zasoby (w wersji BETA) do zarządzania zamówieniami w ramach Allegro REST API. Dzięki nim możecie pobrać listę zdarzeń, a na ich podstawie szczegóły zamówień. W październiku metody w WebAPI do zarządzania zamówieniami oznaczymy jako deprecated:
Dla zamówień przygotowaliśmy nowe zasoby w Allegro REST API:
Dla wielowariantowości przygotowaliśmy nowy zasób w Allegro REST API:
GET /sale/offer-variants - chcę pobrać utworzone oferty wielowariantowe.
Zaktualizowaliśmy zasób, którym sprawdzisz datę w której naliczymy kolejne opłaty w ofercie. Dodaliśmy nową opłatę - za utrzymanie ofert, którą będziemy naliczać od 25 lipca. Zmodyfikowaliśmy następujący zasób:
GET /pricing/offer-quotes - chcę sprawdzić datę naliczenie kolejnej opłaty w Allegro.
W polu type dodaliśmy wartość ILF czyli opłatę utrzymaniową.
Dla wielowariantowości przygotowaliśmy nowe zasoby w Allegro REST API:
PUT /sale/offer-variants/{setId} - chcę połączyć oferty w ofertę wielowariantową.
GET /sale/offer-variants/{setId} - chcę pobrać ofertę wielowariantową.
DELETE /sale/offer-variants/{setId} - chcę rozłączyć ofertę wielowariantową.
Zanim połączysz oferty przy pomocy wielowariantowości poprzez REST API, zapoznaj się z poradnikami o wielowariantowości - jak połączyć oferty i dobre praktyki.
Dla list ofert przygotowaliśmy nowy zasób w Allegro REST API:
GET /offers/listing - chcę pobrać listę ofert według podanych parametrów
Tym samym metodę doGetItemsList wygasimy na początku drugiego kwartału 2019 roku. We wrześniu 2018’ oznaczymy ją jako deprecated.
Wdrożyliśmy dziś limit aktywnych ofert na jednym koncie. Sprzedawca może wystawić maksymalnie 100 000 ofert. Limit dotyczy też ofert, w których ustawił datę wystawienia w przyszłości. Jeśli przekroczy limit i spróbuje wystawić nową albo wznowić zakończoną ofertę - otrzyma komunikat błędu:
{“errors”: [{
“code”: “PublicationValidationException.MaxActiveOffers”,
“message”: “Offer cannot be published - your account has exceeded
the maximum number 100 000 of active offers”,
“details”: null,
“path”: null,
“userMessage”: “Nie można wystawić oferty - Twoje konto przekroczyło
maksymalną liczbę 100 000 aktywnych ofert”
}]}
Na stronie rejestracji nowej aplikacji wyświetlamy nowe pole - Nazwa aplikacji. Możesz w nim podać nazwę aplikacji, którą wyświetlimy klientowi, gdy ten będzie próbował powiązać zewnętrzną aplikację z kontem Allegro. Po tym jak podasz nazwę aplikacji, nie będziesz mógł jej zmienić.
Możesz również nadać nazwę aplikacji, które zarejestrowałeś w przeszłości. Wystarczy, że klikniesz w odnośnik Ustaw nazwę, który znajduje się w kolumnie Nazwa aplikacji.
Zasoby w wersji beta, które pozwalają wystawić i edytować ofertę, będą jeszcze dostępne do 31 lipca.
Zdecydowaliśmy się przedłużyć okres testowy, ponieważ nie odnotowaliśmy do tej pory zadowalającej ilości wywołań. W związku z tym okres testowy potrwa do 31.07.2018.
Jesteśmy otwarci i chętnie wysłuchamy twoich uwag, sugestii i komentarzy. Dlatego tym bardziej zachęcamy do testów. Po tym okresie oznaczymy je jako public. Wówczas wprowadzenie większych zmian ze względu na kompatybilność wsteczną będzie utrudnione.
Chętnie wysłuchamy Waszych uwag, sugestii i komentarzy - zapraszamy na nasze forum.
W styczniu udostępniliśmy nowe zasoby do zarządzania kontaktami w ogłoszeniach. Informowaliśmy o nich w tym artykule. Teraz zwiększyliśmy ilość kontaktów jakie możesz dodać dla pojedynczego konta Allegro z 15 do 50 kontaktów.
Udostępniliśmy dziś nową opcję - sprzedawcy mogą ponownie wystawić zakończoną ofertę - pod tym samym numerem ID. Wznowioną ofertę ponownie udostępnimy w naszym serwisie.
Zakończoną ofertę - w statusie ENDED - możesz wznowić za pomocą akcji ACTIVATE komendą PUT /sale/offer-publication-commands/{commandId}.
W piątek 15 czerwca ok. godz. 9:00 zakończymy wszystkie aktywne oferty na środowisku testowym.
Przygotowujemy się do zmian w drzewie kategorii. W pierwszej kolejności będziemy je wprowadzać w środowisku testowym, dlatego chcemy je odpowiednio przygotować. Dodatkowo - docelowo uspójnimy drzewo kategorii środowiska testowego i produkcyjnego.
Pracujemy nad rozwojem REST API, a zmiany technologiczne, które wprowadzamy, wymagają aktualizacji Regulaminu tej usługi.
Nowa wersja Regulaminu Allegro REST API będzie obowiązywać od 18 czerwca - znajdziesz ją tutaj.
Co zmienimy?
Korzystanie z REST API jest równoznaczne z akceptacją Regulaminu.
Jeśli nie akceptujesz przedstawionych zmian, będziemy musieli wyłączyć Twój dostęp do usługi - w tym celu zgłoś się do nas.
Rozwijamy REST API
Do końca czerwca 2018 zasoby, które pozwalają wystawiać i edytować oferty, są w wersji beta. Jesteśmy otwarci i chętnie wysłuchamy twoich uwag, sugestii i komentarzy. Dlatego tym bardziej zachęcamy do testów.
Harmonogram dla REST API
Docelowo REST API Allegro będzie jedynym interfejsem aplikacyjnym, który pozwoli ci zarządzać ofertą i zamówieniami.
Wygaszamy WebAPI
TLS (ang. Transport Layer Security) zapewnia poufność i integralność transmisji danych. Wersja 1.0 powstała w 1999 roku i nie spełnia już dzisiejszych standardów bezpieczeństwa.
Zaktualizuj oprogramowanie na serwerze i połącz się z Allegro za pomocą protokołu TLS 1.1 lub 1.2. Instrukcje, jak to zrobić,znajdziesz w artykule naszej Pomocy.
Ważne! Jeżeli nie zaktualizujesz oprogramowania na serwerze, wówczas:
Wdrożyliśmy kilka zmian w obsłudze kluczy przez Allegro WebAPI i REST API.
Wprowadzamy zmianę w kalkulatorze opłat w REST API. Dodaliśmy nowy parametr do pola “offer”: “condition” czyli parametr “Stan”.
17 maja w godzinach 01:00 - 03:00 przeprowadzimy prace modernizacyjne w serwisie Allegro.
W tym czasie REST API Allegro będzie niedostępne.
Zgodnie z wcześniejszą zapowiedzią, udostępniliśmy parametr typu string.
Możecie go dodawać do ofert z poziomu Formularza wystawiania, WebAPI i REST API w dwóch kategoriach:
Początkowo parametry typu string nie będą obowiązkowe. Część z nich oznaczymy, jako wymagane w późniejszym czasie.
O wszystkich zmianach będziemy informować ze stosownym wyprzedzeniem.
W najbliższych tygodniach udostępnimy nowy rodzaj parametru - parametr stringowy.
Będzie to parametr, w którym będziecie mogli sami zdefiniować wartości.
Będą dostępne dwa rodzaje parametru typu string:
Przykładowy parametr stringowy:
Skład:
Bawełna 80%
Elastan 10%
Poliester 10%
Od teraz możesz pobrać identyfikatory Tabel rozmiarów i ich zawartość.
Zgodnie z zapowiedzią przestajemy dziś wspierać domenę https://ssl.allegro.pl ponieważ zmieniliśmy adres domeny w procesie autoryzacji OAuth z https://ssl.allegro.pl na https://allegro.pl
Jeśli dotychczas tego nie zrobiłeś, zaktualizuj adres domeny w swoim oprogramowaniu.Wszystkie profile Allegro.pl na Facebooku połączyliśmy z głównym profilem.
Kilka tygodni temu przeprowadziliśmy ankietę, w której pokazaliście nam, że GitHub jest najlepszym wyborem. Nasze repozytorium znajdziecie tutaj.
Pytania dotyczące API zadawajcie w zakładce Issues.
W listopadzie 2017 roku zmieniliśmy adres domeny w procesie autoryzacji OAuth z https://ssl.allegro.pl na https://allegro.pl.
Zgodnie z zapowiedzią domenę https://ssl.allegro.pl przestaniemy wspierać 13 marca. Od tego momentu powinieneś logować się tylko na https://allegro.pl. Zaktualizuj do 13 marca adres domeny w swoim oprogramowaniu.
28 lutego w godzinach 02:00 - 04:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie REST API Allegro będzie niedostępne.
Od dziś nasze strony związane z REST API udostępniliśmy w ramach domeny allegro.pl.
Jeśli podasz dotychczasowy adres stron, to przekierujemy cię na nową domenę.
Zmiana dotyczy:
Zachęcamy także, abyście zmienili adres, w wywołaniach do REST API z https://allegroapi.io na https://api.allegro.pl. Dotychczasowy adres będziemy nadal utrzymywać przez co najmniej rok, o planowanej dacie jego wygaszenia poinformujemy was z odpowiednim wyprzedzeniem.
Od sierpnia 2017 roku opłaty naliczamy w cyklach 10 dniowych. Dziś udostępniamy zasób, który pozwoli wam w prosty sposób sprawdzić, kiedy dany cykl się skończy i kiedy naliczymy kolejną opłatę.
Poszerzyliśmy response w metodach:
o nowe pole ‘status’. Dla tego pola dostępne są dwie wartości:
WAŻNE! Obecnie dla Zestawów promocyjnych to pole zawsze będzie miało wartość ACTIVE.
Poszerzyliśmy możliwości zasobu promotions - od teraz możesz dzięki niemu zarządzać także rabatami ilościowymi. Dzięki rabatom ilościowym możesz zaoferować kupującym rabat na kolejną sztukę, przy zakupie określonej liczby sztuk. Przykładowo: jeśli klient kupi trzy pary soczewek, to czwartą otrzyma 50% taniej.
Zmieniamy adres domeny w procesie autoryzacji OAuth z https://ssl.allegro.pl na https://allegro.pl. Zaktualizowaliśmy informacje na stronie REST API Allegro.
Uwaga! Domenę https://ssl.allegro.pl planujemy wyłączyć w marcu 2018. Od tego momentu użytkownik będzie mógł się zalogować tylko na https://allegro.pl. Zaktualizuj do tego czasu adres domeny w swoim oprogramowaniu.
Udostępniliśmy nowe zasoby do grupowej edycji ofert. Obecnie zasób pozwala na grupowe przypisanie usług dodatkowych. Usługami dodatkowymi są np.: zapakowanie na prezent, wniesienie, montaż itp.
Udostępniliśmy naszym sprzedającym usługi dodatkowe w Allegro. Usługami dodatkowymi są np.: zapakowanie na prezent, wniesienie, montaż itp. Sprzedawca może dodać usługi dodatkowe w swoich ofertach.
Udostępniamy ogłoszenia w Allegro, dlatego wprowadzamy zmiany w kalkulatorze opłat w REST API.
29 października pomiędzy godziną 1:50, a 3:30 nastąpi przerwa techniczna związana ze zmianą czasu z letniego na zimowy. Serwis będzie w tym czasie niedostępny, a na stronie Allegro pojawi się plansza informująca o przerwie technicznej.
Oferty kończące się w trakcie przerwy przedłużymy o 24 godziny.
Dodatkowo, między godziną 02:00 a 05:00 niedostępna będzie usługa PayU.
2 listopada br. Allegro.pl sp. z o.o. łączy się z Grupą Allegro sp. z o.o. Wszelkie prawa i obowiązki Grupy Allegro sp. z o.o. przejdą na Allegro.pl sp. z o.o.
Oznacza to, że 2 listopada br. zmieni się nazwa administratora Waszych danych osobowych. Nie ulegną natomiast zmianie zasady ochrony i przetwarzania danych osobowych. Zawsze macie prawo dostępu do treści swoich danych oraz ich poprawiania, a także żądania zaprzestania ich przetwarzania.
W związku z tą zmianą, zaktualizujemy Regulamin Allegro i pozostałe regulaminy usług świadczonych przez Allegro.pl sp. z o.o. Nową wersję Regulaminu Allegro zamieściliśmy w tym dokumencie. Fragmenty, które dodamy zaznaczyliśmy na zielono, a te które usuniemy - na czerwono
Udostępniliśmy naszym sprzedającym promocyjne zestawy ofert. Dzięki temu sprzedawca może sprzedawać w obniżonej cenie zestaw kilku ofert.
Udostępniliśmy nowe zasoby dzięki którym - jako zalogowany Użytkownik - pobierzecie otrzymane oceny oraz statystyki ocen. Dotychczasowe zasoby oznaczyliśmy jako depracated i w przyszłości (za około pół roku) usuniemy zupełnie. Dlatego zachęcamy, abyście korzystali z nowych.
Udostępniliśmy Sprzedającym kalkulator opłat w REST API. Sprzedający mogą sprawdzić jakie opłaty pobieramy w każdej kategorii. W związku z tym 19 pażdziernika wyłączymy metodę doGetPaymentData, która zwraca niedokładne dane.
Udostępniliśmy naszym sprzedającym punkty odbioru osobistego. Użytkownik może ustawić listę takich punktów. Wyświetlimy je w sekcji Dostawa i płatność we wszystkich jego ofertach z odbiorem osobistym.
Dla punktów odbioru przygotowaliśmy nowe zasoby w REST API Allegro.
27 lipca pomiędzy godziną 3:00, a 5:30 przeprowadzimy prace modernizacyjne. W tym czasie mogą wystąpić przerwy w działaniu Allegro WebAPI oraz REST API.
Oferty, kończące się w czasie przerwy technicznej, przedłużymy o 24 godziny.
31 czerwca pomiędzy godziną 3:00, a 5:30 przeprowadzimy prace modernizacyjne. W tym czasie mogą wystąpić przerwy w działaniu Allegro WebAPI oraz REST API.
Oferty, które kończą się w czasie przerwy technicznej, przedłużymy o 24 godziny.
Przygotowaliśmy dwa endpointy dzięki którym pobierzesz informacje o ocenach.
31 maja pomiędzy godziną 1:00 a 5:00 przeprowadzimy prace modernizacyjne. W tym czasie mogą wystąpić przerwy w działaniu Allegro WebAPI oraz REST API, głównie w kwestiach związanych z płatnościami.
Oferty powinny zakonczyć się w czasie przerwy technicznej, a więc 31.05.2017 od godziny 01:00 do 05:00, przedłużymy o 24 godziny.
Dzisiaj, 11 maja, o godzinie 12:00 rozpoczniemy przerwę serwisową środowiska WebAPI Sandbox, która potrwa do końca dnia.
Przypominamy, że prace wykonywane podczas przerwy serwisowej skutkują przerwą w dostępie do środowiska oraz permanentnym usunięciem wszelkich danych utworzonych do tej pory na Sandboxie (np. dodatkowi użytkownicy czy transakcje kupna).
12 maja w godzinach 4:00 - 5:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie możecie odczuć przerwy w działaniu Allegro WebAPI oraz REST API, głównie w kwestiach związanych z logowaniem.
Oferty kończące się w czasie przerwy technicznej, a więc 12.05.2017 od godziny 04:00 do 05:00, zostaną przedłużone o 24 godziny.
Usunęliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de.
Przygotowaliśmy trzy endpointy dzięki którym pobierzesz listy warunków oferty.
15 marca w godzinach 1:00 - 4:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie REST API Allegro może być niedostępne.
8 lutego między godziną 6:00 a 7:00 zaplanowaliśmy prace modernizacyjne. Podczas trwania przerwy technicznej możecie napotkać chwilowe problemy z wystawianiem i edycją ofert przez API.
Przygotowaliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de.
25 stycznia między godziną 1:30 a 5:00 zaplanowaliśmy prace modernizacyjne. W tym czasie usługa REST API nie będzie dostępna.
Informujemy, że w środę, 16 listopada, w związku z planowaną przerwą techniczną która będzie miała miejsce od godziny 01:00 do 5:00, usługa REST API Allegro będzie niedostępna.
Informujemy, że w niedzielę, 30 października, w związku z planowaną przerwą techniczną która będzie miała miejsce od godziny 01:50 (czasu letniego) do 03:30 (czasu zimowego), usługa REST API Allegro będzie niedostępna.
Dziękujemy za pierwsze uwagi oraz sugestie dotyczące REST API. Najwięcej zgłoszeń otrzymaliśmy odnośnie procesu autoryzacji, który periodycznie wymaga ingerencji użytkownika. Kwestia ta zostanie rozwiązana w niedalekiej przyszłości – o aktualizacji procesu autoryzacji będziemy informować na bieżąco.
Tymczasem dla aplikacji zarejestrowanych od 06.08.2016 wydłużyliśmy czas ważności refresh_tokena do 365 dni.
Od dziś w ramach Allegro REST API masz możliwość modyfikacji ceny w trwających ofertach, nawet jeżeli pojawiła się w nich sprzedaż.
Służy do tego zasób Change the Buy Now price. Zachęcamy do zapoznania się z jego dokumentacją.
Udostępniliśmy dziś nowy interfejs programistyczny oparty o architekturę REST.
Pierwszy zasób, z którego możecie korzystać w ramach nowego interfejsu to: Change the Buy Now price, który pozwala na zmianę ceny w trwających ofertach, niezależnie od tego czy pojawiła się w nich sprzedaż.