Tu Primera Petición

Es momento de hacer tu primera petición real a la API. Comenzaremos con algo simple: validar un RUT. Este endpoint no requiere autenticación en el SII, por lo que es perfecto para empezar.

Paso 1: Obtener tu Access Token

¿Qué es un Access Token?

Es tu “llave” para usar la API. Todas las peticiones deben incluir este token para identificarte como usuario autorizado.

Dónde Obtenerlo

1. Ingresa a tu Dashboard de API Gateway
2. En la sección “API Auth“ podrás crear un nuevo token.
3. Haz clic en “Crear Token”
4. Copia el token generado.

⚠️ Importante: Este token es como una contraseña. No lo compartas ni lo subas a repositorios públicos.

Paso 2: Configurar Autorización en Swagger

Proceso de Autorización

1. En Swagger UI, busca el botón “Authorize” 🔐 (parte superior derecha)

2. Se abrirá un modal de autorización

3. En el campo “Value”, ingresa:

   Bearer sk_live_50kB1cGciOiJSUzI1NiIsInR5c...
   

   Nota: Incluye la palabra “Bearer” seguida de un espacio antes del token

4. Haz clic en “Authorize”

5. El botón mostrará un candado cerrado 🔒 indicando que estás autenticado

Verificar Autorización

Si la autorización fue exitosa:

• El candado aparece cerrado 🔒
• Verás tu token parcialmente oculto
• Opción para “Logout” disponible

Paso 3: Seleccionar el Endpoint

Endpoint Situación Tributaria de un Contribuyente

Busca en la sección “API Contribuyentes”:

GET /api/v1/sii/contribuyentes/situacion_tributaria/tercero/{rut}

¿Por qué este endpoint?

• Es simple (solo requiere un parámetro)
• No necesita autenticación SII
• Respuesta inmediata
• Útil para obtener la situación tributaria de un contribuyente

Expandir el Endpoint

1. Haz clic sobre el endpoint
2. Se desplegará mostrando:
   • Descripción completa
   • Parámetros requeridos
   • Posibles respuestas

Paso 4: Configurar la Petición

Activar Modo de Prueba

1. Haz clic en “Try it out”
2. Los campos se vuelven editables

Completar Parámetros

Para este endpoint solo necesitas:

Path Parameters
───────────────
rut*: 76192083-9

Formato del RUT:

• Sin puntos
• Con guión
• Con dígito verificador
• Ejemplo: 76192083-9 ✅
• No usar: 76.192.083-9 ❌

Paso 5: Ejecutar la Petición

Enviar la Solicitud

1. Verifica que el RUT esté correctamente ingresado
2. Haz clic en “Execute”
3. Swagger enviará la petición a la API

Qué Sucede al Ejecutar

1. Swagger construye la petición completa
2. Añade tu Bearer Token automáticamente
3. Envía la solicitud al servidor
4. Espera la respuesta
5. Muestra los resultados

Paso 6: Interpretar la Respuesta

Respuesta Exitosa (200 OK)

{
  "actividades": [
    {
      "afecta": true,
      "categoria": 1,
      "codigo": "620200",
      "glosa": "ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION DE INSTALACIONE"
    }
  ],
  "documentos_timbrados": [
    {
      "documento": "Factura Electronica",
      "ultimo_timbraje": 2020
    },
  ],
  "dv": "9",
  "excepcion_dte": false,
  "fecha_inicio_actividades": "2012-06-08",
  "inicio_actividades": true,
  "moneda_extranjera": false,
  "obligacion_dte": true,
  "observaciones": {
    "actividad_esporadica": false,
    "domicilio_inexistente": false,
    "inconcurrente": false,
    "no_habido_domicilio": false,
    "no_ubicado": false,
    "suplantado": false,
    "termino_giro": false,
    "termino_giro_obligatorio": false
  },
  "pro_pyme": true,
  "razon_social": "SASCO SPA",
  "rut": 76192083
}

Campos de la respuesta:

Headers de Respuesta

content-type: application/json
x-ratelimit-limit: 1000
x-ratelimit-remaining: 999
x-request-id: 550e8400-e29b-41d4

Headers importantes:

Analizando el cURL

Swagger genera automáticamente el comando cURL:

curl -X 'GET' \
  'https://legacy.apigateway.cl/api/v1/sii/contribuyentes/situacion_tributaria/tercero/76192083-9' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer sk_live_50kB1cGciOiJSUzI1NiIsInR5c...'

Componentes del comando:

• -X 'GET': Método HTTP
• URL completa con el RUT
• -H 'accept: application/json': Esperamos JSON
• -H 'Authorization: ...': Tu token de acceso

Ejercicios Adicionales

1. Probar con RUT Inválido

Intenta con: 11111111-2 (dígito verificador incorrecto)

Respuesta esperada:

{
    "rut": 11111111,
    "dv": "2",
    "razon_social": null,
    "inicio_actividades": null
}

2. Probar sin Autorización

1. Haz “Logout” en el modal de autorización
2. Ejecuta la misma petición
3. Observa el error 401

Respuesta esperada:

{
  "message": "Unauthenticated."
}

3. Explorar Otro Endpoint Simple

Prueba con:

GET /api/v1/sii/contribuyentes/actividades_economicas

Este endpoint retorna el listado de actividades económicas.