Journal/Data lakes/Why your ERP integration is taking three weeks longer than it should.

Why your ERP integration is taking three weeks longer than it should.

It is not the API. It is the four undocumented business rules nobody told you about until you tried to break them.

Published
Jan 11, 2026
Reading time
8 minutes
Category
Data lakes

Every ERP integration we have ever scoped has come in late. Not by a day or two — by weeks, sometimes months. The estimates are not bad. The integrations themselves, in pure software terms, are not difficult. What inflates the timeline is consistent and almost never on the project plan.

This is a short note on the four things that always cost the missing weeks, and how to budget for them honestly.

01. The customer ID is not the customer ID

The first day of any ERP integration begins with a discovery: the table called customer joins to invoice on a column called customer_id. Easy. The first day ends with the realization that some customers in that table also exist in a separate partner table, that the sales team uses a third ID for the same entity in the CRM, and that finance has been quietly maintaining a fourth mapping in a spreadsheet for two years.

This is not a data quality problem. It is the normal state of data in a mid-sized firm. The work that the timeline did not budget for is the conversation across teams about which ID is canonical, and the migration to use it.

Plan for it. A week, sometimes two, just for this.

02. The undocumented business rules

Every ERP has invoices that close on the last business day of the month — except for one customer category that closes on the 15th, except for one country that follows a fiscal calendar, except for the one client whose contract was hand-edited in 2019. None of these exceptions are written down. All of them will break the integration if you do not discover them.

The discovery happens by testing, not by reading. You will run the integration on real data, you will get a number that disagrees with the official one by a small amount, and you will spend three days finding the exception. Then you will find another one.

Every mid-sized firm has business rules that exist only in one person's head. The ERP is the place those rules go to be invisible. — working principle

03. The historical data is not the same shape as the current data

The schema you are integrating against is the schema as it exists today. The data you are pulling spans, typically, five to ten years. Somewhere in there, the schema changed.

Currency codes were renamed. A status that used to be one column became a join to a lookup table. The field that has been called region for two years used to be called territory. The integration that handles "current" data correctly will mishandle "historical" data silently — and your reports, which compare year-on-year, will be quietly wrong.

This is the failure mode that survives the longest. It does not break anything. It just makes the numbers slightly suspect, in a way that the people relying on them cannot easily explain.

04. The people part

The fourth missing week is, almost always, the conversation between the integration team and the people whose monthly close you are about to slightly disrupt. Even read-only integrations affect their work, because they will need to validate the new data against their existing reports, and reconcile any differences.

Budget a week for this conversation. Have it early. Bring the finance lead into the design review before the integration runs against real data, not after. The fastest path to a delayed integration is a finance team that finds out about it the morning the first reconciliation diverges from theirs.

Rule of thumb: the integration timeline most teams quote is the engineering time. Add a week for IDs, a week for business rules, a week for historical data, and a week for the finance conversation. Then quote.

A short closing

ERP integrations are not technically hard. The reason they are slow is that the work is mostly not technical. It is forensic, social, and historical. Estimate as if those things take time, and the project lands close to where you said it would. Estimate the engineering time only, and the project will be three weeks late, every time.


Filed under: DATA · METHOD
First published: Jan 11, 2026