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

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

  • SOCIO (esta es la opción predeterminada): muestra el consumo de uso a nivel de socio.
  • CLIENTE: muestra el consumo total de uso desglosado por el nivel de organizaciones del cliente en virtud del socio.
  • USUARIO: muestra el consumo total de uso desglosado al nivel de organizaciones del cliente y subcontratistas en el socio.
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

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 genere un informe de facturación, utilice esta API para obtener un informe de facturación específico. El informe obtiene 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 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).

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

Tome un registro del id de todos los informes 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 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.