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.
![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)
- Pole przychodzące z pliku lub API partnera
- Typ i transformacja dla każdego pola
- Ścieżka wychodząca do zlecenia, klienta lub przesyłki
- Dodaj pola lub wygeneruj mapowanie za pomocą AI
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.
Co robi
Wszystko, co robi ten moduł, nazwane tak, jak znajdziesz to w produkcie.
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.
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.
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.
Pojęcia i terminologia
Słowa używane w tym module, z linkami do pełnego słownika, gdy pojęcie ma własną stronę.
- 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.
Wewnątrz produktu
Najpierw wypróbuj za darmo
Darmowe narzędzia, które robią część tego, co robi Framework integracji, bez zakładania konta. Gdy robienie tego pojedynczo zacznie Cię męczyć, moduł zrobi to automatycznie dla każdego zlecenia.
Współpracuje z
Konektory, które od razu zasilają ten moduł lub korzystają z jego danych.
Transics / ZF
Exact Online
Salesforce
Portbase
DP World
Timocom
P&O Ferries
PTV xRoute/xTourStworzony dla
Gdzie ten moduł daje najwięcej.
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.
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.
Zobacz wszystkie funkcje
Gotowy, by wykorzystać to w praktyce?
Zacznij za darmo z pełnym dostępem do platformy lub porozmawiaj z naszym zespołem o swojej operacji.