Sandbox live op api.eftisandbox.app

Eén API voor eCMR, ePOD en eFTI.

Cargofollow 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 in de vorm die Verordening (EU) 2020/1056 voorschrijft.

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. Cargofollow regelt de documenten, de handtekeningen en het bewijs.

  1. 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.

  2. 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.

  3. 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.

eFTI-ready, en wat dat wel en niet betekent

Certificering van eFTI-platforms loopt via een geaccrediteerde conformiteitsbeoordelingsinstantie, en de regels daarvoor zijn nog niet vastgesteld — de Europese Commissie verwacht ze uiterlijk december 2026. Niemand is vandaag een gecertificeerd eFTI-platform, wij ook niet. Wat we wel zijn:

  • Het canonieke zendingmodel ís de EU common data set (DR 2024/2024), geen export achteraf.
  • De subsets worden geprojecteerd en gevalideerd tegen consignment-common.xsd: cabotage, gecombineerd vervoer, ADR en de nationale subsets.
  • De UIL en de datasetlevenscyclus uit Uitvoeringsverordening (EU) 2025/2243 zijn geïmplementeerd.
  • De koppeling met een nationale gate is gespecificeerd tegen de referentie-implementatie van EFTI4EU en wacht op registratie.

Wat er nog niet is, staat er net zo hard bij: geen certificering, geen Access Point in productie en geen eID-login op eIDAS-niveau advanced. We houden eis voor eis bij hoe ver we zijn.

Indicatie, geen aanbod

Een vast bedrag per maand en een prijs per vrachtbrief.

De tiers hieronder zijn concept: ze geven de orde van grootte en de verhoudingen weer waarmee we rekenen, niet een prijs waar je vandaag op kunt tekenen. De definitieve tarieven staan in het contract.

Sandbox

€0per maand

€0per zending (eCMR + ePOD)

  • Alles in test-mode, zonder tijdslimiet
  • Zendingen in auto-modus die zichzelf laten tekenen
  • Conformance-checklist per organisatie

Scale

€499 – €1.500per maand

€0,60per zending (eCMR + ePOD)

  • Alle providers, routing per corridor
  • SLA op beschikbaarheid
  • 90 dagen request-logs
  • Support op de SDK’s

Enterprise

Op aanvraagper maand

Staffelper zending (eCMR + ePOD)

  • Eigen D1-shard
  • Bewaartermijnen op maat
  • iSHARE/BDI en AdES/QES
  • Dedicated support

Prijs per zending is onafhankelijk van de provider die de vrachtbrief uiteindelijk uitgeeft: providerkosten zitten in de marge of worden per corridor doorbelast, en dat is zichtbaar in de console. Ter vergelijking rekenen eCMR-providers vervoerders ongeveer €1,33 tot €2,00 per vrachtbrief.

Vragen die iedereen stelt

eCMR, eFTI en wat 2027 betekent.

Vijf antwoorden vooraf. Staat je vraag er niet bij, gebruik dan het formulier hieronder.

Wat is het verschil tussen eCMR en eFTI?

Een eCMR is het vervoersdocument zelf: de elektronische vrachtbrief onder het e-CMR-protocol, met de handtekeningen van afzender, vervoerder en geadresseerde. eFTI gaat niet over het document maar over het delen ervan met de overheid — Verordening (EU) 2020/1056 legt vast in welk formaat een autoriteit gegevens mag opvragen en welke velden daarin zitten. Je hebt dus allebei nodig: de eCMR om vervoer te regelen, de eFTI-dataset om die gegevens aan een controleur te kunnen laten zien.

Wat verandert er op 9 juli 2027?

Vanaf die datum zijn autoriteiten in de EU verplicht elektronische vrachtinformatie te accepteren als die via een gecertificeerd eFTI-platform wordt aangeboden. Het is geen verplichting om elektronisch te gaan werken — papier mag nog — maar het is wel het moment waarop “wij accepteren alleen papier” geen antwoord meer is. Voor een TMS betekent het dat de eFTI-projectie er vóór die datum moet zijn.

Zijn jullie een gecertificeerd eFTI-platform?

Nee, en niemand anders is dat vandaag ook. Certificering loopt volgens artikel 12 van Verordening (EU) 2020/1056 via een conformiteitsbeoordelingsinstantie die door een lidstaat is geaccrediteerd, en het schema waartegen die instantie moet beoordelen bestaat nog niet: de Europese Commissie verwacht de resterende regels uiterlijk december 2026. Wij noemen Cargofollow daarom eFTI-ready en niet gecertificeerd. Dat verschil is geen woordspel — de acceptatieplicht van 9 juli 2027 geldt voor gegevens die via een gecertificeerd platform worden aangeboden, dus certificering is het sluitstuk. Wat er wél staat en wat er nog ontbreekt houden we per eis bij.

In welke landen werkt dit?

De eFTI-verordening geldt in de hele EU. Voor de eCMR ligt het per land anders, omdat het e-CMR-protocol per land geratificeerd wordt; Cargofollow houdt een register bij van wat een traject vereist en geeft dat terug op de requirements-endpoint en in de validator. Landen waar een nationale subset geldt — bijvoorbeeld afvaltransport — krijgen die subset er automatisch bij.

Moeten we onze eigen eCMR-provider opgeven?

Nee. Cargofollow schrijft naar de provider die jij al gebruikt en houdt de eFTI-dataset daarnaast bij. Welke provider een zending uiteindelijk uitgeeft, verandert niets aan het model dat je post en niets aan de prijs per zending.

Eén formulier, één mailbox

Stel je vraag.

We lezen alles zelf. Vertel waar je mee bezig bent en wat je van een koppeling verwacht; dan weten we of het past voordat iemand tijd in een pilot steekt.

Je bericht gaat rechtstreeks naar onze mailbox en wordt nergens opgeslagen. We gebruiken je adres alleen om te antwoorden.

Bouw vandaag tegen de sandbox.

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