Ta strona opisuje wewnętrzne narzędzie firmy FoxLink, które łączy się z Allegro REST API.
Opis i cel aplikacji
FoxLink-Migrator to wewnętrzne narzędzie firmy FoxLink Paweł Borys. Korzysta z niego tylko właściciel firmy i tylko na własnych kontach firmy na Allegro. Narzędzie nie obsługuje kont innych sprzedawców i nie jest im udostępniane.
W Allegro zarejestrowaliśmy dwie aplikacje tego narzędzia, po jednej na każde konto:
n8n_foxlink– konto FoxLink (konto firmowe),foxlink_migrator– konto AliLinka.
Narzędzie wystawia i aktualizuje oferty firmy, a sprzedawcę powiadamia o nowych zamówieniach, anulowaniach i dyskusjach po zakupie.
Zakres funkcjonalny aplikacji
- Wystawianie i aktualizowanie własnych ofert: produktów, parametrów, cen, stanów magazynowych i załączników.
- Odczyt ustawień sprzedaży konta, z których korzystają oferty.
- Sprawdzenie, które konto udzieliło dostępu (
GET /me). - Odczyt nowych zamówień, anulowań i dyskusji po zakupie, żeby powiadomić sprzedawcę. Powiadomienia odczytuje na głos asystent głosowy działający na serwerze firmy.
Zamówienia i dyskusje narzędzie tylko odczytuje. Niczego w zamówieniach nie zmienia.
Planujemy dodać dzienne podsumowanie sprzedaży, obsługę wiadomości od kupujących i podgląd zwrotów płatności.
Sposób połączenia z Allegro
Narzędzie łączy się z Allegro przez OAuth 2.0 w trybie Device Authorization Grant (device flow):
- Narzędzie wysyła żądanie do
https://allegro.pl/auth/oauth/devicei dostaje kod oraz adres strony, na której trzeba go potwierdzić. - Właściciel firmy loguje się na Allegro na koncie FoxLink albo AliLinka i zatwierdza dostęp.
- Narzędzie pobiera z
https://allegro.pl/auth/oauth/tokentoken dostępu i token odświeżania.
Tokeny zapisujemy w bazie danych firmy, na jej serwerze. Ten sam serwer je odświeża. Blokada w bazie danych pilnuje, żeby token odświeżał tylko jeden proces naraz. Tokenów nie przekazujemy nikomu.
Wykorzystanie Allegro API i wymagane uprawnienia
Konto
allegro:api:profile:read– sprawdzenie, które konto udzieliło dostępu.
Oferty
allegro:api:sale:offers:read– odczyt własnych ofert, żeby je aktualizować.allegro:api:sale:offers:write– wystawianie i aktualizowanie własnych ofert.allegro:api:sale:settings:read– odczyt ustawień dostawy i zwrotów, które przypisujemy do ofert.allegro:api:sale:settings:write– zmiana ustawień dostawy i zwrotów, z których korzystają oferty.
Zamówienia i powiadomienia
allegro:api:orders:read– odczyt nowych zamówień i anulowań, żeby powiadomić sprzedawcę.allegro:api:disputes– odczyt dyskusji po zakupie, żeby powiadomić sprzedawcę. Narzędzie dyskusje tylko odczytuje.allegro:api:shipments:read– odczyt statusu przesyłek.allegro:api:fulfillment:read– odczyt statusu realizacji i wysyłki zamówień.allegro:api:ratings– odczyt ocen od kupujących.
Planowane funkcje
allegro:api:billing:read– dzienne podsumowanie sprzedaży (planowane).allegro:api:messaging– obsługa wiadomości od kupujących (planowane).allegro:api:payments:read– podgląd zwrotów płatności (planowane).
Dostęp i bezpieczeństwo danych
- Narzędzie działa na serwerze firmy, w jej biurze.
- Do narzędzia trzeba się zalogować.
- Tokeny OAuth są zapisane w bazie danych firmy na tym samym serwerze i nie trafiają do nikogo spoza firmy.
- Powiadomienia o zamówieniach zapisują tylko numer zamówienia, kwotę, liczbę sztuk i tytuł oferty. Nie zapisują danych osobowych kupujących: imion i nazwisk, adresów, adresów e-mail, numerów telefonów ani treści wiadomości.
- Danych z Allegro nie przekazujemy nikomu.
Dane kontaktowe
- Firma – FoxLink Paweł Borys, ul. Malinowa 17i/1, 84-230 Rumia, NIP: 5882485811
- Osoba odpowiedzialna – Paweł Borys, właściciel firmy
- E-mail – [email protected]
- Telefon – +48 696 979 096