HydrometProduktGT – dokumentacja integracji z Allegro REST API

Wersja integracji: 2026.09
Data aktualizacji dokumentacji: 4 września 2026 r.
Rodzaj aplikacji: wewnętrzna aplikacja desktopowa
Właściciel aplikacji: Przedsiębiorstwo Wielobranżowe Hydromet Stanisław Zyga

1. Przeznaczenie aplikacji

HydrometProduktGT jest wewnętrzną aplikacją firmy Hydromet przeznaczoną do analizy sprzedaży prowadzonej na własnym koncie sprzedawcy Allegro.

Aplikacja pobiera za pośrednictwem Allegro REST API informacje o zamówieniach oraz operacjach billingowych, a następnie lokalnie łączy je z dokumentami sprzedaży zarejestrowanymi w programie Subiekt GT.

Celem integracji jest:

• przypisywanie opłat Allegro do konkretnych zamówień,
• powiązanie zamówień Allegro z fakturami i korektami sprzedaży w Subiekcie GT,
• analiza prowizji, opłat dodatkowych i zwrotów,
• obliczanie rzeczywistych kosztów sprzedaży internetowej,
• analiza rentowności sprzedaży,
• wykrywanie dokumentów i opłat, których nie udało się jednoznacznie powiązać,
• przygotowywanie wewnętrznych raportów kontrolnych.

HydrometProduktGT nie jest usługą publiczną ani aplikacją udostępnianą klientom lub innym sprzedawcom. Obsługuje wyłącznie własne konto Allegro firmy Hydromet.

2. Sposób działania

Analiza jest uruchamiana przez uprawnionego pracownika firmy Hydromet.

Przepływ danych wygląda następująco:

1. Użytkownik wybiera zakres dat analizowanego okresu.
2. Aplikacja pobiera z Allegro informacje o zamówieniach.
3. Aplikacja pobiera operacje billingowe, w tym prowizje, opłaty, dopłaty i zwroty.
4. Operacje są grupowane według identyfikatora zamówienia Allegro order.id.
5. Zamówienia są porównywane z dokumentami sprzedaży zapisanymi w Subiekcie GT.
6. Wynik jest prezentowany w lokalnym raporcie.
7. Użytkownik może świadomie wyeksportować wynik analizy do pliku Excel.

Aplikacja zachowuje znaki operacji billingowych, dzięki czemu zwrot naliczonej wcześniej opłaty nie jest traktowany jako kolejny koszt.

3. Zakres odczytywanych danych

W zakresie zamówień aplikacja może odczytać:

• identyfikator UUID zamówienia Allegro,
• datę zakupu,
• status zamówienia,
• login kupującego,
• adres e-mail kupującego, jeżeli jest udostępniony przez API,
• wartość brutto zamówienia.

W zakresie rozliczeń aplikacja może odczytać:

• identyfikator operacji billingowej,
• rodzaj operacji,
• datę operacji,
• powiązany identyfikator zamówienia,
• kwotę i walutę,
• oznaczenie obciążenia lub uznania,
• informacje podatkowe udostępnione przez API,
• marketplace, którego dotyczy operacja.

Podstawowe dane profilu konta są używane wyłącznie do sprawdzenia, czy aplikacja została połączona z właściwym kontem Hydromet.

4. Wykorzystywane zakresy uprawnień OAuth

Aplikacja korzysta wyłącznie z następujących zakresów odczytu:

• allegro:api:orders:read – odczyt zamówień,
• allegro:api:billing:read – odczyt historii opłat i rozliczeń,
• allegro:api:profile:read – odczyt podstawowych danych konta w celu jego identyfikacji.

Aplikacja nie żąda zakresów pozwalających na zapis lub modyfikację danych.

5. Wykorzystywane zasoby Allegro REST API

Aplikacja korzysta z następujących zasobów:

• GET /me – identyfikacja podłączonego konta,
• GET /order/checkout-forms – pobieranie listy zamówień,
• GET /order/checkout-forms/{orderId} – pobieranie szczegółów wskazanego zamówienia,
• GET /billing/billing-entries – pobieranie historii opłat i rozliczeń.

Żądania POST są wykorzystywane wyłącznie w procesie OAuth do uzyskania i odświeżenia tokenu dostępu. Aplikacja nie wykonuje operacji POST, PUT, PATCH ani DELETE zmieniających dane biznesowe w Allegro.

6. Autoryzacja konta

Połączenie z Allegro odbywa się z wykorzystaniem mechanizmu OAuth 2.0 Device Authorization Grant.

Proces autoryzacji wygląda następująco:

1. Pracownik uruchamia połączenie w HydrometProduktGT.
2. Aplikacja wyświetla stronę autoryzacji Allegro.
3. Użytkownik loguje się bezpośrednio na stronie Allegro.
4. Użytkownik wyraża zgodę na wymagane zakresy odczytu.
5. Aplikacja otrzymuje token dostępowy i token odświeżający.

HydrometProduktGT nie pobiera ani nie przechowuje hasła użytkownika do Allegro.

Dostęp można cofnąć w ustawieniach połączonych aplikacji na koncie Allegro. Funkcja „Odłącz lokalnie” usuwa tokeny zapisane na komputerze, ale nie zastępuje cofnięcia uprawnień po stronie konta Allegro. Mechanizm OAuth i zakresy dostępu są opisane w oficjalnej dokumentacji autoryzacji Allegro.

