--- title: "API Gateway Legacy (V1)" description: "API Gateway Legacy (V1)" 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/legacy-v1" --- # API Gateway Legacy (V1) --- ## ¿Qué es API Gateway Legacy y en qué se diferencia del servicio actual? Es la versión anterior del servicio, con planes mensuales por cuota de consultas y recursos que la versión actual no tiene. # ¿Qué es API Gateway Legacy y en qué se diferencia del servicio actual? **API Gateway Legacy** (o V1) es la versión anterior del servicio. Sigue operativa y es un **servicio independiente** del actual: no comparten cuentas, credenciales, saldo ni recursos. | | Legacy (V1) | Actual (V2) | |---|---|---| | Ingreso | [legacy.apigateway.cl](https://legacy.apigateway.cl/login) | [app.apigateway.cl](https://app.apigateway.cl/signin) | | URL base | `https://legacy.apigateway.cl/api/v1/` | `https://app.apigateway.cl/api/v2/` | | Cobro | Plan mensual con cuota de consultas cada 24 horas | Créditos: base mensual más consumo | | Documentación | [/docs/api-v1](https://www.apigateway.cl/docs/api-v1) | [/docs/api](https://www.apigateway.cl/docs/api) | ## Recursos que solo existen en Legacy - **Emisión de DTE**: facturas, guías, notas de crédito y débito, boletas. - **Acuse de recibo y reclamos comerciales**, y el Recibo de Mercaderías. - **Cesión de DTE**, con la limitación de que no permite volver a ceder un documento ya cedido. ## Lo que debes considerar - **No recibirá recursos nuevos** y, ante un cambio en los sistemas del SII, no tendrá soporte inmediato. - Los recursos de Legacy **no relacionados con la emisión de DTE están obsoletos**: para consultar datos conviene la versión actual. - El servicio terminará en algún momento. Revisa [¿Legacy va a dejar de existir?](https://www.apigateway.cl/faq/legacy-v1/legacy-va-a-dejar-de-existir). Es también multi-RUT: con una cuenta puedes operar por distintas empresas. --- ## ¿Cómo me registro en API Gateway Legacy? El registro se hace en su propia plataforma e incluye un período de prueba de 10 días. # ¿Cómo me registro en API Gateway Legacy? El registro se hace en [legacy.apigateway.cl/register](https://legacy.apigateway.cl/register). También puedes llegar desde [www.apigateway.cl/legacy](https://www.apigateway.cl/legacy). Al registrarte se activa de inmediato un **período de prueba de 10 días**, con acceso a todos los recursos del servicio y una cuota de consultas cada 24 horas. **El período de prueba no se puede extender.** Después, los planes están en [legacy.apigateway.cl/dashboard#plan](https://legacy.apigateway.cl/dashboard#plan). > [!TIP] Revisa la documentación antes de activar la prueba > > Como dura 10 días y no se extiende, conviene llegar con la integración diseñada. Revisa la [documentación de la API V1](https://www.apigateway.cl/docs/api-v1) y la [academia de capacitación inicial](https://www.apigateway.cl/academy/capacitacion-inicial). Si vas a emitir DTE, revisa además la [academia de integración para la emisión de DTE](https://www.apigateway.cl/academy/integracion-para-la-emision-de-dte). Recuerda que **el proxy es obligatorio también en Legacy**, y se configura en el perfil del usuario. Revisa el [tutorial de proxy](https://www.apigateway.cl/docs/tutoriales/proxy). --- ## ¿Cuáles son los planes de API Gateway Legacy? Los planes se definen por cantidad de consultas cada 24 horas, con un tope de documentos emitidos en el mismo período. # ¿Cuáles son los planes de API Gateway Legacy? Los planes de Legacy se definen por la cantidad de **consultas cada 24 horas**, y cada uno incluye un tope de **documentos emitidos** en ese mismo período. Van desde planes pensados para una PYME hasta planes de alto volumen. La **emisión de DTE está incluida en todos los planes**. > [!INFO] Dónde ver los planes y sus precios > > El listado vigente, con su cuota de consultas y su precio, está en [legacy.apigateway.cl/dashboard#plan](https://legacy.apigateway.cl/dashboard#plan), donde también se contratan. El servicio es prepago y no queda ligado a un contrato: solo debes estar de acuerdo con los [términos y condiciones](https://www.apigateway.cl/legal). > [!INFO] La cuota no se reinicia a medianoche > > Es una ventana móvil de 24 horas, no un día calendario. Revisa [¿Cómo funciona la cuota de consultas?](https://www.apigateway.cl/faq/legacy-v1/como-funciona-la-cuota-de-consultas). > [!TIP] Compara con el modelo de créditos > > Según tu patrón de uso, el modelo de la versión actual puede resultar más económico, sobre todo si tu volumen es bajo pero constante. Estímalo en el [cotizador](https://www.apigateway.cl/pricing). --- ## ¿Cómo funciona la cuota de consultas cada 24 horas en Legacy? Es una ventana móvil de 24 horas desde la primera consulta, no un día calendario. # ¿Cómo funciona la cuota de consultas cada 24 horas en Legacy? La cuota de tu plan es una **ventana móvil de 24 horas**, no un día calendario. Si tu primera consulta fue un lunes a las 11:00, tu cuota se renueva el **martes a las 11:00**, no a medianoche. Esto explica una confusión frecuente: los gráficos de consumo por día no calzan con el momento del bloqueo, porque la ventana de 24 horas puede abarcar consultas de la tarde anterior. Para controlarlo, las cabeceras `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` te dicen dónde estás dentro de tu ventana. El detalle está en [manejo de errores](https://www.apigateway.cl/academy/primeros-pasos/punto-de-partida/manejo-de-errores). > [!WARNING] Si te bloquean, revisa el patrón de tus consultas > > Además del tope del plan, acumular respuestas `429` activa un bloqueo automático, y enviar consultas en ráfagas es lo que más lo provoca. Revisa [Bloqueos y límites de uso](https://www.apigateway.cl/docs/solucion-de-problemas/bloqueos-y-limites-de-uso). --- ## ¿Puedo pagar varios meses o un año por adelantado en Legacy? Legacy permite prepagar varios meses con la opción "Prepagar plan actual", generando la cotización antes del siguiente cobro. # ¿Puedo pagar varios meses o un año por adelantado en Legacy? Sí, con la opción **"Prepagar plan actual"** en [legacy.apigateway.cl/dashboard#plan](https://legacy.apigateway.cl/dashboard#plan). El procedimiento: 1. **Actualiza los datos de facturación y las referencias** (por ejemplo una orden de compra) en [legacy.apigateway.cl/dashboard#billing](https://legacy.apigateway.cl/dashboard#billing). 2. Entra a la sección de plan y elige **"Prepagar plan actual"**. 3. Selecciona la **cantidad de meses** a pagar. 4. **Genera la cotización.** Ahí obtienes el monto exacto. 5. Paga por ese monto exacto y notifica el pago. > [!WARNING] Hazlo con anticipación a tu fecha de cobro > > El sistema genera automáticamente la cotización **mensual** cuando se acerca tu fecha de facturación, y una vez generada **no se puede eliminar ni modificar**. Si eso ocurre, quedas obligado a pagar ese cobro mensual primero y el prepago queda para el ciclo siguiente. > [!WARNING] Nunca transfieras sin una cotización generada > > Un pago que no corresponde a una cotización vigente **no se puede procesar**, y los pagos no se devuelven. Genera siempre la cotización primero y transfiere el monto que ella indica. Sobre cómo notificar el pago, incluida la modalidad de pagos masivos o de proveedores, revisa [¿Cómo notifico una transferencia?](https://www.apigateway.cl/faq/pagos-y-facturacion/como-notifico-una-transferencia). > [!INFO] Soporte no genera cotizaciones > > Todo el proceso de cotización, pago y activación se realiza en la plataforma. --- ## ¿Mi plan de Legacy sirve para usar la versión actual? No: los servicios son independientes y un plan de Legacy no se convierte en créditos. # ¿Mi plan de Legacy sirve para usar la versión actual? **No.** Son servicios independientes, con precios, recursos y modelos de cobro distintos. Un plan de Legacy no habilita la versión actual, y pagar un cobro de Legacy **no carga créditos** en V2. Vale en ambos sentidos: los créditos de una conexión de V2 tampoco sirven en Legacy. **Si tienes un plan de Legacy vigente:** sigue funcionando con el precio que contrataste, no estás obligado a migrar, y si decides no seguir simplemente **ignora el cobro** cuando llegue: el plan se desactivará automáticamente. **Si quieres usar la versión actual:** debes crear una cuenta nueva en [app.apigateway.cl/signup](https://app.apigateway.cl/signup), registrar una conexión y comprar créditos. Revisa [¿Qué necesito para empezar?](https://www.apigateway.cl/faq/introduccion/que-necesito-para-empezar). > [!TIP] Puede convenirte > > Según tu volumen, el modelo de créditos puede resultar más barato que tu plan actual. Estímalo en el [cotizador](https://www.apigateway.cl/pricing) o [agenda una reunión comercial](https://www.apigateway.cl/meet). --- ## ¿API Gateway Legacy va a dejar de existir? Terminará en algún momento y se avisará con anticipación; mientras tanto no recibe recursos nuevos. # ¿API Gateway Legacy va a dejar de existir? El servicio **terminará en algún momento**, y **se avisará a los usuarios con anticipación**. No hay una fecha pública definida. Lo que sí está definido hoy: - **No recibirá recursos nuevos.** - Ante cambios en los sistemas del SII, **no tendrá soporte inmediato**: las correcciones se incorporan en la versión actual. - Los recursos que **no** tienen relación con la emisión de DTE están obsoletos. - Comercialmente ya no se ofrece a usuarios nuevos, aunque el registro sigue disponible. ## Qué hacer con esto Si estás **partiendo una integración nueva**, hazla en la versión actual, salvo que necesites emisión de DTE, acuse de recibo o cesión, que solo existen en Legacy. Si **ya operas en Legacy**, tu servicio sigue funcionando. Vale la pena evaluar el modelo de créditos con el [cotizador](https://www.apigateway.cl/pricing). Si tu integración usa **solo algunos recursos de Legacy**, una alternativa es una migración parcial: mover las consultas de datos a la versión actual y mantener en Legacy únicamente lo que no existe en V2. Las novedades y avisos del servicio se publican en el [blog](https://www.apigateway.cl/blog). --- Última actualización el 11/09/2026