Conciliación de facturación para RTM mayorista
Conciliación de facturación
Los administradores de socios pueden utilizar las API de facturación mayorista para generar informes de facturación personalizados que muestren el consumo de uso a los niveles por socio, cliente o usuario. Los partners pueden utilizar esta información para conciliar su factura mensual, de modo que puedan facturar a sus clientes y usuarios en función de su consumo de uso.
Los socios también pueden generar informes de facturación personalizados para los subsocios mediante el parámetro subPartnerOrgId.
Hay cuatro API disponibles para los administradores de socios que cumplen con los requisitos mínimos de acceso.
API de facturación |
Propósito de la API |
Requisito de acceso de administrador de socios |
---|---|---|
Crear un informe de facturación mayorista |
Se utiliza para generar un informe de facturación. |
Lectura/Escritura |
Obtenga un informe de facturación mayorista |
Se utiliza para obtener un informe de facturación generado para descargar. |
Lea |
Enumerar informes de facturación al por mayor |
Se utiliza para enumerar los informes de facturación que existen para ese socio. |
Lea |
Eliminar un informe de facturación mayorista |
Se utiliza para eliminar un informe de facturación existente. |
Lectura/Escritura |
Origen de datos
Los datos de los informes de facturación se extraen de los datos de consumo de uso que Webex rastrea para cada socio. Cada día, Webex realiza un seguimiento del consumo de uso del día anterior para todos los socios, clientes y usuarios y agrega los datos para que puedan utilizarse para generar la factura mensual del socio. Las API de facturación aprovechan estos datos, lo que permite a los administradores de socios generar informes personalizados para que el socio pueda conciliar el consumo de uso de su factura mensual a nivel de socio, cliente y usuario.
Para obtener información más detallada sobre cómo Webex factura a los socios, consulte Facturación del proveedor de servicios.
Crear un informe de facturación mayorista
1 |
Vaya a la API Crear un informe de facturación mayorista. |
2 |
Introduzca el período de facturación; para ello, introduzca los valores para billingStartDate y billingEndDate en el formato que especifica la API. Puede introducir cualquier fecha de los últimos cinco años, pero no el día actual. |
3 |
Introduzca el Tipo de informe:
|
4 |
Haga clic en Ejecutar para generar el informe. |
5 |
Copie el ID del informe de la salida de la API. Puede utilizar este valor con la API de obtención para obtener el informe de facturación generado. |
Qué hacer a continuación
Obtenga un informe de facturación mayorista
1 |
Vaya a la API Obtener un informe de facturación mayorista. |
2 |
En la línea OBTENER , haga clic en el botón id e introduzca el valor de id único para el informe. |
3 |
Haga clic en Ejecutar. |
4 |
La API muestra el estado del informe. La salida incluye el parámetro tempDownloadURL , que proporciona una URL desde la que puede descargar el informe. |
5 |
Copie la tempDownloadURL en un navegador para acceder al informe y descargarlo. |
Enumerar informes de facturación al por mayor
Utilice esta API para obtener una lista de informes de facturación generados para la organización del socio. Puede enumerar todos los informes existentes o limitar la lista a aquellos que cumplan con los parámetros especificados, como su período de facturación y el tipo de facturación (socio, cliente, usuario).
1 |
Ir a la lista API del informe de facturación al por mayor |
2 |
En Parámetros de consulta, introduzca los parámetros de búsqueda que desee utilizar (por ejemplo, startDate, endDate, Type, sortBy on). Para obtener más detalles sobre estos parámetros, consulte la ayuda para desarrolladores en la API. |
3 |
Haga clic en Ejecutar. La API muestra la lista de informes junto con el ID y el estado únicos del informe (COMPLETADO, EN_CURSO).
|
Qué hacer a continuación
Eliminar un informe de facturación mayorista
Utilice este procedimiento para eliminar un informe de facturación generado basado en el ID del informe. Algunos ejemplos en los que puede querer eliminar un informe incluyen los siguientes:
-
Si desea volver a generar un informe de facturación existente, primero debe eliminar el informe existente. Después de eliminar el informe existente, puede crear un nuevo informe para ese período. Tenga en cuenta que el requisito de eliminación no existe si el informe ha fallado o está en curso.
-
Si se genera un informe y usted envía la URL a la persona incorrecta, puede eliminar el informe y esta no podrá acceder a él.
1 |
Vaya a la API Eliminar informe de facturación mayorista. |
2 |
Introduzca el ID del informe. |
3 |
Haga clic en Ejecutar. |
Campos del informe de facturación
Los informes de facturación contienen los siguientes campos:
Campo |
Información adicional |
Aparece en Informes de este tipo |
---|---|---|
NOMBRE_DEL SOCIO |
Nombre del socio |
socio, cliente, usuario |
ID DE_ORGANIZACIÓN_DEL SOCIO |
Identificador único de socio |
socio, cliente, usuario |
ID_DE SUSCRIPCIÓN |
Identificador único de suscripción |
socio, cliente, usuario |
NOMBRE_DEL SERVICIO |
Nombre del servicio (por ejemplo, LLAMADAS DE_ÁREA COMÚN_, WEBEX_CALLING, SERIE DE WEBEX_, WEBEX_MEETINGS) |
socio, cliente, usuario |
SKU |
SKU para el servicio |
socio, cliente, usuario |
descripción |
Descripción del servicio |
socio, cliente, usuario |
FECHA DE_INICIO_DEL CONSUMO |
Inicio del consumo del servicio. Junto con el campo siguiente, este valor define el período de uso. |
socio, cliente, usuario |
FECHA_DE FINALIZACIÓN_DEL CONSUMO |
Fin del consumo del servicio. Junto con el campo anterior, este valor define el período de consumo de uso. |
socio, cliente, usuario |
magnitud |
Representa el consumo agregado de uso de usuarios por socio, cliente o usuario (según el informe y el nivel en el que esté visualizando los datos). Cálculo: Para cada usuario, la cantidad diaria se calcula de forma prorrateada para ese día. Por ejemplo: Uso durante un día completo = 1 Uso durante medio día = 0,5 Los totales por día para todos los días dentro del período de facturación se resumen a fin de proporcionar una cantidad total para ese usuario dentro de ese período de facturación. En el caso de los informes a nivel de clientes y socios, los totales de todos los usuarios se agregan a fin de proporcionar una cantidad total para ese cliente o socio. |
socio, cliente, usuario |
ID DE LA_ORGANIZACIÓN_DEL CLIENTE |
Identificador único interno del cliente |
cliente, usuario |
ID_EXTERNO_DEL CLIENTE |
Identificador único del cliente proporcionado por un socio |
cliente, usuario |
ID_DE SUSCRIPTOR |
Identificador único del suscriptor |
USUARIO |
NOMBRE DE USUARIO_ |
ID de usuario de Webex del suscriptor |
USUARIO |
ID DE ESPACIO DE TRABAJO_ |
Identificador único de espacio de trabajo |
USUARIO |
ID_DE UBICACIÓN |
Identificador de ubicaciones único |
cliente, usuario |
La facturación mayorista de Webex se activa mediante el aprovisionamiento de un paquete a un usuario o se detiene mediante la eliminación de la asignación de paquetes.