Merci pour votre commentaire.
Un commentaire ?Rapports de facturation
Les partenaires peuvent utiliser les API de facturation de gros suivantes pour générer des rapports de facturation qui les aident à valider l'exactitude de l'utilisation et de l'approvisionnement. Les API de facturation de gros sont accessibles via developer.webex.com.
-
Réconciliation : 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 leur facture mensuelle afin de facturer leurs clients et utilisateurs en fonction de leur consommation d'utilisation.
-
Point dans le temps : affiche les allocations de forfaits actuelles par client ou par utilisateur. Le rapport Point-In-Time fournit un décompte en temps réel des allocations de forfaits. Les partenaires peuvent utiliser ces informations pour valider l' exactitude de l'approvisionnement et garantir l'alignement avec les commandes des clients.
Les partenaires peuvent également générer des rapports de facturation personnalisés pour leurs sous-partenaires à l'aide du paramètre SubpartnerOrgID.
Quatre API sont mises à la disposition des administrateurs partenaires qui répondent aux exigences d'accès minimales.
|
API de facturation |
Objectif de l'API |
Conditions d'accès pour les administrateurs partenaires |
|---|---|---|
|
Créer un rapport de facturation pour la vente en gros |
Utilisé pour générer un rapport de facturation. |
Lire/écrire |
|
Obtenir un rapport de facturation de gros |
Utilisé pour obtenir un rapport de facturation généré à télécharger. |
Lire |
|
Répertorier les rapports de facturation de gros |
Utilisé pour répertorier les rapports de facturation existants pour ce partenaire. |
Lire |
|
Supprimer un rapport de facturation de gros |
Utilisé pour supprimer un rapport de facturation existant. |
Lire/écrire |
Source de données
Les données des rapports de facturation sont extraites des attributions de forfaits et des données d'utilisation que Webex suit pour chaque partenaire. Webex regroupe quotidiennement les données des clients et des utilisateurs sur les packages pour générer la facture mensuelle du partenaire. Les API de facturation utilisent ces données pour permettre aux administrateurs partenaires de générer des rapports personnalisés. Ces rapports aident les partenaires à comparer leur consommation d'utilisation avec leur facture mensuelle au niveau du partenaire, du client et de l'utilisateur.
Pour plus d'informations sur la manière dont Webex facture ses partenaires, voir Facturation des fournisseurs de services.
Créer un rapport de facturation pour la vente en gros
| 1 |
Sur developer.webex.com, accédez à l'API Create a Wholesale Billing Report. |
| 2 |
Sélectionnez l'une des catégories de rapports suivantes :
Si vous souhaitez générer un rapport de réconciliation, il n'est pas nécessaire de modifier quoi que ce soit car la réconciliation est sélectionnée par défaut. Vous pouvez donc passer à l'étape suivante. Si vous souhaitez générer un rapport ponctuel, modifiez la sélection en Point-In-Time. |
| 3 |
Entrez BillingStartDate et BillingEndDate dans le format spécifié par l'API. Vous pouvez saisir n'importe quelle date des cinq dernières années, mais pas le jour en cours. 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 les allocations actuelles des forfaits. |
| 4 |
Entrez le type de rapport :
|
| 5 |
Dans le champ Inclure, saisissez les colonnes supplémentaires ou facultatives que vous souhaitez voir apparaître dans les rapports. Chaque type de rapport possède un ensemble d'attributs obligatoires et un ensemble d'attributs facultatifs. Vous pouvez choisir les attributs facultatifs à afficher pour chaque rapport. Si vous n'incluez pas les attributs facultatifs, le rapport n'affiche que les attributs obligatoires. Les colonnes suivantes contiennent les attributs facultatifs que vous pouvez demander à inclure dans le rapport sur les clients et les utilisateurs :
Vous devez CUSTOMER_GROUP_ID les inclure CUSTOMER_GROUP_NAME ensemble si vous voulez voir ces attributs dans votre rapport. Lorsque vous sélectionnez des colonnes facultatives, l'ordre des colonnes dans les rapports de rapprochement entre clients et utilisateurs change. Les partenaires doivent mettre à jour l'intégration de leur API pour accepter le nouveau format CSV. L'ordre des colonnes des rapports ponctuels reste inchangé. Actuellement, les paramètres des fonctionnalités existants ont priorité sur le paramètre Include lorsqu'il s'agit de déterminer l'ordre des colonnes. Par exemple, si un paramètre de fonctionnalité particulier est activé pour un client, cette colonne de fonctionnalités apparaît selon l'ancien format de rapport, même si vous les ajoutez dans le paramètre Include. Nous allons bientôt supprimer ces paramètres. Une fois supprimées, vous pouvez demander les colonnes facultatives uniquement via le paramètre Include. |
| 6 |
Cliquez sur Exécuter pour générer le rapport. |
| 7 |
Copiez l'identifiant du rapport depuis 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
Accédez à la section Obtenir un rapport de facturation en gros pour télécharger une copie du rapport.
Obtenir un rapport de facturation pour la vente en gros
Une fois le rapport de facturation généré, utilisez cette API pour obtenir un rapport de facturation spécifique. Le rapport est affiché sur une URL où il est disponible en téléchargement pendant 30 minutes après la fin de la demande GET.
| 1 |
Sur developer.webex.com, accédez à l'API Get a Wholesale Billing Report. |
| 2 |
Entrez la valeur d'identification unique du rapport et cliquez sur Exécuter. L'API affiche l'état du rapport. La sortie 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 de gros
Utilisez cette API pour obtenir la liste des rapports de facturation générés pour l'organisation partenaire. Vous pouvez répertorier 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 avez spécifiés. Par exemple, si vous spécifiez une période de facturation, seuls les rapports utilisant cette période de facturation spécifique sont renvoyés. Les rapports qui tombent dans cette période, mais qui ne correspondent pas exactement aux dates ne sont pas renvoyés.
| 1 |
Sur developer.webex.com, accédez à l'API List Wholesale Billing Report. |
| 2 |
Dans Paramètres de requête, entrez tous les paramètres de recherche que vous souhaitez utiliser (par exemple, StartDate, EndDate, Type, SortBy activé). |
| 3 |
Cliquez sur Exécuter. L'API affiche la liste des rapports avec l'identifiant et le statut uniques du rapport (TERMINÉ,IN_PROGRESS).
|
Que faire ensuite
Enregistrez l'identifiant de tous les rapports que vous souhaitez télécharger. Accédez à Get a Wholesale billing report pour télécharger le rapport.
Supprimer un rapport de facturation de vente en gros
Suivez cette procédure pour supprimer un rapport de facturation généré en fonction de l'identifiant du rapport. Voici quelques exemples de cas où vous souhaiterez peut-être supprimer un rapport :
-
Si vous souhaitez régénérer un rapport de facturation de rapprochement existant, vous devez d'abord le supprimer. Après avoir supprimé le rapport existant, vous pouvez en créer un nouveau pour cette période. Vous ne pouvez pas supprimer un rapport si sa génération a échoué ou s'il est toujours en cours.
Pour un rapport ponctuel, vous n'avez pas besoin 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 telles qu'elles sont horodatées.
-
Si vous envoyez l'URL d'un rapport généré à la mauvaise personne, vous pouvez supprimer le rapport pour qu'elle n'y ait pas accès.
| 1 |
Sur developer.webex.com, accédez à l'API Supprimer le rapport de facturation en gros. |
| 2 |
Entrez l'identifiant du rapport et cliquez sur Exécuter. |
Champs du rapport de facturation
Les rapports de facturation contiennent les champs suivants :
|
Terrain |
Description |
Type de rapport pris en charge |
Catégorie de rapport prise en charge |
Attribut obligatoire ou facultatif |
|---|---|---|---|---|
|
PARTNER_NAME |
Nom du partenaire |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
PARTNER_ORG_ID |
Identifiant unique du partenaire |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
SUBSCRIPTION_ID |
Identifiant d'abonnement unique |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
CUSTOMER_GROUP_ID | L'identifiant unique du groupe auquel appartient le client. Si le client passe d'un groupe à un autre pendant la période de facturation, l'utilisation est répartie en fonction des groupes auxquels il appartenait pendant cette période. |
CUSTOMER, USER |
Réconciliation ponctuelle |
Facultatif |
|
CUSTOMER_GROUP_NAME | Afficher le nom du groupe de clients. Si le nom du groupe a changé pendant la période de facturation, c'est le dernier nom qui est utilisé. |
CUSTOMER, USER |
Réconciliation ponctuelle |
Facultatif |
|
CUSTOMER_ORG_ID |
Identifiant unique interne du client |
CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
CUSTOMER_EXTERNAL_ID |
Identifiant unique du client fourni par un partenaire |
CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
TYPE |
Type d'utilisateur ou d'espace de travail |
CUSTOMER, USER |
À un moment précis |
Obligatoire |
|
SUBSCRIBER_ID |
Identifiant unique de l'abonné |
USER |
Réconciliation ponctuelle |
Obligatoire |
|
USER_ID |
Le nom d'utilisateur Webex de l'abonné |
USER |
Réconciliation ponctuelle |
Obligatoire |
|
WORKSPACE_ID |
Identifiant unique de l'espace de travail |
USER |
Réconciliation ponctuelle |
Obligatoire |
|
SERVICE_NAME |
Nom du service (par exempleCOMMON_AREA_CALLING,WEBEX_CALLING,WEBEX_SUITE,WEBEX_MEETINGS) |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
SKU |
Du ski pour le service |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
DESCRIPTION |
Description du service |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
CONSUMPTION_START_DATE |
Début de la consommation du service. Avec le champ suivant, cette valeur définit la période d'utilisation. |
PARTNER, CUSTOMER, USER |
Réconciliation |
Obligatoire |
|
CONSUMPTION_END_DATE |
Fin de la consommation du service. Avec le champ précédent, cette valeur définit la période de consommation d'utilisation. |
PARTNER, CUSTOMER, USER |
Réconciliation |
Obligatoire |
|
REPORT_DATE |
La date et l'heure de génération du rapport. |
CUSTOMER, USER |
À un moment précis |
Obligatoire |
|
QUANTITY |
Représente la consommation cumulée des utilisateurs par partenaire, par client ou par utilisateur (selon le rapport et le niveau de consultation des données). Calcul : Le système calcule la quantité par jour pour chaque utilisateur au prorata pour cette journée. Utilisation pendant une journée complète = 1 Utilisation pendant une demi-journée = 0,5 Ensuite, il additionne les totaux quotidiens 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 concernant les clients et les partenaires, les totaux pour tous les utilisateurs sont agrégés afin d'obtenir la quantité totale pour ce client ou ce partenaire. Point-In-Time : Le rapport client répertorie les forfaits alloués par client. Chaque ligne représente la quantité totale d'un package spécifique attribué aux utilisateurs ou aux espaces de travail au sein d'une organisation cliente en particulier. La quantité indique « 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 indique une quantité de 1, représentant un utilisateur ou un espace de travail et son package ou module complémentaire individuel. Si plusieurs packages ou modules complémentaires sont attribués à un utilisateur ou à un espace de travail, le rapport affiche plusieurs entrées, chacune avec une quantité de 1. |
PARTNER, CUSTOMER, USER |
Réconciliation ponctuelle |
Obligatoire |
|
LOCATION_ID |
Identifiant de localisation unique |
CUSTOMER, USER |
Réconciliation ponctuelle Le rapport ponctuel du client n'inclut pas l'identifiant de localisation |
Facultatif |
|
LICENSE_ID |
Identifiant de licence Ce champ n'est visible que pour les forfaits de vente en gros Pour le rapport de réconciliation, le champ License_ID 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 vente en gros s'il est associé à différentes combinaisons de LOCATION_ID etLICENSE_ID. |
CUSTOMER, USER |
Réconciliation ponctuelle |
Facultatif |
La sélection de colonnes facultatives modifie l'ordre des colonnes des rapports de rapprochement entre clients et utilisateurs. L'ordre suivant s'applique aux partenaires dont l'abonnement comprend uniquement des SKU de vente en gros :
Rapport sur le niveau utilisateur : PARTNER_NAME PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME,CUSTOMER_ORG_ID, CUSTOMER_EXTERNAL_IDLOCATION_ID,LICENSE_ID,SUBSCRIBER_ID,USER_ID,WORKSPACE_ID,SERVICE_NAME,, SKU, DESCRIPTIONCONSUMPTION_START_DATE,CONSUMPTION_END_DATE, QUANTITÉ
Rapport sur le niveau client : PARTNER_NAME PARTNER_ORG_IDSUBSCRIPTION_ID,CUSTOMER_GROUP_ID,CUSTOMER_GROUP_NAME, CUSTOMER_ORG_IDCUSTOMER_EXTERNAL_ID,LOCATION_ID,LICENSE_ID,SERVICE_NAME, SKU, DESCRIPTION,CONSUMPTION_START_DATE,CONSUMPTION_END_DATE, QUANTITÉ
La fourniture d'un package à un utilisateur déclenche la facturation de Webex Wholesale, tandis que la suppression de l'attribution du package l'arrête.
Une organisation cliente ne peut appartenir qu'à un seul groupe de clients à la fois. L'assistance pour plusieurs groupes de clients par organisation n'est pas disponible actuellement.
