Ir al contenido

Crear una cuenta

POST/api/account

Crea una cuenta con estado activo, la marca como conciliada y, en la misma transacción, genera la conciliación inicial y el movimiento de conciliación del saldo inicial.

coin_idintegerobligatorio

Moneda de la cuenta. Si account_type es detracción, la moneda debe ser Soles.

typestringobligatorio

Tipo de cuenta: física o virtual.

account_typestringobligatorio

Clase de cuenta: detracción o recaudación.

namestringobligatorio

Nombre de la cuenta. Se guarda en mayúsculas.

amountnumberobligatorio

Saldo inicial de la cuenta.

bank_idintegercondicional

Obligatorio si type es virtual. Si account_type es detracción, el banco debe ser Banco de la Nación.

modalitystringcondicional

Obligatorio si type es virtual, por ejemplo cuenta bancaria.

numberstringcondicional

Obligatorio si type es virtual y modality es cuenta bancaria. Debe ser único entre las cuentas.

number_ccistringcondicional

Obligatorio si type es virtual y modality es cuenta bancaria. Máximo 20 caracteres. Debe ser único entre las cuentas.

cashbox_idinteger

Caja a la que se asigna la cuenta.

settingsobject

Configuración de la cuenta. Acepta overdraft_enabled (booleano).

descriptionstring

Descripción de la cuenta. Se guarda en mayúsculas.

responsiblestring

Responsable de la cuenta. Se guarda en mayúsculas.

cashbox.account.create, que se valida en AccountPolicy::create. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/account" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"coin_id": 1,
"type": "virtual",
"account_type": "recaudación",
"name": "Cuenta corriente soles",
"amount": 1500.5,
"bank_id": 3,
"modality": "cuenta bancaria",
"number": "191-1234567-0-12",
"number_cci": "00219100123456701234"
}'
Cuenta creada201
{
"coin_id": 1,
"type": "virtual",
"account_type": "recaudación",
"name": "CUENTA CORRIENTE SOLES",
"amount": 1500.5,
"bank_id": 3,
"modality": "cuenta bancaria",
"number": "191-1234567-0-12",
"number_cci": "00219100123456701234",
"status": "activo",
"previous_status": null,
"conciliated": true,
"conciliated_at": "2026-11-19T10:40:15.000000Z",
"conciliated_movement_last_date": null,
"create_user_id": 1,
"updated_at": "2026-11-19T10:40:15.000000Z",
"created_at": "2026-11-19T10:40:15.000000Z",
"id": 1
}
Sin permiso403
{
"message": "Esta acción no está autorizada."
}
Datos no válidos422
{
"message": "El tipo de cuenta es requerido.",
"errors": {
"account_type": [
"El tipo de cuenta es requerido."
]
}
}