Informacje o aplikacji

Integracja z Allegro REST API

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

  1. Narzędzie wysyła żądanie do https://allegro.pl/auth/oauth/device i dostaje kod oraz adres strony, na której trzeba go potwierdzić.
  2. Właściciel firmy loguje się na Allegro na koncie FoxLink albo AliLinka i zatwierdza dostęp.
  3. Narzędzie pobiera z https://allegro.pl/auth/oauth/token token 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