cfdi_global.stamped

Monthly factura global (CFDI Público en General) successfully stamped by the monthly-cfdi-publico cron. Distinct from caracol.invoice.stamped (per-sale) — carries batch context (period, salesIds) for downstream fiscal reconciliation and subscription metering.

Senders

• caracol

Receivers

• camino
• constanza

Data schema

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

{
  "tenantId": "string",
  "invoiceId": "string (Firestore doc ID at tenants/{tenantId}/invoices/{invoiceId})",
  "type": "string (literal 'global')",
  "period": {
    "year": "number",
    "month": "number (1-based)",
    "periodString": "string (YYYY-MM)"
  },
  "uuid": "string (SAT fiscal folio UUID)",
  "total": "number (monetary total, MXN)",
  "salesIds": "string[] (sale doc IDs included in this global invoice)"
}

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.

{
  "tenantId": "example-tenantId",
  "invoiceId": "example-invoiceId",
  "type": "example-type",
  "period": "example-period",
  "uuid": "00000000-0000-0000-0000-000000000000",
  "total": 0,
  "salesIds": [
    "example-salesIds"
  ]
}

See also

• Events registry index
• Webhooks integration guide
• Errors & retries

---

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