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

# Create Treasury Adjustment

> Crea un ajuste de tesorería (débito o crédito).

Registra un ajuste manual en tesorería: débito o crédito, con tipo de recurrencia y período inicial.

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de usuario (**userApiKey**).
</ParamField>

## Parámetros de ruta

<ParamField path="account_id" type="integer" required>
  ID de la cuenta.
</ParamField>

## Cuerpo de la solicitud

El cuerpo debe enviarse como objeto `adjustment` con los siguientes campos:

<ParamField body="adjustment.adjustment_type" type="string" required>
  Tipo de ajuste: `debit` o `credit`.
</ParamField>

<ParamField body="adjustment.recurrence_type" type="string" required>
  Recurrencia: `fixed_cycles` (ciclos fijos) o `infinite`.
</ParamField>

<ParamField body="adjustment.amount" type="number" required>
  Monto del ajuste (valor numérico).
</ParamField>

<ParamField body="adjustment.concept" type="string" required>
  Concepto o descripción del ajuste.
</ParamField>

<ParamField body="adjustment.start_period" type="string" required>
  Fecha de inicio del período (formato fecha, ej. `2026-01-01`).
</ParamField>

<ParamField body="adjustment.total_cycles" type="integer">
  Número total de ciclos cuando `recurrence_type` es `fixed_cycles`. Opcional para `infinite`.
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.yampi.ai/api/v1/accounts/1/treasury/adjustments' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "adjustment": {
        "adjustment_type": "credit",
        "recurrence_type": "infinite",
        "amount": 500000,
        "concept": "Ajuste manual por conciliación",
        "start_period": "2026-03-01"
      }
    }'
  ```
</RequestExample>

## Respuesta exitosa

<ResponseExample>
  ```json 201 - Created theme={null}
  {
    "id": 20,
    "account_id": 1,
    "adjustment_type": "credit",
    "recurrence_type": "infinite",
    "amount": 500000,
    "concept": "Ajuste manual por conciliación",
    "start_period": "2026-03-01",
    "created_at": "2026-03-13T12:00:00Z"
  }
  ```
</ResponseExample>

<ResponseField name="id" type="integer" required>
  ID del ajuste creado.
</ResponseField>

<ResponseField name="adjustment_type" type="string">
  `debit` o `credit`.
</ResponseField>

<ResponseField name="amount" type="number">
  Monto del ajuste.
</ResponseField>

## Errores

* **401**: No autenticado.
* **422**: Unprocessable Entity — datos inválidos o faltantes.