Listar representantes del contribuyente

POST/api/v1/sii/misii/representantes/listadov1 · ESTABLE

POST /api/v1/sii/misii/representantes/listado

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/misii/representantes/listado",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Listar representantes del contribuyente autenticado en el SII.

Obtiene la lista de personas (RUT + permisos) autorizadas para representar al contribuyente identificado en el body auth. Cada representante incluye los codigos de permisos otorgados (MISII, FELET, etc.) y fechas de vigencia.

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

credenciales SII del contribuyente en el body (auth.pass.rut/auth.pass.clave).

Quota: Consume 1 consulta | Peso: 1x

Body (JSON)

{
    "auth": {
        "pass": {"rut": "76.XXX.XXX-K", "clave": "clave_tributaria"}
    }
}

Respuesta exitosa (200)

{
    "representado": {"rut": "76000000", "dv": "K", "razon_social": "Empresa Ejemplo SpA"},
    "representantes": [
        {
            "rut": "12345678",
            "dv": "9",
            "nombre": "NOMBRE EJEMPLO",
            "permisos": ["MISII", "FELET"],
            "fecha_inicio": "2020-01-15",
            "fecha_termino": null,
            "activo": true
        }
    ]
}

Errores especificos

Codigo	error_code	Causa
400	`AUTH_ERROR`	RUT/clave SII incorrectos
401	`HTTP_401`	API token ausente o invalido
422	`VALIDATION_ERROR`	Body con formato invalido
429	`SII_RATE_LIMIT`	Rate limit del SII
502	`SII_GATEWAY_ERROR`	SII retorno error
503	`SII_UNAVAILABLE`	SII en mantenimiento

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "clave": "mi_clave_tributaria",
  "rut": "12.345.678-9"
}

Respuestas

200Successful Response

400Credenciales SII invalidas (AUTH_ERROR)

401API token ausente o invalido

403Sin permisos o cuenta bloqueada

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.

{
  "Contribuyente": {
    "dv": "string",
    "nombre": "string",
    "rut": 0
  },
  "permisos": [
    {
      "codigo": "string",
      "descripcion": "string",
      "nivel": "B"
    }
  ],
  "representantes": [
    {
      "codigo": "string",
      "descripcion": "",
      "dv": "string",
      "nombre": "string",
      "rut": "string"
    }
  ]
}