7. Operacje, których aplikacja nie wykonuje

HydrometProduktGT:

• nie tworzy ani nie zmienia ofert,
• nie zmienia cen i stanów magazynowych w Allegro,
• nie zmienia statusów zamówień,
• nie tworzy przesyłek,
• nie wysyła wiadomości do kupujących,
• nie anuluje zamówień,
• nie dokonuje zwrotów płatności,
• nie zmienia danych konta Allegro,
• nie zapisuje ani nie modyfikuje dokumentów w Subiekcie GT w ramach tej integracji,
• nie podejmuje automatycznych decyzji wobec kupujących,
• nie wykorzystuje danych do marketingu ani profilowania klientów.

Integracja działa wyłącznie w trybie odczytu i tworzy lokalne wyniki analityczne.

8. Przechowywanie danych

Surowe odpowiedzi otrzymane z Allegro REST API są przetwarzane w pamięci aplikacji i nie są zapisywane jako oddzielne archiwum odpowiedzi API.

Lokalna baza mapowań może przechowywać:

• identyfikator zamówienia Allegro,
• identyfikator i numer dokumentu z Subiekta GT,
• metodę dopasowania,
• poziom pewności dopasowania,
• status weryfikacji,
• datę aktualizacji mapowania.

Lokalna baza mapowań nie zawiera Client Secret ani tokenów OAuth.

Użytkownik może ręcznie wyeksportować wynik analizy do pliku Excel. Eksport może zawierać identyfikatory zamówień, dane potrzebne do dopasowania, kwoty oraz wynik analizy. Utworzony plik pozostaje pod kontrolą firmy Hydromet.

Mapowania i wyeksportowane raporty są przechowywane lokalnie przez okres wymagany do wewnętrznych analiz i rozliczeń, a następnie mogą zostać usunięte przez uprawnionego administratora.

9. Bezpieczeństwo

Client Secret, token dostępowy oraz token odświeżający są przechowywane wyłącznie na komputerze, na którym działa aplikacja.

Dane te są szyfrowane za pomocą mechanizmu Windows Data Protection API dla bieżącego użytkownika systemu Windows. Nie są umieszczane w dokumentacji, raportach ani przenośnych kopiach konfiguracji.

Dostęp do programu i jego danych jest przeznaczony wyłącznie dla uprawnionych pracowników firmy Hydromet.

Aplikacja nie przekazuje pobranych danych zewnętrznym podmiotom i nie udostępnia publicznego API. Dane są używane wyłącznie do wewnętrznych analiz sprzedaży i rozliczeń własnego konta Allegro.

10. Dane kupujących

Dane kupujących udostępnione przez Allegro są wykorzystywane wyłącznie w zakresie potrzebnym do:

• odnalezienia właściwego dokumentu sprzedaży,
• potwierdzenia poprawności dopasowania,
• rozliczenia kosztów zamówienia,
• obsługi wewnętrznego raportu sprzedaży.

Dane nie są wykorzystywane do dodatkowych działań marketingowych, profilowania ani udostępniania innym podmiotom.

Pytania dotyczące przetwarzania danych można kierować na adres: kontakt@24hydromet.pl.

11. Identyfikacja User-Agent

Każde żądanie aplikacji do Allegro REST API jest identyfikowane nagłówkiem:

HydrometProduktGT/2026.09 (+https://24hydromet.pl/hydrometproduktgt/)

Nazwa HydrometProduktGT odpowiada nazwie aplikacji zarejestrowanej w Allegro Developer Apps. Adres podany w nagłówku prowadzi do niniejszej publicznej dokumentacji.

12. Historia wersji

2026.09

• integracja z zamówieniami Allegro,
• odczyt historii opłat,
• identyfikacja podłączonego konta,
• powiązanie zamówień z dokumentami Subiekta GT,
• lokalny rejestr potwierdzonych mapowań,
• eksport wyników analizy.

13. Właściciel i kontakt

Przedsiębiorstwo Wielobranżowe Hydromet Stanisław Zyga
ul. Lubelska 80
22-400 Zamość
NIP: 922-000-72-79

Strona internetowa: https://24hydromet.pl/
E-mail: kontakt@24hydromet.pl

HydrometProduktGT jest aplikacją wewnętrzną i nie jest oferowana jako usługa dla innych firm lub użytkowników.

14. Dokumentacja Allegro

Integracja została przygotowana na podstawie publicznej dokumentacji Allegro REST API:

• Autoryzacja OAuth: https://developer.allegro.pl/tutorials/uwierzytelnianie-i-autoryzacja-zlq9e75GdIR
• Obsługa zamówień: https://developer.allegro.pl/tutorials/jak-obslugiwac-zamowienia-GRaj0qyvwtR
• Historia opłat: https://developer.allegro.pl/tutorials/jak-sprawdzic-oplaty-nn9DOL5PASX
• Wymagania User-Agent: https://developer.allegro.pl/news/do-konca-czerwca-2026-zaimplementuj-wlasny-niestandardowy-identyfikator-user-agent-w-twojej-aplikacji-q0K2EbxgXCg
• Regulamin REST API Allegro: https://developer.allegro.pl/rules