Follow one record through the workflow

Choose a real task, such as moving an approved order from a sales system into an operational dashboard. Identify who creates the order, who approves it and which system records its completion. Describe the current handoffs, including the spreadsheet or email people use when the normal path breaks.

Keep the initial integration focused on that task. A shared dashboard does not need to copy every field from every application. List what a person needs to make the next decision and which actions the new tool must support. This exposes whether the problem is missing information, unclear ownership or repeated data entry.

Decide which system owns each field

Create a short ownership map. The sales system might own the customer reference and approved amount, while the operations system owns fulfillment status. Decide whether a value is editable, read-only or calculated in the dashboard. Two systems independently editing the same field need an explicit conflict policy.

Use stable identifiers to connect records. Names and email addresses can change or be duplicated, so they are weak foundations for matching important updates. Plan how to find an unmatched record and how a person can resolve it without silently creating a second customer or order.

Make retries safe and failures visible

A timeout leaves an important question: did the receiving system accept the update before the connection failed? Retrying without checking can create a duplicate action. Design repeated updates so the same operation has the intended effect once, using identifiers and duplicate detection where the receiving system supports them.

MDN defines an idempotent operation as one whose intended server effect is the same after one or several identical requests. Do not assume an API's create action is safe to repeat. Check its actual contract and provide an exception queue when an outcome is uncertain. Show the last successful sync, current status and an understandable reason for a failure.

Keep approvals and access explicit

Separate viewing a record from changing it. A dashboard user may need to inspect an order without being allowed to approve a price change. Decide which actions need a reviewer and record who performed them. Validate permissions in the system handling the change rather than relying on the interface alone.

For actions with an operational consequence, provide a preview of the change and the affected record. If the source data changes while a request waits for approval, decide whether the approval is still valid or needs review. These rules help the team understand what happened when records disagree.

Roll out with a reconciliation plan

Test a small set of records before expanding access. Include duplicate identifiers, missing fields, a disconnected source and an update that arrives out of order. Compare the resulting records with the source systems and agree on how the team will investigate differences.

Plan the first release with an owner for monitoring and recovery. Explain how to pause updates, replay a failed operation safely and return to the previous workflow if needed. Bring source-system details and examples of current handoffs to an integration review; they are more useful than a dashboard sketch alone.

Further reading