Consultar documentos autorizados de un contribuyente

POST/api/v1/sii/dte/contribuyentes/{rut}/documentosv1 · ESTABLE

POST /api/v1/sii/dte/contribuyentes/{rut}/documentos

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

Consultar tipos de documentos autorizados para un contribuyente.

Retorna los tipos de DTE que un contribuyente esta autorizado a emitir (ej: factura electronica, boleta, guia de despacho). Permite validar capacidades de facturacion antes de intentar emitir.

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

certificado digital en el body.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

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

Parametros de consulta

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

Respuesta exitosa (200)

{
    "success": true,
    "message": "Documentos autorizados obtenidos exitosamente",
    "data": [
        {
            "codigo": 33,
            "nombre": "Factura Electronica"
        },
        {
            "codigo": 39,
            "nombre": "Boleta Electronica"
        }
    ]
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	RUT con formato invalido	Usar `XXXXXXXX-K`
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Contribuyente no autorizado DTE	Verificar con `/contribuyentes/autorizado/{rut}`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Parámetros

Header / Body

Tipo

Descripción

Requerido

rut

string · path

RUT del contribuyente (`XXXXXXXX-K`)

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..."
    }
  }
}

Respuestas

200Successful Response

400RUT invalido o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o cuenta bloqueada

404Contribuyente no autorizado DTE

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.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}

Consultar documentos autorizados de un contribuyente

On this page