Aktualności

Nowe metody dostawy - Odbiór osobisty w punkcie sprzedawcy

Udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:

• Odbiór osobisty w punkcie sprzedawcy - id afa68f62-0154-4556-9ee4-3f97c3c5bdca
• Odbiór osobisty w punkcie sprzedawcy pobranie - id b6d6e4cf-67b3-4a4f-a38d-724335e9734f

Pamiętaj! Punkty odbioru osobistego dodasz dedykowanym zasobem /points-of-service, więcej informacji na ten temat znajdziesz w naszym poradniku.

Zarządzanie aplikacjami Allegro - możesz już usunąć zbędne klucze aplikacji

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.

Wygaszamy WebAPI do obsługi ofert i sprzedaży. Korzystaj z REST API

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ą:

• wystawiać i edytować oferty,
• wprowadzać zmiany w wielu ofertach jednocześnie,
• obsługiwać zamówienia.

Plany dla API Allegro

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

• Produktyzacja - grupujemy oferty z tym samym produktem
• planujemy udostępnić zasoby, które pozwolą powiązać nową i istniejącą ofertę z produktem z naszej bazy danych. Zasoby opublikujemy w wersji beta, by poznać twoje uwagi i sugestie.
• Równolegle pracujemy nad zasobami, które pozwolą dodać produkt do naszej bazy.
• zasoby, które pozwalają obsługiwać zamówienia udostępnimy w wersji public. Do tego czasu jesteśmy otwarci i chętnie wysłuchamy twoich uwag i sugestii czego jeszcze brakuje w obsłudze zamówień. Dlatego tym bardziej zachęcamy do testów.
• udostępnimy nowy zasób, którym dodasz informacje o przesyłce.
• wspólnie z InPostem rozwiążemy problem integracji związany z nowymi numerami zamówień.

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.

• 3 czerwca 2019 usuniemy metody do obsługi i zarządzania ofertami, które już dziś oznaczamy jako deprecated. Oznacza to, że już teraz odradzamy użycia tych metod w nowych rozwiązaniach i zalecamy migrację na REST API w istniejących rozwiązaniach. Dotyczy to metod:
• doNewAuctionExt.
• doChangeItemFields.
• doGetItemFields.
• doGetSellFormFieldsForCategory.
• doFinishItem.
• doFinishItems.
• doChangePriceItem.
• doChangeQuantityItem.
• doCheckNewAuctionExt.
• doVerifyItem.
• doCheckItemDescription.
• Zgodnie z wcześniejszą zapowiedzią w kwietniu 2019 usuniemy metodę doGetItemsList.
• W chwili, gdy udostępnimy w REST API zasoby które pozwalają obsługiwać zamówienia w wersji public oznaczymy metody do obsługi zamówień w WebAPI jako deprecated.

O planach dla innych metod i zasobów w API będziemy informować na bieżąco. W razie pytań zachęcamy do kontaktu.

Punkty odbioru osobistego - zmiany w zasobie

Zgodnie z zapowiedzią od dziś w metodach POST i PUT na zasobie /points-of-service w strukturze “address” pola:

• “Street”
• “Coordinates”

stają się obowiązkowe. Dokładny opis zasobów do zarządzania punktami odbioru osobistego znajdziesz w naszych aktualnościach.

Pokaż swoim użytkownikom ekran potwierdzenia konta

Dodaliśmy dziś ekran, gdzie użytkownik potwierdza konto, na którym chce uwierzytelnić daną aplikację:

• Code flow dla Allegro OAuth - ekran pokażemy jeśli w procesie autoryzacji, dodasz parametr prompt=confirm, np.:

  https://allegro.pl/auth/oauth/authorize?response_type=code&client_id=a21...6be&redirect_uri=http://exemplary.redirect.uri&prompt=confirm

• Device flow dla Allegro OAuth - ekran będziemy pokazywali zawsze, gdy użytkownik będzie zalogowany

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.

Przerwa techniczna

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.

Client_credentials flow dla Allegro OAuth2

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

[Zapowiedź] Punkty odbioru osobistego - zmiany w zasobie

Od 09.01.2019 w metodach POST i PUT na zasobie /points-of-service w strukturze “address” pola:

• “Street”
• “Coordinates”

staną się obowiązkowe. Dokładny opis zasobów do zarządzania punktami odbioru osobistego znajdziesz w naszych aktualnościach.

Nowe metody dostawy - Dostawa przez sprzedającego

Udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:

Przerwa techniczna

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.

