[13.09] Pytasz i wiesz - Allegro API

[la_nika]

W tym wątku po webinarze z serii Pytasz i wiesz na pytania dotyczące API Allegro odpowiedzą eksperci - Paweł Taberski i Przemysław Łukanowski. 

W wątku znajdziecie zapis wszystkich pytań i odpowiedzi z webinaru. A jeśli coś będzie jeszcze niejasne to do 16 września możecie zadać jeszcze dodatkowe pytania naszym ekspertom. 

@Pawel_Taberski jest od ponad 5 lat związany z branżą e-commerce. Odpowiada za komunikację zmian i propagowanie wiedzy o API Allegro, które pozwala na automatyzację, aktualizację i obsługę dużej skali sprzedaży. Allegro nie ma przed nim tajemnic.

@p_lukanowski pracuje w Allegro od 3 lat. Na co dzień zajmuje się wsparciem zewnętrznych aplikacji, które integrują się API Allegro. Prócz tego odpowiada za warstwę edukacyjną oraz komunikacyjną związaną z API - prowadzi szkolenia, przygotowuje treści na stronę Allegro Developer Portal, a także testuje nowe funkcjonalności zanim zostaną upublicznione.

Zachęcamy do zadawania pytań!

[la_nika]

[Pytanie z webinaru]
Jakie istnieją ograniczenia co do możliwości zmiany kategorii w istniejącej ofercie opublikowanej lub nieaktywnej?

[p_lukanowski]

Kategorię w ofercie nieaktywnej można zmienić bez ograniczeń. Da opublikowanych ofert istnieje limit 12 godzin, po których zmiana kategorii nie jest możliwa oprócz poniższych przypadków:

• oferta ma podpięty produkt, ale kategoria jest błędna - pozwalamy na zmianę kategorii oferty na zgodną z kategorią produktu,
• oferta nie ma podpiętego produktu, bo nigdy go nie miała, albo została odpięta od Katalogu produktów - pozwalamy podpiąć produkt i jednocześnie zmienić kategorię oferty na zgodną z kategorią produktu.

[la_nika]

[Pytanie z webinaru]
Czy za pomocą PUT /parcel-managment-pickup-request-com-mands/{commandId} można zamówić jeden odbiór paczek przez danego kuriera dla paczek (parcelIds) stworzonych na różnych kontach allegro? 

[p_lukanowski]

Nie jest to możliwe, przez API odbiór można zlecić tylko dla tych paczek, które zostały wygenerowane w ramach danego konta.

[la_nika]

[Pytanie z webinaru]
Jak masowo wstawiać oferty na Allegro? Czy jest to możliwe bez kodu EAN produktów?
Jak masowo zaktualizować ilość towarów w Allegro? Które unikalne pole użyć podczas aktualizacji bez użycia kodu ean?

[p_lukanowski]

Każdą ofertę należy utworzyć pojedynczo za pomocą POST /sale/offers lub POST /sale/product-offers, jednak rekomendujemy drugie rozwiązanie, ponieważ zasoby do tworzenia ofert /sale/offers i edycji /sale/offers/{offerID} zostaną przez nas wyłączone z początkiem 2024. Za pomocą endpointu /sale/product-offers mogą Państwo wystawiać oferty, przekazując nam wyłącznie informacje o numerze GTIN, liczbie sztuk oraz cenie. Przy użyciu metody PATCH na zasobie /sale/product-offers/{offerID} mogą Państwo aktualizować dane w ofercie, wskazując nam wyłącznie to pole, które wymaga edycji. Więcej informacji na temat tej metody znajdą Państwo w naszym poradniku. W tej sekcji opisaliśmy natomiast, jak edytować wiele ofert jednocześnie.

[la_nika]

[Pytanie z webinaru]
Na początku 2024 roku wyłączycie zasoby sale/offers służące do tworzenia i edycji ofert. Czy w takim razie zasoby sale/product-proposals pozostają bez zmian?

[p_lukanowski]

Tak, zasób /sale/product-proposals pozostanie bez zmian. Chciałbym również dodać, że produkt można utworzyć za pomocą POST /sale/product-offers, dzięki czemu zostanie od razu połączony z ofertą.

[la_nika]

[Pytanie z webinaru]
 Czy do zamówienia można dodać inne załączniki niż faktura?

[p_lukanowski]

Do zamówienia można dołączyć wyłącznie fakturę, ale na poziomie oferty można dodać także inne załączniki. Może być ich maksymalnie 9 - po jednym załączniku z listy:

