> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Cash Receipt

> Fully cancel an issued cash receipt. Partial cancellation is not supported. The API first returns `202 Accepted`. Check the final result via webhook or the status API.




## OpenAPI

````yaml /openapi.en.yaml post /v1/cashReceipts/{issuanceKey}/cancellation
openapi: 3.1.0
info:
  title: Bolta API
  description: >
    The Bolta e-tax invoice API. [API Overview](/en/api-introduction/overview) |
    [Authentication guide](/en/api-introduction/authentication) | [Use
    cases](/en/api-introduction/usecase-b2b)
  version: 1.0.0
servers:
  - url: https://xapi.bolta.io
    description: Bolta API server
security:
  - basicAuth: []
tags:
  - name: Tax Invoice
    description: >
      Issue and manage e-tax invoices. [Calculating the issuance
      amount](/en/api-introduction/issuance-guide) | [Amendment
      types](/en/api-introduction/amendment-guide)
  - name: Reverse Issuance
    description: >
      Request and manage reverse issuance of e-tax invoices. [Email-approval
      reverse issuance](/en/api-introduction/usecase-reverse-email) |
      [Simple-approval reverse
      issuance](/en/api-introduction/usecase-reverse-simple)
  - name: Cash Receipt
    description: >
      Issue, cancel, and check the status of cash receipts. Issuance and
      cancellation are asynchronous. Check the final result via webhook or the
      status API. [Cash receipt guide](/en/api-introduction/cash-receipt-guide)
      | [Webhook events](/en/api-introduction/webhook-events)
  - name: Supplier
    description: >
      Register and manage the supplier (issuer) that issues tax invoices.
      [Glossary](/en/api-introduction/glossary) | [Delegated
      issuance](/en/api-introduction/usecase-delegated)
  - name: Certificate
    description: >
      Register and manage the supplier's certificate. [Authentication
      guide](/en/api-introduction/authentication)
paths:
  /v1/cashReceipts/{issuanceKey}/cancellation:
    post:
      tags:
        - Cash Receipt
      summary: Cancel Cash Receipt
      description: >
        Fully cancel an issued cash receipt. Partial cancellation is not
        supported. The API first returns `202 Accepted`. Check the final result
        via webhook or the status API.
      parameters:
        - name: issuanceKey
          in: path
          description: >-
            Enter the original cash receipt's `issuanceKey` from the issuance
            response.
          required: true
          schema:
            type: string
        - name: Supplier-Key
          in: header
          description: >-
            Enter the identification key of the supplier used for the original
            issuance. [Glossary](/en/api-introduction/glossary) |
            [Authentication guide](/en/api-introduction/authentication)
          required: true
          example: SupplierKey_bf8paz
          schema:
            type: string
        - name: Bolta-Client-Reference-Id
          in: header
          description: >-
            Enter a client reference ID between 1 and 255 characters that
            differs from the issuance request. The API uses this value as the
            cancellation request's idempotency key. If you retry with the same
            value and an identical cancellation request, the API returns the
            existing result. If the request content or type differs, the API
            returns `409 Conflict`. To check the status later, pass this value
            as `clientReferenceId`.
          required: true
          example: your-unique-reference-id-cancel
          schema:
            type: string
        - name: Bolta-Webhook-Test-Code
          in: header
          description: >-
            Use this header only to reproduce a failure webhook with a test key.
            Do not use this header in production (live).
          required: false
          example: ORIGINAL_ISSUANCE_FAILED
          schema:
            type: string
            enum:
              - INVALID_ISSUER
              - INVALID_RECIPIENT_IDENTIFIER
              - ORIGINAL_ISSUANCE_FAILED
              - CANCELLATION_TARGET_NOT_FOUND
              - UNKNOWN
      responses:
        '202':
          description: >-
            The API accepted the cancellation request. Check the final result
            via webhook or the status API.
          headers:
            Location:
              description: Path to check the issuance status
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuanceKey:
                    $ref: '#/components/schemas/CashReceiptIssuanceKey'
                  originalIssuanceKey:
                    $ref: '#/components/schemas/CashReceiptIssuanceKey'
                required:
                  - issuanceKey
                  - originalIssuanceKey
              example:
                issuanceKey: 9XK21ABC5KOAEIPGK8U6UO05I3EAQPLI8OE78Z1Q
                originalIssuanceKey: MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >
            supplierKey authorization failed. The `code` in the response is
            `FORBIDDEN`. Returned when the Supplier-Key does not exist, belongs
            to another partner, or was not issued with the API key you are
            using. Use the same Supplier-Key as the supplier used for the
            original issuance. A supplierKey is issued per API key, so if you
            issued a new API key, register the supplierKey again with that key.
            [Authentication guide](/en/api-introduction/authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: >-
            The same clientReferenceId was used for a different request, the
            original status cannot be canceled, or an active cancellation
            request already exists. The response `code` is
            `IDEMPOTENCY_CONFLICT`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
components:
  schemas:
    CashReceiptIssuanceKey:
      type: string
      description: >-
        The cash receipt issuance key. Store the entire string as-is because its
        format and length may change.
      examples:
        - MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I
    ErrorResponse:
      type: object
      description: The error response returned when an API request fails
      properties:
        code:
          type: string
          description: Error type identifier
        message:
          type: string
          description: Error description
      required:
        - code
        - message
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Base64-encode your API key and pass it. Enter the API key as the
        username and leave the password empty.

````