---
title: "Emitir documento tributario"
method: POST
path: "/receipt"
tags: ["Receipts"]
---

# Emitir documento tributario

`POST /receipt`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/receipt`
- Auth: API key in header `x-api-key`

Emite el documento tributario que corresponde a una deuda ya pagada y lo asocia a ella.

El documento se emite a través del proveedor de facturación configurado para la cuenta, según el país de la organización: en Chile una boleta o una factura, y en México un CFDI. El tipo de documento se toma de la deuda y, si esta no lo define, del valor por omisión del Customer.

La deuda se identifica por `product_id` junto con `due_date` o `invoice_external_id`. Cuando el documento se emite, queda vinculado a la deuda y se le envía al Customer.

No toda deuda es elegible. La respuesta es `200` —no un error— cuando la emisión se omite, y `message` explica el motivo: la deuda no existe, no tiene Customer, no registra pago cuando el tipo de documento lo exige, ya tenía un documento emitido, el tipo de documento no corresponde emitirlo, el país de la organización no cuenta con emisión de documentos tributarios, o faltan datos tributarios del Customer o de la organización. Emitido el documento, la respuesta es `201`.

## Headers

- `x-account-key` string

## Request body

- CreateReceiptRequest: Datos con que se identifica la deuda cuyo documento tributario se quiere emitir.
  - `due_date` string, nullable: Fecha de vencimiento de la deuda. Solo se usa para construir `invoice_external_id` cuando este no se envía. Debe enviarse este campo o `invoice_external_id`; si no se envía ninguno, la petición falla con `422`.
  - `invoice_external_id` string, nullable: Identificador externo de la deuda, con el que se la busca. Si se omite, se construye como `{product_id}-{due_date}`.
  - `product_id` string, required: Identificador del producto o servicio al que corresponde la deuda.
  - `use_idempotency_key` boolean, nullable: Envía una clave de idempotencia al proveedor de facturación, para que un reintento no emita dos documentos. Solo se considera en Chile.
  - `use_transaction_date` boolean, nullable: Emite el documento con la fecha del pago en lugar de la fecha de emisión. Solo se considera en Chile.

## Response `200`

La deuda no era elegible y no se emitió ningún documento. El motivo viene en `message`.

- ReceiptCreationResult: Resultado de una solicitud de emisión de documento tributario.
  - `message` string, required: Detalle del resultado: la confirmación de que el documento fue emitido, o el motivo por el que la deuda no era elegible y no se emitió ninguno.

## Other responses

- `201`: El documento tributario fue emitido y quedó asociado a la deuda.
- `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.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/receipt/post.md)

---

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