Ir al contenido

Crear una cuenta de cliente

POST/api/customer-account

Crea una cuenta de cliente. El servidor la guarda con estado activo y asigna al usuario autenticado como creador (create_user_id). Responde 201 con el registro.

customer_idintegerobligatorio

Identificador del cliente. Debe existir entre los clientes. No se puede cambiar al actualizar.

bank_idintegerobligatorio

Banco de la cuenta. Si account_type es detracción, debe ser el Banco de la Nación.

coin_idintegerobligatorio

Moneda de la cuenta. Si account_type es detracción, debe ser la moneda marcada por defecto.

namestringobligatorio

Nombre de la cuenta. Máximo 60 caracteres; solo letras, números y espacios.

responsiblestringobligatorio

Responsable de la cuenta. Máximo 60 caracteres; solo letras y espacios.

account_numberstringobligatorio

Número de cuenta. Máximo 20 caracteres y único entre las cuentas (customer_accounts). Mensaje si se repite: El número de cuenta ya está en uso.

account_typestringobligatorio

Tipo de cuenta: detracción o recaudación (AccountTypeEnum). Si no es uno de los dos, el mensaje es El tipo de cuenta seleccionado no es válido.

descriptionstring

Descripción. Máximo 500 caracteres.

customer.create, que se valida en CustomerAccountPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/customer-account" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"customer_id": 12,
"bank_id": 3,
"coin_id": 1,
"name": "Cuenta soles",
"responsible": "Juan Pérez",
"account_number": "19412345678",
"account_type": "recaudación"
}'
Cuenta de cliente creada201
{
"id": 1,
"customer_id": 12,
"bank_id": 3,
"coin_id": 1,
"responsible": "Juan Pérez",
"name": "Cuenta soles",
"account_number": "19412345678",
"account_type": "recaudación",
"email": null,
"description": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El cliente es requerido.",
"errors": {
"customer_id": ["El cliente es requerido."]
}
}