update_billing_plan
Puede utilizar el método update_billing_plan para crear, actualizar y eliminar un plan de facturación:
svc=account/update_billing_plan¶ms={
"callMode": <text>,
"plan": {
"name": <text>,
"rename": <text>,
"servicesModCounter": <uint>,
"historyPeriod": <int>,
"flags": <uint>,
"denyBalance": <double>,
"blockBalance": <double>,
"minDaysCounter": <int>,
"currencyFormat": <text>,
"descr": <text>,
"email": <text>,
"enable_smtp": <text>, /* Estado del SMTP de email. */
"smtp_host": <text>, /* Host SMTP. */
"smtp_port": <text>, /* Puerto SMTP. */
"smtp_login": <text>, /* Nombre de usuario SMTP. */
"smtp_password": <text>, /* Contraseña SMTP. */
"mapserver_tags": <text>, /* Etiquetas del mapa. */
"hwTypes": {
"<hw_id>": {
"name": <uint>
},
...
},
"parent": <text>,
"personal": {
"services": <object>
}
}
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
| callMode | Tipo de solicitud (create, update, delete). |
| name | Nombre del plan de facturación (campo único). |
| rename | Nuevo nombre del plan de facturación. No se puede modificar el nombre del plan de facturación del usuario de la cuenta de nivel superior. Los nombres de los planes de facturación son únicos: no se puede asignar el mismo nombre a dos planes de facturación. |
| servicesModCounter | Cantidad de modificaciones en la lista de servicios. |
| historyPeriod | Tiempo de almacenamiento de los mensajes de las unidades, en días. |
| flags | Flags del plan de facturación (consulte a continuación). |
| denyBalance | Saldo mínimo para que la cuenta esté activa. Si el saldo es inferior, la cuenta se bloquea. |
| blockBalance | Saldo mínimo para que los servicios de pago estén disponibles. Si el saldo es inferior, los servicios se bloquean. |
| minDaysCounter | Cantidad de días restantes antes de que se bloquee la cuenta. La cantidad de días disminuye si está habilitada la opción Bloqueo por días. |
| currencyFormat | Formato de moneda. |
| descr | Descripción del plan de facturación. |
| Dirección de email. |
Flags del plan de facturación
| Flag | Descripción |
|---|---|
| 0x01 | Bloquear a los usuarios si el saldo es inferior al umbral de bloqueo. |
| 0x02 | Si el saldo es inferior al mínimo, el usuario no puede iniciar sesión en el sistema y la cuenta se suspende. |
| 0x08 | Se prohíbe utilizar los tipos de equipo indicados. |
| 0x10 | Se prohíbe utilizar los tipos de equipo no indicados. |
| 0x20 | Disminuir la cantidad de días en el contador de días y bloquear la cuenta cuando la cantidad de días restantes llegue al mínimo. |
Tipos de equipo
| Nombre | Descripción |
|---|---|
| <hw_name> | Nombre del equipo. |
| id | ID del equipo. |
Servicios
| Nombre | Descripción |
|---|---|
| cost | Límite y coste en el formato descrito en la página Servicios. |
| descr | Descripción del servicio. |
| flags | Acción: 0 — ninguna, 1 — crear/actualizar, 2 — eliminar. |
| interval | Frecuencia de reinicio: |
| maxUsage | Cantidad de elementos disponibles. |
| name | Nombre del servicio. |
| type | Tipo de servicio: 1 — bajo demanda, 2 — periódico. |
Para obtener más detalles sobre los servicios, consulte la página get_account_data.
Respuesta
Si la solicitud se completa correctamente, la respuesta tiene el siguiente formato:
{
"parent": <text>, /* Nombre del plan de facturación padre. */
"name": <text>, /* Nombre del plan de facturación. */
"servicesModCounter": <uint>, /* Cantidad de modificaciones de servicios. */
"historyPeriod": <uint>, /* Período de almacenamiento de los mensajes, en días. Si se indica 0, el período es ilimitado. */
"flags": <uint>, /* Flags del plan de facturación. */
"denyBalance": <int>, /* Valor del saldo con el que los servicios de pago dejan de estar disponibles. */
"blockBalance": <int>, /* Valor del saldo con el que se bloquea la cuenta. */
"minDaysCounter": <int>, /* Contador mínimo de días. */
"currencyFormat": <text>, /* Formato de moneda. */
"descr": <text>, /* Descripción. */
"email": <text>, /* Email. */
"mapserverTags": <text>, /* Etiquetas del servidor de mapas. */
"hwTypes": { /* Objeto de equipos. */
"<hw_id>": { /* ID del equipo. */
"name": <text> /* Nombre del equipo. */
},
...
},
"personal": {
"services": <object> /* Objeto de servicios (consulte a continuación). */
},
"combined": {
"services": { /* Objeto de servicios cuyas claves son nombres de servicios válidos. */
"<service_name>": { /* Indique el nombre del servicio en lugar de <service_name>. */
"type": <uint>, /* Tipo: 1 — bajo demanda; 2 — periódico. */
"maxUsage": <int>, /* Cantidad de recursos activos del servicio. */
"cost": <text>, /* Cantidad máxima de recursos. */
"interval": <uint>, /* Tabla de costes. */
"descr": <text>, /* Intervalo: 0 — ninguno, 1 — cada hora, 2 — diariamente, 3 — semanalmente, 4 — mensualmente. */
"flags": <uint>
},
...
}
}
}
Para obtener más detalles sobre los servicios, consulte la página get_account_data.