---
title: "Create receipt for a payment."
method: POST
path: "/fiscal-document/v1/fiscal-documents/receipt"
tags: ["Fiscal Documents"]
---

# Create receipt for a payment.

`POST /fiscal-document/v1/fiscal-documents/receipt`

Create a receipt for a payment and optionally specify allocations per transaction.
In case of no allocations, a 'Simple receipt' will be created that can later be allocated to charge transactions.
The amounts of all allocations must be equal to the payment amount.
The transactions should not be fully allocated already
  and the amount allocated should not be more than the remaining balance on the transaction.
All transactions not part of an invoice will be added to newly created invoice.

## Headers

- `X-Property-ID` integer, required

## Request body

- CreateReceiptRequest
  - `allocations` ReceiptTransactionAllocation[], nullable
    - `transactionId` integer, required
    - `amount` number, required
    - `documentId` integer
  - `transactionId` integer, nullable — Id of the transaction associated to a payment. This parameter is mutually exclusive with `paymentId`.
  - `paymentId` integer, nullable — Id of the payment. This parameter is mutually exclusive with `transactionId`.
  - `invoiceId` integer, nullable — Id of invoice that receipt should be applied to. Ignored if allocations are presented.
  - `sequenceId` integer, nullable
  - `skipIntegration` boolean — At the moment this can only be set to True on Italy to skip the integration, for italy this case is needed to avoid Printing the Receipt
  - `handwritten` boolean — Indicates this is a handwritten receipt created during POS unavailability. Only allowed for properties with Fiskaltrust integration enabled.
  - `userId` integer, required
  - `sourceId` integer, required
  - `sourceKind` 'GROUP_PROFILE' | 'RESERVATION' | 'HOUSE_ACCOUNT' | 'ACCOUNTS_RECEIVABLE_LEDGER', required — Kind of the source entity
  - `recipient` RecipientRequest
    - `type` 'GUEST' | 'CONTACT' | 'GROUP' | 'COMPANY' | 'GROUP_PROFILE' | 'GROUP_PROFILE_CONTACT', required — Type of the recipient.
    - `id` integer, required — ID of the recipient, references guestId, contactId, groupId, etc. depending on type.
    - `taxDocumentSource` 'GUEST_TAX_ID' | 'GUEST_DOCUMENT_NUMBER' — Source of the tax document number.
  - `manualRecipient` ManualRecipientRequest
    - `type` 'PERSON' | 'COMPANY', required — Type of recipient (person or company)
    - `name` string, nullable, required — Name of the recipient
    - `gender` 'M' | 'F' | 'N/A' — Gender of the guest
    - `email` string, email, nullable — Email address of the recipient
    - `birthday` string, date, nullable — Birthday of the recipient
    - `phone` string, nullable — Phone number
    - `cellPhone` string, nullable — Cell phone number
    - `taxId` string, nullable, required — Tax ID / VAT number
    - `address` object, nullable
      - `country` string, nullable — Country code
      - `state` string, nullable — State or province
      - `city` string, nullable — City
      - `address1` string, nullable — Primary street address
      - `address2` string, nullable — Secondary street address
      - `zip` string, nullable — Zip/postal code
    - `document` object, nullable
      - `type` 'na' | 'driver_licence' | 'student_id' | 'passport' | 'dni' | 'nie' — Type of guest identification document
      - `number` string, nullable — Document number
      - `issueDate` string, date, nullable — Document issue date
      - `issuingCountry` string, nullable — Country that issued the document
      - `expirationDate` string, date, nullable — Document expiration date

## Response `200`

Receipt successfully created

- 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
- `404` — Payment or payment transaction not found.

---

[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)