POA External Sync

Summary

POA external sync turns approved document workflow state into commands for ServiceTitan, Spectrum, and QuickBooks Online.

Problem

External systems require side effects that may fail after partial success. Without commands, linkage, and diagnostics, retrying can create duplicates or hide provider errors.

Principle

Render, enqueue, dispatch, and audit external actions through command and data sync boundaries.

Platform Shape

POA command services preview and execute side-effect payloads. Dispatch jobs claim ready commands, and data-sync linkage records external identifiers and operation outcomes for retry safety.

Source Evidence

• services/poa/commands
• jobs/poa/dispatch_external_commands
• jobs/poa/sync_to_spectrum
• docs/domains/data_sync.md

Related Reading

• docs/engineering/concepts/external-command-outbox.md
• docs/engineering/concepts/idempotency-in-operational-jobs.md