---
title: "Registrar nota de crédito o factura de proveedor"
method: POST
path: "/adjustment-documents"
tags: ["Adjustment Documents"]
---

# Registrar nota de crédito o factura de proveedor

`POST /adjustment-documents`

## Request

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

Registra un documento de ajuste que la organización puede aplicar como saldo a favor al momento del cobro. Es idempotente por `(organización, external_id)`: reenviar el mismo par devuelve el documento original con HTTP 200; la primera llamada responde HTTP 201. La moneda del documento se deriva de la Account asociada y no debe enviarse en el cuerpo de la petición. Si se envía `id_origin_invoice`, el documento solo se puede aplicar al pagar esa Invoice.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Headers

- `x-account-key` string

## Request body

- CreateAdjustmentDocumentPayload: Subclass of BaseModel that allows public aliases for fields. _aliases defines aliases in the way "external": "internal"
  - `amount` number, required: Monto positivo en la moneda de la Account. La precisión decimal debe coincidir con `currency.decimals` de la Account asociada (por ejemplo, 0 para CLP, 2 para USD, 4 para UF). La moneda no se acepta aquí — se deriva de `id_account`.
  - `external_id` string, required: Identificador único de este documento de ajuste definido por la organización. Junto con la organización autenticada forma la clave de idempotencia: enviar el mismo par dos veces devuelve el documento original.
  - `id_account` string, required: Identificador de la Account contra la que se aplica el documento. Determina la moneda y debe pertenecer a la organización autenticada.
  - `id_customer` string, required: Identificador del Customer dueño del documento.
  - `id_origin_invoice` string: Identificador opcional de la Invoice a la que se liga el documento. Si se envía, el documento solo se puede aplicar al pagar esa Invoice, que debe ser del mismo Customer y la misma Account y no estar pagada ni anulada. Si se omite, el documento se puede aplicar al pagar cualquier Invoice del mismo Customer y Account. No se puede cambiar después: para ligarlo a otra Invoice, anula el documento y registra uno nuevo con otro `external_id`.
  - `issued_at` string, date-time: Fecha y hora opcional (UTC) que representa cuándo se emitió el documento, a diferencia de cuándo se registró en Toku. Omítelo para dejarlo sin definir.
  - `metadata` object: Metadata de pares clave/valor de formato libre que se muestra al Customer en el detalle del cobro. Los valores que sean URLs se muestran como enlaces. Por defecto está vacía.
  - `type` 'credit_note' | 'supplier_invoice', required: An enumeration.

## Response `200`

Reintento idempotente: se devuelve sin cambios el documento existente para ese par (organización, external_id).

- AdjustmentDocumentResponse: Subclass of BaseModel that allows public aliases for fields. _aliases defines aliases in the way "external": "internal"
  - `amount` number, required: Monto del documento en la moneda de la Account.
  - `created_at` string, date-time, required: Fecha y hora de registro en UTC.
  - `external_id` string, required: Identificador definido por la organización.
  - `id` string, required: Identificador del documento de ajuste.
  - `id_account` string, required: Identificador de la Account.
  - `id_customer` string, required: Identificador del Customer.
  - `id_origin_invoice` string: Identificador de la Invoice a la que está ligado el documento, que solo se puede aplicar al pagar esa Invoice. null si se puede aplicar al pagar cualquier Invoice del mismo Customer y Account.
  - `is_void` boolean: Indica si el documento está anulado. Los documentos anulados se excluyen de la disponibilidad al momento del cobro.
  - `issued_at` string, date-time: Fecha y hora de emisión del documento (UTC), distinta de la de registro. null si no está definida.
  - `metadata` object: Metadata de pares clave/valor de formato libre asociada al documento.
  - `type` 'credit_note' | 'supplier_invoice', required: An enumeration.

## Other responses

- `201`: Successful Response
- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El Customer, la Account o la Invoice de origen no existe bajo la organización autenticada.
- `422`: El cuerpo no pasó la validación: campo faltante, tipo no soportado, monto no positivo o precisión del monto mayor que los decimales de la moneda de la Account. También si la Invoice de origen es de otro Customer u otra Account, o ya está pagada o anulada (`TK31702`).
- `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/adjustment-documents/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)