Planes y cuotas

Los planes de SendIt, las guías incluidas por mes y cómo funcionan los excedentes.

Cada plan incluye una cuota mensual de guías y rastreadores. No hay topes duros. Al exceder tu cuota pagas una tarifa de excedente por guía, cobrada al momento de la compra.

Los planes

En todos los planes: API completo, modo de prueba, webhooks y todas las paqueterías. Las peticiones por minuto se cuentan por clase de endpoint. El detalle está en Límites de peticiones.

La columna de cuenta propia aplica cuando compras con tus propias credenciales de paquetería. En ese caso pagas esa tarifa y nada más: la guía no consume excedente normal, aunque sí cuenta para tu cuota mensual. Ver Cuentas de paquetería.

Cómo funciona el excedente

No hay tope mensual. Una organización Free puede comprar 600 guías en un mes: las primeras 500 al precio normal, y las 100 restantes con $0.90 MXN extra cada una. El excedente:

• Se cobra al momento de cada compra, junto con la guía. Nunca llega como factura sorpresa a fin de mes.
• Aparece explícito en la respuesta de compra (overageCharge) y en la guía (overageAmount); es "0.00" dentro de cuota o en planes ilimitados.
• Cuenta solo la operación real: las compras en modo de prueba jamás consumen cuota ni cobran excedente.

Lo mismo aplica a los rastreadores externos. Solo los registros externos consumen cuota: los rastreadores que se crean solos con una guía de SendIt son gratuitos y no cuentan.

Topes duros: llaves, webhooks y miembros

Las guías y los rastreadores no tienen tope: pagas excedente. Las llaves de API y los endpoints de webhook sí tienen un tope duro por plan. Crear uno más allá del límite devuelve 403 PLAN_LIMIT_REACHED, con resource, limit y plan en details. Sube de plan para elevar el tope.

El conteo de llaves excluye las que están en su ventana de rotación de 24 h; el de webhooks excluye los endpoints eliminados.

Miembros en el plan Free

El plan Free permite 3 miembros, contando los miembros actuales más las invitaciones pendientes. Invitar por encima del tope devuelve el mismo 403 PLAN_LIMIT_REACHED. Aceptar una invitación hacia una organización que ya llegó a 3 miembros también: en ese caso la invitación sigue pendiente y funciona en cuanto subas de plan.

Los planes de pago no limitan miembros. Las organizaciones que ya tenían más de 3 miembros antes de este tope los conservan, pero no pueden invitar a nadie más sin subir de plan.

Consulta tu uso del mes

GET /v1/organizations/me/usage devuelve el consumo del mes calendario actual contra las cuotas de tu plan:

{
  "success": true,
  "data": {
    "month": "2026-07",
    "plan": "FREE",
    "labelsCreated": 562,
    "labelsQuota": 500,
    "overageLabels": 62,
    "overagePerLabel": "0.90",
    "trackersCreated": 30,
    "trackersQuota": 100,
    "overageTrackers": 0,
    "overagePerTracker": "0.80",
    "totalSpent": "18234.50",
    "currency": "MXN"
  }
}

Ideal para mostrar barras de consumo en tu propio panel o para alertarte antes de entrar en excedente.

Alertas de uso

Tu uso en vivo dispara un aviso al cruzar por primera vez el 80% y el 100% de una cuota, sea de guías o de rastreadores. Avisamos al dueño de la organización por correo. Cada umbral avisa a lo más una vez por mes calendario y se rearma al mes siguiente. Los planes ilimitados no generan alertas, y el modo de prueba nunca cuenta.

Consulta tu suscripción

GET /v1/billing/subscription devuelve el plan activo, su ciclo y los límites completos:

{
  "success": true,
  "data": {
    "plan": "GROWTH",
    "status": "ACTIVE",
    "currentPeriodStart": "2026-07-01T00:00:00.000Z",
    "currentPeriodEnd": "2026-08-01T00:00:00.000Z",
    "cancelledAt": null,
    "trialEndsAt": null,
    "isStripeManaged": true,
    "limits": {
      "labelsPerMonth": 3000,
      "overagePerLabel": "0.70",
      "trackersPerMonth": 2000,
      "overagePerTracker": "0.50",
      "rateLimits": { "read": 300, "write": 150, "quote": 60 },
      "maxApiKeys": 10,
      "maxWebhookEndpoints": 10,
      "maxMembers": null
    }
  }
}

• status: TRIALING, ACTIVE, PAST_DUE, CANCELLED o UNPAID.
• limits.rateLimits trae el presupuesto por minuto de cada clase de endpoint.
• maxMembers es null en los planes de pago (sin tope) y 3 en Free.
• Las organizaciones en plan Free, sin suscripción de pago, reportan isStripeManaged: false y periodos null. El endpoint nunca devuelve 404.

Organizaciones personales

Tu organización personal inicia en Free y puede subir de plan como cualquier otra. Las cuotas y los excedentes aplican igual. El sandbox es un modo, no la organización: nada de lo que hagas en modo de prueba consume cuota.

Cambia de plan

Puedes subir o administrar tu plan tú mismo (rol ADMIN o superior):

• POST /v1/billing/checkout-session con { "plan": "GROWTH" } devuelve una URL de Stripe Checkout: redirige ahí al usuario para completar el pago. Al terminar, tu plan se actualiza automáticamente. Acepta GROWTH o SCALE.
• POST /v1/billing/portal-session devuelve una URL del portal de facturación de Stripe para cambiar el método de pago, ver recibos o cancelar. Requiere que tu organización ya haya subido de plan al menos una vez.

Ambos endpoints usan tu sesión del dashboard (JWT), no llaves de API. ENTERPRISE se contrata con ventas: pedirlo por checkout devuelve 503 CHECKOUT_NOT_CONFIGURED. Al subir de plan, la cuota nueva aplica de inmediato; al bajar, al cierre del periodo en curso.