Crear caja

Crea una nueva caja en el sistema, asociada a la compañía de la cuenta Pymes. Requiere que la estructura empresarial, el responsable y el empleado asignado existan. La cuenta contable es opcional: si se envía, debe existir, pertenecer al plan de cuentas base de la compañía (que debe tener dicho libro base configurado), estar activa, ser imputable y no manejar moneda extranjera; si NO se envía, la caja se crea igual, pero en estado SUSP en vez de ACTI (ver estadoCaja más abajo).

Los campos tipoCaja, estadoCajaVentaMostrador, base, usoExclusivoEstructura, numeroCuadreCaja, fechaApertura y moneda no se reciben en la creación: siempre se guardan con su valor fijo (RECA, CER, 0, false y null respectivamente), salvo moneda, que se resuelve automáticamente a partir de la moneda base de la compañía o, si esta no tiene una configurada, de la moneda por defecto del sistema (COP). Enviar cualquiera de estos campos en el cuerpo de la petición produce un error campo.no-reconocido. estadoCaja tampoco se recibe en la creación, pero no es fijo: es ACTI si se envió una cuenta válida, o si la compañía no maneja contabilidad activa (en ese caso la cuenta no es requerida y la caja siempre queda ACTI, se envíe cuenta o no). Si la compañía sí maneja contabilidad y no se envió cuenta, la caja queda SUSP.
La caja siempre se crea con saldo y saldo en efectivo en 0.

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

Datos para crear una caja. La compañía se resuelve automáticamente de la cuenta Pymes. De los campos de texto, solo codigo y descripcion validan longitud máxima; el resto son llaves foráneas y se validan por existencia (no por longitud).

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

Código único de la caja. Solo se permiten letras, números, guion y guion bajo.

string
required
length ≤ 50
string | null

UUID o código real de la cuenta contable a la que se contabiliza la caja. 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); la caja resultante queda en estado ACTI. Si NO se envía, la caja se crea igual, pero en estado SUSP.

string
required

UUID o código de la estructura empresarial a la que se asigna la caja. Se acepta cualquiera de los dos; el sistema resuelve y valida la estructura antes de persistir. Debe existir, estar clasificada como 'EPP' o 'EST', y estar activa.

string
required

UUID o cédula del empleado responsable. Se acepta cualquiera de los dos; el sistema resuelve y valida que la persona tenga un comportamiento comercial de tipo empleado antes de persistir.

string
required

UUID o cédula del empleado asignado. Se acepta cualquiera de los dos; el sistema resuelve y valida que la persona tenga un comportamiento comercial de tipo empleado antes de persistir.

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