Nowe pole external.id w zdarzeniach i zamówieniach

Dodaliśmy nowe pole external.id w zasobach:

• GET /order/events - dziennik zdarzeń
• GET /order/checkout-forms - lista zamówień
• GET /order/checkout-forms/{id} - szczegóły zamówienia

Jeśli w ofercie sprzedawca dodał zewnętrzny identyfikator, pokażemy go w zdarzeniach i zamówieniach utworzonych od dnia 23.11.2018 r.

Nowe zasoby - grupowa edycja ceny i liczby przedmiotów

Udostępniliśmy zasoby, które pozwolą:

1. Zmienić cenę w wielu ofertach jednocześnie:

• PUT /sale/offer-price-change-commands/{commandId} - chcę zlecić operację grupową zmiany ceny w wybranych ofertach.
• GET /sale/offer-price-change-commands/{commandId} - chcę sprawdzić ogólny status zleconej operacji grupowej zmiany ceny w ramach jednego {commandId}.
• GET /sale/offer-price-change-commands/{commandId}/tasks - sprawdzić statusy zadań operacji grupowej zmiany ceny w ramach jednego {commandId}.

2. Zmienić liczbę przedmiotów w wielu ofertach jednocześnie:

• PUT /sale/offer-quantity-change-commands/{commandId} - chcę zlecić operację grupową zmiany liczby przedmiotów w wybranych ofertach.
• GET /sale/offer-quantity-change-commands/{commandId} - chcę sprawdzić ogólny status zleconej operacji grupowej zmiany liczby przedmiotów w ramach jednego {commandId}.
• GET /sale/offer-quantity-change-commands/{commandId}/tasks - użyj tego zasobu, by sprawdzić statusy zadań operacji grupowej zmiany liczby przedmiotów w ramach jednego {commandId}.

Nowe pole w parametrach typu string - allowedNumberOfValues

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
    }
}

Zarządzanie aplikacjami Allegro - zmień adres przekierowania

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.

Powiązane aplikacje

Od dziś w dedykowanej zakładce “Powiązane aplikacje” w “Moim Allegro” użytkownik może:

• usunąć powiązanie aplikacji ze swoim kontem
• sprawdzić jakie aplikacje są powiązane z jego kontem.

Device flow dla Allegro OAuth

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ą:

• interfejsu graficznego,
• przeglądarki,
• lub innego prostego sposobu na wpisanie tekstu.

Obsługa oznaczeń na liście ofert dla rabatów ilościowych

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.

Nowe pole “smart” w szczegółach zamówienia

Udostępniliśmy nowe pole ‘smart’. Od teraz w zasobach:

• GET /order/checkout-forms - chcę pobrać listę zamówień
• GET /order/checkout-forms/{id} - chcę pobrać szczegóły zamówienia

zwracamy wartość true/false, która informuje czy kupujący skorzystał z opcji smart wybierając sposób i metodę dostawy.

Od 8.11. nie zwracamy kodu EAN w metodach doShowItemInfoExt i doGetItemsInfo

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ł:

• WebAPI - doGetItemFields
• REST API - GET /sale/offers/{offerId}

Nowe pole “discounts” w szczegółach zamówienia

Udostępniliśmy nowe pole ‘discounts’. Od teraz w zasobach:

• GET /order/checkout-forms - chcę pobrać listę zamówień
• GET /order/checkout-forms/{id} - chcę pobrać szczegóły zamówienia

zwracamy wartość, która informuje z jakiej zniżki skorzystał kupujący:

• COUPON - podczas płatności użyto kuponu,
• BUNDLE - niektóre przedmioty z zamówienia zostały kupione w zestawie,
• MULTIPACK - co najmniej jeden przedmiot w zamówieniu został kupiony z rabatem ilościowym,
• CROSSMULTIPACK - niektóre przedmioty z zamówienia zostały kupione z rabatem ilościowym na wielu ofertach.

Przerwa techniczna

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.

Wielowariantowość w REST API nowy pole - parametr weryfikujący

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’

Nowy zasób - moje oferty w wersji beta

Udostępniliśmy zasób do pobierania listy wszystkich ofert zautoryzowanego sprzedawcy, który utworzył te oferty (Moje oferty) w wersji beta:

• GET /sale/offers - chcę pobrać wszystkie moje oferty

Nowe pole w odpowiedzi w zasobach do zarządzania cennikami

Udostępniliśmy nowy pole “paymentPolicy” (rodzaj płatności) w odpowiedzi w zasobie:

