[Home](/pl)›[Produkt](/pl/product)›Framework integracji Rozszerzaj i zarządzaj # 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. [Zacznij za darmo](https://portal.otms.transportial.com/auth/register)[Poproś o demo](/pl/contact) REST APIOpenAPIFTPEDIApp StoreSDKKafka REST Full OpenAPI spec FTP Embedded server EDI EDIFACT & file templates App Store UI extensions Integracja · Mapowanie danych ![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) Mapuj dowolne pole przychodzące na ścieżkę w modelu OTM5, z typami, regexem i opcjami dla każdego pola. 1. Pole przychodzące z pliku lub API partnera 2. Typ i transformacja dla każdego pola 3. Ścieżka wychodząca do zlecenia, klienta lub przesyłki 4. 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](/pl/integrations). * 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 1. ### 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. 2. ### Połącz Endpoint, harmonogram, uwierzytelnianie i nagłówki albo pozwól Transportial hostować dla Ciebie wirtualny folder FTP. 3. ### Zmapuj Zmapuj pola na model OTM5, dodaj mapowania wartości i filtry lub wygeneruj mapowanie za pomocą AI na podstawie próbki. 4. ### Przetestuj Utwórz przypadki testowe z oczekiwanym wynikiem i asercjami; uruchamiaj je przy każdej zmianie. 5. ### Uruchom i obserwuj Śledź każdy obiekt przez zadania, logi i żądania; watchdog alarmuje, gdy integracja staje. Integracje · Nowa integracja ![Formularz nowej integracji z nazwą, opisem i listą typów: gotowa, samodzielnie konfigurowalna, dostęp do API i szablon pliku, oraz przyciskiem Generuj z AI](/assets/screens/integration-types.webp) Cztery typy integracji: gotowy konektor, samodzielnie konfigurowalna, dostęp do API i szablon pliku. ## 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. Integracje · Gotowe ustawienia ![Selektor gotowych integracji z listą transics, web_fleet, squarell, evogps, trimble, mapon, portbase, psa i dpworld](/assets/screens/integration-presets.webp) Gotowe konektory: wybierz konektor, dodaj dane dostępowe, gotowe. ## 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 · Konfiguracja ![Konfiguracja gotowej integracji z wartością i jednostką harmonogramu, adresem URL i portem, typem uwierzytelniania basic z nazwą użytkownika i hasłem, przyciskami dodania atrybutu i nagłówka oraz przełącznikiem włącz/wyłącz](/assets/screens/integration-preset-config.webp) Harmonogram, endpoint, uwierzytelnianie i nagłówki dla każdego połączenia. ## 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ę. [Otwórz słownik](/pl/glossary) 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. EDI[Słownik](/pl/glossary/edi) Elektroniczna wymiana danych; Transportial wymienia w frameworku JSON, XML i CSV, a z partnerami promowymi i terminalowymi komunikuje się w EDIFACT. OTM5[Słownik](/pl/glossary/otm5) Otwarty model, do którego kierowane jest każde mapowanie. ## Wewnątrz produktu Integracja · Wyzwalacz ![Wyzwalacz samodzielnie konfigurowalnej integracji z interwałem, zdarzeniem po aktualizacji tripu i selektorem status równy potwierdzony](/assets/screens/integration-trigger.webp) Wyzwalacze wychodzące: zdarzenie plus warunek decydują, kiedy dane są wysyłane. ## 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. [Wszystkie darmowe narzędzia](/pl/tools) [Darmowe narzędzieKonwerter OTM5Zamień CSV lub JSON na zlecenia transportowe OTM5](/pl/tools/otm5-converter) ## Współpracuje z Konektory, które od razu zasilają ten moduł lub korzystają z jego danych. [![](/assets/integrations/zf-transics.svg)Transics / ZF](/pl/integration/transics)[![](/assets/integrations/exact.svg)Exact Online](/pl/integration/exact-online)[![](/assets/integrations/salesforce.svg)Salesforce](/pl/integration/salesforce)[![](/assets/integrations/portbase.svg)Portbase](/pl/integration/portbase)[![](/assets/integrations/dp-world.svg)DP World](/pl/integration/dp-world)[![](/assets/integrations/timocom.svg)Timocom](/pl/integration/timocom)[![](/assets/integrations/po-ferries.svg)P&O Ferries](/pl/integration/po-ferries)[![](/assets/integrations/ptv.svg)PTV xRoute/xTour](/pl/integration/ptv)[Wszystkie integracje →](/pl/integration) ## Stworzony dla Gdzie ten moduł daje najwięcej. [3PL i operatorzy logistyczni](/pl/solutions/logistics-service-providers)[Spedytorzy](/pl/solutions/freight-forwarders)[Nadawcy i producenci](/pl/solutions/shippers) 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. ## 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. ## Powiązane funkcje [Zobacz wszystkie funkcje](/pl/product) [Wielodostępność i white-labelProwadź własną platformę logistyczną pod swoją marką, w pełni odizolowaną i konfigurowalną, we własnej domenie.](/pl/product/white-label)[Raporty i analizyZamieniaj dane operacyjne w decyzje dzięki konfigurowalnym pulpitom, zapytaniom TQL i pełnej ścieżce audytu.](/pl/product/reporting)[Automatyzacja wiadomościWysyłaj właściwą wiadomość właściwej osobie dokładnie we właściwym momencie, automatycznie wyzwalaną przez ponad 75 zdarzeń operacyjnych.](/pl/product/message-automations) Zobacz wszystkie funkcje [Zarządzanie zleceniami transportowymi](/pl/product/transport-orders)[Interaktywna tablica planowania](/pl/product/plan-board)[Optymalizacja tripów wspierana przez AI](/pl/product/trip-optimisation)[Zarządzanie flotą i zasobami](/pl/product/fleet-management)[Planowanie załadunku 3D](/pl/product/load-planning)[Aplikacja dla kierowców OpenMove](/pl/product/driver-app)[Śledzenie pojazdów w czasie rzeczywistym](/pl/product/vehicle-tracking)[Wyznaczanie tras multimodalnych](/pl/product/routing)[Silnik wycen](/pl/product/pricing-engine)[Fakturowanie i zarządzanie finansami](/pl/product/invoicing)[Automatyzacja wiadomości](/pl/product/message-automations)[Zarządzanie i generowanie dokumentów](/pl/product/documents)[Oprogramowanie eCMR: cyfrowe listy przewozowe](/pl/product/ecmr)[Zintegrowana skrzynka e-mail](/pl/product/email-inbox)[Czat w aplikacji](/pl/product/chat)[Portal klienta i firmy](/pl/product/customer-portal)[Framework integracji](/pl/product/integration-framework)[Raporty i analizy](/pl/product/reporting)[Wielodostępność i white-label](/pl/product/white-label)[Bezpieczeństwo i kontrola dostępu](/pl/product/security) ## 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. [Zacznij za darmo](https://portal.otms.transportial.com/auth/register)[Umów demo](/pl/contact) --- Canonical page: https://transportial.com/pl/product/integration-framework