Skip to main content
GET
/
honorary
/
authorized-users
Listar usuarios autorizados
curl --request GET \
  --url https://api.tupana.ai/v1/honorary/authorized-users/ \
  --header 'Authorization: <api-key>'
{
  "authorized_users": [
    {
      "rut": "12.345.678-9",
      "nombre": "MARIA JOSEFA GONZALEZ LOPEZ",
      "enrolled": false
    }
  ]
}

​
Qué hace

Obtiene la lista completa de usuarios autorizados para emitir boletas de honorarios desde el Servicio de Impuestos Internos (SII) para una entidad emisora específica. Esta lista incluye todos los usuarios que tienen permisos para autorizar boletas en la empresa.

​
Endpoints disponibles

Este endpoint está disponible en dos formatos:
  • GET /v1/honorary/authorized-users/?master_entity_id={id} (recomendado): El master_entity_id se proporciona como query parameter
  • GET /v1/honorary/master-entities/{master_entity_id}/authorized-users/: El master_entity_id se proporciona en la ruta (mantiene compatibilidad)

​
Ejemplos de uso

  • Mostrar en la interfaz de administración qué usuarios pueden ser enrolados para una entidad específica
  • Verificar qué usuarios ya están autorizados por el SII para emitir boletas
  • Actualizar el estado de enrolamiento de cada usuario en el sistema

​
Reglas de negocio

​
Obtención de datos en tiempo real

La lista se obtiene directamente del SII en tiempo real cada vez que se consulta. No se almacena en caché para garantizar que siempre refleje el estado actual de autorizaciones.

​
Estado de enrolamiento

Cada usuario en la lista incluye un campo que indica si ya fue enrolado en el sistema. Esto permite al frontend mostrar visualmente qué usuarios están disponibles para enrolar y cuáles ya están activos.

​
Validación de credenciales

Se requiere una credencial SII válida asociada a la entidad emisora. Si no existe una credencial válida, la consulta falla.

​
Consideraciones importantes

  • La lista se obtiene directamente del SII en tiempo real
  • Se requiere una credencial SII válida asociada a la entidad
  • El campo enrolled indica si el usuario ya fue enrolado en el sistema
  • Los nombres se obtienen tal como aparecen en el registro del SII

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Query Parameters

​
master_entity_id
integer
required

ID de la entidad para la cual se consultan los autorizados. Debe proporcionarse como query parameter. ID de la entidad maestra

Response

Lista de usuarios autorizados obtenida exitosamente

​
authorized_users
object[]
required