---
title: "Cancelar Billing Document"
method: POST
path: "/billing-documents/{public_id_billing_document}/cancel"
tags: ["Facturación"]
---

# Cancelar Billing Document

`POST /billing-documents/{public_id_billing_document}/cancel`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/billing-documents/{public_id_billing_document}/cancel`
- Auth: API key in header `x-api-key`

Cancela un billing document ante el SAT (vía Facturama) por su identificador.

Devuelve el resultado de la cancelación. Falla con `404` si el billing document no existe en la organización y con `500` si Facturama rechaza la cancelación.

## Path parameters

- `public_id_billing_document` string, required: Identificador público del billing document sobre el que se opera.

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- CancelBillingDocumentResponse
  - `customer_facing_message` string
  - `data` object
  - `message` string, required
  - `success` boolean, required

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)