Update a fiscal document by id

Update a fiscal document status, government integration details, or failure reason.
Used by integration partners to update document lifecycle and government processing status.

Common Updates:

  • Update status (PENDING_INTEGRATION, COMPLETED_INTEGRATION, FAILED, etc.)
  • Set government integration details (series, number, external ID, QR codes)
  • Record failure reasons for failed integrations

Invoice Cancellation:

  • Set status to CANCEL_REQUESTED to cancel invoices
  • Only invoices in OPEN, PAID, PARTIALLY_PAID or CORRECTION_NEEDED status can be canceled
  • Invoices with rectifying documents cannot be canceled
  • Integration partners must handle CANCEL_REQUESTED and update to CANCELED (success) or revert to previous status (failure)
  • For a fiscalized Mexico invoice (CFDI tipo I), provide reason as SAT motivo "02" or "03"; it defaults to "03"
  • For a Mexico invoice fiscalized through Fonoa, the service sends the cancellation to SAT itself: the invoice
    stays CANCEL_REQUESTED until SAT's verdict, then becomes CANCELED or returns to its previous status, and
    setting CANCELED manually is rejected
  • Such an invoice cannot be canceled while it has active payment complements or credit notes
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required
≥ 1

Unique ID of the fiscal document to download.

Body Params
string
enum

Status of the fiscal document

string

SAT cancellation motive when cancelling a fiscalized Mexico invoice (CFDI tipo I): "02" (issued with errors, no substitute) or "03" (operation not carried out). Defaults to "03" when omitted and is ignored elsewhere.

string
governmentIntegration
object
Headers
int64
required
≥ 1

Property id

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json