Consultá los roles de persona disponibles para una cuenta comitente y sus códigos de referencia.

Antes de empezar

1. Usá este endpoint cuando necesites poblar listas de roles de persona en formularios o validaciones.
2. Si querés obtener un rol puntual, enviá person_role_id como query parameter.
3. Guardá el código de cada rol para usarlo luego en requests que requieran ese identificador.

Cómo consultar roles de persona

GET /api/master-tables/person-roles

Filtrar un rol puntual

GET /api/master-tables/person-roles?person_role_id=TI

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa un rol de persona disponible para cuentas comitentes.

Respuesta esperada

{
  "items": [
    {
      "person_role_id": "AC",
      "person_role": "Accionista"
    },
    {
      "person_role_id": "AP",
      "person_role": "Apoderado"
    },
    {
      "person_role_id": "TI",
      "person_role": "Titular"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "person_role_id": "TI",
      "person_role": "Titular"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar roles de persona en un formulario
• validar un código antes de enviarlo a otro servicio
• traducir un identificador técnico a una descripción legible

Errores frecuentes

• 404 Value not found: el código enviado no tiene coincidencias en el maestro.
• 422 Validation Error: el query parameter tiene un formato inválido.

Siguiente paso

Si necesitás consultar tipos de cuenta por tipo de persona, usá GET /api/master-tables/person-accounts.