Este artículo explica cómo se factura el uso de la API en Easyship, qué está incluido en tu plan y cómo monitorear tu uso en tu panel de control.
Resumen
Todos los planes de suscripción de Easyship incluyen una asignación mensual de llamadas API por endpoint. Solo pagas extra si excedes tu límite incluido y, aun así, tu acceso nunca se bloquea.
Los siguientes endpoints están disponibles en todos los planes:
- Validación Internacional de Direcciones
- Validación Nacional de Direcciones
- Seguimiento de Terceros
- Cálculo de Impuestos y Derechos
- Cálculo de Código HS
- Tarifas
Límites Incluidos
Cada plan viene con un número establecido de llamadas API por endpoint por mes. Tu asignación se restablece en la fecha de renovación de tu suscripción cada mes.
Qué cuenta para tu límite: Solo se cuentan las llamadas API exitosas. Las solicitudes fallidas no se cuentan ni se cobran.
Clientes Enterprise: El uso de la API se rastrea pero no se cobra.
Cargos por Exceso
Si excedes tu límite incluido para cualquier endpoint, se te cobrará una tarifa por llamada adicional para el uso extra. Tu acceso nunca se bloquea: tu integración sigue funcionando y los cargos por exceso se añadirán a tu próxima factura mensual. Ten en cuenta que debe haber una tarjeta de pago válida registrada para que esto aplique.
Los límites estándar de tasa aún se aplican en todos los planes para garantizar la estabilidad del sistema.
Ciclo de Facturación
Los cargos por uso de la API se facturan mensualmente y se alinean con la fecha de renovación de tu suscripción.
- Planes mensuales: facturados en tu fecha de renovación cada mes
- Planes anuales: el uso de la API se factura mensualmente, no anualmente
Ejemplo: Si te registraste el 2 de junio en un plan anual, el uso de la API se facturará el día 2 de cada mes.
Suscriptores anuales: tu factura mensual por uso de la API es independiente de la cuota anual de suscripción.
Ámbitos de la API
Los ámbitos definen a qué endpoints y funcionalidades tiene acceso una conexión API. Algunos ámbitos son controlados por el usuario, mientras que otros son gestionados por Easyship.
Al configurar una integración API, elegirás entre dos versiones de API:
- 2023-01 o anterior (legacy): Los ámbitos se listan sin acciones específicas — habilitar un ámbito otorga acceso de lectura y escritura a todos los endpoints relevantes dentro de ese ámbito.
- 2024-09 o posterior (recomendado): Los ámbitos usan el formato <scope>.<resource>:<action> (por ejemplo, public.address:read). Esto te da un control más granular.
Cómo crear una integración API
- Inicia sesión en tu cuenta de Easyship en app.easyship.com
- Haz clic en Nueva Integración bajo Conectar en la barra lateral
- Haz clic en Integración API al final de la página
- Completa los detalles y selecciona tu versión de API preferida
- Haz clic en Conectar
Cómo ver o editar ámbitos
- Inicia sesión en tu cuenta de Easyship en app.easyship.com
- Selecciona tu conexión API bajo la pestaña Conectar en la barra lateral
- Bajo Token de Acceso API, puedes ver a qué ámbitos tiene acceso el token
- Para hacer cambios, haz clic en Editar, selecciona o deselecciona ámbitos según sea necesario y luego haz clic en Guardar
Si necesitas acceso a ámbitos adicionales para funcionalidades avanzadas o funciones beta, contacta a tu gestor de cuenta o comunícate vía Soporte Easyship.
Visualización de tu Uso
- Inicia sesión en tu cuenta de Easyship
- Ve a Suscripción en la configuración de tu cuenta
- Selecciona la pestaña Uso de API
Aquí verás:
- Todos los endpoints disponibles en tu plan
- Llamadas usadas vs. tu límite incluido por endpoint
- Cargos por exceso acumulados para el período actual
- Llamadas API usadas desglosadas por conexión API individual
- Qué plataformas están conectadas y qué APIs están activas
Los datos de uso se actualizan aproximadamente cada 15 minutos.
Entendiendo tu Factura
Los cargos por uso de la API aparecen como partidas en tu factura mensual, con un desglose detallado que muestra:
- Llamadas API por endpoint
- Uso incluido vs. exceso
- Cargos totales por endpoint
Para ver tus facturas, ve a Suscripción > Facturación en la configuración de tu cuenta.
Preguntas Frecuentes
¿Se bloqueará mi acceso si alcanzo mi límite?
No. Tu integración continúa funcionando sin interrupciones. Los cargos por exceso de cualquier llamada más allá de tu límite incluido aparecerán en tu próxima factura mensual.
¿Recibiré notificaciones cuando me acerque a mi límite?
Sí. Recibirás alertas al 90% y 100% de tu uso incluido para cada endpoint.
Estoy en un plan anual — ¿por qué recibo cargos mensuales?
Los cargos por uso de la API se facturan mensualmente, independientemente del tipo de suscripción. Estos son independientes de la cuota anual de suscripción y aparecerán como partidas distintas cada mes.
¿Qué sucede si cambio a un plan inferior?
Los límites incluidos de API se ajustarán inmediatamente al nivel de tu nuevo plan. Si estabas usando ámbitos disponibles solo en un nivel superior, perderás acceso a esos ámbitos. Un nuevo período de facturación comienza con tu nuevo plan.
¿Los clientes Enterprise pagan por el uso de la API?
No. El uso de la API de Enterprise se rastrea para visibilidad pero no se cobra.
Necesito más llamadas API de las que incluye mi plan. ¿Cuáles son mis opciones?
Si tu uso excede consistentemente los límites incluidos en tu plan, considera actualizar tu suscripción. Si los planes estándar no satisfacen tus necesidades de volumen, contacta a nuestro equipo — podemos crear un plan personalizado adaptado a tus requerimientos.
¿Qué sucede si no tengo un método de pago registrado?
Se requiere un método de pago válido para el acceso a endpoints pagados. Si no hay ninguno registrado, verás el error: "Se requiere método de pago para acceso a endpoint pagado." Agrega un método de pago en la configuración de facturación para restaurar el acceso.
¿Qué pasa si falla el pago de mi suscripción?
Si tu pago falla, el acceso a endpoints pagados puede ser restringido. Actualiza tu método de pago en la configuración de facturación y vuelve a intentar el pago, o contacta a nuestro equipo de soporte para ayuda.