Integration overview
SpaceRivers exchanges data with external systems through authenticated APIs and the SR-Bridge desktop agent.
flowchart LR
SOURCE[Customer system] --> BRIDGE[SR-Bridge]
BRIDGE --> STAGE[Inbound staging]
STAGE --> VALIDATE[Validate]
VALIDATE --> MASTER[SpaceRivers master and cost data]
MASTER --> OPERATE[Schedule, time, expense, budget]
OPERATE --> OUTBOUND[Eligible outbound records]
OUTBOUND --> BRIDGE
BRIDGE --> SOURCE
Inbound domains
The current bridge supports employee, job, phase, cost-code, initial-budget, change-order-budget, committed-cost, and actual-cost jobs. Imported payloads are staged so invalid records can be corrected without silently changing operational data.
Outbound domains
Configured flows can retrieve eligible time-sheet and expense records. The bridge writes them to the customer system, then reports success or structured failure so SpaceRivers can update posting state.
Responsibilities
- The integration administrator owns connection, mapping, and API-key setup.
- The data owner resolves invalid master or financial data.
- Payroll/accounting reconciles batch totals and posting results.
- SpaceRivers logs show API/staging activity; SR-Bridge logs show local extraction and write activity.
Never edit an integration identifier casually. It is part of the contract that prevents duplicates and connects related records.