System Integration in a Procurement Brief: Objects, Fields, Refresh and Acceptance Evidence

A procurement promise to “support integration” needs specific objects, data direction, field definitions, update conditions, permissions, recovery behavior and test records. Verify source-vendor access and authorization first, then link each interface to pages, deployment and deliverables. This guide retains the full dashboard brief and adds a worksheet for technical integration discussions.

The more verifiable the brief, the easier it is to compare quotations and decide whether a later change belongs to the original scope or is new work.

Dashboard procurement brief and page-data scope illustration
First align page, data, and delivery scope at procurement, then discuss visual direction and implementation schedule.
On this page13 sections

Part 1: explain why the project is being built

Define the use case and users first. Showroom reporting, management review, production monitoring, park operations, and emergency command require different page structures, refresh rates, and interaction depth. Start the brief with background, primary users, target displays, desired launch date, and first-phase goal so several directions do not become one oversized project.

Part 2: define functionality with a page inventory

For each page, list its name, purpose, main modules, interactions, and target device. “Build a data dashboard” is not enough: a single display and a full system of overview, topic, detail, and admin pages represent very different workloads.

PageMain contentTo confirm
Overall overviewCore measures, trends, geographic or business distribution, and risk signalsFirst-screen priority and target resolution
Business topicSales, production, energy, project, or equipment topicFilters, drilldowns, and detail scope
Alerts and eventsSeverity, location, time, state, and response recordWhether maps, video, or work orders are linked
AdministrationAccounts, permissions, content settings, and data maintenanceWhat the customer must be able to maintain independently

Part 3: define every important metric

Identical metric names do not guarantee identical calculations. Sales may be counted on contracts, invoices, or receipts; equipment availability may use an instantaneous state or a period. Record each core metric's business meaning, formula, time range, filter conditions, data source, refresh rate, and approving owner. Mark unknown definitions “to be confirmed” instead of asking developers to guess.

Part 4: make the API inventory ready for integration

For each source system, document connection method, field scope, authentication, refresh rate, test environment, and owner. If an API is not open yet, provide de-identified sample sheets and field definitions, plus a date for confirming the production interface and a rule for reassessing major field changes.

Data itemWhat to recordWhy it matters
Source systemsERP, MES, CRM, WMS, IoT platform, or databaseIdentify system count and integration owners
Connection methodAPI, database, file, message queue, or manual entryDetermine technical route and access conditions
Update frequencyReal-time, minute, hourly, or dailyDefine refresh and caching strategy
Error handlingDisplay behavior for timeouts, nulls, disconnection, or missing fieldsAvoid blank screens after launch

Expand “supports integration” into a testable requirement

For each integration requirement, record the business object, data direction, fields, update conditions, authorization, error behavior and acceptance evidence. Listing ERP, MES or IoT is insufficient for estimating scope. Read-only summaries, historical migration and approval write-back from the same source are different work items.

Requirement fieldProject conditions to specifyAcceptance evidence
Source and directionSystem, API version, objects, read/write scope and source owner.Approved access method and a jointly confirmed object list.
DefinitionsTypes, units, unique IDs, timestamps, nulls and deletion rules.Field mappings and recalculable normal/error samples.
Update conditionsSeparate source updates, collection and page refresh; set achievable targets.Source/page timing records and late/stale states.
Permissions and environmentTest/production access, roles, network approval and vendor authorization.Authorized-role tests and denied-access tests.
Failure and recoveryTimeouts, duplicates, outages, credential expiry, retries and owners.Fault-injection or an agreed equivalent test record.
Dependencies and changesSample readiness, contact owners, changed fields and new scope.Readiness list, impact review and retest records.

Hypothetical wording: “Read equipment ID, operating state and source timestamp through an approved read-only platform API. Field meanings follow the jointly approved point-list version. Refresh targets depend on source capability. Timeouts show stale data rather than normal operation. Authorized tests retain inputs, source times, page outputs and recovery results.” This illustrates technical scope; actual objects and conditions must be added before it becomes part of a project agreement.

Confirm that the source vendor provides the interface, who pays any associated fees, when environments become available and who accepts joint tests. Record unknowns as dependencies, with a method to pause affected tests or reassess scope. For displays and site networks, use the command-center responsibility checklist.

