caracol.creditnote.cancelled

Caracol cancelled a previously-stamped credit note — Constanza reverses both pólizas posted at issuance (revenue reversal + COGS reclass), restoring the books to their state before the credit note was issued.

Senders

• caracol

Receivers

• constanza

Data schema

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

{
  "tenantId": "string",
  "creditNoteId": "string",
  "creditNoteUuid": "string | null",
  "creditNoteSerie": "string | null",
  "creditNoteFolio": "string | number | null",
  "creditNoteType": "\"devolution\" | \"adjustment\"",
  "relatedInvoiceId": "string",
  "relatedInvoiceUUID": "string | null",
  "relatedSaleId": "string | null",
  "originalSaleCategory": "\"normal\" | \"courtesy\" | \"sample\" | \"promotional\" | \"fiscal_adjustment\" | undefined",
  "branchId": "string",
  "thirdPartyId": "string | null",
  "thirdPartyName": "string | null",
  "thirdPartyRfc": "string | null",
  "subtotal": "number",
  "iva": "number",
  "total": "number",
  "paymentMethod": "string | null",
  "items": "CreditNoteIssuedItem[]",
  "cancelMotivo": "\"01\" | \"02\" | \"03\" | \"04\"",
  "cancelReason": "string | undefined",
  "cancelledAt": "string (ISO datetime) | undefined"
}

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",
  "creditNoteId": "example-creditNoteId",
  "creditNoteUuid": "example-creditNoteUuid",
  "creditNoteSerie": "example-creditNoteSerie",
  "creditNoteFolio": "example-creditNoteFolio",
  "creditNoteType": "example-creditNoteType",
  "relatedInvoiceId": "example-relatedInvoiceId",
  "relatedInvoiceUUID": "example-relatedInvoiceUUID",
  "relatedSaleId": "example-relatedSaleId",
  "originalSaleCategory": "example-originalSaleCategory",
  "branchId": "example-branchId",
  "thirdPartyId": "example-thirdPartyId",
  "thirdPartyName": "example-thirdPartyName",
  "thirdPartyRfc": "example-thirdPartyRfc",
  "subtotal": 0,
  "iva": 0,
  "total": 0,
  "paymentMethod": "example-paymentMethod",
  "items": [],
  "cancelMotivo": "example-cancelMotivo",
  "cancelReason": "example-cancelReason",
  "cancelledAt": "2026-04-17T12:00:00.000Z"
}

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.