CLcloudbeds
Fiscal Documents

Update pro forma invoice status

Update the status of a pro forma invoice. Supported status transitions:

  • OPEN -> ACCEPTED, REJECTED, CANCELED
  • ACCEPTED -> CANCELED
  • REJECTED -> CANCELED
put/fiscal-document/v1/fiscal-documents/pro-forma-invoice/{id}/status

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/pro-forma-invoice/{id}/status
  • 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 pro forma invoice to update.

Headers

X-Property-IDinteger required

Property id

Request body

status'ACCEPTED' | 'REJECTED' | 'CANCELED' required

New status for the pro forma invoice

Response

Pro forma invoice status successfully updated

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.