DEV Community

Dhruvi
Dhruvi

Posted on

The Hardest Part of Integrating with Legacy ERPs Is Not the API

When people hear "ERP integration," they usually think the difficult part is the API.

Sometimes there isn't even an API.

But honestly, that's rarely the biggest problem.

The harder problem is understanding how the business actually uses the system.

Because what the ERP does and what the organization does are often two different things.

I've seen situations where:

  • a field means one thing in the documentation and something completely different in practice
  • a workflow exists because someone created a workaround five years ago
  • critical business rules live in spreadsheets instead of the ERP
  • important decisions happen outside the system entirely

Technically, the integration works.

Operationally, it's wrong.

This is where many integration projects get stuck.

The data moves successfully.

The API calls succeed.

The sync completes.

And yet users immediately tell you something is broken.

Because the integration followed the system.

Not the business process.

One thing I learned early on:

Never assume the ERP is the source of truth for how work gets done.

It's often just one piece of a much larger process.

The real workflow usually spans:

  • ERP systems
  • spreadsheets
  • emails
  • manual approvals
  • undocumented habits

The API is a technical challenge.

Understanding operational behavior is a people challenge.

And in my experience, the people challenge takes longer.

The best integrations I've worked on started with questions like:

Why does this process exist?

Who actually uses this field?

What happens if this step is skipped?

Those conversations usually uncover more than the technical documentation ever does.

The interesting part is that older systems are often doing exactly what they were designed to do.

The complexity comes from everything built around them over the years.

This is something we see regularly at BrainPack when connecting existing enterprise systems to modern workflows and AI capabilities. The technical connection is usually the easy part. Understanding how the organization actually operates is where most of the real integration work happens.

Top comments (0)