API de Enrolamiento
Empresas

Actualiza el usuario con RUT {rutUsuario} con permisos en el SII para la empresa con RUT {rutEmpresa}.

POST
/v1/empresas/{rutEmpresa}/permisos/{rutUsuario}/{ambiente}

Actualiza el usuario con RUT {rutUsuario} con permisos en el SII para la empresa con RUT {rutEmpresa}.

Autorización

basic
headerAuthorizationBasic <token>

Parámetros de ruta

rutEmpresa*string

RUT de la empresa.

rutUsuario*string

RUT del usuario.

ambiente*integer

Ambiente del SII: 0 = Homologación (certificación), 1 = Producción. El segmento es opcional en la API: si se omite, opera en producción. Páselo siempre explícito. Un valor que no se reconoce no da error: la operación corre en producción. Un número distinto de 0 y 1 no da error y corre en homologación.

Formatoint32
Por defecto1
Valor en01

Cuerpo del request

Certificado para autenticación en el SII.

application/json
  1. body

Datos del certificado digital.

Contrasenna*string

Contraseña del PFX, en claro o cifrada con la clave de cifrado del perfil del cliente. Dato sensible: no se registra en logs del integrador.

Data*string

PFX del certificado, en base64. Dato sensible: no se registra en logs del integrador.

Formatobyte

Cuerpo de la respuesta

true si la operación fue exitosa. Si falla, la API responde con un error.

response?booleanapplication/json
curl --request POST \  --url https://api.enrolamiento.cl/v1/empresas/1-9/permisos/1-9/0 \  --header 'Accept: application/json' \  --header 'Authorization: Basic <base64 de usuario:apikey>' \  --header 'Content-Type: application/json' \  --data '{  "Contrasenna": "********",  "Data": "MIIC"}'
true

Reintentos e idempotencia

Idempotente: desconocido. No está establecido: trátela como no idempotente.

Qué hacerCódigos y status
Reintentar solo, con espera (automatico)409
Consultar el estado antes de repetir (manual)CERT_ERROR, ERROR_GENERAL, SII_ERROR_CXN
No repetir: corregir la causa (nunca)CERT_REQUERIDO

Un código que no figura en esta tabla se resuelve con la regla de respaldo.