---
title: "Editar o desactivar un banco o una caja"
method: PATCH
path: "/tesoreria/cuentas/{id}"
tags: ["tesoreria"]
---

# Editar o desactivar un banco o una caja

`PATCH /tesoreria/cuentas/{id}`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/tesoreria/cuentas/{id}`
- Auth: HTTP bearer

Una cuenta no se borra: se desactiva con `activa: false` y deja de ofrecerse al registrar un cobro. `cuentaId: null` le quita la cuenta contable.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `nombre` string
  - `tipo` 'banco' | 'caja'
  - `cuentaId` string, uuid, nullable
  - `entidad` string, nullable
  - `numero` string, nullable
  - `activa` boolean
  - `saldoInicial` number: Lo que tenía antes de su primer movimiento en Contadeo. Solo para su estado de cuenta: en la contabilidad, el saldo de partida va en los saldos iniciales. Cero por defecto

## Response `200`

La cuenta, ya cambiada

- CuentaTesoreria
  - `id` string, uuid, required
  - `emisorId` string, uuid, required
  - `nombre` string, required
  - `tipo` 'banco' | 'caja', required
  - `entidad` string, nullable, required
  - `numero` string, nullable, required
  - `activa` boolean, required
  - `cuenta` object, nullable, required: Su cuenta contable. `null` si no tiene: el asiento usa la del concepto.
    - `id` string, uuid, required
    - `codigo` string, required
    - `nombre` string, required
  - `saldoInicial` number, required: Lo que tenía antes de su primer movimiento en Contadeo (módulo 17). Puede ser negativo
  - `saldo` number, required: Lo que tiene hoy según los libros: el saldo inicial más lo que entró y menos lo que salió, sin lo anulado
  - `porDepositar` number, required: Sus cobros que todavía no se llevaron al banco. Cero en un banco

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `402`: La cuenta no tiene el módulo `tesoreria`
- `403`: Token/key ausente, inválido o expirado
- `404`: Recurso inexistente (o de otra cuenta — aislamiento multi-tenant)
- `409`: Ya hay una cuenta con ese nombre

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)