field report

The architecture fit report: where B2B ecommerce projects fail before the first line of code

Most B2B ecommerce projects that fail were already broken at the architecture stage. The symptoms only surface during implementation, when the storefront refuses to model customer-specific pricing the way the contracts require, or when the ERP cannot expose what the buyer experience needs in real time. The good news is the failures are predictable. The patterns repeat, and discovery work catches them before contracts get signed.

The hidden cost of skipping architecture

Architecture work feels expensive because the deliverable is paper. A roadmap, a capability scorecard, an integration map. Nothing renders in a browser. To a CFO comparing a four-week discovery quote against a four-month build quote, the architecture work looks like the optional line item. It almost never is.

The cost of skipping architecture shows up later, and it shows up bigger. In our rescue engagements, the average cost of mid-implementation rework runs between three and eight times what a discovery sprint would have cost. Some of that is engineering rework. Most of it is people-time: re-aligning stakeholders, renegotiating contracts, retraining sales reps, and rebuilding executive confidence in a project that no longer matches the original promise.

The unspoken cost is worse. A failed first launch makes the next launch harder to fund. Boards remember the cheque they signed last time. CFOs ask more questions. Sponsors lose air cover. A project that should have run on momentum runs on apology instead. The team learns the wrong lesson, which is that ecommerce is risky, when the actual lesson is that skipping discovery is risky.

Eight failure patterns we see across mid-market engagements

The patterns below show up again and again in the projects that come to us for rescue or rebuild. None of them is exotic. All of them are catchable in two to six weeks of structured discovery. We see at least three of these in nearly every stalled project we open.

1. Platform chosen by demo. Someone senior saw a demo, or a peer company runs on a platform, and the decision was effectively made before requirements were written. Architecture got fit around the platform instead of the other way around.
2. ERP treated as a black box. The integrator did not pressure-test what the ERP can and cannot expose in real time, and the storefront made promises the ERP cannot keep. Inventory shows green when the warehouse is empty.
3. Business logic owned by nobody. Customer-specific pricing rules live in three places: a written policy, a CRM custom field, and the head of one veteran sales rep. The discovery never mapped them, so the storefront ships with whichever version the developer asked about.
4. Workflows ported, not redesigned. A six-step approval chain that made sense when each step was a wet signature got carried into digital unchanged. Buyers abandon the cart at step three.
5. Buying committee never aligned. The CIO wants stability, the VP of Sales wants flexibility, the COO wants efficiency, and the project pretends they all want the same thing. The conflict surfaces during UAT, when the project is already six months in.
6. Integration scoped by feature list. The integration was scoped by checking off ERP fields, not by mapping the workflows the integration has to support. The data syncs. The business does not work.
7. Operating capacity overcommitted. A composable architecture got chosen because it sounded modern, with no honest conversation about who would run it post-launch. The team that owns it after go-live has neither the headcount nor the partner relationship to operate the stack.
8. Discovery defined as kickoff. A two-day kickoff workshop got called discovery. It surfaced personas and a sitemap, not the operational truth a build can execute against. The team built confidently on the wrong foundation.

Each of these is the topic of its own deeper piece elsewhere in this pillar. The point of listing them here is the pattern: they are not implementation problems. They are architecture-stage problems that surface during implementation. The right place to fix them is before the build starts.

What operational truth means in practice

Operational truth is how the business actually sells, ships, and gets paid, not how the org chart says it does, not how the requirements doc summarizes it, and not how the executive deck markets it. It is the answer to questions like: what does an order from a tier-two distributor actually do inside the ERP after the rep keys it in, and which of those steps does the storefront have to replicate or honour?

In every rescue engagement we open, operational truth is the gap. The leadership team knows what the business is supposed to do. The order desk knows what it actually does. The architecture decision needs both views, and the only way to get both is to talk to both, in the same week, with a structured set of questions and a willingness to write down the contradictions.

A useful test: ask three people in three different departments to describe how a freight surcharge gets calculated for a contract account. If you get three answers, that gap is operational truth waiting to be surfaced. The storefront will get one answer. The customer will get another. The audit will get a third.

How discovery catches risk before contracts are signed

A real discovery engagement does four things the kickoff workshop cannot. It interviews the people who actually run the order-to-cash flow. It stress-tests the ERP against the workflows the storefront has to surface. It maps the business logic to a capability scorecard every shortlisted platform can be scored against. And it produces a recommendation a CFO can fund and a CIO can defend.

Discovery is also where the buying committee gets honest with itself. The CIO, the VP of Sales, and the COO sit in the same room with the same artifacts, and the architecture conversation forces the conflicts that the executive offsite avoided. Alignment that emerges in discovery is alignment that holds through implementation. Alignment papered over in kickoff cracks at UAT.

Acro structures this work through its discovery and strategy methodology, refined across more than two decades of mid-market B2B engagements. The deliverables are not slides. They are the artifacts a build team can execute against: data contracts, integration maps, business-rule catalogues, and a platform recommendation written in language a CFO will sign and a CIO will respect.

A pre-implementation readiness checklist

Before the contract gets signed, every B2B commerce project should be able to answer the following honestly. If the project cannot answer most of them, the architecture work is incomplete. If it cannot answer any of them, the architecture work has not started.

1. The business logic that matters most to revenue is documented, shared, and signed off by both leadership and the order desk.
2. The ERP's real-time capabilities have been tested against the workflows the storefront will surface, with named owners on both sides.
3. The architecture path has been chosen with a clear rationale and a named alternative that was considered and rejected for a stated reason.
4. The buying committee has aligned on the trade-offs the architecture forces, including the ones nobody is excited about.
5. The team that will operate the stack after launch is in the discovery conversation and accepts the operating model the architecture implies.
6. The platform shortlist scores against the capability matrix the discovery produced, not against a feature list lifted from the vendor sales deck.
7. The integration scope is described as workflows the integration must support, not as ERP fields the integration must sync.
8. The success criteria are written in operational language the order desk would recognize, not in marketing language the board would approve.

A project that can answer those eight questions cleanly is not guaranteed to ship on time. A project that cannot answer them is almost guaranteed to stall. The checklist is not the work. The work is the discovery sprint behind the answers. The checklist is how you tell whether the discovery happened.

Read this report alongside the architecture fit framework for the methodology and the common mistakes piece for the patterns described from the other angle. If you are scoping a project now, our discovery and strategy practice is the way in.

Frequently Asked Questions

Next step

Get the foundation right before you build.

For readers scoping a platform decision or wanting a full architecture recommendation.