Listar Usuarios Autorizados
Obtiene la lista de usuarios autorizados para emitir boletas de honorarios, leída desde un caché local. Nunca consulta el SII en el momento del request — para refrescarla contra el SII, usa POST /honorary/master-entities//authorized-users/sync/. El master_entity_id se proporciona como query parameter.
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): Elmaster_entity_idse proporciona como query parameterGET /v1/honorary/master-entities/{master_entity_id}/authorized-users/: Elmaster_entity_idse 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 delGET — 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, elGET 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 esteGET.
Consideraciones importantes
- La lista se lee de un caché local; nunca dispara un scrape al SII
- Incluye
last_sync_status,last_sync_errorylast_synced_atpara saber el estado y frescura del caché - El campo
enrolledindica 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
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
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
Estado del último intento de sincronización con el SII. null si esta entidad nunca fue sincronizada.
queued, syncing, done, error, null "done"
Mensaje de error del último intento, solo presente si last_sync_status es 'error'
""
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).
"2026-07-22T15:40:12.123456+00:00"
