Skip to content

handoff.completed

Generic physical handoff completed with proof. Covers document delivery, product returns, sample collection, key handoff, equipment transfer. Baul physical layer event.

Senders

  • baul

Receivers

  • camino
  • colectiva
  • constanza
  • agora
  • agente
  • caracol
  • cosmos-pet
  • madriguera

Data schema

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

json
{
  "delivery_order_id": "string",
  "tracking_token": "string",
  "handoff_category": "string (financial | legal | reverse_logistics | asset_transfer | custom)",
  "delivery_type": "string (document_delivery | product_return | sample_collection | key_handoff | equipment_handoff | custom)",
  "completed_at": "string (ISO datetime)",
  "recipient_name": "string",
  "proof_of_delivery_photos": "string[] (URLs)",
  "signature_url": "string | null",
  "pod_location": "{ lat: number, lng: number } | null",
  "deposit_metadata": "object | null",
  "document_metadata": "object | null"
}

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
{
  "delivery_order_id": "example-delivery_order_id",
  "tracking_token": "example-tracking_token",
  "handoff_category": "financial",
  "delivery_type": "document_delivery",
  "completed_at": "2026-04-17T12:00:00.000Z",
  "recipient_name": "example-recipient_name",
  "proof_of_delivery_photos": [
    "example-proof_of_delivery_photos"
  ],
  "signature_url": "example-signature_url",
  "pod_location": "example-pod_location",
  "deposit_metadata": {},
  "document_metadata": {}
}

See also


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

Red Broom Software Ecosystem