• GET /sale/delivery-methods - chcę pobrać identyfikatory i nazwy metod dostawy, które są dostępne w Allegro.

Wprowadziliśmy limit na liczbę edytowanych ofert

Od dziś w zasobach:

• PUT /sale/offer-publication-commands/{commandId}.
• PUT /sale/offer-modification-commands/{commandId}.

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”
    }]
}

W kwietniu 2019 usuniemy metodę doGetItemsList

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.

Nowe zasoby - mapowanie dealId i lineItemId

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

Nowy zasób do usuwania draftów ofert

Udostępniliśmy nowy zasób do usuwania draftów ofert DELETE /sale/offers/{offerId}. Można nim usunąć tylko oferty o statusie “INACTIVE”.

Rabaty ilościowe dla zakupów w wielu ofertach sprzedającego

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.

Nowe możliwości w zasobie do wyszukiwania i przeglądania ofert w REST API

Wdrożyliśmy dziś dwie zmiany w metodzie GET na zasobie /offers/listing w REST API:

• Wdrożyliśmy nowy filtr, dzięki któremu możecie wyszukiwać oferty z darmową dostawą SMART.
• W odpowiedzi dodaliśmy nowe pole do filtrów numerycznych z jednostką “unit”.

Aktualizacja - kalkulator opłat

Wprowadzamy zmianę w kalkulatorze opłat w REST API. Dodaliśmy nowy parametr do pola “offer”: “multiVariant” czyli “oferta multiwariantowa”.

Wprowadzamy ograniczenia dla zmiany ceny w aktywnej ofercie

24 września wprowadzimy następujące ograniczenia dla jednorazowej zmiany ceny w ofercie:

• Jeśli cena w ofercie wynosi do 50 zł - sprzedawca może ją zwiększyć maksymalnie o kolejne 50 zł
• Jeśli cena w ofercie wynosi ponad 50 zł - sprzedawca może ją zwiększyć maksymalnie o kolejne 100%.

Przy próbie zmiany ceny powyżej ograniczeń w zasobach:

• PUT /offers/{offerId}/change-price-commands/{commandId}
• PUT /sale/offers/{offerId}
• PUT /sale/offer-modification-commands/{commandId}

• Jeśli cena w ofercie wynosi ponad 50 zł:
  “message”: “You cannot increase the price by more than PLN 50. The maximum price is PLN {cena Kup teraz + 50zł}.”,
  “userMessage”: “Nie możesz podnieść ceny więcej niż 50 zł. Maks. cena to {cena Kup teraz + 50zł} zł.”
• Jeśli cena w ofercie wynosi ponad 50 zł:
  “message”: “You cannot increase the price by more than 100% The maximum price is PLN {cena Kup teraz + 100%}”,
  “userMessage”: “Nie możesz podnieść ceny o więcej niż 100%. Maks. cena to {cena Kup teraz + 100%} zł.”

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.

Nowe metody dostawy od Poczty Polskiej

Wspólnie z Pocztą Polską, udostępniliśmy nowe metody dostawy. Identyfikatory nowych metod możesz uzyskać zasobem GET/sale/delivery-methods:

• Allegro Pocztex Kurier 48 - w cenie nie wyższej niż 9,90 zł - id 6eced786-aee4-47ba-9cb6-e24f8b1d3182
• Allegro Pocztex Kurier 48 pobraniowy - w cenie nie wyższej niż 12,36 zł - id ec0e7fff-8233-4869-99ce-fe2b67a7de84

• Allegro Przesyłka polecona - w cenie nie wyższej niż 5,90 zł - id aa1d05e0-943b-47cb-a759-9d8c16707129

Przerwa techniczna

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.

Nowy zasób, którym pobierzesz id ostatniego zdarzenia

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.

Zasoby do wystawiania i edycji ofert od września w wersji public

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:

• dodamy obsługę tagów w ofertach
• tymczasowo nie będziemy wymagać cennika dostawy, gdy wznawiasz lub modyfikujesz ofertę przez REST API. W pierwszej połowie przyszłego roku będziemy wymagać cennika dostawy również przy wznawianiu i edycji oferty
• udostępnimy nowe zasoby, dzięki którym będziecie mogli tworzyć i edytować cenniki dostaw.

Przerwa techniczna

16 sierpnia w godzinach 02:00 - 05:00 przeprowadzimy prace modernizacyjne w serwisie Allegro.

W tym czasie REST API Allegro będzie niedostępne.

Dodaliśmy nową strukturę w modelu oferty - Pasuje do pojazdów

