Conciliación de facturación para la ruta al mercado mayorista
Conciliación de facturación
Los administradores de socios pueden usar las API de facturación mayorista para generar informes de facturación personalizados que muestren el consumo de uso por socio, por cliente o por usuario. Los socios pueden utilizar esta información para conciliar su factura mensual y así poder facturar a sus clientes y usuarios según su consumo de uso.
Los socios también pueden generar informes de facturación personalizados para subsocios utilizando el parámetro subPartnerOrgId.
Hay cuatro API que están 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. |
Leer / Escribir |
Obtenga un informe de facturación mayorista |
Se utiliza para obtener un informe de facturación generado para descargar. |
Leer |
Lista de informes de facturación mayorista |
Se utiliza para enumerar los informes de facturación que existen para ese socio. |
Leer |
Eliminar un informe de facturación mayorista |
Se utiliza para eliminar un informe de facturación existente. |
Leer / Escribir |
Origen de datos
Los datos para los informes de facturación se extraen de los datos de consumo de uso que Webex rastrea para cada socio. Cada día, Webex rastrea el consumo de uso del día anterior de todos los socios, clientes y usuarios y agrega los datos para que puedan usarse 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 para crear un informe de facturación mayorista. |
2 |
Ingrese el período de facturación ingresando valores para billingStartDate y billingEndDate en el formato que especifica la API. Puede ingresar 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 informe id de la salida de la API. Puede utilizar este valor con la API Get 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 GET, haga clic en el botón id e ingrese el valor de identificación único para el informe. |
3 |
Haga clic en Ejecutar. |
4 |
La API genera un informe del estado. La salida incluye el parámetro tempDownloadURL, que proporciona una URL desde la que puede descargar el informe. |
5 |
Copie tempDownloadURL en un navegador para acceder y descargar el informe. |
Lista de informes de facturación mayorista
Utilice esta API para obtener una lista de informes de facturación generados para la organización asociada. Puede enumerar todos los informes existentes o limitar la lista a aquellos informes que cumplan con los parámetros especificados, como el período de facturación y el tipo de facturación (socio, cliente, usuario).
1 |
Ir a la API de informes de facturación mayorista de listas |
2 |
En Parámetros de consulta, ingrese cualquier parámetro de búsqueda que desee utilizar (por ejemplo, fecha de inicio, fecha de finalización, tipo, ordenar por). Para obtener detalles adicionales sobre estos parámetros, consulte la ayuda para desarrolladores en la API. |
3 |
Haga clic en Ejecutar. La API genera la lista de informes junto con el identificador único del informe y el estado (COMPLETO, EN_PROGRESO).
|
Qué hacer a continuación
Eliminar un informe de facturación mayorista
Utilice este procedimiento para eliminar un informe de facturación generado según el ID del informe. Algunos ejemplos en los que quizás desee eliminar un informe incluyen:
-
Si desea regenerar un informe de facturación existente, primero debe eliminarlo. 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 falla o está en progreso.
-
Si se genera un informe y envía la URL a la persona equivocada, puede eliminar el informe y esa persona no podrá acceder a él.
1 |
Vaya a la API para eliminar informes de facturación mayorista. |
2 |
Ingrese el reporte Id. |
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 del tipo |
---|---|---|
NOMBRE DEL SOCIO_ |
Nombre del socio |
SOCIO, CLIENTE, USUARIO |
SOCIO_ORG_ID |
Identificador único de socio |
SOCIO, CLIENTE, USUARIO |
ID DE SUSCRIPCIÓN_ |
Identificador único de suscripción |
SOCIO, CLIENTE, USUARIO |
SERVICIO_NOMBRE |
Nombre del servicio (por ejemplo, ÁREA COMÚN__LLAMADAS, WEBEX_LLAMADAS, WEBEX_SUITE, WEBEX_REUNIONES) |
SOCIO, CLIENTE, USUARIO |
SKU |
Sku para el servicio |
SOCIO, CLIENTE, USUARIO |
DESCRIPCIÓN |
Descripción del servicio |
SOCIO, CLIENTE, USUARIO |
FECHA DE CONSUMO_INICIO_ |
Inicio del consumo del servicio. Junto con el siguiente campo, este valor define el período de uso. |
SOCIO, CLIENTE, USUARIO |
FECHA DE CONSUMO_FIN_ |
Fin del consumo del servicio. Junto con el campo anterior, este valor define el período de consumo de uso. |
SOCIO, CLIENTE, USUARIO |
CANTIDAD |
Representa el consumo de uso agregado del usuario por socio, por cliente o por usuario (según el informe y el nivel en el que esté viendo los datos). Cálculo: Calculan la cantidad por día para cada usuario de forma prorrateada para ese día. Uso durante un día completo = 1 Uso durante medio día = 0.5 Suman los totales por día para todos los días dentro del período de facturación para calcular la cantidad total para ese usuario dentro de ese período de facturación. Para los informes a nivel de cliente y socio, los totales de todos los usuarios se agregan para proporcionar una cantidad total para ese cliente o socio. |
SOCIO, CLIENTE, USUARIO |
CLIENTE_ORG_ID |
Identificador único del cliente interno |
CLIENTE, USUARIO |
CLIENTE_EXTERNO_ID |
Identificador único del cliente proporcionado por un socio |
CLIENTE, USUARIO |
ID DEL SUSCRIPTOR_ |
Identificador único del suscriptor |
USUARIO |
NOMBRE DE USUARIO_ |
ID de usuario de Webex del suscriptor |
USUARIO |
ESPACIO DE TRABAJO_ID |
Identificador único del espacio de trabajo |
USUARIO |
UBICACIÓN_ID |
Identificador de ubicación único |
CLIENTE, USUARIO |
LICENCIA_ID |
Identificador de licencia Este campo sólo es visible para paquetes mayoristas. El ID License_está en blanco para las licencias asignadas antes de la introducción de este campo. Un informe de facturación puede mostrar varias filas para el mismo paquete mayorista, y cada fila representa un número único. package/license Combinación de identificación. Si el campo ID DE LICENCIA_está presente, cada fila representa un ID único package/location/license Combinación de identificación. |
CLIENTE, USUARIO |
El aprovisionamiento de un paquete a un usuario activa la facturación de Webex Wholesale, mientras que la eliminación de la asignación del paquete la detiene.