Este artículo explica cómo se factura el uso de la API en Easyship, qué incluye tu plan y cómo supervisar tu uso en tu panel.
Descripción general
Todos los planes de suscripción de Easyship incluyen una cantidad mensual de llamadas a la API por endpoint. Solo pagarás un cargo adicional si superas el límite incluido y, aun así, tu acceso nunca se bloqueará.
Los siguientes endpoints están disponibles en todos los planes:
- Seguimiento de terceros
- Cálculos de impuestos y aranceles
- Cálculo del código HS
- Tarifas
- Validación de direcciones (fuera de EE. UU.)
- Validación de direcciones (EE. UU.)
Límites incluidos
Cada plan incluye una cantidad determinada de llamadas a la API por endpoint al mes. Tu asignación se restablece cada mes en la fecha de renovación de tu suscripción.
Qué se contabiliza para tu límite: Solo se contabilizan las llamadas a la API exitosas. Las solicitudes fallidas no se contabilizan ni se cobran.
Clientes Enterprise: El uso de la API se registra, pero no se cobra.
Cargos por exceso
Si superas el límite incluido para cualquier endpoint, se te cobrará una tarifa por llamada por el uso adicional. Tu acceso nunca se bloqueará: tu integración seguirá funcionando y los cargos por exceso se añadirán a tu próxima factura mensual. Ten en cuenta que debes tener registrada una tarjeta de pago válida para que esto se aplique.
Los límites de velocidad estándar siguen aplicándose 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 coinciden con la fecha de renovación de tu suscripción.
- Planes mensuales: se facturan en tu fecha de renovación cada mes
- Planes anuales: el uso de la API se sigue facturando mensualmente, no anualmente
Ejemplo: Si te registraste el 2 de junio con un plan anual, el uso de tu API se facturará el día 2 de cada mes.
Suscriptores anuales: la factura mensual por el uso de la API es independiente de la cuota de tu suscripción anual.
Ámbitos de la API
Los ámbitos definen a qué endpoints y funciones tiene acceso una conexión de API. Algunos ámbitos los controla el usuario, mientras que otros los gestiona Easyship.
Al configurar una integración de API, elegirás entre dos versiones de la API:
- 2023-01 o anteriores (heredada): Los ámbitos aparecen sin acciones específicas; al habilitar un ámbito, se concede acceso de lectura y escritura a todos los endpoints relevantes dentro de ese ámbito.
- 2024-09 o posteriores (recomendada): Los ámbitos utilizan el formato <scope>.<resource>:<action> (por ejemplo, public.address:read). Esto te proporciona un control más granular.
Cómo crear una integración de API
- Inicia sesión en tu cuenta de Easyship en app.easyship.com
- Haz clic en New Integration en Connect, en la barra lateral
- Haz clic en API Integration en la parte inferior de la página
- Completa los datos y selecciona tu versión de API preferida
- Haz clic en Connect
Cómo ver o editar los ámbitos
- Inicia sesión en tu cuenta de Easyship en app.easyship.com
- Selecciona tu conexión de API en la pestaña Connect de la barra lateral
- En API Access Token, puedes ver a qué ámbitos tiene acceso el token
- Para realizar cambios, haz clic en Edit, selecciona o deselecciona los ámbitos según sea necesario y, a continuación, haz clic en Save
Si necesitas acceso a ámbitos adicionales para funciones avanzadas o funciones beta, ponte en contacto con tu administrador de cuenta o comunícate con Easyship Support.
Cómo consultar tu uso
- Inicia sesión en tu cuenta de Easyship
- Ve a Subscription en la configuración de tu cuenta
- Selecciona la pestaña API Usage
Aquí verás:
- Todos los endpoints disponibles en tu plan
- Las llamadas utilizadas frente al límite incluido por endpoint
- Los cargos por exceso acumulados durante el período actual
- Las llamadas a la API utilizadas, desglosadas por conexión de API individual
- Qué plataformas están conectadas y qué API están activas
Los datos de uso se actualizan aproximadamente cada 15 minutos.
Cómo entender tu factura
Los cargos por uso de la API aparecen como conceptos en tu factura mensual, con un desglose detallado que muestra:
- Llamadas a la API por endpoint
- Uso incluido frente al uso excedente
- Cargos totales por endpoint
Para consultar tus facturas, ve a Subscription > Billing en la configuración de tu cuenta.
Preguntas frecuentes
¿Se bloqueará mi acceso si alcanzo mi límite?
No. Tu integración seguirá funcionando sin interrupciones. Los cargos por exceso de las llamadas que superen tu límite incluido aparecerán en tu próxima factura mensual.
¿Se me notificará cuando me acerque a mi límite?
Sí. Recibirás alertas cuando alcances el 90 % y el 100 % de tu uso incluido para cada endpoint.
Tengo un plan anual, ¿por qué recibo cargos mensuales?
Los cargos por uso de la API se facturan mensualmente independientemente del tipo de suscripción. Son independientes de la cuota de tu suscripción anual y aparecerán como conceptos separados cada mes.
¿Qué sucede si cambio a un plan inferior?
Tus límites de API incluidos se ajustarán inmediatamente al nivel de tu nuevo plan. Si utilizabas ámbitos disponibles únicamente en un nivel superior, perderás el acceso a esos ámbitos. Con tu nuevo plan comenzará un nuevo período de facturación.
¿Los clientes Enterprise pagan por el uso de la API?
No. El uso de la API de Enterprise se registra para ofrecer visibilidad, pero no se cobra.
Necesito más llamadas a la API de las que incluye mi plan. ¿Qué opciones tengo?
Si tu uso supera constantemente los límites incluidos en tu plan, considera actualizar tu suscripción. Si los planes estándar no cubren tus necesidades de volumen, ponte en contacto con nuestro equipo; podemos crear un plan personalizado adaptado a tus requisitos.
¿Qué sucede si no tengo un método de pago registrado?
Se requiere un método de pago válido para acceder a los endpoints de pago. Si no hay ninguno registrado, verás el error: "Payment method required for paid endpoint access." Añade un método de pago en la configuración de facturación para restablecer el acceso.
¿Qué sucede si falla el pago de mi suscripción?
Si tu pago falla, es posible que se restrinja el acceso a los endpoints de pago. Actualiza tu método de pago en la configuración de facturación y vuelve a intentar realizar el pago, o ponte en contacto con nuestro equipo de asistencia para obtener ayuda.