Crea planes de tarifas futuros

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Introducción

Después de que se publica un plan de tarifas existente, la única propiedad que puedes cambiar es su fecha de finalización. Sin embargo, puedes crear una versión nueva del plan que incluya las propiedades modificadas, como las tarifas modificadas del plan de tarifas. Puedes configurar la revisión para que entre en vigencia en una fecha futura. El plan de tarifas original finaliza cuando la revisión entra en vigencia.

Por ejemplo, supongamos que creaste un plan de tarifas estándar que vence el 31 de diciembre de 2019 y deseas reemplazarlo por otro que entre en vigencia el 1 de enero de 2020. Para ello, debes crear un plan de tarifas futuro y configurarlo para que entre en vigencia el 1 de enero de 2020.

Si no se estableció una fecha de finalización para el plan de tarifas actual, puedes reemplazar un plan de tarifas existente por uno futuro que comience hoy mismo. Deberás vencer el plan de tarifas actual, como se describe en Cómo vencer un plan de tarifas publicado.

Se notifica a los desarrolladores sobre el plan de tarifas revisado. Los desarrolladores que aceptan el plan de tarifas original se registran automáticamente para la revisión (pero tienen la opción de rechazar la revisión).

Puedes crear un plan de tarifas futuro con la IU de administración o la API de monetización, como se describe en las siguientes secciones.

Crea un plan de tarifas futuro con la IU

Crea un plan de tarifas futuro, como se describe a continuación.

Conexión de integración

Para crear una versión futura de un plan de tarifas que comienza en algún momento después de hoy con la IU de Edge, sigue estos pasos.

  1. En la página Planes de tarifas, coloca el cursor dentro de la fila asociada con el plan de tarifas para el que deseas crear un plan de tarifas futuro.
    El plan de tarifas debe tener una fecha de finalización.
  2. Haz clic en +Future.
  3. En la sección Plan de tarifas futuro, selecciona una de las siguientes opciones:
    • Reiniciar el período completo del contrato en la nueva fecha de entrada en vigencia: El plan de tarifas futuro entra en vigencia en la fecha de entrada en vigencia. El plazo de renovación del plan de tarifas futuro es el mismo que el del plan de tarifas actual.
    • Deduce el tiempo dedicado al contrato anterior del período nuevo, en la fecha de entrada en vigencia: El plan de tarifas futuro entra en vigencia en la fecha de entrada en vigencia. El tiempo dedicado a usar el plan de tarifas actual se deduce del plazo de renovación del plan de tarifas futuro. Esto significa que, si un desarrollador usa el plan actual durante 3 meses, y el período de renovación se reduce en 3 meses.
  4. Configura los siguientes campos en el panel superior:
    Nota: Otros campos son de solo lectura.
    Campo Descripción Predeterminada Obligatorias
    Nombre del plan de tarifas

    El nombre de tu plan de tarifas.

    Nota: No es necesario que el nombre coincida con el nombre del plan de tarifas original.

    Nombre del plan actual
    Fecha de inicio Fecha en la que entra en vigencia el plan de tarifas. Ingresa una fecha de inicio o selecciona una fecha con el calendario. Hoy No
    Fecha de finalización Fecha de finalización del plan de tarifas. Para especificar una fecha de finalización, habilita el interruptor Tiene una fecha de finalización y, luego, ingresa una fecha de finalización, o bien selecciona una fecha mediante el calendario.

    Nota: El plan de tarifas estará vigente hasta el fin del día en la fecha especificada. Por ejemplo, si quieres que un plan de tarifas venza el 1 de diciembre de 2018, debes establecer el valor endDate en 2018-11-30. En este caso, el plan de tarifas vencerá al final del día el 30 de noviembre de 2018 y se bloquearán todas las solicitudes del 1 de diciembre de 2018.

    Ninguna No
    Visible para los portales Establece si el plan de tarifas es público o privado. Consulta Planes de tarifas públicos frente a planes privados. Habilitada No
  5. Configura las tarifas del plan de tarifas. Consulta Configura las tarifas.
    Nota: No es aplicable a los planes de notificaciones ajustables.
  6. Si seleccionas un paquete de productos que contiene más de un producto de API, establece las siguientes preferencias en la sección Plan de tarifas específico o genérico:
    Nota: Este paso no es aplicable a los planes de notificación ajustables.
    Campo Descripción Predeterminada
    Configura cada producto de forma individual Marca que especifica si se debe configurar un plan de tarifas individual para cada producto de API. Inhabilitado
    Configura la oferta freemium de cada producto de forma individual Marca que especifica si se debe configurar un plan freemium para cada producto de API. Inhabilitado
    Seleccionar un producto Si habilitas una o ambas marcas, debes seleccionar cada producto de forma individual de la lista desplegable y configurar los detalles de su plan de tarifas.

    Nota: Asegúrate de configurar todos los productos del paquete de productos.

    No disponible
  7. Configura los detalles del plan de tarifas según el tipo de plan de tarifas seleccionado:
  8. Haz clic en una de las siguientes opciones:
    Botón Descripción
    Actualizar borrador Guarda el plan de tarifas como borrador.

    Los desarrolladores de apps no podrán ver el plan de tarifas hasta que lo publiques. Puedes editar cualquier campo en un borrador del plan de tarifas.

    Publicar borrador Publica el plan.

    Nota: Después de publicar un plan de tarifas, solo puedes modificar la fecha de finalización si aún no se configuró. No puedes borrar un plan de tarifas después de publicarlo, pero puedes vencerlo y reemplazarlo por uno futuro, como se describe en Cómo vencer un plan de tarifas publicado.