An April 2026 public procurement notice for a decision platform separates integrated dashboards, application scenarios and back-end support, including page integration and metric/data interfaces. It is an example of decomposing procurement scope; its budget and schedule are not benchmarks for other projects, and this worksheet does not replace procurement documents.

Part 5: set design and interaction boundaries

Attach brand colors, reference pages, screen dimensions, and viewing distance. Specify whether maps, 3D models, video, motion, carousels, filters, drilldowns, exports, or multiple device layouts are required. Reference images communicate direction; they do not confirm every feature. Interactions and media types that affect delivery must appear in the inventory.

Part 6: deployment, security, and operations

State whether deployment is on the public internet, a cloud server, or the enterprise intranet. Note HTTPS, allowlists, permissions, logs, backups, security-level compliance support, and domestic-platform adaptation if required. Assign who provides the servers, purchases third-party licenses, and maintains certificates and API accounts after launch.

Part 7: make delivery and acceptance testable

Requirement IDAcceptance prerequisiteTest actionExpected resultEvidence retainedOwner and status
Pages and devicesPage list, target resolution, browsers, and devices agreedReview every page for content, interactions, overflow, empty states, and errorsMatches the approved design and scope; differences are recordedScreenshots, test logs, and discrepancy listCustomer approves; implementer fixes or explains
Metrics and dataFormula, period, filters, source, update time, and owner agreedCompare selected core metrics with source data or approved reportsResults can be recalculated; missing data, delays, and conflicting definitions remain visibleDefinitions table, reconciliation, and exception recordsBusiness and data owners approve together
APIs and permissionsTest accounts, API environments, data scope, and error conditions availableTest normal calls, denied access, timeouts, empty data, and recovery after disconnectionAccess matches authorization; error and recovery behavior is clearRequest logs, permissions matrix, and error test recordsSystem owner, implementer, and security owner approve
Deployment and handoverServers, certificates, backups, and deliverables list frozenDeploy and restore from documentation; inventory code, configuration, and instructionsReproducible in the agreed environment; omissions and third-party dependencies disclosedDeployment and restore records, signed handover listOwner specified in the contract signs off

Vague phrases to replace in procurement briefs

Vague phraseMore useful wording
The pages should look high-techProvide brand colors, visual references, use case, and target screen; agree on a visual-direction review round
All data should be real-timeSpecify refresh frequency per item and whether source systems can supply it
Support multiple devicesName which of large display, desktop, tablet, and phone are in this phase
Easy to extend laterIdentify configurable metrics, pages, accounts, and data sources and the limits of extension APIs

A ready-to-use preparation checklist

Download the on-site CSV template and fill in project background, page scope, key metrics, data sources, interactions, permissions, deployment, and acceptance. It supports internal discussion before procurement and can be a starting attachment for a quotation request.

Download the dashboard requirements checklist

When turning the requirements list into a procurement technical annex, also use the dashboard tender technical parameters and acceptance matrix (Chinese) to map each requirement to an acceptance environment, method, and evidence.

Reference and usage limits

Checked on October 15, 2026: the national standards portal lists GB/T 9385-2008 as current. This is an independently organized procurement worksheet, not a clause-by-clause reproduction of that standard.

GB/T 9385-2008, Computer Software Requirements Specification Standard This can inform the organization of a software requirements specification. The fields here are a practical dashboard project checklist, not the standard's text, and they do not replace legal advice on procurement, tendering, intellectual property, or contracts. Procurement, business, technical, and legal owners should approve formal annexes and contract terms for the specific project.

Frequently asked questions

Must the procurement brief specify every chart?

The first procurement round should at least define pages, core metrics, data sources, and main interactions. Ordinary charts can leave room for design, but maps, 3D, video, drilldowns, and administration affect effort and should be stated.

Can procurement start before APIs are confirmed?

Yes, if you identify expected source systems, sample data, and owners, and document the formal API confirmation milestone and limits of subsequent change.

How can vendor quotations be compared more easily?

Ask each vendor to itemize the same page, API, administration, deployment, and handover list, marking included, optional, and excluded items.

What is often missed in procurement acceptance?

Typical gaps are metric definitions, error states, target resolution, permissions, deployment materials, and source-code or documentation boundaries.

Related pages

Related service:Custom data visualization dashboards (Chinese). Continue reading:Tables and APIs to prepare before a project, Dashboard quotation scope and cost factors, Dashboard project acceptance criteria.