Skip to content

palacio.contract_signed ​

A contract signed in Palacio (palacio_configs.signature_status flipped to 'signed') is entered in RBS's relationship ledger in Colectiva (participation_agreements, RBS workspace; acceptedBySource 'palacio_signature'). NOT routed via a registered app: the emitter is the Control Plane (CPR, POST /api/v1/palacio/configs/:ref/signature), which signs the standard bus envelope with its own secret (CPR_PALACIO_WEBHOOK_SECRET, sourceApp 'cpr'). Carries a reference + content_hash, never ip/user-agent/amounts/contract text. The entry NEVER creates charges or distributions in Colectiva (born without fee, autoDistribution false). First emission eventId palacio:<ref>:signed:<signed_at ms>; reconciler re-emissions palacio:<ref>:signed:r<ms>; real idempotency is Colectiva's handler by palacioRef. Not the contract.* family (Agora, dealId). Spec: docs/superpowers/specs/2026-10-19-S988-asiento-en-colectiva-de-firmas-de-palacio-design.md. Shared fixture: packages/api/lib/libro-colectiva.contrato.json.

Senders ​

None declared.

Receivers ​

  • colectiva

Data schema ​

Each field maps to a type hint. | null indicates an optional field.

json
{
  "ref": "string (palacio_configs.ref, opaque)",
  "signedAt": "string (ISO datetime, UTC) | null",
  "signerTypedName": "string | null",
  "client": "{ legalName: string|null, email: string|null, rfc: string|null }",
  "provider": "{ legalName: string|null, rfc: string|null }",
  "contentHash": "string (sha256 hex, frozen at signing) | null",
  "contentHashedAt": "string (ISO datetime) | null",
  "sourceTemplate": "string | null",
  "prospectId": "string | null",
  "contractId": "string | null (Agora contract id)",
  "tenantId": "string (optional; audit.provisioning existing/tenant id)",
  "esPrueba": "boolean (config.audit.esPrueba === true)"
}

Example payload ​

The following is a synthetic payload that matches the schema. Production payloads are signed with HMAC-SHA256 and delivered to each receiver's registered webhook endpoint.

json
{
  "ref": "example-ref",
  "signedAt": "2026-04-17T12:00:00.000Z",
  "signerTypedName": "example-signerTypedName",
  "client": "example-client",
  "provider": "example-provider",
  "contentHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "contentHashedAt": "2026-04-17T12:00:00.000Z",
  "sourceTemplate": "example-sourceTemplate",
  "prospectId": "example-prospectId",
  "contractId": "example-contractId",
  "tenantId": "example-tenantId",
  "esPrueba": true
}

See also ​


Generated from ecosystem-sdk/packages/mcp-server/src/registry/events.json. Do not edit by hand.

Red Broom Software Ecosystem