Listar usuarios autorizados a operar en nombre del contribuyente

POST/api/v1/sii/dte/contribuyentes/usuarios/{rut}v1 · ESTABLE

POST /api/v1/sii/dte/contribuyentes/usuarios/{rut}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/dte/contribuyentes/usuarios/76192083-9",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Listar usuarios autorizados para operar en nombre de un contribuyente.

Retorna la lista de usuarios (RUT y permisos) autorizados a operar servicios DTE (emitir facturas, descargar CAF, etc.) en nombre del contribuyente indicado.

Autenticacion requerida: API token en header X-API-Token con scope sii:read

certificado digital con permiso sobre el RUT.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`rut`	string	Si	RUT del contribuyente

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion

Respuesta exitosa (200)

{
    "success": true,
    "message": "Usuarios autorizados obtenidos exitosamente",
    "data": [
        {
            "rut": "12.345.678-9",
            "nombre": "Juan Perez",
            "permisos": [
                "emitir_dte",
                "descargar_caf"
            ]
        }
    ]
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`AUTH_ERROR`	Certificado sin permiso sobre el RUT	Usar certificado del contribuyente
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Parámetros

Header / Body

Tipo

Descripción

Requerido

rut

string · path

RUT del contribuyente (`XXXXXXXX-K`)

Sí

ambiente

string · query

`0` produccion, `1` certificacion

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  }
}

Respuestas

200Successful Response

400RUT invalido o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o sin permiso sobre contribuyente

404Contribuyente no encontrado

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}

Listar usuarios autorizados a operar en nombre del contribuyente

On this page