---
title: "Crear un banco o una caja"
method: POST
path: "/tesoreria/cuentas"
tags: ["tesoreria"]
---

# Crear un banco o una caja

`POST /tesoreria/cuentas`

## Request

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

El nombre no se repite dentro del emisor, sin distinguir mayúsculas. `cuentaId` es su cuenta contable y es opcional: sin ella, el asiento de un cobro usa la cuenta del concepto `bancos` o `caja`. Si se indica, tiene que ser una cuenta de activo, imputable y activa.

## Request body

- object
  - `emisorId` string, uuid, required
  - `nombre` string, required
  - `tipo` 'banco' | 'caja', required
  - `cuentaId` string, uuid, nullable
  - `entidad` string, nullable
  - `numero` string, nullable
  - `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 `201`

La cuenta creada

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