Start with the operational problem, not the integration tool
If you are asking for quotes on an integration project, the quality of the result depends heavily on how well the job is scoped before anyone starts connecting software.
That matters because many integration projects do technically work, but still make the business harder to run. Data moves between systems, but staff still chase missing information, job statuses still become unreliable, and reporting still needs manual correction. The integration has simply become another workaround sitting on top of a messy process.
A properly scoped integration project should answer a simpler question first:
What operational problem are we actually trying to solve?
For example:
- Are staff entering the same customer and job information in multiple systems?
- Are approved quotes not reaching operations cleanly?
- Is finance receiving incomplete job data for invoicing?
- Are technicians completing work in the field without the office seeing status updates in time?
- Is reporting unreliable because each system holds a different version of the truth?
If that problem is not defined clearly, the project often gets scoped as “connect system A to system B”, which is not the same thing as improving the workflow.
The goal is not to make software talk for the sake of it. The goal is to create a simpler, more reliable operating model.
Why integration projects become fragile
Most fragile integrations fail for process reasons before they fail for technical ones.
A few common patterns cause problems.
Syncing bad process instead of fixing it
If the current workflow already depends on staff remembering side steps, manually correcting records, or deciding ad hoc where information should live, an integration usually just spreads that confusion faster.
For example, if sales creates a job before key site details are confirmed, and operations later updates those details in a different system, connecting the two systems does not solve the ownership problem. It just creates more chances for conflicting records.
No source-of-truth rules
When nobody decides which system owns each important piece of information, the integration becomes a constant negotiation.
One system updates the customer phone number. Another updates the site contact. A third holds the invoice contact. Staff stop trusting the data because they cannot tell which version is current.
Syncing everything because it feels safer
This is one of the most common scoping mistakes. Businesses often assume the best integration is the one that syncs the most fields, most often, in both directions.
Usually that creates unnecessary complexity.
Not every field needs to move. Not every system needs a full copy of the record. And not every update should go both ways.
Ignoring exceptions
Integrations are often scoped around the happy path:
- quote approved
- job created
- work completed
- invoice raised
Real operations are less tidy. Jobs are put on hold. Site information changes late. A form is submitted with missing data. A job is split into stages. A record fails to sync. Someone edits a field manually after the event.
If exception handling is not scoped upfront, staff end up doing detective work to figure out what broke and what now needs fixing.
What a good integration scope should define
A useful integration scope is not just a list of systems and fields. It should describe how the workflow is meant to operate.
At minimum, it should define the following.
1. The business outcome
Be specific about what should improve.
Examples:
- approved quotes should create operational jobs without rekeying
- completed field work should reach payroll and invoicing with less manual handling
- customer contact details should only be maintained in one place
- job status changes should be visible to the office in near real time
- reporting should rely on captured operational events rather than after-the-fact spreadsheet fixes
This gives the project a decision-making anchor. If a proposed integration adds complexity without improving that outcome, it is probably the wrong design.
2. Source-of-truth rules
This is the most important scoping decision in many projects.
For each core data type, define where it should primarily live and which system is allowed to create or update it.
Typical examples include:
- customer details
- site details
- quote values
- job numbers
- scheduling information
- completion dates
- timesheet or labour data
- invoice status
- payment status
You do not need one system to own everything. You do need clear rules about which system owns what.
Without that, you are not designing an integration. You are creating a conflict machine.
3. Trigger events
An integration should be driven by business events, not vague intentions.
Good trigger definitions sound like this:
- when a quote is marked approved, create a job
- when a technician marks a job stage complete, notify the office and update job status
- when all required completion documents are present, make the job available for invoicing
- when payroll is finalised, update payout status in the operations system
Poor trigger definitions sound like this:
- keep the systems in sync
- send updates across automatically
- mirror records between platforms
The more clearly you define the triggering event, the more reliable the automation will be.
4. Required fields and field mapping
Field mapping is not just a technical exercise. It is where workflow assumptions become visible.
For each step, ask:
- What data is required before the next action can happen?
- Which system already holds that data?
- Does the data need to be transformed or reformatted?
- Is the destination field actually used, or are we copying it because it exists?
For example, if a job should only be created once the site address, scope, customer contact and accepted value are confirmed, that should be explicit in the scope. Otherwise the integration may create incomplete jobs and push the clean-up work downstream.
5. Sync direction and timing
Not all integrations should behave the same way.
You need to decide:
- one-way or two-way sync
- event-based or scheduled sync
- real-time, near real time or batched updates
- what happens when two systems are edited close together
A common mistake is assuming everything must update instantly. In some workflows, that matters. In others, a scheduled sync is simpler and more reliable.
The right answer depends on the operational consequence of delay. If a scheduling team needs immediate visibility of a field update, timing matters. If finance only needs a daily summary for reconciliation, real-time syncing may add complexity without much value.
6. Exception handling and retries
Every integration scope should answer the question: what happens when the normal process fails?
At a minimum, define:
- what happens if required data is missing
- what happens if a receiving system is unavailable
- how failed syncs are retried
- who is notified
- where the failure is visible
- how duplicates are prevented or resolved
- what happens when a record is edited after initial sync
If the answer is “someone will notice”, the scope is not finished.
7. Ownership and support responsibility
Someone in the business needs to own the process, not just the software connection.
That includes:
- who owns data quality at the source
- who reviews failed syncs
- who approves changes to mapped fields or statuses
- who decides whether a workflow change requires an integration change
- who staff go to when the process stops behaving as expected
A surprising number of integration issues are really ownership issues. The technology may be working exactly as built, but the business has nobody clearly responsible for the workflow it supports.
8. Reporting implications
Integration scoping should also consider what downstream reporting depends on.
If management wants to report on quote conversion, job progress, technician completion, invoicing lag or profitability, the integration design affects whether that data will be trustworthy.
This often gets missed because teams focus on getting records across, not on whether the right operational events are being captured in the first place.
If reporting matters, ask:
- which system should be used for which report
- whether the integration changes where a status is recorded
- whether timestamps need to be preserved
- whether manual overrides need to be visible
- whether failures create reporting gaps
Questions to answer before requesting integration quotes
If you want sensible proposals from consultants or developers, answer these questions first.
- What specific workflow problem are we trying to fix?
- What does the process look like today, including manual workarounds?
- Which systems are involved, and what role does each one play?
- Which system should own each core data type?
- What event should trigger each automated action?
- What minimum data must be present before a record moves forward?
- Which fields genuinely need to sync?
- Does the sync need to be one-way or two-way?
- How quickly does each update need to happen?
- What exceptions occur in normal operations?
- What should happen when data is missing, invalid or changed later?
- How will failed syncs be detected and handled?
- Who in the business owns the process after go-live?
- What reporting depends on this data being accurate?
- Are we simplifying the workflow, or preserving a broken one?
You do not need a perfect technical specification before speaking to a consultant. But if these questions have not been considered, there is a good chance the project will be scoped too loosely or around the wrong problem.
Signs you need workflow redesign before integration
Sometimes the best scoping decision is to pause the integration project and redesign the workflow first.
That is usually the right move when one or more of the following are true:
- staff use multiple systems interchangeably for the same information
- nobody agrees where customer, job or financial data should be maintained
- the current process relies heavily on phone calls, memory or inbox follow-ups
- job stages are not clearly defined
- records are often incomplete when handed to the next team
- staff regularly edit data after the fact to make reporting look right
- exceptions are common but undocumented
- teams want the integration to “just mirror everything”
- the real request is to compensate for unclear process ownership
A simple example: if sales, operations and accounts all update job status differently for their own purposes, integrating those systems will not create clarity. It will spread ambiguity faster. Status design needs to be fixed first.
Likewise, if field staff can complete work without capturing the documents required for invoicing or payroll, connecting the field app to finance may simply move incomplete data downstream. The handover rule needs to be redesigned before the systems are connected.
A practical pre-project checklist
Before approving an integration project, check whether you can confidently describe the following:
- the exact business problem being solved
- the current workflow from start to finish
- the source of truth for each critical data set
- the events that should trigger automation
- the fields required at each handover
- the direction of each sync
- the acceptable delay for each update
- the exceptions that occur in real life
- the retry and failure-handling approach
- the person or team who owns the process
- the reporting consequences of the design
- any areas where workflow redesign is needed first
If several of these are unclear, the project is probably not ready for build.
What good scoping looks like in practice
A well-scoped integration project usually feels less ambitious on paper than a poorly scoped one, because it is more selective.
Instead of “sync both systems completely”, it might define something like this:
- customer master data remains in the CRM
- once a quote is approved and mandatory fields are complete, a job is created in the job management system
- scheduling data is maintained only in the job management system
- invoice status flows back to the CRM once raised
- failed syncs generate a visible queue for review
- reports on quote conversion come from the CRM
- reports on operational completion come from the job platform
- only specific statuses trigger automation
That is not smaller thinking. It is clearer thinking.
The result is usually a more reliable workflow, less duplicated data, and fewer situations where staff stop trusting the system because they have seen too many contradictions.
Scope the operating model, not just the connection
If an integration project is scoped as a technical exercise alone, there is a high chance it will create another layer of fragility.
The better approach is to scope the operating model first:
- what should happen
- who owns each part
- where data should live
- what triggers movement
- what happens when things go wrong
- what reporting depends on the result
Then the technical design can support that workflow properly.
If your process spans multiple systems, teams and exceptions, mapping the workflow before building the integration is usually the difference between a cleaner operation and a more expensive workaround. That is often the point where an external systems consultant can help clarify the design before development starts.
