Integraties & automatisering

# Een zelf te configureren integratie bouwen

Wissel gegevens uit met elk systeem via API, SQL, FTP, SFTP, webhook of e-mail, met je eigen triggers, filters en veldkoppelingen.

Bijgewerkt 4 oktober 2026

**Wie kan dit:** Rolniveau 800 of hoger en het integratierecht.

Een zelf te configureren integratie is bedoeld voor systemen waarvoor geen preset koppeling bestaat. Jij bepaalt wanneer hij draait, welke records hij verwerkt en hoe velden in het andere systeem worden gekoppeld aan velden in Transportial. Eén integratie kan meerdere gegevensbronnen hebben, bijvoorbeeld één die orders ophaalt en één die statusupdates terugstuurt.

## Kiezen hoe de integratie start

Kies na het type **Zelf te configureren integratie** een trigger bij **Selecteer triggertype**:

* **Gepland**: draait met vaste tussenpozen of volgens een cron-schema, bijvoorbeeld om elke 10 minuten een FTP-map te controleren.
* **Trigger**: draait als er iets gebeurt in Transportial. Kies een of meer gebeurtenissen bij **Selecteer triggergebeurtenis**, bijvoorbeeld wanneer een trip wordt bijgewerkt.
* **Listener**: wacht tot het andere systeem gegevens instuurt, bijvoorbeeld via een webhook of per e-mail. De gegevensbronnen staan dan op inkomende gegevens.

Bij **Trigger** en **Listener** kun je filters toevoegen, zodat de integratie alleen draait voor records die voldoen.

## De integratie aanmaken

1. Open het zijmenu (☰, rechtsboven), kies **Integraties** en klik op **\+ Integratie aanmaken**.
2. Vul een **Naam** in en kies **Zelf te configureren integratie** bij **Selecteer integratietype**.
3. Kies de trigger bij **Selecteer triggertype** en stel voor een geplande integratie het schema in.
4. Klik voor een integratie met **Trigger** of **Listener** eventueel op **\+ Filter toevoegen** en bouw een voorwaarde: een **Selector** (het veld), een vergelijking (bijvoorbeeld **Gelijk aan (==)** of **Is in ...**) en een **Waarde**.
5. Klik op **\+ Gegevensbron toevoegen**.
6. Kies de richting bij **Selecteer gegevensrichting...**: **IN** voor gegevens die Transportial binnenkomen, **OUT** voor gegevens die naar buiten gaan.
7. Kies de verbinding bij **Selecteer verbindingstype...** en vul de velden ervan in (zie hieronder).
8. Kies bij **Selecteer entiteit** welk soort record de gegevensbron aanmaakt of leest, bijvoorbeeld een transportorder of een trip.
9. Koppel de velden (zie hieronder) en test de koppeling.
10. Zet **Uit/Aan** op aan en klik op **Opslaan**.

## Verbindingstypes

| Verbinding          | Wat je instelt                                                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **API**             | De **URL** en de requestmethode bij **Selecteer requestmethode**.                                                                    |
| **SQL-verbinding**  | Het adres van de database en de inloggegevens.                                                                                       |
| **FTP** / **SFTP**  | **Host**, **Port**, **Pad** en inloggegevens.                                                                                        |
| **Virtuele FTP**    | Transportial host de FTP-server voor je. De verbindingsgegevens en inlog worden bij het opslaan gegenereerd; deel ze met je partner. |
| **Webhook**         | Na het opslaan verschijnt er een webhookadres. Geef dat aan het andere systeem, zodat het gegevens naar Transportial kan posten.     |
| **E-mailontvanger** | Transportial ontvangt de gegevens per e-mail.                                                                                        |

Bij elke verbinding bepaalt de schakelaar **Met authenticatie** hoe de toegang is beveiligd. Zet hem aan om inloggegevens in te vullen. Laat hem uit om alleen de **IP-adressen** toe te staan die je invult. Kies voor uitgaande gegevens het bestandsformaat (JSON, XML of CSV) bij **Selecteer gegevenstype**.

## De velden koppelen

Elke koppelregel verbindt een veld in het andere systeem met een veld in Transportial.

* **Inkomend** en **Uitgaand**: het pad van het veld aan elke kant.
* **Selecteer veldtype**: **Tekst**, **Lijst**, **Object**, **Boolean**, **Datum & Tijd**, **Tijd** en meer. Lijsten en objecten bevatten hun eigen regels.
* **Formaat**, **Regex** en **Standaardwaarde**: lees een datum in een bepaald formaat, neem een deel van een waarde, of vul een waarde in als het veld leeg is.
* Opties zoals **Identificatie** (het veld identificeert het record, zodat een tweede levering het bijwerkt in plaats van een dubbel aan te maken), **Spaties aan begin en eind verwijderen** of **Naar hoofdletters**.

Klik op **\+ Veld toevoegen** om een regel toe te voegen, of zet **JSON-modus** aan om de hele koppeling als tekst te bewerken. Met een gekozen entiteit stelt **Mapping genereren met AI** een koppeling voor je op. Zet **OTM** aan als de gegevensbron de Open Trip Model-standaard gebruikt in plaats van je eigen koppeling.

## Opties voor inkomende gegevens

* **Sequentiële verwerking**: verwerk leveringen één voor één, op volgorde.
* **Gedeeltelijke updates**: een levering noemt maar een deel van de elementen (bijvoorbeeld één order van een trip) en de andere blijven behouden. Elk element moet een identificatie hebben; een element dat wordt geleverd met deleted = true wordt verwijderd.

## De koppeling testen

1. Zet **Testweergave** aan voor de gegevensbron.
2. Plak of typ voorbeeldgegevens uit het andere systeem.
3. Klik op **Testen** en controleer het resultaat dat ernaast wordt getoond.

Sla je voorbeeldgegevens op als test, zodat je hem na elke wijziging opnieuw kunt draaien. Zie [Een integratie testen](/nl/help/integration-tests).

## Gerelateerde artikelen

* [Andere systemen koppelen met integraties](/nl/help/integrations)
* [Een integratie testen](/nl/help/integration-tests)
* [Een integratie bewaken](/nl/help/integration-logs)
* [Gegevens importeren vanuit een bestand](/nl/help/data-importer)

## Nog steeds hulp nodig?

Ons supportteam beantwoordt graag al je vragen over Transportial.

[Contact met support](/nl/contact)[Een probleem melden](/nl/report-issue)

---
Canonical page: https://transportial.com/nl/help/self-configurable-integration