Gracias por sus comentarios.
Informes de facturación de ruta al mercado al por mayor
¿Comentarios?Informes de facturación
Los socios pueden utilizar las siguientes API de facturación mayorista para generar informes de facturación que les ayuden a validar la precisión del uso y el aprovisionamiento. Se puede acceder a las API de facturación mayorista a través de developer.webex.com.
-
Conciliación: muestra el consumo de uso por socio, por cliente o por usuario. Los socios pueden usar esta información del informe de facturación personalizado para conciliar su factura mensual y así poder facturar a sus clientes y usuarios según su consumo de uso.
-
Punto en el tiempo: muestra las asignaciones de paquetes actuales por cliente o por usuario. El informe de punto en el tiempo proporciona un recuento en tiempo real de las asignaciones de paquetes. Los socios pueden utilizar esta información para validar la precisión del aprovisionamiento y garantizar la alineación con los pedidos de los clientes.
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. |
Read/write |
|
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. |
Read/write |
Fuente de datos
Los datos para los informes de facturación se extraen de las asignaciones de paquetes y de los datos de uso que Webex rastrea para cada socio. Webex agrega diariamente los datos de los paquetes de clientes y usuarios para generar la factura mensual del socio. Las API de facturación utilizan estos datos, lo que permite a los administradores de socios generar informes personalizados. Estos informes ayudan a los socios a 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 |
Desde developer.webex.com, vaya a Crear una API de informe de facturación mayorista. |
| 2 |
Seleccione cualquiera de las siguientes categorías de informes:
Si desea generar un informe de conciliación, no es necesario cambiar nada porque la opción Conciliación está seleccionada de forma predeterminada, por lo que puede continuar al siguiente paso. Si desea generar un informe de punto en el tiempo, cambie la selección a Punto en el tiempo. |
| 3 |
Ingrese 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. Para el informe de punto en el tiempo, los campos billingStartDate y billingEndDate no son obligatorios y se ignoran si se ingresan. El informe siempre refleja las asignaciones de paquetes actuales. |
| 4 |
Introduzca el tipo de informe:
|
| 5 |
Haga clic en Ejecutar para generar el informe. |
| 6 |
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 la sección 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 completarse la solicitud GET.
| 1 |
Desde developer.webex.com, vaya a Obtener una API de informe de facturación mayorista. |
| 2 |
Introduzca el valor único id para el informe y haga clic en Ejecutar. 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. |
| 3 |
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 especifique. Por ejemplo, si especifica 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 caen dentro del período, pero que no coinciden exactamente con las fechas, no se devuelven.
| 1 |
Desde developer.webex.com, vaya a Lista de API de informes de facturación mayorista. |
| 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). |
| 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 de conciliación existente, primero debe eliminar el informe existente. Después de eliminar el informe existente, puede crear un nuevo informe para ese período. No se puede eliminar un informe si su generación ha fallado o aún está en progreso.
Para un informe de un punto en el tiempo, no es necesario eliminar un informe existente, ya que el sistema no regenera estos informes. Cada informe siempre refleja los datos a la fecha y hora actuales.
-
Si envía la URL de un informe generado a la persona equivocada, puede eliminar el informe para que no pueda acceder a él.
| 1 |
Desde developer.webex.com, vaya a Eliminar API de informe de facturación mayorista. |
| 2 |
Ingrese el informe Id y haga clic en Ejecutar. |
Campos del informe de facturación
Los informes de facturación contienen los siguientes campos:
|
Campo |
Descripción |
Tipo de informe admitido |
Categoría de informe compatible |
|---|---|---|---|
|
NOMBRE DEL SOCIO_ |
Nombre del socio |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
SOCIO_ORG_ID |
Identificador único de socio |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
SUSCRIPCIÓN_ID |
Identificador de suscripción único |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
SERVICIO_NOMBRE |
Nombre del servicio (por ejemplo, ÁREA COMÚN__LLAMADAS, WEBEX_LLAMADAS, WEBEX_SUITE, WEBEX_REUNIONES) |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
SKU |
Sku para el servicio |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
DESCRIPCIÓN |
Descripción del servicio |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
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 |
Conciliación |
|
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 |
Conciliación |
|
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: El sistema calcula 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 Luego, suma 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. Punto en el tiempo: El informe del cliente enumera las asignaciones de paquetes por cliente. Cada fila representa la cantidad total de un paquete específico asignado a usuarios o espacios de trabajo dentro de una organización de cliente en particular. La cantidad muestra “0” si no hay paquetes asignados. El informe de usuario enumera los paquetes asignados a usuarios o espacios de trabajo. Cada fila muestra una cantidad de 1, que representa un usuario o espacio de trabajo y su paquete o complemento individual. Si se asignan varios paquetes o complementos a un usuario o espacio de trabajo, el informe muestra varias entradas, cada una con una cantidad de 1. |
SOCIO, CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
CLIENTE_ORG_ID |
Identificador único del cliente interno |
CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
CLIENTE_EXTERNO_ID |
Identificador único del cliente proporcionado por un socio |
CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
ID DEL SUSCRIPTOR_ |
Identificador único del suscriptor |
USUARIO |
Reconciliación, punto en el tiempo |
|
NOMBRE DE USUARIO_ |
ID de usuario de Webex del suscriptor |
USUARIO |
Reconciliación, punto en el tiempo |
|
ESPACIO DE TRABAJO_ID |
Identificador único del espacio de trabajo |
USUARIO |
Reconciliación, punto en el tiempo |
|
UBICACIÓN_ID |
Identificador de ubicación único |
CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
LICENCIA_ID |
Identificador de licencia Este campo es visible solo para paquetes mayoristas Para el informe de conciliación, el ID License_está en blanco para las licencias asignadas antes de la introducción de este campo. El informe de facturación muestra varias filas para el mismo paquete mayorista si está asociado con diferentes combinaciones de ID DE UBICACIÓN_e ID DE LICENCIA_. |
CLIENTE, USUARIO |
Reconciliación, punto en el tiempo |
|
INFORME_FECHA |
La fecha y hora en que se genera el informe. |
CLIENTE, USUARIO |
Punto en el tiempo |
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.
