Skip to main content
Returns the SAT cancellation receipt (acuse de cancelación) XML, decoded, for an invoice whose cancellation was accepted, as a downloadable attachment. Like Download Invoice XML, this is a flat route — it does not carry /organizations/{organizationId}/ in the URL. The invoice’s uuid (its folio fiscal) is enough to resolve the owning organization server-side, combined with the caller’s own auth context (session or API key). The response is XML only.

Authentication

Accepts either:
  • A Supabase Bearer session (Authorization: Bearer <token>) — the authenticated user must be a member of the invoice’s organization.
  • An API key (X-API-Key: sk_test_...) with the read:invoices scope — the key’s own organization must match the invoice’s organization, and the key’s environment (sandbox or production) must match the invoice’s, or the request is rejected with 403 Forbidden.

Path Parameters

Example Request

cURL
TypeScript SDK
CLI

Example Response

This endpoint does not return a JSON body — it streams the raw XML file with: The body is the decoded acuse XML (Timbrix stores it as the PAC returned it and decodes it for download). Abbreviated example (abreviado):
Timbrix stores the receipt the SAT returned when it received the cancellation request and does not replace it when the request is later marked accepted: the receiver’s response produces no new receipt in Timbrix. If the SAT answered 202 (the CFDI was previously cancelled), the receipt may correspond to the earlier cancellation. To follow the status of a request, use List Invoice Cancellations.

Common Errors

401 Unauthorized

Missing or invalid Bearer token / API key.

403 Forbidden

The authenticated user is not a member of the invoice’s organization, or the API key does not have the read:invoices scope / belongs to a different organization than the one that owns the invoice. An API key whose environment differs from the invoice’s is rejected with the code ENVIRONMENT_MISMATCH.

404 Not Found

uuid does not match any invoice.

409 Conflict

Audit Log

Each successful download is recorded in the audit log as cfdi.cancellation_receipt_downloaded.