Versión clásica de Edge (nube privada)

Para crear una versión futura de un plan de tarifas que comenzará en algún momento después de hoy con la IU de Edge clásica, sigue estos pasos.

  1. En el catálogo del paquete, haz clic en + Future en la columna Borrador/Futuro del plan de tarifas que deseas reemplazar.

    Se abrirá una ventana futura del Plan de tarifas.

    La diferencia principal entre la ventana del plan de tarifas futuro y la del plan de tarifas actual es agregar una sección de suscriptores existentes.

  2. Al igual que con cualquier plan de tarifas:
    • Ingresa un nombre para el plan en el campo Nombre del plan de tarifas. El nombre no tiene que coincidir con el nombre del plan de tarifas original.
    • Configura las tarifas de un plan de tarifas (opcional).
    • Configura los detalles del plan de tarifas según el tipo de plan de tarifas seleccionado:
    • Especifica una fecha en la que el plan futuro entra en vigencia (consulta Publicación de planes de tarifas) y una fecha de finalización (también puedes seleccionar “Sin fecha de finalización” si no quieres que el plan de tarifas futuro finalice en una fecha específica). Si se establece una fecha de finalización para el plan actual, la fecha de entrada en vigencia del plan futuro debe ser posterior a la fecha de finalización del plan actual.
  3. En la sección Suscriptores existentes, selecciona una de las siguientes opciones:
    • Reiniciar el período del contrato completo en la nueva fecha de entrada en vigencia. El plan de tarifas futuro entra en la fecha de entrada en vigencia. El plazo de renovación del plan de tarifas futuro es el mismo que el del plan de tarifas actual.
    • Resta el tiempo dedicado al contrato anterior del nuevo período, en la fecha de entrada en vigencia. El plan de tarifas futuro entra en vigencia en la fecha de entrada en vigencia. El tiempo dedicado a usar el plan de tarifas actual se deduce del plazo de renovación del plan de tarifas futuro. Esto significa que, si un desarrollador usa el plan actual durante 3 meses, y el período de renovación se reduce en 3 meses.
  4. En el campo Fecha de entrada en vigencia, ingresa una fecha de inicio que ocurra después de la fecha de finalización del plan de tarifas existente.

Crea un plan de tarifas futuro con la API

Puedes crear un plan de tarifas futuro con la API si envías una solicitud POST a /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.

Donde:

  • {org_id} es el nombre de la organización.
  • {package_id} es la identificación del paquete de la API.
  • {plan_Id} es la identificación del plan de tarifas.
Cuando creas la revisión, debes especificar las siguientes propiedades en el cuerpo de la solicitud:
  • parentRatePlan especifica el ID del plan de tarifas original.
  • startDate especifica la fecha en que entrará en vigencia el nuevo plan.

El nombre del plan de tarifas futuro no tiene que coincidir con el del plan original. Si deseas conservar la fecha de inicio original registrada para los desarrolladores, establece la marca keepOriginalStartDate en true. El valor predeterminado de esta marca es false.

Para obtener más información sobre los parámetros de configuración, consulta Parámetros de configuración de los planes de tarifas.

Por ejemplo, la siguiente solicitud crea un plan de tarifas futuro:

$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "parentRatePlan": {
       "id": "monetization_package_flat_rate_card_plan_1379513833409"
     },
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "myorg"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.05",
        "startUnit": "0"       
       }      
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2014-01-01 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password