Quién paga y quién queda limitado
Un envío necesita ambas cosas: una unidad en la cuenta de unidades y crédito en la cuenta padre. Las
unidades son un límite, no dinero prepago. Un mensaje de tres partes toma tres unidades.
Una cuenta de unidades es siempre hija directa de una cuenta que tiene dinero. Una cuenta de unidades no
puede tener hijas propias.
Cómo se cuentan las unidades
Las unidades las cuenta el mismo motor que cuenta el crédito prepago: cada nodo de la pasarela reserva un bloque, lo gasta desde memoria sin ninguna llamada a la base de datos por mensaje y liquida lo gastado. El recuento es exacto tras una caída.- Un mensaje reembolsado devuelve su unidad, una sola vez: un rechazo del proveedor, una expiración, un descarte, un mensaje que no se pudo encolar.
- Las asignaciones pequeñas se reparten de forma justa. Un nodo nunca reserva más de su parte de lo que está libre, y devuelve un bloque que no ha usado durante unos segundos, así que cinco unidades en una pasarela de dos nodos son cinco mensajes enviables, llegue el cliente al nodo que llegue.
- Las unidades se aplican allí donde se aplica el crédito prepago. En una pasarela con la aplicación del prepago desactivada, los logins de una cuenta de unidades no se cargan y no pueden hacer bind ni enviar: nada los estaría contando.
Qué ve un cliente cuando se le acaban
No se cobra nada en ninguno de los tres casos, y en el tercero la unidad se devuelve.
0x403 deliberadamente no es el 0x402 de falta de crédito: un cliente puede distinguir “me he quedado
sin unidades” de “mi proveedor se ha quedado sin dinero”. El estado se establece por listener con
conf.status.noUnits, en hexadecimal o decimal; el valor por defecto es 0x00000403.
unitsPending es el único que vale la pena reintentar: las unidades retenidas en otro sitio vuelven en
cuestión de segundos.
De dónde vienen las cuentas de unidades
Una cuenta de unidades la crea, le da unidades y se las retira la plataforma que la gestiona (FireFlo OMNI, por ejemplo) a través de la API de gestión de la pasarela. El panel de control muestra las cuentas de unidades y su libro; no las crea ni mueve unidades. Cada entrega, retirada y movimiento se escribe en un libro de unidades de solo anexado bajo una referencia, y una repetición con la misma referencia no cambia nada. Para cada cuenta y producto, libres- reservadas + usadas es igual a la suma de su libro.
Lo que un login de unidades no puede hacer
Un login de unidades no es su cuenta padre en la API de autoservicio.- Balance responde con sus propias unidades, nunca con el dinero de la cuenta padre. Consulte Saldo.
- Un envío aceptado no muestra el precio de la cuenta padre.
- La cotización de tarifa, las transferencias de crédito, los registros de sender ID y de plantillas y
la lista de lotes responden
403con el códigoUNITS_LOGIN. Esas cosas pertenecen a la cuenta que paga.
A qué velocidad puede enviar
Una cuenta de unidades puede tener un límite de velocidad propio, además del de su cuenta padre. Lo establece la plataforma que la gestiona; son dos valores, y cualquiera de ellos puede dejarse sin establecer.
Precedencia. Un submit se comprueba primero contra el límite propio de la cuenta de unidades. Si lo
supera, el submit se rechaza sin consumir el límite de la cuenta padre, así que un cliente que envía
demasiado rápido no agota la asignación de su revendedor. Dentro de él, se aplican los límites de la
cuenta padre como siempre: el
conf.maxRate propio de la cuenta padre, el valor por defecto del listener
y el presupuesto del puerto. Un login con un límite propio más rápido sigue sujeto al límite de su
cuenta de unidades.
0x58 significa “vaya más despacio”; 0x14 significa “inténtelo de nuevo en breve”. Vacío o 0
significa que la cuenta de unidades no tiene límite propio, y solo se aplican los de la cuenta padre.
Los binds de un login de unidades cuentan contra el límite de conexiones de su cuenta padre. No hay un
límite de binds aparte por cuenta de unidades.
En el panel de control
La página de una cuenta de unidades dice units en lugar de un saldo y nombra la cuenta a la que se cobra. Su pestaña Billing muestra las unidades restantes y usadas por producto, sus logins, las unidades usadas este mes y por día, sus límites de velocidad y el libro de unidades. Las pestañas Tariff y Statement no se muestran: los precios y el extracto son los de la cuenta padre. No se ofrece ninguna acción con dinero. La pestaña Billing de una cuenta padre lista sus subcuentas, con las unidades restantes por producto y un estado “no units”. Si las cuentas de unidades aún no se pueden usar, porque un nodo es anterior a 0.16.0 o la aplicación del prepago está desactivada, la pestaña indica cuál es el motivo. Los mensajes rechazados aparecen en Refused bajo No units left y Units being reserved; try again. La cuenta que se muestra allí es la cuenta padre, que paga; el login es el de la cuenta de unidades.Actualizar a 0.16.0
El esquema pasa de 1.129.0 a 1.131.0, así que actualice con--migrate. Añade tablas de unidades vacías
y una columna que admite nulos en el registro de llamada. Una instalación sin cuentas de unidades se
comporta como lo hacía en 0.15.13. Hay una clave nueva, conf.status.noUnits; no hace falta establecer
nada.
Actualice el panel de control junto con la pasarela: un panel más antiguo informa de que el esquema es
más nuevo de lo que espera.
Relacionado
Crédito prepago
El motor con el que se cuentan las unidades.
Códigos de estado
0x403, y lo que deliberadamente no es.