Crear cuenta bancaria

Crea una cuenta bancaria en el módulo financiero de Pymes. La compañía se resuelve automáticamente de la cuenta Pymes. numeroCuenta debe ser único dentro de la compañía (no globalmente: otra compañía puede tener el mismo número). entidadFinanciera acepta uuid o NIT del tercero asociado, y determina también la sucursal de la cuenta bancaria; si se cambia en la actualización, la sucursal se vuelve a resolver ahí también. tipoCuentaBancaria solo permite AHO (Cuenta Ahorros) o COR (Cuenta Corriente); TCR (Tarjeta de Crédito) existe como valor legado pero se rechaza aquí (es de una historia aparte). La moneda y la estructura empresarial de la cuenta bancaria no se reciben en la petición: ambas se resuelven automáticamente. La moneda siempre se resuelve a la moneda base de la compañía o, si esta no tiene una configurada, a la moneda por defecto del sistema (COP). La estructura empresarial siempre se resuelve al nodo raíz (tipoNodo 'COM') de la propia compañía.

cuenta es opcional: si se envía, se acepta uuid o código, se valida que exista, esté activa, sea imputable y no maneje moneda extranjera; la cuenta bancaria resultante queda en estado ACT. Si NO se envía, la cuenta bancaria se crea igual, pero en estado SUS en vez de ACT (ver estado más abajo).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Datos para crear una cuenta bancaria. La compañía se resuelve automáticamente de la cuenta Pymes. De los campos de texto, solo numeroCuenta y nombreCuenta validan longitud máxima; el resto son llaves foráneas o códigos de catálogo y se validan por existencia (no por longitud). La moneda y la estructura empresarial de la cuenta bancaria no se reciben aquí: no son campos de este objeto, se resuelven automáticamente (ver CuentaBancariaDTO).

string
required
length ≤ 25
[\w-]{1,25}

Número de cuenta bancaria. Único dentro de la compañía (no globalmente: otra compañía puede tener el mismo número).

string | null
string
required

UUID o NIT de la entidad financiera (banco) emisora de la cuenta (a diferencia de cuenta, cuyo segundo formato aceptado es un código propio, acá es el NIT del tercero asociado). Determina también la sucursal de la cuenta bancaria (resuelta internamente); es editable después de la creación (ver actualización), y al cambiarla la sucursal se vuelve a resolver.

string
enum
required
length ≤ 3

Código de tipo de cuenta bancaria. Solo se permiten AHO (Cuenta Ahorros) y COR (Cuenta Corriente); TCR (Tarjeta de Crédito) existe como valor legado en el catálogo, pero se rechaza explícitamente en este servicio.

Allowed:
string | null

UUID o código real de la cuenta contable a la que se contabiliza la cuenta bancaria. Opcional: si se envía, se acepta cualquiera de los dos (uuid o código) y el sistema resuelve y valida la cuenta antes de persistir (debe pertenecer al plan de cuentas base de la compañía, estar activa, ser imputable y no manejar moneda extranjera); la cuenta bancaria resultante queda en estado ACT. Si NO se envía, la cuenta bancaria se crea igual, pero en estado SUS.

Responses

401

No autorizado.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json