Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
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 propiedades modificadas, como las tarifas 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 plan que entre en vigencia el 1 de enero de 2020. Para ello, crea un plan de tarifas futuro y configúralo para que entre en vigencia el 1 de enero de 2020.
Si no se establece una fecha de finalización para el plan de tarifas actual, puedes reemplazar un plan de tarifas existente por un plan de tarifas futuro que comience hoy mismo. Deberás vencer el plan de tarifas actual, como se describe en Vence 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.
Edge
Para crear una versión futura de un plan de tarifas que comience en algún momento después de hoy con la IU de Edge, sigue estos pasos.
- 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. - Haz clic en +Futuro.
- 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.
- Deducir el tiempo invertido en el 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 invertido en el uso del 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, el período de renovación se reduce en 3 meses.
- Configura los siguientes campos en el panel superior:
Nota: Otros campos son de solo lectura.Campo Descripción Predeterminado Obligatorio Nombre del plan de tarifas 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 Sí Fecha de inicio Fecha en 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 en que finaliza el plan de tarifas. Para especificar una fecha de finalización, habilita el botón de activación Tiene fecha de finalización y, luego, ingresa una fecha de finalización o selecciona una fecha con el calendario. Nota: El plan de tarifas estará vigente hasta el final del día en la fecha especificada. Si deseas vencer un plan de tarifas el 1 de diciembre de 2018, por ejemplo, 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; se bloquearán todas las solicitudes el 1 de diciembre de 2018.
Ninguno No Visible para los portales Establece si el plan de tarifas es público o privado. Consulta Planes de tarifas públicos y privados. Habilitado No - Configura las tarifas del plan de tarifas. Consulta Cómo configurar las tarifas.
Nota: No se aplica a los planes de notificaciones ajustables. - 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 se aplica a los planes de notificaciones ajustables.
Campo Descripción Predeterminado Configurar cada producto de forma individual Marca que especifica si se debe configurar un plan de tarifas individual para cada producto de API. Inhabilitado Configurar 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 Selecciona un producto Si habilitas una o ambas marcas, debes seleccionar cada producto de forma individual en la lista desplegable y configurar los detalles de su plan de tarifas. Nota: Asegúrate de configurar todos los productos del paquete de productos.
N/A - Configura los detalles del plan de tarifas según el tipo de plan de tarifas seleccionado:
- Haz clic en una de las siguientes opciones:
Botón Descripción Actualizar borrador Guarda el plan de tarifas como borrador. El plan de tarifas no será visible para los desarrolladores de apps hasta que lo publiques. Puedes editar cualquier campo en un plan de tarifas en borrador.
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 está establecida. No puedes borrar un plan de tarifas después de que se publica, pero puedes vencer el plan de tarifas y reemplazarlo por un plan de tarifas futuro, como se describe en Vence un plan de tarifas publicado.
Classic Edge (nube privada)
Para crear una versión futura de un plan de tarifas que comience en algún momento después de hoy con la IU de Classic Edge, sigue estos pasos.
- En el catálogo de paquetes, haz clic en +Futuro en la columna Borrador/Futuro para el
plan de tarifas que deseas reemplazar.
Se abrirá una ventana de Plan de tarifas futuro.
La diferencia principal entre una ventana de plan de tarifas futuro y una ventana de plan de tarifas actual es la adición de una sección de Suscriptores existentes.
- Como lo harías con cualquier plan de tarifas, haz lo siguiente:
- Ingresa un nombre para el plan en el campo Nombre del plan de tarifas. No es necesario que el nombre coincida 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 entrará en vigencia el plan futuro (consulta Publica planes de tarifas), y una fecha de finalización (también puedes seleccionar "Sin fecha de finalización" si no deseas 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.
- En la sección Suscriptores existentes, 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.
- Deducir el tiempo invertido en el 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 invertido en el uso del 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, el período de renovación se reduce en 3 meses.
- En el campo Fecha de entrada en vigencia, ingresa una fecha de inicio que se produzca 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 API.{plan_Id}es la identificación del plan de tarifas.
parentRatePlanespecifica el ID del plan de tarifas original.startDateespecifica la fecha en que entra en vigencia el plan nuevo.
El nombre del plan de tarifas futuro no debe coincidir con el nombre del plan original. Además, debe ser
único entre todos tus planes de tarifas. Si deseas mantener la fecha de inicio original registrada para
los desarrolladores, establece la marca keepOriginalStartDate en true. Esta marca
se establece en false de forma predeterminada.
Para obtener más información sobre los parámetros de configuración, consulta Parámetros de configuración para 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