--- title: "Introducción al servicio" description: "Introducción al servicio" type: "faq" category: "question" tags: [] authors: [Anonymous] date: "2026-09-11" last_update: "2026-09-11" time_minutes: 1 draft: false unlisted: false url: "https://www.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). --- ## ¿Qué puedo hacer con API Gateway y qué no? Resumen de lo que la versión actual permite hacer y de lo que no está disponible, incluida la emisión de documentos tributarios. # ¿Qué puedo hacer con API Gateway y qué no? La versión actual (V2) está orientada a **extraer datos** del SII y de Previred, y a operar algunos portales del propio SII: situación tributaria de terceros, Registro de Compras y Ventas, Formulario 29, Boletas de Honorarios y de Terceros, boletas del Portal eBoleta, extracción de documentos del Portal MiPYME, folios (CAF), estado de envío de un DTE, cesiones, bienes raíces, vehículos e indicadores previsionales. El listado completo está en la [documentación de la API](https://www.apigateway.cl/docs/api) y en el [cotizador](https://www.apigateway.cl/pricing). **No está disponible en la versión actual:** - Emitir DTE (facturas, guías, notas de crédito y débito). Revisa [¿Puedo emitir facturas y otros DTE?](https://www.apigateway.cl/faq/dte/puedo-emitir-facturas-y-otros-dte). - Aceptar o rechazar documentos recibidos (acuse de recibo y reclamos). - Ceder facturas. - Emitir documentos **reales** desde los recursos del Portal MiPYME: solo generan borradores. - Carpeta tributaria, e-RUT, Formulario 22 y declaraciones juradas: esos recursos no existen. - Enviar varios RUT en una misma solicitud: cada consulta es individual. --- ## ¿API Gateway tiene un ambiente de pruebas o sandbox? No hay sandbox propio, porque cada consulta va directamente al SII con credenciales reales. # ¿API Gateway tiene un ambiente de pruebas o sandbox? **No.** Al ser una conexión directa al SII, cada consulta llega con credenciales reales y produce efectos reales. Si emites un documento en tus pruebas, queda emitido ante el SII. Cómo probar entonces: - Usa los **créditos de bienvenida** que recibes al crear tu primera conexión. - Empieza por **recursos de solo lectura**, que no generan documentos. - En el Portal MiPYME, la única forma de probar la generación es crear un borrador y luego **eliminarlo** con el recurso de eliminación. - Para la emisión de DTE en el **ambiente de certificación del SII**, revisa la academia de [integración para la emisión de DTE](https://www.apigateway.cl/academy/integracion-para-la-emision-de-dte). Ese flujo aplica a los recursos de emisión de [API Gateway Legacy](https://www.apigateway.cl/faq/legacy-v1/que-es-api-gateway-legacy). > [!WARNING] Lee la documentación antes de probar > > Una consulta con la estructura mal armada consume créditos igual y devuelve un error. Revisar la [documentación del recurso](https://www.apigateway.cl/docs/api) antes de la primera llamada es la forma más eficiente de aprovechar los créditos de prueba. --- ## ¿Cuál es la diferencia entre API Gateway V2 y API Gateway Legacy? Son dos servicios independientes, con plataformas, precios, recursos y formas de cobro distintas. # ¿Cuál es la diferencia entre API Gateway V2 y API Gateway Legacy? Son **dos servicios independientes**: no comparten cuentas, credenciales, saldo ni recursos. | | API Gateway V2 (actual) | API Gateway Legacy (V1) | |---|---|---| | Ingreso | [app.apigateway.cl](https://app.apigateway.cl/signin) | [legacy.apigateway.cl](https://legacy.apigateway.cl/login) | | URL base | `https://app.apigateway.cl/api/v2/` | `https://legacy.apigateway.cl/api/v1/` | | Cobro | Créditos: base mensual más consumo por consulta | Plan mensual con cuota de consultas cada 24 horas | | Unidad de trabajo | Conexiones, cada una con su token y sus créditos | Un usuario con un plan | | Emisión de DTE, acuse y cesión | No disponible | Disponible | | Recursos nuevos y ajustes ante cambios del SII | Sí | No | Si tu cuenta es **anterior al lanzamiento de la plataforma actual**, existe solo en Legacy. Revisa [Al iniciar sesión me dice que mi usuario no existe](https://www.apigateway.cl/faq/cuenta-y-acceso/mi-usuario-no-existe-al-iniciar-sesion). **No es obligatorio migrar:** un plan vigente en Legacy sigue funcionando con el precio contratado. Revisa [¿Mi plan de Legacy sirve para usar la versión actual?](https://www.apigateway.cl/faq/legacy-v1/mi-plan-de-legacy-sirve-en-v2). --- ## ¿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 [¿Cómo obtengo mi certificado digital en formato PEM?](https://www.apigateway.cl/faq/autenticacion-api/como-obtengo-mi-certificado-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](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 11/09/2026