Sandbox live op api.eftisandbox.app

Eén API voor eCMR, ePOD en eFTI.

FreightAPI is de developer-first infrastructuur voor elektronische vrachtdocumenten in de EU. Eén POST /v1/shipments maakt de e-vrachtbrief, regelt handtekeningen en aflevering, en levert de eFTI-dataset die autoriteiten vanaf 9 juli 2027 moeten accepteren.

Bekijk de API-referentie Hoe het werkt

Een zending aanmaken

$ curl https://api.eftisandbox.app/v1/shipments \
    -H "Authorization: Bearer sk_test_…" \
    -H "Content-Type: application/json" \
    -d '{
      "reference": "ORD-2026-0917",
      "consignor": { "name": "Van der Berg Logistiek B.V.",
                     "address": { "city": "Rotterdam", "country": "NL" } },
      "carrier":   { "name": "Transport Nowak Sp. z o.o.",
                     "address": { "city": "Poznań", "country": "PL" } },
      "consignee": { "name": "Müller Maschinenbau GmbH",
                     "address": { "city": "Stuttgart", "country": "DE" } },
      "goods": [{ "description": "CNC machine parts", "quantity": 12,
                  "package_type": "pallet", "gross_weight_kg": 8400 }]
      // … pickup, delivery, vehicle, driver
    }'

HTTP/1.1 201 Created
{
  "id": "shp_01K4ZQ4G8ZJ6T3N9R7W2XVB5CD",
  "status": "draft",
  "transport_type": "international",
  "warnings": []
}

Validatie op schema én business-regels (ADR, cabotage, internationaal vervoer). Fouten komen terug als leesbare problem+json, in het Nederlands of Engels.

Hoe het werkt

Drie stappen van TMS naar getekende vrachtbrief.

Jouw software praat met één REST-API. FreightAPI regelt de documenten, de handtekeningen en het bewijs.

Zending aanmaken
POST /v1/shipments met afzender, vervoerder, ontvanger en goederen. Fouten in schema of business-regels krijg je direct terug, met veld en uitleg.
Uitgeven en tekenen
Bij het uitgeven ontstaat de eCMR als PDF, versie 1. Afzender, chauffeur en ontvanger tekenen op hun eigen telefoon via link of QR. Geen app-installatie.
Bewijs en webhooks
Elke stap is een event in een hash-chain. Je TMS ontvangt shipment.delivered en signature.completed als webhook, met ePOD, foto’s en voorbehouden.

Features

Gebouwd zoals je een betaal-API verwacht.

Test-keys, een publieke OpenAPI-specificatie, idempotente requests en webhooks met retries. Zodat een integratie een middag kost, geen kwartaal.

OpenAPI-first

De volledige specificatie staat op /openapi.json, met een interactieve referentie. SDK’s voor TypeScript en .NET worden eruit gegenereerd.

Sandbox met test-keys

Bouw met sk_test_-keys tegen dezelfde API als productie. Sandbox-zendingen doorlopen ophalen, transport en aflevering vanzelf.

Business-regels ingebouwd

ADR vraagt een UN-nummer, cabotage een ander vervoerdersland, internationaal vervoer beide landen. Fouten blokkeren, waarschuwingen reizen mee.

Handtekeningen met bewijs

Tekenen op scherm, klikken met OTP, via de API of als foto van papier. Elke handtekening bindt de hash van het document, met tijd, IP en toestel.

Webhooks met retries

HMAC-gesigneerd, acht pogingen in 24 uur, een volledig deliverylog en replay per event.

eFTI-dataset uit dezelfde zending

Het canonieke model wordt geprojecteerd naar de CMDS (consignment-common.xsd), met subsets voor cabotage, gecombineerd vervoer en gevaarlijke stoffen.

eCMR & eFTI

eCMR is niet eFTI. Wij doen allebei.

Twee wettelijke kaders, één zendingmodel. Documenten en audit-log blijven in de EU.

eCMR: het commerciële document

De elektronische vrachtbrief onder het e-CMR-protocol: de overeenkomst tussen afzender, vervoerder en ontvanger, met handtekeningen bij ophalen en aflevering. Nederland, Duitsland, Frankrijk, Polen en de meeste andere lidstaten hebben het protocol geratificeerd.

eFTI: de informatie voor handhaving

Verordening (EU) 2020/1056 regelt welke vervoersinformatie autoriteiten digitaal moeten accepteren: cabotage, gecombineerd vervoer, gevaarlijke stoffen en afvaltransport. Dat loopt via gecertificeerde eFTI-platforms en nationale gates.

Bouw vandaag tegen de sandbox.

De API-referentie draait op api.eftisandbox.app. Test-keys, voorbeeldzendingen en webhooks, zonder productierisico.

API-referentie OpenAPI-specificatie