Listar contribuyentes representables

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

POST /api/v1/sii/misii/representados/listado

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

Listar contribuyentes que el usuario puede representar.

Obtiene la lista de contribuyentes que han delegado su representacion al usuario autenticado en el SII, con los permisos otorgados por cada uno. Si no hay representados, se retorna un mensaje del SII.

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

credenciales SII del usuario en el body.

Quota: Consume 1 consulta | Peso: 1x

Body (JSON)

Mismo formato que /representantes/listado (ver documentacion de ese endpoint).

Respuesta exitosa (200)

{
    "representante": {"rut": "12345678", "dv": "9"},
    "representados": [
        {
            "rut": "76000000",
            "dv": "K",
            "razon_social": "Empresa Ejemplo SpA",
            "permisos_otorgados": ["MISII", "FELET"],
            "fecha_inicio": "2020-01-15",
            "activo": true
        }
    ]
}

Errores especificos

Identicos a /representantes/listado.

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400Credenciales SII invalidas

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
  },
  "mensaje": "string",
  "representados": [
    {
      "codigo": "",
      "descripcion": "",
      "dv": "string",
      "razon_social": "string",
      "rut": "string"
    }
  ]
}