Edit the partner guide
The console guide editor and/v1/partners/{id}/guide expose the saved validation rules,
explicit overlay, and revision. Draft validation checks syntax and policy without publishing.
Publication is a full replacement with expected_revision, validation, explicit overlay
(or null to clear), and an optional note. Omitted validation fields are removed; unknown
fields are rejected. Stale revisions return 409; invalid drafts return 422.
Immutable snapshots support diff and restoration. Restore an earlier definition as a new
reviewed revision; do not treat it as permission to overwrite another editor’s changes.
Guide publication does not establish that the rules match a licensed/current counterparty
guide or that the counterparty has accepted a transmission.
Publish mappings with regression fixtures
Mapping definitions use JSON pointers for source fields, recursive arrays, lookup tables, required/default rules, and exact decimal-string multiplication. Preview transforms input without delivery. Publication requires PostgreSQL, an expected version, review note, and positive/negative fixtures; it records an immutable revision after fixture checks pass.
A deterministic preview can be as small as:
/v1/partners/{id}/xref/ are separate identities to inspect/import/export deliberately.
Deliver document callbacks
Customer callbacks currently describe document-recorded events, not every transport or business-status transition. Subscriptions require PostgreSQL and connection encryption. Saving a subscription creates a new immutable endpoint/key revision. Work accepted earlier retains its original event ID, payload, endpoint, and signing revision. Inspect/v1/callback-deliveries and each event’s /history before retrying held work.
Pause and permanent revision revocation are different actions; a revoked current revision
must be rotated before re-enabling it. Already claimed requests may be in flight.
Callbacks are at-least-once; receiver deduplication needs durable event-ID storage.
The source JavaScript client includes the verifier. Run this example beside your
stateset-edi source checkout: