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/:contribuyente",
    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

—

Sí

ambiente

string · query

`0` produccion, `1` certificacion

dry_run

string | null · query

Si es `true` (o `1`/`yes`/`on`), el endpoint valida el payload y retorna una respuesta de previsualización (mismo shape que la respuesta real) sin contactar al SII. Útil para validar requests sin consumir folios, cuota ni créditos.

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