Rapprochement de facturation

Les administrateurs partenaires peuvent utiliser les API de facturation Wholesale pour générer des rapports de facturation personnalisés qui affichent la consommation d’utilisation au niveau du partenaire, du client ou de l’utilisateur. Les partenaires peuvent utiliser ces informations pour rapprocher leur facture mensuelle afin qu’ils puissent facturer leurs clients et utilisateurs en fonction de leur consommation d’utilisation.

Les partenaires peuvent également générer des rapports de facturation personnalisés pour les sous-partenaires en utilisant le paramètre SubPartnerOrgId.

Quatre API sont disponibles pour les administrateurs partenaires qui répondent aux exigences d'accès minimum.

API de facturation

Objectif de l’API

Exigence d’accès administrateur du partenaire

Créer un rapport de facturation Wholesale

Utilisé pour générer un rapport de facturation.

Lecture/écriture

Obtenir un rapport de facturation Wholesale

Utilisé pour obtenir un rapport de facturation généré à télécharger.

Lu(s)

Lister les rapports de facturation Wholesale

Utilisé pour lister les rapports de facturation qui existent pour ce partenaire.

Lu(s)

Supprimer un rapport de facturation Wholesale

Utilisé pour supprimer un rapport de facturation existant.

Lecture/écriture

Source des données

Les données des rapports de facturation sont extraites des données de consommation d’utilisation que Webex suit pour chaque partenaire. Chaque jour, Webex suit la consommation d’utilisation de la veille pour tous les partenaires, clients et utilisateurs et agrège les données afin qu’elles puissent être utilisées pour générer la facture mensuelle du partenaire. Les API de facturation tirent parti de ces données, permettant aux administrateurs partenaires de générer des rapports personnalisés afin que le partenaire puisse rapprocher la consommation d’utilisation de sa facture mensuelle au niveau du partenaire, du client et de l’utilisateur.

Pour plus d’informations sur la façon dont Webex facture les partenaires, voir Facturation du fournisseur de services.

Créer un rapport de facturation Wholesale

Utilisez cette procédure pour générer un rapport de facturation personnalisé que vous pouvez utiliser pour rapprocher votre facturation.
1

Allez à l’API Créer un rapport de facturation Wholesale.

2

Saisissez la période de facturation en saisissant les valeurs pour la DateDébutFacturation et la DateFinFacturation dans le format spécifié par l’API. Vous pouvez saisir n'importe quelle date des cinq dernières années, mais pas la date actuelle.

3

Saisissez le Type de rapport :

  • PARTENAIRE (ceci est la valeur par défaut)—Affiche la consommation d'utilisation au niveau du partenaire.
  • CLIENT—Affiche la consommation totale d'utilisation détaillée au niveau des organisations des clients sous le partenaire.
  • UTILISATEUR—Affiche la consommation totale de l'utilisation détaillée au niveau des organisations des clients et des utilisateurs sous le partenaire.
4

Cliquez sur Exécuter pour générer le rapport.

5

Copiez l'id du rapport à partir de la sortie de l'API. Vous pouvez utiliser cette valeur avec l’API Get afin d’obtenir le rapport de facturation généré.

Que faire ensuite

Allez à Obtenir un rapport de facturation Wholesale pour télécharger une copie du rapport.

Obtenir un rapport de facturation Wholesale

Une fois qu’un rapport de facturation est généré, utilisez cette API pour obtenir un rapport de facturation spécifique. Le rapport obtient une sortie vers une URL où il est disponible pour le téléchargement pendant 30 minutes après la fin de la demande GET.
1

Allez à l’API Obtenir un rapport de facturation Wholesale.

2

Dans la ligne GET , cliquez sur le bouton id et saisissez la valeur d'id unique pour le rapport.

3

Cliquez sur À vide.

4

L’état des sorties de l’API. La sortie inclut le paramètre tempDownloadURL , qui fournit une URL à partir de laquelle vous pouvez télécharger le rapport.

5

Copiez tempDownloadURL dans un navigateur pour accéder et télécharger le rapport.

Lister les rapports de facturation Wholesale

Utilisez cette API pour obtenir une liste des rapports de facturation générés pour l’organisation partenaire. Vous pouvez lister 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 renvoie uniquement les rapports qui correspondent exactement aux paramètres que vous saisissez. Par exemple, si vous saisissez une période de facturation, seuls les rapports qui utilisent cette période de facturation spécifique sont renvoyés. Les rapports qui se situent dans la période, mais qui ne correspondent pas exactement aux dates ne sont pas renvoyés.
1

