Zmiany w module Allegro - jak przejść na REST API? [edit]

REST API to rozwijane od 2017 przez Allegro nowe API, które pozwala na integrację konta Allegro z zewnętrznym systemem, jak AtomStore. Przejście na nowe API pociąga za sobą wiele korzyści dla sprzedawców. Eliminuje frustrujące błędy związane z wznawianiem aukcji czy poprawia stabilność działania wymiany danych.

W AtomStore wykorzystujemy REST API Allegro od kilkunastu miesięcy. Do tej pory obejmowało ono jedynie wybrane procesy. W ostatnich tygodniach prace nad API po stronie Allegro znacząco przyspieszyły - platforma zaczęła wyłączać kolejne metody na starym API. Dlatego sugerujemy przepięcie się na REST API.

Pomimo iż dołożyliśmy starań, aby przetestować nowe API i funkcje synchronizacji, należy mieć na uwadze, że moduł integracji jest nowy, metody w REST API Allegro nadal są rozwijane. W związku z tym trzeba liczyć się z drobnymi problemami w pierwszych tygodniach po uruchomieniu integracji za pomocą REST API.

W tym wpisie znajdują się najświeższe informacje dotyczące problemów z działaniem Allegro REST API oraz poszególnych metod. Na bieżąco staramy się informować o błędach ze strony platfromy handlowej oraz wyjaśnieniach. Kliknij tutaj, aby sprawdzić.

Jak zintegrować Allegro REST API z AtomStore?

1. Konfiguracja modułu Allegro w AtomStore odbywa się w zakładce Ustawienia → Konfiguracja sklepu → Sprzedaż i ceny.

Konfigurację REST API należy rozpocząć na stronie https://apps.developer.allegro.pl/. Następnie w rubryce "Adres aplikacji" należy wprowadzić: https://TWOJA-DOMENA.pl/admin/AllegroRestApi/getToken. Wygenerowane klucze wystarczy wprowadzić w sekcji Allegro REST API w AtomStore. Zalecamy następującą konfigurację ustawień, jak na załączonym obrazku.

UWAGA! Krok ten dotyczy Klientów, którzy jeszcze nie korzystali z REST API np. do aktualizacji stanów i cen produktów.

Więcej informacji znajduje się w sekcji Pomoc w panelu zarządzania AtomStore.

2. Określenie statusu zamówień.

 Na poziomie konfiguracji Allegro, należy zaznaczyć jaki status zamówień pobraniowych czy opłaconych przez Allegro PayU ma zostać przypisany do zamówienia. Można to zrobić w Ustawienia → Konfiguracja sklepu → Sprzedaż i ceny → Allegro.

UWAGA! Ten krok jest wymagany do prawidłowego importu zamówień.

3. Kolejnym krokiem jest zmapowanie form dostawy.

W integracji konieczne jest ponowne określenie odpowiednika formy dostawy w Allegro spośród dostępnych w sklepie online. Wynika to z zupełnie nowej struktury tych danych po stronie REST API Allegro. Zrobić to można w Multichannel → Allegro - formy dostawy.

Opcja Allegro - formy dostawy odblokowuje się dopiero po przejściu kroku 1 (konfiguracji kluczy dla REST API).

4. Następnym krokiem jest dodanie cennika dostawy.

Na początku należy zalogować się do swojego konta (lub kont) Allegro. W Moja sprzedaż → Ustawienia sprzedaży → Ustawienia dostawy → Dodaj cennik, ustawiamy cennik form dostaw. Następnie w panelu AtomStore Multichannel → Allegro - szablony wybierz nazwę cennika stworzonego wcześniej na koncie Allegro dla szablonu aukcji.

Dodanie cennika dostawy można dokonać jedynie przez panel Allegro, nie jest możliwe zdefiniowanie go przez Allegro API. Cennik należy przypisać w kazdym szablonie Allegro, który jest obecnie wykorzystywany w sklepie.

5. Pamiętaj o dodaniu formy płatności z jakich korzystasz

Podobnie jak cennik dostaw, zmapować należy formy płatności. Należy je przypisać w każdym szablonie Allegro, który jest obecnie wykorzystywany w sklepie.

Ważne! Przejście z WebAPI na REST API ma zakończyć się w Allegro w kwietniu 2020 roku. Pełny harmonogram wygaszania modułów WebAPI można sprawdzić tutaj. Do tego czasu każdy dotychczasowy Klient powinien przepiąć swoje konto Allegro na REST API.

Zalecamy przejście na REST API już teraz, ponieważ kolejne metody starego API Allegro są sukcesywnie wyłączane (np. wystawienia aukcji).

Dlaczego warto przejść na REST API Allegro?

Nowe API pracuje przede wszystkim stabilniej, a wiele funkcji doczekało się koniecznych udoskonaleń. Są to m.in. wznawianie aukcji, nawet w sytuacji, gdy towar został wyprzedany, ustawienie oferty bezterminowej, poprawa jakości importu zamówień (np. brak etapu z zamówieniami cząstkowymi, które trzeba było łączyć ze sobą) oraz zarządzanie kosztami dostawy na aukcjach.

Rozwijanie REST API to wciąż proces, który trwa po stronie samego Allegro. Wiele funkcji nadal jest w wersji beta.

Aktualizacje:

• Występują problemy przy aktualizacji/pobieraniu stanów magazynowych w Allegro po przejściu na REST API (są nieprawidłowe tj. większe niż faktycznie dostępne). Problem dotyczy niektórych aukcji (nie wszystkich). Jest to problem po stronie Allegro, nad którego rozwiązaniem obecnie pracują.
• Zalecamy mapowanie cennika dostaw oraz form pałtności w każdym używanym szablonie Allegro w sklepie (Multichannel --> Allegro - szablony). W przeciwnym wypadku mogą występować problemy z zamówieniami. 
• Ponowne mapowanie atrybutów kategorii jest konieczne. Jak zrobić to krok po kroku w naszym systemie tłumaczymy w nowej instrukcji.