Crear una cuenta
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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»coin_idintegerobligatorioMoneda de la cuenta. Si account_type es detracción, la moneda debe ser Soles.
typestringobligatorioTipo de cuenta: física o virtual.
account_typestringobligatorioClase de cuenta: detracción o recaudación.
namestringobligatorioNombre de la cuenta. Se guarda en mayúsculas.
amountnumberobligatorioSaldo inicial de la cuenta.
bank_idintegercondicionalObligatorio si type es virtual. Si account_type es detracción, el banco debe ser Banco de la Nación.
modalitystringcondicionalObligatorio si type es virtual, por ejemplo cuenta bancaria.
numberstringcondicionalObligatorio si type es virtual y modality es cuenta bancaria. Debe ser único entre las cuentas.
number_ccistringcondicionalObligatorio si type es virtual y modality es cuenta bancaria. Máximo 20 caracteres. Debe ser único entre las cuentas.
cashbox_idintegerCaja a la que se asigna la cuenta.
settingsobjectConfiguración de la cuenta. Acepta overdraft_enabled (booleano).
descriptionstringDescripción de la cuenta. Se guarda en mayúsculas.
responsiblestringResponsable de la cuenta. Se guarda en mayúsculas.
Permiso
Sección titulada «Permiso»cashbox.account.create, que se valida en AccountPolicy::create. Ver Permisos y políticas.
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/account", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "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" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/account', [ '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', ]);{ "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}{ "message": "Esta acción no está autorizada."}{ "message": "El tipo de cuenta es requerido.", "errors": { "account_type": [ "El tipo de cuenta es requerido." ] }}