Aller à l’API de rapport de facturation Wholesale

2

Sous Paramètres de requête, saisissez les paramètres de recherche que vous souhaitez utiliser (par exemple, la date de début, la date de fin, le type, le tri). Pour plus de détails sur ces paramètres, consultez l'aide du développeur sur l'API.

3

Cliquez sur À vide.

L'API génère la liste des rapports ainsi que l'ID et le statut du rapport unique (TERMINÉ, EN_COURS).

Que faire ensuite

Prenez un enregistrement de l'id pour tous les rapports que vous souhaitez télécharger. Allez à Obtenir un rapport de facturation Wholesale pour télécharger le rapport.

Supprimer un rapport de facturation Wholesale

Utilisez cette procédure pour supprimer un rapport de facturation généré en fonction de l’ID du rapport. Voici quelques exemples où vous pouvez vouloir supprimer un rapport :

  • Si vous souhaitez générer à nouveau un rapport de facturation existant, vous devez préalablement supprimer le rapport existant. Après avoir supprimé le rapport existant, vous pouvez créer un nouveau rapport pour cette période. Notez que l'exigence de suppression n'existe pas si le rapport a échoué ou est en cours.

  • Si un rapport est généré et que vous envoyez l'URL à la mauvaise personne, vous pouvez supprimer le rapport et elle ne pourra pas y accéder.

1

Allez à l’API Supprimer le rapport de facturation Wholesale.

2

Saisissez l'ID du rapport.

3

Cliquez sur À vide.

Champs du rapport de facturation

Les rapports de facturation contiennent les champs suivants :

Champ

Informations complémentaires

Apparaît dans les rapports de ce type

NOM_DU PARTENAIRE

Nom du partenaire

partenaire,client,utilisateur

ID_DE L’ORGANISATION_ PARTENAIRE

Identifiant unique du partenaire

partenaire,client,utilisateur

IDENTIFIANT D’ABONNEMENT_

Identifiant d’abonnement unique

partenaire,client,utilisateur

NOM_DU SERVICE

Nom du service

(par exemple, COMMON_AREA_CALLING, WEBEX_CALLING, WEBEX_SUITE, WEBEX_MEETINGS)

partenaire,client,utilisateur

RÉF

Réf pour le service

partenaire,client,utilisateur

description

Description de la prestation

partenaire,client,utilisateur

DATE_DÉBUT_DE LA CONSOMMATION

Début de la consommation du service. En même temps que le champ ci-dessous, cette valeur définit la période d'utilisation.

partenaire,client,utilisateur

DATE_FIN_DE CONSOMMATION

Fin de la consommation du service. En même temps que le champ ci-dessus, cette valeur définit la période de consommation de l'utilisation.

partenaire,client,utilisateur

quantité

Représente la consommation agrégée de l'utilisation des utilisateurs par partenaire, par client ou par utilisateur (en fonction du rapport et du niveau auquel vous consultez les données).

Calcul :

Pour chaque utilisateur, la quantité par jour est calculée au prorata pour ce jour. Par exemple :

Utilisation sur une journée complète = 1

Utilisation sur une demi-journée = 0,5

Les totaux quotidiens pour tous les jours de la période de facturation sont additionnés pour fournir une quantité totale pour cet utilisateur pendant cette période de facturation.

Pour les rapports au niveau des clients et des partenaires, les totaux de tous les utilisateurs sont agrégés pour fournir une quantité totale pour ce client ou ce partenaire.

partenaire,client,utilisateur

ID_DE L’ORGANISATION_ DU CLIENT

Identifiant unique du client interne

client, utilisateur

ID_EXTERNE_DU CLIENT

Identifiant unique du client fourni par un partenaire

client, utilisateur

ID_D’ABONNÉ

Identifiant unique de l'abonné

UTILISATEUR

IDUTILISATEUR_

L’ID utilisateur Webex de l’abonné

UTILISATEUR

ID_DE L’ESPACE DE TRAVAIL

Identifiant unique de l’espace de travail

UTILISATEUR

ID_DE L’EMPLACEMENT

Identificateur d’emplacement unique

client, utilisateur

La facturation de Webex Wholesale est déclenchée par le provisionnement d’un pack à un utilisateur ou est interrompue par la suppression de l’affectation du pack.