Jak automatycznie wysyłać rozliczenia z marketplace do ERP — REST API zamiast ręcznego eksportu

Dashbord pobiera pliki rozliczeniowe z Allegro, Amazona i innych marketplace'ów, a następnie automatycznie dopasowuje każdą wpłatę do konkretnego zamówienia. To żmudna praca, którą system robi za Ciebie. Ale potem i tak trzeba te dane ręcznie przenieść do systemu ERP — Subiekt GT, enova365, Symfonia. Eksport CSV, logowanie do panelu, import po stronie ERP, sprawdzanie czy wszystko się zgadza. Codziennie lub co kilka dni.

REST API Dashbord eliminuje ten krok. ERP sam odpytuje Dashbord i pobiera gotowe, dopasowane rozliczenia — bez żadnego ręcznego działania.

Problem: most danych między marketplace a ERP

Typowy przepływ bez API wygląda tak: plik rozliczeniowy trafia do Dashbord, system dopasowuje wpłaty do zamówień, a księgowy lub integrator musi wejść do panelu, wyeksportować CSV, otworzyć system ERP i ręcznie zaimportować dane. Każdy z tych kroków to czas i potencjalne miejsce na błąd.

Skutki ręcznego procesu to nie tylko stracony czas:

Opóźnienia w księgowaniu — ERP dostaje dane z kilkudniowym poślizgiem, co utrudnia bieżące raportowanie finansowe.
Ryzyko błędu przy imporcie — nieprawidłowe mapowanie kolumn, różnice w formacie daty, zdublowane rekordy przy ponownym imporcie.
Zależność od osoby — jeśli ktoś zapomni lub jest nieobecny, dane w ERP są nieaktualne.
Brak historii zmian — trudno ustalić, który plik był importowany i kiedy.

API odwraca ten układ: to ERP przychodzi po dane, kiedy ich potrzebuje, i robi to sam.

Jak działa API ERP w Dashbord

API Dashbord opiera się na standardowym podejściu REST. Każde żądanie wymaga klucza API przekazywanego w nagłówku X-Api-Key (lub jako Bearer token w nagłówku Authorization). Klucz generujesz jednorazowo w panelu Dashbord i konfigurujesz po stronie swojego systemu ERP lub skryptu integracyjnego.

Dostępne są dwa podstawowe tryby pracy:

Lista nowych rozliczeń — endpoint zwraca wyłącznie wpisy, które nie zostały jeszcze pobrane. Po pobraniu są automatycznie oznaczane jako odczytane. Idealny tryb do regularnego odpytywania (np. co godzinę przez cron lub scheduler ERP).
Lista po numerze zamówienia — endpoint zwraca rozliczenia powiązane z konkretnym zewnętrznym ID zamówienia. Przydatne gdy ERP chce sprawdzić status konkretnej transakcji lub odtworzyć historię rozliczenia.

Każde żądanie do API jest logowane — masz pełen wgląd w to, kiedy ERP pobierał dane i co dokładnie dostał.

Endpointy

Dashbord udostępnia trzy endpointy do integracji z ERP:

GET /api/erp/reconciliations — zwraca nowe wpisy (nieodczytane). Po pobraniu każdy wpis jest automatycznie oznaczany jako odczytany, więc kolejne wywołanie zwróci tylko to, co pojawiło się od ostatniego razu.
GET /api/erp/reconciliations/all — zwraca wszystkie rozliczenia bez zmiany statusu odczytania. Służy do pełnej synchronizacji lub weryfikacji historycznej.
GET /api/erp/reconciliations/order/:externalId — zwraca rozliczenia powiązane z konkretnym zamówieniem (zewnętrzne ID z marketplace'u lub OMS-a).

Każde żądanie — niezależnie od endpointu — jest rejestrowane w logach API. Możesz sprawdzić historię zapytań z ostatnich 7 dni: kiedy ERP odpytywał system, który klucz był użyty i ile rekordów zostało zwróconych.

Przykład: żądanie i odpowiedź

GET /api/erp/reconciliations
Authorization: Bearer sk_live_abc123...

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "externalId": "ALG-2026-98231",
    "orderId": "ORD-00441",
    "amount": 142.50,
    "matchStatus": "matched",
    "settledAt": "2026-10-31T14:22:00Z"
  },
  {
    "externalId": "ALG-2026-98232",
    "orderId": "ORD-00442",
    "amount": 89.00,
    "matchStatus": "matched",
    "settledAt": "2026-10-31T14:22:00Z"
  }
]

Bezpieczeństwo

Klucz API generowany jest w panelu Dashbord i jest widoczny tylko raz — w momencie utworzenia. Skopiuj go i zapisz bezpiecznie po stronie swojego systemu. Po zamknięciu okna nie ma możliwości jego podglądu — tylko unieważnienie i wygenerowanie nowego.

Klucze są przechowywane jako hash SHA-256, co oznacza że nawet w przypadku incydentu bezpieczeństwa po stronie serwera surowy klucz nie jest możliwy do odtworzenia. Każdy klucz możesz unieważnić w dowolnym momencie z poziomu panelu — po unieważnieniu przestaje działać natychmiast.

Logi API przechowywane są przez 7 dni i zawierają: timestamp żądania, użyty klucz (zamaskowany), endpoint, liczbę zwróconych rekordów oraz adres IP klienta. To wystarczy do audytu i diagnostyki przy problemach z integracją.

Dla kogo to jest

API ERP w Dashbord jest przede wszystkim dla:

Integratorów ERP — firm które wdrażają i utrzymują systemy finansowe u klientów e-commerce. Zamiast budować import CSV, podłączają się do jednego endpointu.
Firm z własnym zespołem IT — jeśli masz programistę który utrzymuje wewnętrzne systemy, podłączenie Dashbord do ERP to kilka godzin pracy, nie tygodnie.
Software house'ów wdrażających systemy finansowe — każde nowe wdrożenie może skorzystać z gotowego API zamiast budować synchronizację od zera.

API działa z każdym systemem ERP, który potrafi wykonać zapytanie HTTP GET — Subiekt GT (przez sferę lub zewnętrzny skrypt), enova365, Symfonia, Optima, a także dowolne rozwiązania własne. Jedynym wymogiem po stronie ERP jest możliwość skonfigurowania harmonogramu odpytywania i obsługa odpowiedzi JSON.

Twój ERP pobiera rozliczenia sam — bez eksportu CSV, bez logowania do panelu, bez ręcznej pracy.

Jeśli chcesz zobaczyć jak rozliczenia wyglądają przed wysłaniem do ERP, sprawdź artykuł o rozliczeniach marketplace w Dashbord oraz jak działa billing Allegro.

Podłącz swój ERP do Dashbord

Klucz API wygenerujesz w kilka sekund. Integracja działa od razu po pierwszym zapytaniu.

Załóż konto →