--- title: "Introducción al servicio" description: "Introducción al servicio" type: "faq" category: "question" tags: [] authors: [Anonymous] date: "2026-10-26" last_update: "2026-10-26" time_minutes: 1 draft: false unlisted: false url: "https://www.stage.apigateway.cl/faq/introduccion" --- # Introducción al servicio --- ## ¿Qué es API Gateway? API Gateway es una pasarela que expone como API REST en JSON información y trámites que el SII y otros organismos solo ofrecen en sus sitios web. # ¿Qué es API Gateway? Es una **pasarela** que te permite consultar y operar con el SII, Previred y otros organismos desde tu propio sistema, mediante una API REST con solicitudes y respuestas en JSON. Lo importante es la palabra *pasarela*: API Gateway **no tiene información tributaria propia**. En cada consulta inicia sesión en el organismo con las credenciales que tú envías, obtiene el dato en ese momento y te lo devuelve. De eso se desprenden tres cosas: - Necesitas **credenciales válidas** del contribuyente por el que consultas. - Si el organismo está lento o caído, la consulta falla. - **No existe un ambiente de pruebas** aislado: cada consulta va al SII real. Los conceptos del servicio están en [Conceptos del servicio](https://www.apigateway.cl/docs/manual/introduccion), los productos y costos en el [cotizador](https://www.apigateway.cl/pricing), y el detalle de cada recurso en la [documentación de la API](https://www.apigateway.cl/docs/api). --- ## ¿API Gateway tiene un ambiente de pruebas o sandbox? API Gateway no tiene un sandbox propio, pero algunos recursos permiten operar en el ambiente de certificación del SII. # ¿API Gateway tiene un ambiente de pruebas o sandbox? **API Gateway no tiene un sandbox propio.** Por defecto, cada consulta va al ambiente de **producción** del SII con credenciales reales y produce efectos reales: si emites un documento en tus pruebas, queda emitido ante el SII. Algunos recursos sí se pueden usar en el **ambiente de certificación del SII**, que es el ambiente de pruebas del propio SII. Para eso se agrega el parámetro `certificacion=1` a la consulta. No todos los recursos lo permiten: la documentación de cada recurso indica si lo tiene disponible. --- ## ¿API Gateway guarda mis credenciales o mi certificado digital? No: las credenciales del SII y el certificado se envían en cada consulta y no quedan almacenados. # ¿API Gateway guarda mis credenciales o mi certificado digital? **No.** La plataforma no persiste las credenciales del SII ni el certificado digital. Se envían **en el cuerpo de cada consulta**, en el objeto `auth`, y se usan solo para resolver esa operación. Debes almacenarlas en tu propio sistema. ```json { "auth": { "pass": { "rut": "11111111-1", "clave": "tu_clave_tributaria" } } } ``` Hay un matiz: para no iniciar sesión en cada llamada, la plataforma puede **reutilizar la sesión** ya abierta un tiempo. Lo que se conserva es la sesión, no la clave. Revisa [¿Por qué mis consultas reutilizan la sesión del SII?](https://www.apigateway.cl/faq/autenticacion-api/por-que-se-reutiliza-la-sesion-del-sii). > [!INFO] La sección "Certificado" no almacena tu certificado > > Es solo una herramienta que lo convierte al formato PEM que la API necesita. Revisa [Certificado digital en formato PEM](https://www.apigateway.cl/docs/manual/token-y-certificado#certificado-digital-en-formato-pem). El tratamiento de datos y las políticas de seguridad están en los [términos y condiciones](https://www.apigateway.cl/legal). --- ## ¿Puedo operar varias empresas (multi-RUT) con una sola cuenta? Sí, API Gateway es multi-RUT, con dos consideraciones sobre el costo y sobre la sesión. # ¿Puedo operar varias empresas (multi-RUT) con una sola cuenta? **Sí.** Con una misma conexión y un mismo token puedes consultar por distintos contribuyentes, siempre que tengas credenciales válidas y con permisos para cada uno. Dos cosas a considerar: **1. Cada credencial distinta tiene costo.** El servicio incluye un usuario de autenticación gratuito; cada credencial adicional descuenta créditos una vez por período. Si vas a consultar por muchos contribuyentes conviene contratar un pack de usuarios. Revisa [Productos y límites](https://www.apigateway.cl/docs/manual/productos-y-limites). **2. Los créditos son por conexión.** Si trabajas con varias conexiones, cada una tiene su propio saldo. Revisa [¿Puedo tener más de una conexión?](https://www.apigateway.cl/faq/conexiones/puedo-tener-mas-de-una-conexion). > [!WARNING] Cuidado al consultar varias empresas en secuencia > > Algunos recursos, en particular los del Portal MiPYME, están diseñados para operar sobre **un solo contribuyente** por sesión. Revisa [¿Por qué recibo documentos de otra empresa?](https://www.apigateway.cl/faq/mipyme/recibo-documentos-de-otra-empresa). --- ## ¿Qué necesito para empezar a usar el servicio? Los cinco pasos necesarios para dejar una conexión operativa y hacer la primera consulta. # ¿Qué necesito para empezar a usar el servicio? En orden. Si te salta alguno, la API responderá con un error: 1. **Crear tu cuenta** en [app.apigateway.cl/signup](https://app.apigateway.cl/signup) y verificar tu correo. 2. **Registrar una conexión** en [Registrar conexión](https://app.apigateway.cl/connections/register). 3. **Activar los productos** que vas a usar, en [Gestionar conexión → Productos](https://app.apigateway.cl/connections/manage#products), y presionar **"Actualizar productos y límites"**. 4. **Generar el token** en [Gestionar conexión → Token API](https://app.apigateway.cl/connections/manage#token), que va en la cabecera `Authorization: Token <tu_token>`. 5. **Configurar tu proxy** en la conexión: es un requisito obligatorio. Revisa el [tutorial de proxy](https://www.apigateway.cl/docs/tutoriales/proxy). Además necesitarás **créditos**: al crear tu primera conexión recibes créditos de bienvenida y después los compras en [Gestionar conexión → Créditos](https://app.apigateway.cl/connections/manage#credits). > [!TIP] Antes de escribir código > > Recorre la [academia de primeros pasos](https://www.apigateway.cl/academy/primeros-pasos) y revisa el [manual de la plataforma](https://www.apigateway.cl/docs/manual). --- Última actualización el 26/10/2026