Actualizar datos privados del contribuyente

POST/api/v1/sii/dte/contribuyentes/set_datos/{contribuyente}v1 · ESTABLE

POST /api/v1/sii/dte/contribuyentes/set_datos/{contribuyente}

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

Actualizar datos privados de un contribuyente ante el SII.

Asigna o modifica los datos privados del contribuyente (emails de contacto + software de facturacion) en el registro del SII via el flujo multi-step de ad_empresa1 → ad_empresa2 → ad_empresa3 → ad_empresa4. Requiere certificado con permiso de escritura sobre el RUT.

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

certificado digital del contribuyente o representante autorizado.

Quota: Consume 1 consulta | Peso: 5x (operacion critica de escritura)

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`contribuyente`	string	Si	RUT del contribuyente (`XXXXXXXX-K`)

Parametros de consulta

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

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.cert.cert-data`	string	Si	Certificado digital (base64)
`auth.cert.pkey-data`	string	Si	Clave privada del certificado (base64)
`auth.cert.passphrase`	string	No	Passphrase del certificado
`datos`	object	Si	Contenedor de datos a actualizar (al menos un sub-campo)
`datos.emails.administrador`	string	No	Mail Contacto Usuario-Administrador (`MAIL_SUP` en el SII)
`datos.emails.sii`	string	No	Mail Contacto SII (`MAIL_SII` en el SII)
`datos.emails.intercambio`	string	No	Mail Contacto Empresas / intercambio DTE (`MAIL_DTE` en el SII)
`datos.software.nombre`	string	No	Nombre del software de facturacion (`NOM_SW`, se envia en MAYUSCULAS)
`datos.software.url`	string	No	URL del software (`URL`, se envia en minusculas)

Nota: estos son los 3 emails editables en el formulario del SII ad_empresa3 + datos del software. El campo contacto que aparece en la respuesta de GET /datos_privados NO es editable desde aqui (es un campo derivado del registro base del contribuyente).

Request de ejemplo

{
  "auth": {
    "cert": {
      "cert-data": "BASE64_CERT",
      "pkey-data": "BASE64_PKEY",
      "passphrase": "CERT_PASSPHRASE"
    }
  },
  "datos": {
    "emails": {
      "administrador": "admin@empresa.cl",
      "sii": "sii@empresa.cl",
      "intercambio": "intercambio@empresa.cl"
    },
    "software": {"nombre": "FiscalBridge", "url": "https://fiscalbridge.cl"}
  }
}

Respuesta exitosa (200)

Mensaje extraido dinamicamente del HTML de confirmacion del SII (gateway transparente, sin hardcoded):

{
    "success": true,
    "message": "Operación completada exitosamente",
    "data": null
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
400	`VALIDATION_ERROR`	Datos rechazados por SII	Revisar `message`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`INSUFFICIENT_SCOPE`	Token sin scope `sii:write`	Generar token con scope adecuado
403	`AUTH_ERROR`	Certificado sin permiso sobre el RUT	Usar certificado del contribuyente
422	`VALIDATION_ERROR`	Campo extra no permitido (ej: `contacto`) o body sin `datos`	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII rechazo la actualizacion	Revisar `message` y `details.observacion`

Parámetros

Header / Body

Tipo

Descripción

Requerido

contribuyente

string · path

RUT del contribuyente

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..."
    }
  },
  "datos": {
    "emails": {
      "administrador": "string",
      "intercambio": "string",
      "sii": "string"
    },
    "software": {
      "nombre": "string",
      "url": "string"
    }
  }
}

Respuestas

200Successful Response

400Datos invalidos o credenciales SII incorrectas

401API token ausente o invalido

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

422Body con formato invalido

429Limite de tasa excedido

502SII rechazo la actualizacion

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "message": "string",
  "success": true
}

Actualizar datos privados del contribuyente

On this page