Skip to main content
GET
Listar usuarios autorizados

Qué hace

Obtiene la lista de usuarios autorizados para emitir boletas de honorarios para una entidad emisora específica, leída desde un caché local — nunca consulta el SII en el momento del request. Esta lista incluye todos los usuarios que tenían permisos para autorizar boletas en la empresa según la última sincronización. Para refrescar el caché contra el SII, usa Sincronizar Usuarios Autorizados. Si la entidad nunca fue sincronizada, este endpoint devuelve una lista vacía.

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

Lectura siempre desde caché

La lista nunca se scrapea del SII en el momento del GET — esto garantiza que el endpoint responda rápido y no falle por una caída o lentitud transitoria del SII. El caché se actualiza únicamente vía Sincronizar Usuarios Autorizados.

Un sync fallido no borra el caché

Si la última sincronización terminó en error, el GET sigue devolviendo la última lista exitosa conocida — nunca queda vacío por una falla transitoria del SII. El campo last_sync_status permite distinguir “nunca sincronizado” de “sincronizado con error” de “sincronizado con éxito”.

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 (solo al sincronizar)

La credencial SII válida asociada a la entidad emisora solo se necesita al sincronizar (ver Sincronizar Usuarios Autorizados), no al hacer este GET.

Consideraciones importantes

  • La lista se lee de un caché local; nunca dispara un scrape al SII
  • Incluye last_sync_status, last_sync_error y last_synced_at para saber el estado y frescura del caché
  • El campo enrolled indica si el usuario ya fue enrolado en el sistema
  • Los nombres se obtienen tal como aparecían en el SII durante la última sincronización exitosa

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
last_sync_status
enum<string> | null

Estado del último intento de sincronización con el SII. null si esta entidad nunca fue sincronizada.

Available options:
queued,
syncing,
done,
error,
null
Example:

"done"

last_sync_error
string

Mensaje de error del último intento, solo presente si last_sync_status es 'error'

Example:

""

last_synced_at
string<date-time> | null

Fecha y hora (ISO 8601) en que terminó la última sincronización exitosa o fallida. null si nunca terminó ninguna (incluye el caso de una sincronización todavía en curso, cuando aún no hay ninguna completada).

Example:

"2026-07-22T15:40:12.123456+00:00"