Merci pour votre commentaire.
rapports de facturation de la voie de commercialisation en gros
Un commentaire ?Rapports de facturation
Les partenaires peuvent utiliser les API de facturation de gros suivantes pour générer les rapports de facturation qui les aident à valider l'utilisation et l'exactitude de l'approvisionnement. Les API de facturation en gros sont accessibles via developer.webex.com.
-
Rapprochement — Affiche la consommation d’utilisation par partenaire, par client ou par utilisateur. Les partenaires peuvent utiliser les informations de ce rapport de facturation personnalisé pour rapprocher leurs factures mensuelles et ainsi facturer leurs clients et utilisateurs en fonction de leur consommation.
-
Point dans le temps — Affiche les allocations de forfaits actuelles par client ou par utilisateur. Le rapport ponctuel fournit un décompte en temps réel des affectations de colis. Les partenaires peuvent utiliser ces informations pour valider l'exactitude des approvisionnements et garantir leur conformité avec les commandes des clients.
Les partenaires peuvent également générer des rapports de facturation personnalisés pour les sous-partenaires à l'aide du paramètre subPartnerOrgId.
Quatre API sont disponibles pour les administrateurs partenaires qui répondent aux exigences d'accès minimales.
|
API de facturation |
Objectif de l'API |
Exigences d'accès administrateur partenaire |
|---|---|---|
|
Créer un rapport de facturation en gros |
Utilisé pour générer un rapport de facturation. |
Read/write |
|
Obtenez un rapport de facturation en gros |
Utilisé pour obtenir un rapport de facturation généré et téléchargeable. |
Lire |
|
Liste des rapports de facturation en gros |
Permet de lister les rapports de facturation existants pour ce partenaire. |
Lire |
|
Supprimer un rapport de facturation en gros |
Utilisé pour supprimer un rapport de facturation existant. |
Read/write |
Source de données
Les données des rapports de facturation proviennent des affectations de forfaits et des données d'utilisation que Webex suit pour chaque partenaire. Webex agrège quotidiennement les données relatives aux forfaits clients et utilisateurs afin de générer la facture mensuelle du partenaire. Les API de facturation utilisent ces données, permettant aux administrateurs partenaires de générer des rapports personnalisés. Ces rapports aident les partenaires à rapprocher la consommation d'utilisation de leur facture mensuelle aux niveaux partenaire, client et utilisateur.
Pour plus d'informations sur la façon dont Webex facture ses partenaires, voir Facturation des fournisseurs de services.
Créer un rapport de facturation en gros
| 1 |
Depuis developer.webex.com, accédez à Créer une API de rapport de facturation en gros. |
| 2 |
Sélectionnez l'une des catégories de rapports suivantes :
Si vous souhaitez générer un rapport de rapprochement, il n'est pas nécessaire de modifier quoi que ce soit car le rapprochement est sélectionné par défaut ; vous pouvez donc passer à l'étape suivante. Pour générer un rapport à un instant précis, sélectionnez « À un instant précis ». |
| 3 |
Saisissez les valeurs billingStartDate et billingEndDate au format spécifié par l'API. Vous pouvez saisir n'importe quelle date des cinq dernières années, mais pas la date du jour. Pour le rapport Point-In-Time, les champs billingStartDate et billingEndDate ne sont pas obligatoires et sont ignorés s'ils sont saisis. Le rapport reflète toujours la répartition actuelle des colis. |
| 4 |
Saisissez le type de rapport :
|
| 5 |
Cliquez sur Exécuter pour générer le rapport. |
| 6 |
Copiez le rapport id de la sortie de l'API. Vous pouvez utiliser cette valeur avec l'API Get pour obtenir le rapport de facturation généré. |
Que faire ensuite
Rendez-vous à la section Obtenir un rapport de facturation en gros pour télécharger une copie du rapport.
Obtenez un rapport de facturation de gros
Une fois le rapport de facturation généré, utilisez cette API pour obtenir un rapport de facturation spécifique. Le rapport est généré et disponible au téléchargement à une URL pendant 30 minutes après la fin de la requête GET.
| 1 |
Depuis developer.webex.com, allez à Obtenir un rapport de facturation en gros API. |
| 2 |
Saisissez la valeur unique id du rapport et cliquez sur Exécuter. L'API génère un rapport d'état. Le résultat inclut le paramètre tempDownloadURL, qui fournit une URL à partir de laquelle vous pouvez télécharger le rapport. |
| 3 |
Copiez le tempDownloadURL dans un navigateur pour accéder au rapport et le télécharger. |
Liste des rapports de facturation en gros
Utilisez cette API pour obtenir la liste des rapports de facturation générés pour l'organisation partenaire. Vous pouvez afficher tous les rapports existants ou limiter la liste aux rapports qui répondent aux paramètres spécifiés, tels que votre période de facturation et votre type de facturation (partenaire, client, utilisateur).
Si vous saisissez des paramètres facultatifs, l'API ne renvoie que les rapports qui correspondent exactement aux paramètres que vous spécifiez. Par exemple, si vous spécifiez une période de facturation, seuls les rapports utilisant cette période de facturation spécifique seront renvoyés. Les rapports qui se situent dans la période, mais dont les dates ne correspondent pas exactement, ne sont pas renvoyés.
| 1 |
Depuis developer.webex.com, accédez à List Wholesale Billing Report API. |
| 2 |
Sous Paramètres de requête, saisissez les paramètres de recherche que vous souhaitez utiliser (par exemple, startDate, endDate, Type, sortBy on). |
| 3 |
Cliquez sur À vide. L'API renvoie la liste des rapports ainsi que l'identifiant unique du rapport et son statut (TERMINÉ, EN_EN COURS).
|
Que faire ensuite
Notez l' id de tous les rapports que vous souhaitez télécharger. Allez à Obtenir un rapport de facturation en gros pour télécharger le rapport.
Supprimer un rapport de facturation de gros
Utilisez cette procédure pour supprimer un rapport de facturation généré en fonction de son identifiant. Voici quelques exemples de situations où vous pourriez souhaiter supprimer un rapport :
-
Si vous souhaitez régénérer un rapport de facturation de rapprochement existant, vous devez d'abord supprimer le rapport existant. Après avoir supprimé le rapport existant, vous pouvez créer un nouveau rapport pour cette période. Vous ne pouvez pas supprimer un rapport si sa génération a échoué ou est toujours en cours.
Pour un rapport ponctuel, il n'est pas nécessaire de supprimer un rapport existant, car le système ne régénère pas ces rapports. Chaque rapport reflète toujours les données à la date et à l'heure actuelles.
-
Si vous envoyez par erreur l'URL d'un rapport généré à la mauvaise personne, vous pouvez supprimer le rapport afin qu'elle ne puisse pas y accéder.
| 1 |
Depuis developer.webex.com, accédez à Supprimer l'API de rapport de facturation en gros. |
| 2 |
Saisissez l'identifiant du rapport et cliquez surExécuter. |
Champs du rapport de facturation
Les rapports de facturation contiennent les champs suivants :
|
Champ |
Description |
Type de rapport pris en charge |
Catégorie de rapport prise en charge |
|---|---|---|---|
|
NOM DU PARTENAIRE_ |
Nom du partenaire |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
PARTENAIRE_ORG_ID |
Identifiant unique du partenaire |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
ABONNEMENT_ID |
Identifiant unique d'abonnement |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
NOM DU SERVICE_ |
Nom du service (par exemple, COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS) |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
RÉF |
Référence du service |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
DESCRIPTION |
Description du service |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
CONSOMMATION_DÉBUT_DATE |
Début de la consommation du service. Associée au champ suivant, cette valeur définit la période d'utilisation. |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation |
|
CONSOMMATION_FIN_DATE |
Fin de la consommation du service. Associée au champ précédent, cette valeur définit la période de consommation. |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation |
|
QUANTITÉ |
Représente la consommation d'utilisation agrégée des utilisateurs par partenaire, par client ou par utilisateur (selon le rapport et le niveau auquel vous consultez les données). Calcul: Le système calcule la quantité journalière pour chaque utilisateur au prorata de la consommation de ce jour. Utilisation pour une journée complète = 1 Utilisation pour une demi-journée = 0,5 Ensuite, il additionne les totaux journaliers pour tous les jours de la période de facturation afin de calculer la quantité totale pour cet utilisateur au cours de cette période de facturation. Pour les rapports au niveau client et partenaire, les totaux de tous les utilisateurs sont agrégés afin de fournir une quantité totale pour ce client ou partenaire. Point précis dans le temps : Le rapport client répertorie les attributions de colis par client. Chaque ligne représente la quantité totale d'un forfait spécifique attribué aux utilisateurs ou aux espaces de travail au sein d'une organisation cliente particulière. La quantité affichée est « 0 » si aucun colis n'est attribué. Le rapport utilisateur répertorie les packages attribués aux utilisateurs ou aux espaces de travail. Chaque ligne affiche une quantité de 1, représentant un utilisateur ou un espace de travail et son package ou module complémentaire individuel. Si plusieurs modules ou extensions sont attribués à un utilisateur ou à un espace de travail, le rapport affiche plusieurs entrées, chacune avec une quantité de 1. |
PARTENAIRE, CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
CLIENT_ORG_ID |
Identifiant unique du client interne |
CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
CLIENT_EXTERNE_ID |
Identifiant unique du client fourni par un partenaire |
CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
ABONNÉ_ID |
Identifiant unique de l'abonné |
UTILISATEUR |
Réconciliation, point à un instant donné |
|
IDUTILISATEUR_ |
L'identifiant utilisateur Webex de l'abonné |
UTILISATEUR |
Réconciliation, point à un instant donné |
|
ESPACE DE TRAVAIL_ID |
Identifiant unique de l'espace de travail |
UTILISATEUR |
Réconciliation, point à un instant donné |
|
EMPLACEMENT_ID |
Identifiant unique de localisation |
CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
LICENCE_ID |
Identifiant de licence Ce champ est visible uniquement pour les forfaits de vente en gros. Pour le rapport de rapprochement, l'identifiant License_est vide pour les licences attribuées avant l'introduction de ce champ. Le rapport de facturation affiche plusieurs lignes pour le même forfait de gros s'il est associé à différentes combinaisons de LOCATION_ID et LICENSE_ID. |
CLIENT, UTILISATEUR |
Réconciliation, point à un instant donné |
|
RAPPORT_DATE |
Date et heure de génération du rapport. |
CLIENT, UTILISATEUR |
Point dans le temps |
L'attribution d'un forfait à un utilisateur déclenche la facturation Webex Wholesale, tandis que la suppression de cette attribution l'arrête.
