Gracias por sus comentarios.
¿Comentarios?Informes de facturación
Los socios pueden utilizar las siguientes API de facturación mayorista para generar los informes de facturación que les ayudan a validar el uso y la precisión del aprovisionamiento. Las API de facturación mayorista son accesibles a través de developer.webex.com.
-
Conciliación: muestra el consumo de uso por socio, por cliente o por usuario. Los socios pueden utilizar la información de este informe de facturación personalizado para conciliar su factura mensual y así poder facturar a sus clientes y usuarios en función de su consumo.
-
Momento en el tiempo: muestra las asignaciones de paquetes actuales a nivel de cliente o de usuario. El informe "Punto en el momento" proporciona un recuento en tiempo real de las asignaciones de paquetes. Los socios pueden utilizar esta información para validar la exactitud del aprovisionamiento y garantizar que se ajuste a los pedidos de los clientes.
Los socios también pueden generar informes de facturación personalizados para los subsocios utilizando el parámetro subPartnerOrgId.
Existen cuatro API disponibles para los administradores asociados que cumplan con los requisitos mínimos de acceso.
|
API de facturación |
Finalidad 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 su descarga. |
Leer |
|
Lista de informes de facturación mayorista |
Se utiliza para listar los informes de facturación existentes 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 los datos de uso que Webex registra para cada socio. Webex recopila 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 asociados 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 sus 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 informes 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, ya que la conciliación está seleccionada por defecto, por lo que puede pasar al siguiente paso. Si desea generar un informe puntual, cambie la selección a "Punto en el tiempo". |
| 3 |
Introduzca billingStartDate y billingEndDate en el formato que especifica la API. Puedes introducir cualquier fecha de los últimos cinco años, pero no la fecha actual. Para el informe de punto en el tiempo, los campos billingStartDate y billingEndDate no son obligatorios y se ignoran si se introducen. El informe siempre refleja la asignación actual de paquetes. |
| 4 |
Introduzca el tipo de informe:
|
| 5 |
En el campo Incluir, introduzca las columnas adicionales u opcionales que desea ver en los informes. Cada tipo de informe tiene un conjunto de atributos obligatorios y un conjunto de atributos opcionales. Puedes decidir qué atributos opcionales mostrar en cada informe. Si no incluye los atributos opcionales, el informe mostrará únicamente los atributos obligatorios. Las siguientes columnas son los atributos opcionales que puede solicitar que se incluyan en el informe de Clientes y Usuarios:
Debe incluir CUSTOMER_GROUP_ID y CUSTOMER_GROUP_NAME juntos si desea ver estos atributos en su informe. Al seleccionar columnas opcionales, el orden de las columnas en los informes de conciliación de clientes y usuarios cambia. Los socios deben actualizar su integración de API para que acepte el nuevo formato CSV. El orden de las columnas de los informes de datos puntuales permanece sin cambios. Actualmente, la configuración de las funciones existentes tiene prioridad sobre el parámetro Incluir a la hora de determinar el orden de las columnas. Por ejemplo, si una configuración de función específica está habilitada para un cliente, esa columna de función aparecerá según el formato de informe anterior, incluso si la agrega en el parámetro Incluir. Eliminaremos estas configuraciones próximamente. Una vez eliminadas, solo podrá solicitar las columnas opcionales mediante el parámetro Incluir. |
| 6 |
Haga clic en Ejecutar para generar el informe. |
| 7 |
Copie el informe id de la salida de la API. Puedes usar este valor con la API Get para obtener el informe de facturación generado. |
Qué hacer a continuación
Diríjase 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 generado el informe de facturación, utilice esta API para obtener un informe de facturación específico. El informe se genera en una URL donde está disponible para su descarga durante 30 minutos después de que se complete 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 informes de estado. La salida incluye el parámetro tempDownloadURL, que proporciona una URL desde la cual puede descargar el informe. |
| 3 |
Copie la URL de descarga temporal 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 los informes de facturación generados para la organización asociada. Puede consultar todos los informes existentes o limitar la lista a aquellos que cumplan con los parámetros especificados, como el período de facturación y el tipo de facturación (socio, cliente, usuario).
Si introduce parámetros opcionales, la API devolverá únicamente los 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 se encuentran dentro del período, pero que no coinciden exactamente con las fechas, no se devuelven.
| 1 |
Desde developer.webex.com, vaya a Listar informe de facturación mayorista API. |
| 2 |
En Parámetros de consulta, introduzca los parámetros de búsqueda que desee utilizar (por ejemplo, startDate, endDate, Type, sortBy on). |
| 3 |
Haga clic en Ejecutar. La API genera la lista de informes junto con el ID único del informe y el estado (COMPLETADO, EN_PROGRESO ).
|
Qué hacer a continuación
Anota el id para cualquier informe que quieras 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 su ID. Algunos ejemplos de situaciones en las que podría querer 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 curso.
Para un informe puntual, no es necesario eliminar un informe existente, ya que el sistema no regenera estos informes. Cada informe siempre refleja los datos correspondientes a la fecha y hora actuales.
-
Si envías la URL de un informe generado a la persona equivocada, puedes eliminar el informe para que no pueda acceder a él.
| 1 |
Desde developer.webex.com, vaya a Eliminar API de informes de facturación mayorista. |
| 2 |
Introduzca el Id del informe 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 |
Atributo obligatorio u opcional |
|---|---|---|---|---|
|
NOMBRE DEL SOCIO_ |
Nombre del socio |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
ID DE LA ORGANIZACIÓN_SOCIO_ |
identificador único de socio |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
ID DE SUSCRIPCIÓN_ |
Identificador único de suscripción |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
CLIENTE_GRUPO_ID | El identificador único del grupo al que pertenece el cliente. Si el cliente cambia de grupo durante el período de facturación, el consumo se divide en función de los grupos a los que pertenecía durante ese período. |
CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Opcional |
|
CLIENTE_GRUPO_NOMBRE | Nombre para mostrar del grupo de clientes. Si el nombre del grupo cambió durante el período de facturación, se utilizará el nombre más reciente. |
CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Opcional |
|
ID DE CLIENTE_ORGANIZACIÓN_ |
identificador único de cliente interno |
CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
CLIENTE_EXTERNO_ID |
Identificador único del cliente proporcionado por un socio |
CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
TIPO |
Tipo de usuario o espacio de trabajo |
CLIENTE, USUARIO |
Punto en el tiempo |
Obligatorio |
|
ID DE SUSCRIPTOR_ |
Identificador único para el suscriptor |
USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
NOMBRE DE USUARIO_ |
El ID de usuario de Webex del suscriptor |
USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
ID DE ESPACIO DE TRABAJO_ |
Identificador único del espacio de trabajo |
USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
SERVICIO_NOMBRE |
Nombre del servicio (p_. ej., LLAMADA DE ÁREA_COMÚN_, LLAMADA DE WEBEX_, SUITE DE WEBEX_, REUNIONES DE WEBEX) |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
SKU |
Código SKU del servicio |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
DESCRIPCIÓN |
Descripción del servicio |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
CONSUMO_INICIO_FECHA |
Inicio del consumo del servicio. Junto con el campo siguiente, este valor define el período de uso. |
SOCIO, CLIENTE, USUARIO |
Conciliación |
Obligatorio |
|
CONSUMO_FIN_FECHA |
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 |
Obligatorio |
|
INFORME_FECHA |
La fecha y hora en que se genera el informe. |
CLIENTE, USUARIO |
Punto en el tiempo |
Obligatorio |
|
CANTIDAD |
Representa el consumo total de uso por parte del usuario, por socio, por cliente o por usuario (dependiendo del informe y del nivel en el que se visualicen los datos). Cálculo: El sistema calcula la cantidad diaria para cada usuario de forma proporcional a la cantidad asignada para ese día. Uso para un día completo = 1 Uso para medio día = 0,5 Luego, suma los totales diarios de 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. En 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 detalla la asignación 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 los usuarios o espacios de trabajo. Cada fila muestra una cantidad de 1, que representa a 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 mostrará varias entradas, cada una con una cantidad de 1. |
SOCIO, CLIENTE, USUARIO |
Conciliación, punto en el tiempo |
Obligatorio |
|
UBICACIÓN_ID |
identificador de ubicación único |
CLIENTE, USUARIO |
Conciliación, punto en el tiempo El informe de punto en el tiempo del cliente no incluye el ID de ubicación. |
Opcional |
|
ID DE LICENCIA_ |
Identificador de licencia Este campo solo es visible para los 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 |
Conciliación, punto en el tiempo |
Opcional |
Al seleccionar columnas opcionales, se modifica el orden de las columnas en los informes de conciliación de clientes y usuarios. El siguiente orden se aplica a los socios que solo tienen SKU mayoristas en su suscripción:
Informe a nivel de usuario: NOMBRE_DEL SOCIO, ID_DE LA ORGANIZACIÓN DEL SOCIO_, ID_DE LA SUSCRIPCIÓN_, ID DEL GRUPO_DE CLIENTES_, NOMBRE_DEL GRUPO DE CLIENTES,_ID DE LA_ORGANIZACIÓN DE CLIENTES_, ID EXTERNO DE_CLIENTES , ID DE LA UBICACIÓN_, ID_DE LA LICENCIA_, ID DEL SUSCRIPTOR_, ID DEL USUARIO_, ID DEL ESPACIO DE TRABAJO_, NOMBRE_DEL SERVICIO, SKU, DESCRIPCIÓN, FECHA DE INICIO DEL CONSUMO_, FECHA_DE FIN DEL CONSUMO,_CANTIDAD
Informe a nivel de cliente: NOMBRE_DEL SOCIO, ID_DE LA ORGANIZACIÓN DEL SOCIO_, ID_DE LA SUSCRIPCIÓN_, ID DEL GRUPO DE_CLIENTES_, NOMBRE DEL GRUPO_DE CLIENTES_, ID_DE LA ORGANIZACIÓN DE CLIENTES_, ID EXTERNO DE_CLIENTES , ID DE LA UBICACIÓN_, ID DE LA LICENCIA_, NOMBRE_DEL SERVICIO, SKU, DESCRIPCIÓN_,_FECHA DE INICIO DEL CONSUMO_, FECHA DE FIN DEL CONSUMO_, CANTIDAD
Al asignar un paquete a un usuario, se activa la facturación de Webex Wholesale, mientras que al eliminar la asignación del paquete, se detiene.
Una organización de clientes solo puede pertenecer a un grupo de clientes a la vez. Actualmente no se ofrece soporte para múltiples grupos de clientes por organización.
