---
title: "Create a fiscal document of the type rectify invoice"
method: POST
path: "/fiscal-document/v1/fiscal-documents/rectify-invoice"
tags: ["Fiscal Documents"]
---

# Create a fiscal document of the type rectify invoice

`POST /fiscal-document/v1/fiscal-documents/rectify-invoice`

Create a fiscal document of the type rectify invoice.

**Spanish Fiscal Regulations:**
- Only available for properties in Spain
- An invoice that has already been rectified cannot be rectified again
- To make corrections to a rectified invoice, you must rectify the most recent invoice in the rectification chain

**Validation Rules:**
- The target invoice must not have been previously rectified
- If the invoice has been rectified, the API will return an error with details about which invoice should be rectified instead

## Headers

- `X-Property-ID` integer, required

## Request body

- RectifyInvoiceNoteRequest — Request to create a rectifying invoice. Only available for Spanish properties. **Important:** The specified invoice must not have been previously rectified. If it has been rectified, you must rectify the most recent invoice in the rectification chain instead.
  - `invoiceId` integer, required — ID of the invoice to be rectified. **Validation:** This invoice must not have been previously rectified according to Spanish fiscal regulations.
  - `reason` string — Reason for rectifying the invoice
  - `userId` integer — ID of the user creating the rectification
  - `method` 'VOID' | 'ADJUSTMENT', required
  - `transactionIds` integer[], nullable — Include transactions with the specified IDs (deprecated, use `includeTransactionIds` instead)
  - `folioIds` integer[], nullable — Include all transactions from the specified folio IDs
  - `excludeTransactionIds` integer[], nullable — Exclude transactions with the specified IDs
  - `includeTransactionIds` integer[], nullable — Include transactions with the specified IDs

## Response `200`

OK

- FiscalDocumentSummaryResponse
  - `id` string
  - `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
  - `governmentIntegration` GovernmentIntegration
    - `number` string
    - `series` string
    - `status` string
    - `qr` object
      - `url` string, uri
      - `string` string
    - `url` string, uri
    - `officialId` string
    - `externalId` string
    - `rectifyingInvoiceType` string
    - `cancellationFailedFallbackStatus` '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
    - `pdfFileBase64` string, byte — Base64-encoded PDF file content. Only allowed when status is COMPLETED_INTEGRATION.
    - `handwritten` boolean — Indicates this is a handwritten receipt created during POS unavailability.
    - `signatures` IntegrationSignature[] — Array of semantic signatures/response data from the government integration.
      - `type` string — Semantic type (JWT_TOKEN, QR_CODE_DATA, TRANSACTION_ID, COMPLIANCE_CHECK, etc.)
      - `label` string — Human-readable display label.
      - `value` string — The actual signature data/value.
      - `format` 'TEXT' | 'BASE64' | 'HEX' | 'URL' | 'UNKNOWN' — Format of the value.
      - `source` string — Source integration (FISKALTRUST_FR, FISKALTRUST_IT, etc.)
      - `rawMetadata` object — Original integration-specific codes for debugging/auditing.
    - `folioFiscal` string — MX SAT UUID (Folio Fiscal) — populated after CFDI acceptance by Fonoa.
    - `satQrCode` string — MX SAT validation URL used to verify a CFDI at verificacfdi.facturaelectronica.sat.gob.mx.
  - `linkedTo` string

## Other responses

- `400` — Bad Request - Validation errors

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)