update_billing_plan

Puede utilizar el método update_billing_plan para crear, actualizar y eliminar un plan de facturación:

Copied!
svc=account/update_billing_plan&params={
  "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.
email 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:
  • 0 — ninguna
  • 1 — cada hora
  • 2 — diariamente
  • 3 — semanalmente
  • 4 — mensualmente
  • 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:

    Copied!
    {
      "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.

    Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.