CLcloudbeds
Fiscal Documents

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
put/fiscal-document/v1/fiscal-documents/{id}

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/{id}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://api.cloudbeds.com/auth/oauth/authorize
      Token URL: https://api.cloudbeds.com/auth/oauth/token scopes: write:reservation

Path parameters

idinteger required

Unique ID of the fiscal document to download.

Headers

X-Property-IDinteger required

Property id

Request body

status'COMPLETED' | 'VOIDED' | 'PAID' | 'PENDING_INTEGRATION' | 'PARTIALLY_PAID' | 'COMPLETED_INTEGRATION' | 'FAILED_INTEGRATION' | 'CORRECTION_NEEDED' | 'CANCELED' | 'CANCEL_REQUESTED' | 'OPEN' | 'REQUESTED' | 'VOID_REQUESTED' | 'FAILED' | 'MANUALLY_RECONCILED' | 'REJECTED' | 'ACCEPTED' | 'PENDING_TRANSACTION' | 'ALLOCATED' | 'APPLIED'

Status of the fiscal document

reasonstring

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.

failReasonstring

Example request

{
  "governmentIntegration": {
    "folioFiscal": "9B3E26F4-1234-4A5B-8C9D-ABCDEF012345",
    "ext": {
      "ar-arca-doc-type": "6",
      "arca-cae-expiry": "2026-10-02"
    }
  }
}

Response

OK

idstring
kind'INVOICE' | 'CREDIT_NOTE' | 'RECEIPT' | 'RECTIFY_INVOICE' | 'PRO_FORMA_INVOICE' | 'REFUND_RECEIPT' | 'INVOICE_RECEIPT' | 'ADVANCE_INVOICE' | 'SETTLEMENT_INVOICE' | 'TAX_WITHHOLDING'

Kind of fiscal document

status'COMPLETED' | 'VOIDED' | 'PAID' | 'PENDING_INTEGRATION' | 'PARTIALLY_PAID' | 'COMPLETED_INTEGRATION' | 'FAILED_INTEGRATION' | 'CORRECTION_NEEDED' | 'CANCELED' | 'CANCEL_REQUESTED' | 'OPEN' | 'REQUESTED' | 'VOID_REQUESTED' | 'FAILED' | 'MANUALLY_RECONCILED' | 'REJECTED' | 'ACCEPTED' | 'PENDING_TRANSACTION' | 'ALLOCATED' | 'APPLIED'

Status of the fiscal document

linkedTostring

Example response

{
  "governmentIntegration": {
    "folioFiscal": "9B3E26F4-1234-4A5B-8C9D-ABCDEF012345",
    "ext": {
      "ar-arca-doc-type": "6",
      "arca-cae-expiry": "2026-10-02"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.