Update credit clients and aportantes via RRHH

The RRHH module exposes edit endpoints for credit clients and aportantes (investors). These records are initially created through the Business Operations module at /api/negocios; the endpoints documented here only update existing records.

To create a new credit client or aportante, use the /api/negocios endpoints. See the Business Operations reference for details.

All endpoints require a valid JWT bearer token. The authenticated user’s ID is recorded internally as the actor who performed the update.

Edit credit client

PUT /api/rrhh/clientes/editar Updates one or more profile fields for an existing credit client. At least one body field must be provided.

clienteId

string

required

UUID of the credit client to update.

nombre

string

First name. Formatted as title case.

apellido

string

Last name. Formatted as title case.

cedula_rif

string

National ID or tax ID. Accepted formats: V-12345678, E-12345678-9, J-12345678-9.

string

Email address. Converted to lowercase automatically.

tipo

string

Client type. Accepted values: corp, natural.

credito

number

Total approved credit amount.

disponible

number

Currently available credit balance.

prestado

number

Amount currently lent.

referido

string

Name or identifier of the referring contact.

estatus

string

Account status. Accepted values: activo, desactivo, suspendido, pendiente, en_curso, moroso.

responsable

string

UUID of the employee responsible for this client.

curl -X PUT "https://api.marbes.org/api/rrhh/clientes/editar?clienteId=c1d2e3f4-a5b6-7890-cdef-123456789abc" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Carlos",
    "apellido": "Rodríguez",
    "estatus": "activo",
    "credito": 50000
  }'

success

boolean

required

true on a successful update.

data

object

Updated credit client record.

Show fields

string

Client UUID.

nombre

string

First name (formatted).

apellido

string

Last name (formatted).

cedula_rif

string

ID with hyphens.

string

Lowercased email.

tipo

string

corp or natural.

credito

number

Approved credit amount.

disponible

number

Available balance.

prestado

number

Amount lent.

estatus

string

Current status.

updated_at

string

ISO 8601 timestamp of the update.

200

{
  "success": true,
  "data": {
    "id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
    "nombre": "Carlos",
    "apellido": "Rodríguez",
    "cedula_rif": "V-98765432",
    "email": "[email protected]",
    "tipo": "natural",
    "credito": 50000,
    "disponible": 50000,
    "prestado": 0,
    "estatus": "activo",
    "updated_at": "2024-05-06T15:00:00Z"
  }
}

400 – missing clienteId

{
  "success": false,
  "message": "clienteId es requerido"
}

400 – no fields provided

{
  "success": false,
  "message": "Debe proporcionar al menos un campo para actualizar"
}

401

{
  "success": false,
  "message": "Usuario no autenticado"
}

500

{
  "success": false,
  "message": "Error interno del servidor"
}

Edit aportante (investor)

PUT /api/rrhh/aportante/editar Updates one or more profile fields for an existing aportante. At least one body field must be provided.

aportanteId

string

required

UUID of the aportante to update.

nombre

string

First name. Formatted as title case.

apellido

string

Last name. Formatted as title case.

cedula_rif

string

National ID or tax ID. Accepted formats: V-12345678, E-12345678-9, J-12345678-9.

string

Email address. Converted to lowercase automatically.

telefono

string

Phone number. A leading 0 is added if missing. Final format: 0424-1234567.

tipo

string

Investor type. Accepted values: corp, natural.

referido

string

Name or identifier of the referring contact.

responsable

string

UUID of the employee responsible for this aportante.

estatus

string

Account status. Accepted values: activo, desactivo, suspendido.

curl -X PUT "https://api.marbes.org/api/rrhh/aportante/editar?aportanteId=a9b8c7d6-e5f4-3210-abcd-987654321fed" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "telefono": "4121234567",
    "estatus": "activo"
  }'

success

boolean

required

true on a successful update.

data

object

Updated aportante record.

Show fields

string

Aportante UUID.

nombre

string

First name.

apellido

string

Last name.

cedula_rif

string

ID with hyphens.

string

Lowercased email.

telefono

string

Formatted phone number.

tipo

string

corp or natural.

estatus

string

Current status.

updated_at

string

ISO 8601 timestamp of the update.

200

{
  "success": true,
  "data": {
    "id": "a9b8c7d6-e5f4-3210-abcd-987654321fed",
    "nombre": "Ana",
    "apellido": "Martínez",
    "cedula_rif": "V-11223344",
    "email": "[email protected]",
    "telefono": "0412-1234567",
    "tipo": "natural",
    "estatus": "activo",
    "updated_at": "2024-05-06T16:00:00Z"
  }
}

400 – missing aportanteId

{
  "success": false,
  "message": "aportanteId es requerido"
}

400 – no fields provided

{
  "success": false,
  "message": "Debe proporcionar al menos un campo para actualizar"
}

401

{
  "success": false,
  "message": "Usuario no autenticado"
}

500

{
  "success": false,
  "message": "Error interno del servidor"
}

Authentication

HR & Users

Business Operations

Banking

Accounting & Reports

Update credit clients and aportantes via RRHH

Edit credit client

Edit aportante (investor)

Build docs developers (and LLMs) love

Authentication

HR & Users

Business Operations

Banking

Accounting & Reports

Documentation Index

​Edit credit client

​Edit aportante (investor)

Build docs developers (and LLMs) love

Edit credit client

Edit aportante (investor)