Entitlements

Donde la red se vuelve contrato.

Un plan comercial — con cuotas, precio y medición — convertido en una regla que se cumple antes de cada llamada. No publicamos APIs: gobernamos quién las consume, cuánto y a qué precio.

Algunos módulos de facturación están en construcción
Consola Entitlements Ejemplo
allow · cuota disponiblenumber-verification · price_ref 0,008

Contrato activo

Ejemplo
planantifraude-m
scopenumber-verification, sim-swap
cuota100.000 req / mes
periodo2026-03
fail_modeclosed

Medidor de consumo

Ejemplo
allow Number Verification
x-correlator: 7f3a-91 price_ref 0,008

Más llamadas CAMARA

allow SIM Swap
x-correlator: 2c9d-44 price_ref 0,012
deny Device Location
x-correlator: a110-0e price_ref 0,015
lectura permitido / rechazado por cuota
Producto
Entitlement Server
Capa
Comercial · APIs
Estándar
CAMARA · GSMA
Infra
Soberana · del grupo
Estado
En operación interna

Un gateway te dice cuántas llamadas pasaron. Mobiconnect te dice cuáles tenían derecho a pasar, y cuánto valen.

¿Cómo convierto un plan comercial en una regla que se cumple en cada llamada? La respuesta es una secuencia, no una promesa:

01 · Contrato plan: antifraude-m cuota 100.000/mes
02 · Cuota 64.200 usada 35.800 restante
03 · Decisión allow fail_mode: closed
04 · Precio price_ref 0,008 congelado por contrato
05 · Factura Trazable x-correlator 7f3a-91
Capacidades

Todo lo que una API necesita para venderse.

Exponer un servicio es fácil. Venderlo — con planes, límites y contratos — exige una capa comercial explícita. Eso es Entitlements.

Catálogo de planes

El plan comercial, en producción.

Segmentos, unidades y matrices de planes se declaran por contrato. El catálogo comercial deja de vivir en hojas de cálculo y pasa a correr en cada decisión.

allow · plan antifraude-mcuota 64.200 / 100.000 · price_ref 0,008
Idempotencia y fail-closed

Ningún consumo se cobra dos veces. Si no se puede decidir, no se sirve.

t1 · correlation_id 7f3c…200 allow · medido 1×
t2 · mismo id, reintento409 duplicate_correlation_id
decisor no disponible503 pdp_unavailable

Cuotas y medición

Cada llamada se mide contra el plan; los límites se aplican de forma consistente y auditable.

Licencias por contrato

Qué puede usar cada tenant, definido en contrato y aplicado en runtime. Sin accesos implícitos.

Pensado para agentes AI

Cada decisión es determinista y legible por máquina: permiso, cuota, precio y razón del rechazo.

Estándar CAMARA (GSMA)

Errores comunes, correlación de trazas, OAuth2/OIDC con scopes y versionado SemVer.

Catálogo comercial

El plan comercial, convertido en regla.

Cada plan declara cuotas, unidades, licencias y precio por consulta. Esa declaración es la que corre en cada decisión allow/deny — conectada, trazable, sin intermediarios.

plan.antifraude-m → runtime Ejemplo
Unidad req / mes
Cuota 100.000
Precio 0,008 congelado
x-correlator 7f3a-91
evaluado contra
allow · cuota disponible64.200 / 100.000 consumida
Equipo de producto definiendo el catálogo comercial de una API
Catálogo → runtime

De la hoja de cálculo al contrato vivo

Nuevos planes son cambios de catálogo, no de arquitectura.

Cómo funciona

Del catálogo al cobro, en tres movimientos.

01

Define el catálogo

Planes, cuotas y licencias se declaran por contrato. El catálogo comercial deja de vivir en hojas de cálculo y pasa a ser parte del sistema.

02

Conecta tus APIs

Cada solicitud se verifica contra el entitlement del tenant y se mide contra su plan, en tiempo real y de forma auditable.

03

Crece sin rediseñar

Nuevos planes, mercados o capacidades son cambios de catálogo, no de arquitectura. Cada consumo se evalúa contra ese contrato explícito.

entitlement.json — ejemplo ilustrativo

Ejemplo ilustrativo del modelo de datos, no una respuesta real de la API.

{
  "tenant": "banco-demo",
  "plan": "antifraude-m",
  "entitlements": {
    "number-verification:verify": { "quota": "250000/mes", "used": 184203 },
    "sim-swap:check":             { "quota": "120000/mes", "used": 91412 }
  },
  "licensed_features": ["reportes-auditoria"]
}
Medición y facturación

El contrato activo → cuota → decisión → factura.

Cada llamada deja un registro auditable. Al cierre del período, ese registro se convierte en una factura trazable hasta el último x-correlator.

01

Contrato activo

Plan, cuota y licencias vigentes para el tenant en el período.

02

Cuota medida

Cada llamada consume contra el límite declarado, en tiempo real.

03

Decisión allow/deny

Permiso explícito o rechazo por cuota, nunca ambigüedad.

04

Factura trazable

Consumo y precio congelado, agregados por contrato y período.

Factura — ejemplo

Ejemplo
tenantbanco-demo
planantifraude-m
periodo2026-03
number-verification:verify184.203 × price_ref
sim-swap:check91.412 × price_ref
rechazos por cuota0 cobrados
Total período Según contrato
Panel financiero conciliando consumo de APIs contra un contrato
Estado de los módulos

Módulos en construcción

El modelo de medición ya corre en producción interna. Algunos módulos de facturación automatizada siguen en construcción: hoy el cierre se concilia con el registro auditable.

Preguntas

Lo que suelen preguntarnos.

¿Qué es exactamente un entitlement server?

Es el sistema que decide, antes de cada llamada, si un tenant tiene permiso para usar una API, cuánta cuota le queda y a qué precio se mide ese consumo. No reemplaza al gateway ni a la API: gobierna el contrato que hay detrás.

¿Para quién está pensado?

Para operadores, bancos, fintech y plataformas que exponen APIs — propias o alineadas a CAMARA — y necesitan venderlas con planes, cuotas y precio, no solo publicarlas.

¿En qué estado está?

El modelo de decisión, cuota y medición opera hoy sobre la infraestructura propia del grupo. Algunos módulos de facturación automatizada y la especificación OpenAPI pública están en construcción.

¿Cómo se integra?

Cada solicitud a tu API se verifica contra el entitlement del tenant antes de ejecutarse. La superficie de integración sigue las Commonalities de CAMARA: errores comunes, OAuth2/OIDC con scopes y x-correlator para trazabilidad.

¿Qué es CAMARA y por qué importa?

CAMARA es el estándar de GSMA Open Gateway para APIs de red: define la interfaz de llamadas como Number Verification, SIM Swap o Device Location. Resuelve la forma de la llamada; Entitlements resuelve quién tiene derecho a hacerla y a qué precio.

¿Quién está detrás?

El grupo construye y opera infraestructura de telecomunicaciones propia. Entitlements nació de gobernar el consumo de esa misma operación antes de ofrecerse como producto.

Alcance

CAMARA resuelve la interfaz. Mobiconnect no la reemplaza: la gobierna.

El estándar ya define cómo se llama a una API de red. Entitlements se instala antes, para decidir quién consume, cuánto y a qué precio, con una regla que se cumple en cada llamada.

Equipo revisando decisiones de consumo de APIs en tiempo real
Contacto

Habla con quien construye.

Conversaciones técnicas directas con quienes diseñan y operan la plataforma. Sin embudos ni intermediarios.