Trans.eu — faktury za fracht
Integracja dla przewoźników korzystających z platformy Trans.eu. Pobieramy listę zrealizowanych zleceń transportowych, jednym kliknięciem dodajemy zleceniodawcę do kartoteki kontrahentów i wystawiamy fakturę za fracht — bez przepisywania danych z platformy.
Moduł znajdziemy w grupie Inne: pozycja Trans.eu to lista zleceń, a Połaczenia Trans.eu — konfiguracja kont.
Połączenie z platformą
Zaczynamy od dodania połączenia (Inne → Połaczenia Trans.eu → Dodaj).
Potrzebne są dane aplikacji z panelu deweloperskiego Trans.eu: Client ID,
Client Secret i Api-key. W panelu aplikacji Trans.eu rejestrujemy
dokładnie ten adres powrotny, który okno pokazuje w polu tylko do odczytu
(http://127.0.0.1:53682/) — adres musi zgadzać się co do znaku, inaczej
autoryzacja zostanie odrzucona.
Przycisk Autoryzuj otwiera przeglądarkę, w której logujemy się na konto Trans.eu i potwierdzamy dostęp. Program czeka na potwierdzenie do 5 minut. Uzyskany token dostępowy żyje około 6 godzin i odnawia się automatycznie — autoryzację wykonujemy raz, nie przed każdym pobraniem.
W sekcji Wystawianie faktury ustawiamy:
- Nazwa usługi na fakturze — pusta oznacza „Usługa transportowa”,
- Stawka VAT dla pozycji frachtu. To celowo nasze ustawienie, nie wartość z platformy: transport międzynarodowy bywa opodatkowany stawką 0%, NP albo odwrotnym obciążeniem zależnie od kierunku i statusu kontrahenta, a Trans.eu nie zwraca polskiej kwalifikacji podatkowej — program nie zgaduje jej za nas.
Można dodać kilka połączeń, jeśli firma pracuje na kilku kontach Trans.eu.
Lista zleceń
W widoku Trans.eu wybieramy połączenie, zakres dat (domyślnie ostatnie 30 dni — typowy okres rozliczeniowy przewoźnika) i klikamy Pobierz zlecenia. Lista pokazuje numer zlecenia, datę, zleceniodawcę z numerem NIP / VAT-ID, miejsca załadunku i rozładunku, kwotę frachtu, walutę oraz status realizacji — dzięki niemu nie zafakturujemy zlecenia, które nie zostało jeszcze wykonane.
Wynik pobrania jest buforowany przez 10 minut — kolejne kliknięcia w tym czasie nie odpytują platformy. Gdy chcemy mieć pewność, że widzimy najświeższy stan, używamy przycisku Odśwież z serwera, który pomija bufor.
Import zleceniodawcy
Importuj kontrahenta dodaje zleceniodawcę zaznaczonego zlecenia do kartoteki. Program najpierw szuka istniejącego kontrahenta po numerze NIP — porównanie ignoruje separatory i prefiks kraju, więc „PL 887-116-00-53” z kartoteki i „8871160053” z platformy to ten sam podmiot. Po nazwie program dopasowuje wyłącznie wtedy, gdy zlecenie nie niesie NIP-u — i tylko wśród kontrahentów bez NIP-u. Jeśli kontrahent już istnieje, uzupełniane są jedynie brakujące pola; duplikat nie powstaje.
Wystawienie faktury
Wystaw fakturę tworzy fakturę VAT z jedną pozycją: usługą transportową o nazwie z ustawień połączenia i kwocie frachtu netto ze zlecenia. Do opisu pozycji trafia trasa (załadunek → rozładunek) i numer zlecenia, który zapisuje się też w polu „Nr zamówienia” dokumentu.
Każde zlecenie fakturujemy tylko raz — program oznacza fakturę znacznikiem z numerem zlecenia i przy ponownej próbie informuje, że zlecenie było już zafakturowane, zamiast tworzyć duplikat.
Fracht w walucie obcej (np. EUR przy przewozach międzynarodowych) jest przeliczany na złote:
- pole Kurs nad listą pozwala wpisać kurs ręcznie (np. umowny) — wartość większa od zera ma pierwszeństwo,
- przy kursie „0” program pobiera średni kurs NBP z dnia poprzedzającego datę zlecenia (art. 31a ustawy o VAT); gdy na ten dzień nie ma tabeli (weekend, święto), cofa się do ostatniej opublikowanej,
- jeśli kursu nie uda się pobrać (brak internetu), program poprosi o wpisanie go ręcznie — faktura nie powstanie z kursem zerowym.
Czego integracja nie robi
Zakres jest świadomie wąski — Faktura VAT nie jest systemem TMS. Program nie przechowuje tras, ładunków, pojazdów ani kierowców; trasa i numer zlecenia trafiają wyłącznie do opisu pozycji na fakturze. Zlecenia nie są też nigdzie zapisywane na stałe — lista służy do zaimportowania kontrahenta i wystawienia dokumentu.