---
title: "Void a receipt"
method: POST
path: "/fiscal-document/v1/fiscal-documents/receipts/{receiptId}/void"
tags: ["Fiscal Documents"]
---

# Void a receipt

`POST /fiscal-document/v1/fiscal-documents/receipts/{receiptId}/void`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscal-documents/receipts/{receiptId}/void`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
    - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `write:reservation`

Voids a receipt by updating its status to VOIDED.
The receipt must be in OPEN status.
For Italy, a refund receipt will be automatically created and linked to the voided receipt.

## Path parameters

- `receiptId` integer, required

## Headers

- `X-Property-ID` integer, required

## Request body

- VoidReceiptRequest
  - `reason` string: Cancellation reason for the fiscal authority. Required on Mexico when voiding a fiscalized payment receipt (CFDI tipo P), where it is the SAT motivo de cancelacion: "02" (issued with errors, no substitute) or "03" (operation not carried out). Defaults to "03" when omitted. Ignored by countries that do not fiscalize a receipt void.

## Response `204`

Receipt successfully voided

## Other responses

- `400`: Bad Request - Invalid status or document type
- `404`: Receipt not found

---

[API](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/revisions/9c2a47775e5e?raw)