Framework integracji
Połącz Transportial z dowolnym systemem zewnętrznym (ERP, telematyka, platformy zamówień i inne) dzięki pełnemu REST API i App Store.
Wewnątrz produktu
Nowoczesne operacje logistyczne działają na wielu systemach. Transportial został zaprojektowany z myślą o integracjach. Pełne REST API z dokumentacją OpenAPI, wbudowany serwer FTP dla starszych integracji, parsowanie plików EDI i App Store do rozszerzania interfejsu. Każdy scenariusz integracji jest obsłużony.
Framework wygrywa z jednorazowymi konektorami
Prędzej czy później każdy przewoźnik słyszy prośbę o „ten XML, który wysyła ERP klienta”. Jednorazowy skrypt radzi sobie z tym, dopóki format się nie zmieni. Transportial traktuje każde połączenie jako konfigurację w tym samym frameworku: połączenie, format, mapowanie, filtry, wyzwalacze, testy i logi. Gotowe konektory to po prostu mapowania, które zespół dostarcza i utrzymuje; własna integracja najemcy dostaje to samo śledzenie i monitoring stanu.
Framework zapewnia też bezpieczeństwo operacyjne: tłumienie echa zatrzymuje pętle między dwoma systemami, okna synchronizacji utrzymują uczciwe odpytywanie pod obciążeniem, a te same zdarzenia wyzwalające, które sterują automatyzacjami, sterują danymi wychodzącymi.

Wirtualny FTP i szablony plików dla długiego ogona
Nie każdy partner ma API. Transportial hostuje serwer FTP, aby partner mógł wrzucać pliki do folderu należącego do Twojej platformy, a szablony plików parsują tekst o stałych pozycjach, arkusze według komórek i HTML. Ten sam silnik mapowania umieszcza następnie dane w zleceniach, przesyłkach i firmach.
Integracja · Wyzwalacz
Wyzwalacze wychodzące: zdarzenie plus warunek decydują, kiedy dane są wysyłane.



Jak to działa
Wybierz typ
Gotowy dla znanego partnera; samodzielnie konfigurowalny dla własnego API lub wymiany plików; dostęp do API dla własnego klienta partnera; szablon pliku dla arkuszy i plików o stałych pozycjach.

Połącz
Endpoint, harmonogram, uwierzytelnianie i nagłówki albo pozwól Transportial hostować dla Ciebie wirtualny folder FTP.

Zmapuj
Zmapuj pola na model OTM5, dodaj mapowania wartości i filtry lub wygeneruj mapowanie za pomocą AI na podstawie próbki.
Przetestuj
Utwórz przypadki testowe z oczekiwanym wynikiem i asercjami; uruchamiaj je przy każdej zmianie.
Uruchom i obserwuj
Śledź każdy obiekt przez zadania, logi i żądania; watchdog alarmuje, gdy integracja staje.