• Poradnik (MANUAL)
• Regulamin promocji (SPECIAL_OFFER_RULES)
• Regulamin konkursu (COMPETITION_RULES)
• Fragment książki (BOOK_EXCERPT)
• Instrukcję obsługi (USER_MANUAL)
• Instrukcję montażu (INSTALLATION_INSTRUCTIONS)
• Instrukcję gry (GAME_INSTRUCTIONS)
• Etykietę energetyczną (ENERGY_LABEL)
• Kartę produktu (PRODUCT_INFORMATION_SHEET)

[la_nika]

[Pytanie z webinaru]
Pobieram zwroty i w parcels mają one swój numer waybill. Pytanie czy na podstawie numeru waybill mogę ustalić status zwrotu paczki?

[p_lukanowski]

Nie, taka funkcja nie jest dostępna.

[la_nika]

[Pytanie z webinaru]
Czy mogę w jakiś sposób śledzić zmiany w waszym API, nie wchodząc co jakiś czas na stronę?

[p_lukanowski]

Tak, na naszej stronie znajdą Państwo newsletter - wystarczy się na niego zapisać i w ten sposób wszelkie informacje o zmianach w naszym API będziemy wysyłać bezpośrednio na skrzynkę pocztową.

[la_nika]

[Pytanie z webinaru]
Chciałem dopytać o warunki i możliwości korzystania z developer.allegro.pl. Chcielibyśmy zautomatyzować część procesów i potrzebowalibyśmy więcej informacji dotyczących warunków / limitów itp. korzystania z Allegro REST API. 

[p_lukanowski]

W usłudze Allegro REST API (produkcyjnej oraz testowej) obowiązuje główny limit nakładany na Client ID (lub Sofware Statement ID w przypadku DCR) - 9000 zapytań na minutę.

Po przekroczeniu limitu:

• na minutę zablokujemy Client ID,
• zwrócimy odpowiedź ze statusem: 429 Too Many Requests.

Po tym czasie automatycznie przywrócimy dostęp do usługi dla Państwa Client ID.

Dla niektórych zasobów stosujemy dodatkowe limity zapytań, jak np. leaky bucket - gdy użytkownik przekroczy dozwoloną liczbę wywołań na minutę (RPM), wydłużamy czas odpowiedzi. W przypadku zbyt dużej liczby równoległych zapytań w imieniu tego samego użytkownika serwer odpowie błędem HTTP: 429 Too Many Requests.

Jeśli chodzi o inne warunki, to zachęcamy się do zapozniania z pełnym regulaminem, którzy jest do przeczytania na naszej stronie.

[la_nika]

[Pytanie z webinaru]
Chciałbym mieć możliwość połączenia Allegro API z aplikacji MS ACCess. Prosiłbym o podanie skryptu VBA logującego z przykładami operacji jakie można wykonać. Ewentualnie dodatkowo prosiłbym o podanie jakim innym oprogramowanie warto się posługiwać Accessem (jaki jest obecnie trendy). 

[p_lukanowski]

Nie posiadamy takich skryptów, nie jesteśmy również do końca pewni, czy takie połączenie jest  w ogóle możliwe. Co do innych programów, to niestety nie możemy nic zarekomendować, ponieważ nie jesteśmy ich twórcami, zatem nie możemy wziąć odpowiedzialności za ich prawidłowe działanie. Zachęcamy, aby wpisać sobie po prostu w przeglądarce internetowej “allegro api integracja” i zapoznać się z najpopularniejszymi wynikami.

[la_nika]

[Pytanie z webinaru]
Limit 20 jednocześnie połączonych kont oznacza, że limit zostanie wyczerpany jeśli na każdym tych 20 powiązanych kont aktywny jest refreshToken/accessToken?

[Pawel_Taberski]

W API Allegro nie ma limitu na liczbę powiązanych kont z aplikacją. Obowiązuje limit dla liczby access tokenów, które możesz wygenerować w określonym czasie dla jednego użytkownika. Jeżeli go przekroczysz, w odpowiedzi zwrócimy błąd HTTP: 429 Too Many Requests. Oznacza to, że działanie Twojej aplikacji odbiega od normy - upewnij się, że nie tworzysz więcej tokenów niż wymagają tego operacje, które wykonujesz. Raz wygenerowany token dla jednego użytkownika powinien być używany aż do momentu wygaśnięcia, po tym czasie odśwież token za pomocą refresh tokena.