---
title: "Actualizar documento de ajuste"
method: PATCH
path: "/adjustment-documents/{id_adjustment_document}"
tags: ["Adjustment Documents"]
---

# Actualizar documento de ajuste

`PATCH /adjustment-documents/{id_adjustment_document}`

## Request

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

Actualiza un documento de ajuste. `is_void` controla su disponibilidad al momento del cobro (los documentos anulados se excluyen y no pueden aplicarse como saldo a favor); `metadata` reemplaza la metadata libre almacenada. Ambos campos son opcionales: omite un campo para dejarlo sin cambios y envía `metadata={}` para vaciarla. La llamada es idempotente: fijar un campo a su valor actual no tiene efecto y devuelve el documento sin cambios.

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

## Path parameters

- `id_adjustment_document` string, required: Identificador público del documento de ajuste (`ad_...`).

## Headers

- `x-account-key` string

## Request body

- UpdateAdjustmentDocumentPayload: Subclass of BaseModel that allows public aliases for fields. _aliases defines aliases in the way "external": "internal"
  - `is_void` boolean: Envía `true` para anular el documento (se excluirá de la disponibilidad al momento del cobro) o `false` para restaurar un documento previamente anulado. Omítelo para dejarlo sin cambios.
  - `issued_at` string, date-time: Fija la fecha y hora de emisión (UTC) cuando se envía. Omítelo para dejarlo sin cambios.
  - `metadata` object: Reemplaza la metadata libre almacenada cuando se envía. Omítelo para dejarlo sin cambios; envía `{}` para vaciarla.

## Response `200`

Successful Response

- 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

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El documento de ajuste no existe bajo la organización autenticada.
- `422`: El cuerpo no pasó la validación: `is_void` no es booleano o `metadata` no es un objeto.
- `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/:id_adjustment_document/patch.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)