W metodach:

• POST na zasobie /sale/offers
• PUT na zasobie /sale/offers/{offerId}
• GET na zasobie /sale/offers/{offerId}

wdrożyliśmy nową sekcję. Jeśli sprzedajesz w jednej z wybranych podkategorii Części samochodowych:

• Układ chłodzenia silnika
• Układ hamulcowy
• Układ kierowniczy
• Układ napędowy
• Układ wydechowy

Nowe zasoby do zarządzania zamówieniami

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:

• doGetPostBuyData
• doGetPostBuyFormsDataForSellers
• doGetPostBuyFormsIds
• doGetTransactionsIDs
• doGetSiteJournalDeals
• doGetSiteJournalDealsInfo
• doGetShipmentData

Dla zamówień przygotowaliśmy nowe zasoby w Allegro REST API:

• GET /order/events - dziennik zdarzeń
• GET /order/checkout-forms - lista zamówień
• GET /order/checkout-forms/{id}) - szczegóły zamówienia

Od dziś w ramach Allegro REST API możecie pobrać utworzone oferty wielowariantowe.

Dla wielowariantowości przygotowaliśmy nowy zasób w Allegro REST API:

• GET /sale/offer-variants - chcę pobrać utworzone oferty wielowariantowe.



Więcej…

Aktualizacja - zasób, którym sprawdzicie datę naliczenia kolejnej opłaty w ofercie

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

Od dziś w ramach Allegro REST API możecie tworzyć oferty wielowariantowe.

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.

Od dziś w ramach Allegro REST API możecie wyszukiwać i przeglądać oferty.

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.

Możesz wystawić maksymalnie 100 000 ofert na jednym koncie

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”
        }]}
      

Możesz już wprowadzić nazwę aplikacji

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

Jak nadać nazwę już zarejestrowanej aplikacji

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.

Oferta w wersji beta do końca lipca. Czekamy na Wasze uwagi i opinie

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.

Zwiększamy liczbę kontaktów w ogłoszeniach

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.

Wznów zakończoną ofertę

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

15.06. - kończymy oferty na środowisku testowym

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.

Aktualizacja regulaminu REST API

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?

• dostosujemy Regulamin do wymogów RODO
• wprowadzimy nowy tryb akceptacji zmian Regulaminu
• uporządkujemy jego treść

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.

Wygaszamy WebAPI do obsługi ofert i sprzedaży. Korzystaj z REST API

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

• Lipiec 2018 - zasoby, które pozwalają wystawiać i edytować oferty udostępnimy w wersji public.
• Lipiec 2018 - udostępnimy zasoby do pobierania i zarządzania zamówieniami z Allegro w wersji beta.
• Październik 2018 - udostępnimy zasoby dla zamówień w wersji public

Docelowo REST API Allegro będzie jedynym interfejsem aplikacyjnym, który pozwoli ci zarządzać ofertą i zamówieniami.

Wygaszamy WebAPI

• Nowe funkcjonalności będziemy udostępniać tylko w REST API.
• W październiku 2018 oznaczymy metody do obsługi oferty i zamówień jako deprecated. Od tego momentu, będziemy odradzać użycia tych metod w nowych rozwiązaniach i mocno zalecać migrację na REST API w istniejących rozwiązaniach.
• W kwietniu 2019 usuwamy metody do obsługi oferty i zamówień.

Do 31 maja zaktualizuj protokół szyfrowania danych TLS

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:

• po 31 maja: stracisz możliwość pobierania, tworzenia i edycji danych przez API Allegro. Jeśli wyślesz request z takiego serwera, to otrzymasz komunikat błędu, że używasz przestarzałej wersji protokołu TLS. Pełne wersje komunikatów dostępne są w naszej pomocy.
• po 30 czerwca: nie będziesz mógł nawiązać połączenia z API Allegro.

Zmiany w obsłudze kluczy API

Wdrożyliśmy kilka zmian w obsłudze kluczy przez Allegro WebAPI i REST API.

Aktualizacja - kalkulator opłat

Wprowadzamy zmianę w kalkulatorze opłat w REST API. Dodaliśmy nowy parametr do pola “offer”: “condition” czyli parametr “Stan”.

Przerwa techniczna

17 maja w godzinach 01:00 - 03:00 przeprowadzimy prace modernizacyjne w serwisie Allegro.

W tym czasie REST API Allegro będzie niedostępne.

Udostępniliśmy parametr typu string

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:

