SIIDTE
Listar contribuyentes autorizados DTE
Listar contribuyentes autorizados para emitir DTE.
POST
/api/v1/sii/dte/contribuyentes/autorizadosv1 · ESTABLEPOST /api/v1/sii/dte/contribuyentes/autorizados
Listar contribuyentes autorizados para emitir DTE.
Retorna la nomina oficial del SII con contribuyentes autorizados para emitir documentos tributarios electronicos. Util para validar si un RUT puede recibir facturas electronicas antes de emitirlas.
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 consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
dia | string | hoy | Fecha AAAA-MM-DD (opcional) |
ambiente | string | 0 | 0 produccion, 1 certificacion |
formato | string | json | json (default) o html |
sistema | string | mercado | mercado (propio/mercado) o sii (gratuito SII) |
Respuesta exitosa (200)
Lista de DTEContribuyenteAutorizado:
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | AUTH_ERROR | Certificado SII invalido | Renovar certificado |
| 400 | VALIDATION_ERROR | Fecha con formato invalido | Usar AAAA-MM-DD |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 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 |
Notas
- El listado es oficial del SII y se actualiza diariamente.
- Para verificar un RUT especifico, usar
GET /contribuyentes/autorizado/{rut}(publico).
Parámetros
Header / Body
Tipo
Descripción
Requerido
ambiente
string · query
`0` produccion, `1` certificacion
No
dia
string | null · query
Fecha `AAAA-MM-DD` (opcional, default: hoy)
No
formato
string · query
`json` (default) o `html`
No
sistema
string · query
Sistema de facturacion: `mercado` (propio/mercado) o `sii` (gratuito SII)
No
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200Successful Response
400Parametros invalidos o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o cuenta bloqueada
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.