AssureLiner
All resources
Whitepaper Feb 22, 2026 11 min· Integrations

EDI → REST: a pragmatic migration playbook

Every shipping integrations roadmap eventually asks the same question: do we stay on EDI or go REST? The honest answer is "yes."

Assuretrac Research
AssureLiner · Integrations

What to keep on EDIFACT, what to move to REST, and how to run both in parallel without breaking partners.

What to keep on EDIFACT

Anything where the partner graph is >200 counterparties and the messages are mature (IFTMIN, IFTMBF, CODECO, COPRAR). The cost of migrating each partner is much higher than the marginal gain.

Also: anywhere the regulatory requirement is EDI-specific. Some customs authorities haven't moved, and the compliance risk of fighting that is nonzero.

What to move to REST

New partners. Internal systems. High-frequency, low-schema-stability flows (visibility, IoT telemetry, event streams). Anywhere you need bidirectional real-time.

One of the underappreciated wins of REST is the developer-onboarding cost — a new partner can be live in hours instead of weeks, which matters more than the technical merits most of the time.

How to run both in parallel

Strangler pattern. Build the canonical domain model once. Adapt EDI inbound to the canonical model at ingress. Adapt canonical to EDI outbound at egress. REST speaks the canonical model directly.

This gives you two wins. Partners don't see any disruption. And when you eventually deprecate an EDI flow, it's an adapter change, not a domain change.

Key takeaways

  • 1Keep mature high-partner-graph EDI flows. Don't migrate for migration's sake.
  • 2Move new partners, internal systems, and real-time flows to REST
  • 3Strangler pattern — one canonical domain, two edge adapters
  • 4Developer onboarding time is often the biggest argument for REST
Want to see this on your data?
Book a 30-minute tailored demo.
Book a demo

Keep reading

Like this? Get them direct to your inbox.

One email a fortnight. Field notes + case studies + early access to webinars.