Preguntas Frecuentes - FAQ

Guía de Integración API – Consulta Situación Tributaria SII

Esta guía explica cómo integrar el servicio de consulta de Situación Tributaria de terceros en el SII mediante la API de INFSEG. El servicio permite consultar información tributaria de un RUT y obtener una respuesta estructurada en formato JSON para ser utilizada en sistemas internos, plataformas web o automatizaciones.

1. Objetivo

Esta integración permite consultar la Situación Tributaria de un RUT en el SII y obtener un JSON estructurado con información relevante como:

• Razón social
• Inicio de actividades
• Actividades económicas
• Documentos tributarios timbrados
• Obligación de emisión de DTE
• Observaciones tributarias

2. Requisitos

• URL base del API: https://api.infseg.cl
• Autenticación: Token JWT válido
• Header requerido: Authorization: Bearer <token>
• Formato de RUT: RUT chileno válido (con o sin puntos o guion)

3. Endpoint disponible

El endpoint principal para realizar consultas es:

GET /api/situacion-terceros/consultar-sii/{rut}

Ejemplo de consulta:

https://api.infseg.cl/api/situacion-terceros/consultar-sii/76683544-9

Este endpoint retorna un objeto JSON con la información tributaria disponible para el RUT consultado.

4. Ejemplo de respuesta JSON

{
    "rut": 76683544,
    "dv": "9",
    "razon_social": "HIPERCUBO SERVICIOS INFORMATICOS INTEGRALES SPA",
    "inicio_actividades": true,
    "fecha_inicio_actividades": "2017-02-08",
    "moneda_extranjera": false,
    "pro_pyme": false,
    "actividades": [
        {
            "codigo": "474100",
            "glosa": "VENTA AL POR MENOR DE COMPUTADORES, EQUIPO PERIFERICO",
            "categoria": 1,
            "afecta": true,
            "fecha": "2017-06-15"
        }
    ],
    "documentos_timbrados": [
        {
            "documento": "Factura Electronica",
            "ultimo_timbraje": 2026
        }
    ],
    "obligacion_dte": true,
    "excepcion_dte": false,
    "observaciones": {
        "actividad_esporadica": false,
        "domicilio_inexistente": false,
        "inconcurrente": false,
        "no_habido_domicilio": false,
        "no_ubicado": false,
        "suplantado": false,
        "termino_giro": false
    }
}

5. Códigos de estado y manejo de errores

6. Recomendaciones para manejo de errores

• Reintentar 1 o 2 veces ante errores 5xx
• Aplicar backoff exponencial entre intentos
• No reintentar ante errores 400 o 401 sin corregir los datos o renovar el token

7. Buenas prácticas de consumo

Para garantizar un uso eficiente del servicio recomendamos:

• Aplicar rate limit en el cliente
• Implementar caché local para consultas frecuentes
• Registrar información de auditoría en el cliente
• Monitorear latencias de respuesta

Campos recomendados para registro:

• RUT consultado
• Status code
• Latencia de respuesta
• Timestamp de consulta

También se recomienda definir un timeout entre 15 y 30 segundos para solicitudes HTTP hacia la API.

8. Soporte técnico

Si necesita asistencia con la integración o presenta problemas con el servicio, puede contactar al equipo de soporte técnico a través de:

INFSEG
https://infseg.cl