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

Utilice este procedimiento para generar un informe de facturación personalizado que pueda utilizar para conciliar su facturación.
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:

  • SOCIO (este es el valor predeterminado): muestra el consumo de uso a nivel de socio.
  • CLIENTE: muestra el consumo total de uso desglosado por nivel de organizaciones de clientes bajo el socio.
  • USUARIO: muestra el consumo total de uso desglosado por nivel de organizaciones de clientes y suscriptores del socio.
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

Vaya a Obtener un informe de facturación mayorista para descargar una copia del informe.

Obtenga un informe de facturación mayorista

Una vez que se genera un informe de facturación, utilice esta API para obtener un informe de facturación específico. El informe se envía a una URL donde está disponible para su descarga durante 30 minutos después de completar la solicitud GET.
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).

Si ingresa parámetros opcionales, la API solo devolverá aquellos informes que coincidan exactamente con los parámetros que ingrese. Por ejemplo, si ingresa un período de facturación, solo se devolverán los informes que utilicen ese período de facturación específico; los informes que se encuentren dentro del período, pero que no coincidan exactamente con las fechas, no se devuelven.
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

Tome un registro del id para cualquier informe que desee descargar. Vaya a Obtener un informe de facturación mayorista para descargar el informe.

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.