• Fotografia > Aparaty cyfrowe - Model
• Motoryzacja > Części samochodowe > Filtry > Kabinowe - Numer katalogowy

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.

Nowy rodzaj parametru - zapowiedź

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:

• z jedną wartością
• z wieloma wartościami

Przykładowy parametr stringowy:

Skład:

Bawełna 80%

Elastan 10%

Poliester 10%

Grupowa edycja ofert - poszerzamy możliwości zasobu

Tabele rozmiarów w REST API

Od teraz możesz pobrać identyfikatory Tabel rozmiarów i ich zawartość.

Wystawiaj i zarządzaj ofertami przez REST API

Nowe środowisko testowe - Allegro Sandbox

Przestajemy wspierać domenę https://ssl.allegro.pl

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

GitHub zamiast Facebooka

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.

Przestajemy wspierać domenę https://ssl.allegro.pl

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.

Przerwa techniczna

28 lutego w godzinach 02:00 - 04:00 przeprowadzimy prace modernizacyjne w serwisie Allegro. W tym czasie REST API Allegro będzie niedostępne.

Zmieniamy nazwę domen allegroapi.io na allegro.pl

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:

• developer.allegroapi.io (portal developerski) - nowy adres to developer.allegro.pl
• credentials.allegroapi.io (subportal do rejestracji aplikacji) - nowy adres to apps.developer.allegro.pl

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.

Udostępniamy zasób, którym sprawdzicie datę naliczenia kolejnej opłaty w ofercie

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

Rabaty ilościowe i Zestawy promocyjne - nowe pole w odpowiedzi “status”

Poszerzyliśmy response w metodach:

• POST /sale/loyalty/promotions
• GET /sale/loyalty/promotions?user.id={Seller_ID}
• GET /sale/loyalty/promotions/{promotionId}

o nowe pole ‘status’. Dla tego pola dostępne są dwie wartości:

• ACTIVE - oznacza, że w danej ofercie masz wystarczający zapas przedmiotów i promocja jest gotowa do wykorzystania
• SUSPENDED - oznacza, że masz za mały zapas produktów w danej ofercie, aby skorzystać z tej promocji. Aby z niej skorzystać, uzupełnij ilość przedmiotów

WAŻNE! Obecnie dla Zestawów promocyjnych to pole zawsze będzie miało wartość ACTIVE.

Rabaty ilościowe

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.

Udostępniamy zasoby do zarządzania kontaktami

Niedawno udostępniliśmy ogłoszenia w Allegro, dlatego teraz udostępniamy wam zasoby, które pozwolą zarządzać kontaktami w REST API.

Zmieniamy adres domeny w procesie autoryzacji

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.

Grupowa edycja ofert

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.

Usługi dodatkowe

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.

Kalkulator opłat

Udostępniamy ogłoszenia w Allegro, dlatego wprowadzamy zmiany w kalkulatorze opłat w REST API.

Przerwa techniczna

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.

Allegro.pl sp. z o.o. łączy się z Grupą Allegro sp. z o.o.

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

Promocyjne zestawy ofert

Udostępniliśmy naszym sprzedającym promocyjne zestawy ofert. Dzięki temu sprzedawca może sprzedawać w obniżonej cenie zestaw kilku ofert.

Nowe zasoby, którymi pobierzesz informacje o ocenach

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.

Kalkulator opłat

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.

Punkty odbioru osobistego

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.

Przerwa techniczna

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.

Przerwa techniczna

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.

Nowe zasoby, którymi pobierzesz informacje o ocenach

Przygotowaliśmy dwa endpointy dzięki którym pobierzesz informacje o ocenach.

Przerwa techniczna

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.

Przerwa serwisowa środowiska WebAPI Sandbox

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

Przerwa techniczna

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.

Usunięcie zasobów - “Publikuj Ofertę również na Allegro.de”

Usunęliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de.

Nowe zasoby - “Warunki oferty”

Przygotowaliśmy trzy endpointy dzięki którym pobierzesz listy warunków oferty.

Przerwa techniczna

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.

Przerwa techniczna

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.

Nowe zasoby - “Publikuj Ofertę również na Allegro.de”

Przygotowaliśmy dwa endpointy do hurtowego udostępniania ofert w Allegro.de.

Przerwa techniczna

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.

Przerwa techniczna

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.

Przerwa techniczna

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.

Wydłużyliśmy czas ważności refresh_tokena do 365 dni

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.

Możliwość zmiany ceny Kup Teraz

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

Allegro REST API - zaczynamy!

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