Consultar datos contribuyente certificacion

POST/api/v1/sii/certificacion/contribuyentes/datos/{contribuyente}v1 · ESTABLE

POST /api/v1/sii/certificacion/contribuyentes/datos/{contribuyente}

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

Consultar datos del contribuyente para proceso de certificacion DTE.

Recupera los datos del contribuyente registrados en el portal de certificacion DTE del SII (RUT, razon social, emails de contacto, documentos autorizados, software postulados) usando autenticacion con certificado digital.

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

credencial certificado digital en el body bajo auth.cert.*: PEM (cert-data + pkey-data) o PFX (pfx-data + passphrase).

Quota: Consume 1 consulta | Peso: 2x (operacion con cert web auth)

Parametros de ruta

Parametro	Tipo	Requerido	Formato
`contribuyente`	string	Si	`DDDDDDDD-X` (sin puntos, 1-8 digitos + guion + DV)

Errores especificos

Codigo	error_code	Causa
400	`AUTH_ERROR`	Certificado digital invalido o passphrase incorrecta
401	`HTTP_401`	API token ausente o invalido
422	`VALIDATION_ERROR`	RUT no cumple patron `DDDDDDDD-X` o 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

Parámetros

Header / Body

Tipo

Descripción

Requerido

contribuyente

string · path

RUT del contribuyente (ej: 77742536-6)

Sí

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  }
}

Respuestas

200Successful Response

400Credenciales SII o datos invalidos

401API token ausente o invalido

403Sin permisos o cuenta bloqueada

422Path RUT o body 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.

{
  "actividades": [
    {}
  ],
  "casa_matriz": {},
  "dv": "string",
  "giro": "string",
  "razon_social": "string",
  "rut": 0,
  "unidad_sii": "string"
}