Co robi
Cztery sposoby łączenia
Gotowe konektory
Wbudowane obsługi dla telematyki, OEM rFMS, terminali, promów, giełd frachtowych, księgowości, CRM, płatności, e-maila, komunikatorów, kalendarzy i innych, wymienione w katalogu integracji.
Samodzielnie konfigurowalne
Dowolne API, webhook, FTP, SFTP, połączenie SQL, odbiornik e-maili lub wirtualny serwer FTP hostowany dla Ciebie przez Transportial; JSON, XML lub CSV; przychodząco i wychodząco.
Dostęp do API
REST API pod /api z trasami generowanymi z modelu, dokumentacja OpenAPI renderowana w ReDoc, klucze API i tokeny aplikacji oraz limit 500 żądań na minutę.
Szablony plików
Parsuj i twórz pliki za pomocą selektorów: macierz (pozycje w arkuszu), HTML, pozycja zmiennej tekstowej i stałe, dla partnerów, którzy pracują wyłącznie na plikach.
Mapowanie bez kodu
Mapowania pól
Pole przychodzące na ścieżkę wychodzącą z typem, regexem i opcjami, takimi jak przycinanie, wielka litera na początku, wielkie lub małe litery, usuwanie spacji i pola identyfikacyjne.
Mapowania wartości
Tłumaczenie kodów partnera na wartości platformy, łącznie z celami specyficznymi dla dostawców Transics, Webfleet, Mapon, Squarell, slotami telemetrycznymi i przyciskami pojazdu.
Filtry i wyzwalacze
Filtry porównań (==, !=, >, <, in, not in) z AND/OR; wyzwalacze wychodzące na dowolnym zdarzeniu wyzwalającym platformy z warunkiem.
Generowanie z AI
Wklej przykładowy plik lub odpowiedź API, a powstanie szkic mapowań pól; albo wygeneruj całą integrację na podstawie opisu.
Zarządzaj tym jak oprogramowaniem
Widok śledzenia
Karty logów, zadań, obiektów, żądań, testów, macierzy i HTML oraz ślad, który łączy obiekt → zadanie → log → żądanie.
Testy integracji
Wejście i oczekiwany JSON, asercje na poziomie błędu lub ostrzeżenia, dokładne dopasowanie, tylko asercje lub oba, uruchamianie wszystkich, z powiadomieniami o niepowodzeniach.
Niezawodność
Watchdog stanu zgłaszający alerty o zawieszeniu i ciszy, powiadomienia e-mail o błędach i przestojach, okna synchronizacji ograniczające wycinek danych, ale nigdy zasięg, równoważenie obciążenia między workerami Kafka, tłumienie echa, aby integracja nigdy nie otrzymała własnej zmiany, tryby logowania żądań: wszystkie, błędy lub wyłączone, oraz maskowanie sekretów.
Uwierzytelnianie
Klucz API, klucze dostępu, basic, OAuth, bearer, OpenID, klucze klienta i własne nagłówki.
Rozszerzaj platformę
App Store
Przeglądaj, instaluj i konfiguruj aplikacje z uprawnieniami, historią wersji i hookami: endpointy webhooków lub hooki UI, które dodają kartę pulpitu lub kartę menu.
Portal deweloperski
Aplikacje, wydawcy, klucze API, analityka, recenzje i modele cenowe (darmowy, freemium, jednorazowy, subskrypcja, rozliczenie za użycie: za wywołanie, trip, przesyłkę lub pojazd), z samodzielną rejestracją dostawców i deweloperów.
Webhooki
Webhooki wychodzące na zdarzeniach wyzwalających; webhooki przychodzące dla Stripe, Mollie, Adyen, Burger Ferry i Salesforce.
Przyciski akcji
Definiowane przez najemcę przyciski przy zasobach, które wywołują integrację, np. aby wysłać wiadomość na komputer pokładowy.
Szczegóły techniczne. Zadania integracyjne są rozdzielane między workery Kafka z równoważeniem obciążenia, tłumieniem echa i strażnikiem kondycji, który zgłasza alerty o zablokowanych i milczących integracjach. Żądania API są ograniczone do 500 na minutę. Aplikacje z App Store rozszerzają platformę przez webhooki i punkty zaczepienia w interfejsie.
Najpierw wypróbuj za darmo
Współpracuje z
Najczęściej zadawane pytania
Czy jest publiczne API?
Tak. REST API z dokumentacją OpenAPI, kluczami API i tokenami aplikacji oraz limitem 500 żądań na minutę. Narzędzie konwertera OTM5 pomaga w pracy z modelem.
Czy możemy podłączyć system bez API?
Tak. Użyj FTP lub SFTP, wirtualnego FTP hostowanego przez Transportial, odbiornika e-maili, połączenia SQL lub szablonów plików dla arkuszy i plików o stałych pozycjach.
Czy obsługujecie EDI?
Framework wymienia JSON, XML i CSV z dowolnym partnerem, a komunikaty EDIFACT są używane z partnerami promowymi i terminalowymi, takimi jak P&O Ferries i DP World. Ogólne komunikaty zleceń EDIFACT lub X12 są mapowane dla każdego partnera osobno.
Skąd wiemy, że integracja działa prawidłowo?
Watchdog zgłasza alerty o zawieszeniu i ciszy, błędy i przestoje wysyłają powiadomienia e-mail, a widok śledzenia łączy każdy obiekt z jego zadaniami, logami i żądaniami.
Czy integracje można przetestować przed uruchomieniem?
Tak. Przypadki testowe z wejściem, oczekiwanym wynikiem i asercjami uruchamia się pojedynczo lub wszystkie naraz, a test zakończony niepowodzeniem może wysłać powiadomienie.
Czy firmy zewnętrzne mogą budować na platformie?
Tak. App Store i portal deweloperski pozwalają wydawcom publikować aplikacje z hookami webhooków i UI oraz wyceniać je jako darmowe, freemium, jednorazowe, w subskrypcji lub z rozliczeniem za użycie.
Pojęcia i terminologia
- Gotowa integracja
- Wbudowany konektor do konkretnego systemu partnera, konfigurowany danymi dostępowymi i opcjami.
- Samodzielnie konfigurowalna integracja
- Zdefiniowane przez najemcę połączenie z dowolnym API, serwerem plików, bazą danych lub skrzynką pocztową z własnym mapowaniem.
- Mapowanie pola
- Reguła, która kopiuje pole przychodzące do ścieżki w modelu platformy, z typem, regexem i opcjami.
- Mapowanie wartości
- Tabela tłumaczeń kodów partnera na wartości platformy.
- Wirtualny FTP
- Serwer FTP hostowany przez Transportial dla Twojej platformy, aby partnerzy mogli wymieniać pliki bez własnego serwera.
- Tłumienie echa
- Niewysyłanie zmiany z powrotem do integracji, która ją spowodowała.
- EDISłownik
- Elektroniczna wymiana danych; Transportial wymienia w frameworku JSON, XML i CSV, a z partnerami promowymi i terminalowymi komunikuje się w EDIFACT.
- OTM5Słownik
- Otwarty model, do którego kierowane jest każde mapowanie.
![Tabela mapowania pól z nazwami pól przychodzących, takimi jak firma, kontaktperson, email i telefon, po lewej, typem dla każdego pola, ścieżkami wychodzącymi, takimi jak customer.name i customer.contactDetails[0].value, po prawej, kolumną regex i przyciskami Dodaj pole](/assets/screens/integration-data-mapping.webp)


