Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un partenaire crée un transfert vers le partenaire actuel d’un client. Le partenaire actuel ou source accepte le transfert et le soumet pour terminer le transfert.
TransferEntity
Décrit une entité de transfert pour les nouveaux transferts commerciaux.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| id | ficelle | Identificateur de transferEntity fourni après la création réussie du transferEntity. |
| statut | ficelle | État du transferEntity. Les valeurs possibles sont « Active » (peut être supprimée/envoyée) et « Completed » (a déjà été terminé). Appliqué lors de la création réussie de transferEntity. |
| type de transfert | ficelle | Nombre représentant le type de transfert. 3 correspond à ModernAzure et 5 correspond à NewCommerce. Les partenaires réalisant des transferts commerciaux directs entre partenaires peuvent utiliser l'une ou l'autre méthode mais devraient se standardiser sur la méthode 5. |
| customerEmailId | ficelle | Identifie l’e-mail du client utilisé pour les notifications. |
| heureDeCréation | Date/Heure | Date de création de transferEntity au format date-heure. Appliqué lors de la création réussie de transferEntity. |
| heure de dernière modification | Date/Heure | Date de la dernière mise à jour du transferEntity, au format date-heure. Appliqué lors de la création réussie de transferEntity. |
| heureDeAchèvement | Date/Heure | Date à laquelle le transferEntity a été complété, sous le format date-heure. Appliqué suite à la réussite du transfert d'entité. |
| clientNom | ficelle | facultatif. Nom du client dont les abonnements sont transférés. |
| customerTenantId | ficelle | ID client au format GUID qui identifie le client. Appliqué lors de la création réussie de transferEntity. |
| partnertenantid | ficelle | ID de partenaire au format GUID qui identifie le partenaire. |
| sourcePartnerName | ficelle | facultatif. Nom de l’organisation du partenaire qui lance le transfert. |
| targetPartnerName | ficelle | facultatif. Nom de l’organisation du partenaire auquel le transfert est ciblé. |
| partnerOnRecord | ficelle | facultatif. Le partenaire de référence des fournisseurs indirects attribue les articles transférés. |
| typesDeProduitsCiblés | ficelle | facultatif. Une collection de chaînes qui déterminent les types d’abonnements pouvant être soumis pour un transfert. Null est supposé pour tous les types. Les valeurs peuvent inclure AzureSubscription, AzureReservation, AzureSavingsPlan et OnlineServicesNCE, Software, SaaS. |
| targetPartnerTenantId | ficelle | ID de partenaire au format GUID qui identifie le partenaire auquel le transfert est ciblé. |
| Identifiant de courriel du partenaire cible | ficelle | ID de partenaire au format GUID qui identifie le partenaire auquel le transfert est ciblé. Cet ID est identique à targetPartnerTenantId |
| transferDirection | ficelle | Nombre représentant la direction du transfert. 1 représente un transfert entrant pour le partenaire qui accepte le transfert. Pour le partenaire qui crée le transfert, 2 représente le transfert sortant. |
| ignorerVérificationD'éligibilité | ficelle | Cette valeur doit être false. |
| dernierUtilisateurModifié | ficelle | ID d’utilisateur au format GUID qui identifie le dernier utilisateur pour modifier le transfert |
| lineItems | Tableau d’objets | Une liste de ressources TransferLineItem. |
TransferLineItem
Représente un élément contenu dans une nouvelle entité de transfert commercial. Les partenaires sources voient les éléments de ligne pour le transfert d’éléments qu’ils tentent de transférer. Les partenaires cibles voient les éléments de ligne nouvellement créés une fois qu’ils sont terminés. Les partenaires cibles peuvent utiliser les identifiants d’élément de ligne pour mieux comprendre les abonnements nouvellement créés résultant du transfert.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| id | ficelle | Identificateur unique d’un élément de ligne de transfert. Appliqué lors de la création réussie de transferEntity. |
| nom convivial | ficelle | Nom de l’abonnement. |
| ID d'abonnement | ficelle | Identificateur de l’abonnement. |
| quantité | Int | Nombre de licences ou d’instances. |
| cycle de facturation | Objet | Type de cycle de facturation défini pour la période actuelle. |
| type de produit | ficelle | Chaîne représentant le type de produit transféré. |
| statut | ficelle | L'état de l'élément de ligne dans l'entité de transfert. |
| dateDebutTermeSourceAbonnement | date et heure | Cette valeur représente la date et l’heure de création (en UTC) de l’abonnement source transféré au partenaire cible. |
| prix | liste des prix | Collection de valeurs de prix pour un élément de ligne de transfert achevé. Applicable uniquement aux nouveaux éléments de ligne de transfert basés sur les licences commerciales. |
Prix
Le prix représente les valeurs qui expliquent le coût des éléments de ligne. Il existe quatre valeurs incluses dans le prix.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| prix catalogue | nombre à virgule flottante | Prix unitaire unique pour la période de facturation suivante sans appliquer de modificateurs de prix. Ce montant est avant impôt. Dans les pays/régions inclusifs fiscaux, ce prix inclut la taxe ; sinon, pas. Prix unitaire par période de facturation. Applicable uniquement aux nouveaux éléments de ligne de transfert basés sur les licences commerciales. |
| prix réduit | nombre à virgule flottante | ListPrice après avoir appliqué tous les modificateurs de prix applicables. Ce montant est avant impôt. Dans les pays/régions inclusifs fiscaux, ce prix inclut la taxe ; sinon, pas. Applicable uniquement aux nouveaux éléments de ligne de transfert basés sur les licences commerciales. |
| prix | nombre à virgule flottante | Montant des frais unitaires au prorata pour le cycle de facturation restant. Prix de la quantité unique dans la devise de facturation cible après que toutes les remises ont été appliquées et que toute proration a été effectuée. Ce montant est avant impôt. Dans les pays/régions inclusifs fiscaux, ce prix inclut la taxe ; sinon, pas. Il s’agit de UnitPrice dans l’expérience utilisateur. Montant de la facture d’unité suivante. Applicable uniquement aux nouveaux éléments de ligne de transfert basés sur les licences commerciales. |
| extendedPrice | nombre à virgule flottante | Prix de l’article de ligne avec quantité, remises et proration appliquées, dans la devise de facturation cible. Pour le reste du terme. Ce montant est avant impôt. Dans les pays/régions inclusifs fiscaux, ce prix inclut la taxe ; sinon, pas. Il s’agit de TotalPrice dans l’expérience utilisateur. Applicable uniquement aux nouveaux éléments de ligne de transfert basés sur les licences commerciales. |
| code de devise | ficelle | Abréviation de la devise de tarification. Applicable uniquement aux nouveaux éléments de ligne de transfert basés sur les licences commerciales. |
TransferEntity pour les transferts basés sur des licences traditionnels
Décrit une EntitéDeTransfert.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| id | ficelle | Un identificateur de transferEntity fourni lors de la création réussie du transferEntity. |
| createdTime | Date/Heure | Date de création de transferEntity au format date-heure. Appliqué lors de la création réussie de transferEntity. |
| heure de dernière modification | Date/Heure | Date de la dernière mise à jour du transferEntity, au format date-heure. Appliqué lors de la création réussie de transferEntity. |
| dernierUtilisateurModifié | ficelle | Utilisateur qui a mis à jour le transferEntity pour la dernière fois. Appliqué lors de la création réussie de transferEntity. |
| nomClient | ficelle | facultatif. Nom du client dont les abonnements sont transférés. |
| customerTenantId | ficelle | ID client au format GUID qui identifie le client. Appliqué lors de la création réussie de transferEntity. |
| partnertenantid | ficelle | ID de partenaire au format GUID qui identifie le partenaire. |
| sourcePartnerName | ficelle | facultatif. Nom de l’organisation du partenaire qui lance le transfert. |
| sourcePartnerTenantId | ficelle | ID de partenaire au format GUID qui identifie le partenaire qui lance le transfert. |
| targetPartnerName | ficelle | facultatif. Nom de l’organisation du partenaire auquel le transfert est ciblé. |
| targetPartnerTenantId | ficelle | ID de partenaire au format GUID qui identifie le partenaire auquel le transfert est ciblé. |
| lineItems | Tableau d’objets | Une liste de ressources TransferLineItem. |
| statut | ficelle | État du transferEntity. Les valeurs possibles sont « Active » (peut être supprimée/envoyée) et « Completed » (a déjà été terminé). Appliqué lors de la création réussie de transferEntity. |
TransferLineItem pour les transferts basés sur des licences traditionnelles
Représente un élément contenu dans un transferEntity.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| id | ficelle | Identificateur unique d’un élément de ligne de transfert. Appliqué lors de la création réussie de transferEntity. |
| ID d'abonnement | ficelle | Identificateur de l’abonnement. |
| quantité | Int | Nombre de licences ou d’instances. |
| cycle de facturation | Objet | Type de cycle de facturation défini pour la période actuelle. |
| nom convivial | ficelle | facultatif. Nom convivial de l’élément défini par le partenaire pour aider à lever l’ambiguïté. |
| partnerIdOnRecord | ficelle | PartnerId sur enregistrement sur l’achat qui se produit lorsque le transfert est accepté. |
| identifiant d'offre | ficelle | Identificateur de l’offre. |
| éléments de module complémentaire | Liste des objets TransferLineItem | Collection d’éléments de ligne transferEntity pour les compléments transférés avec l’abonnement de base en cours de transfert. Appliqué lors de la création réussie de transferEntity. |
| erreur de transfert | ficelle | Appliqué après que transferEntity est accepté, en cas d’erreur. |
| statut | ficelle | L'état de l'élément de ligne dans l'entité de transfert. |
RésultatSoumettreTransfert
Représente le résultat d’une acceptation de transfert pour les transferts basés sur des licences traditionnelles.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| ordres | Liste des objets Order. | Collection de commandes. |
| erreurs de transfert | Liste des objets TransferError . | Collection d’erreurs de transfert. |
TransferError
Représente une erreur qui se produit lorsqu’un transfert basé sur une licence traditionnelle est accepté.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| transferGroupId | ficelle | ID du groupe de commande de la commande avec l’erreur. |
| code | Int | Code d’erreur. |
| descriptif | ficelle | Description de l'erreur. |
| lineItems | Liste des objets TransferLineItem | Collection d’éléments de ligne transferEntity qui font partie de l’erreur de transfert. |
TransferErrorCode
[Enum/dotnet/api/system.enum) avec des valeurs qui indiquent un type d’erreur d’ordre pour les transferts traditionnels basés sur des licences.
| Valeur | Poste | Descriptif |
|---|---|---|
| PartnerTokenMissing | 800001 | Jeton de partenaire manquant dans le contexte de la requête. |
| EntréeInvalide | 800002 | Entrée de demande non valide. |
| ServiceException | 800003 | Erreur de service inattendue. |
| InvalidOfferId | 800004 | ID d’offre non valide. |
| ErreurDeCréationDeCommande | 800005 | La création de l'ordre a échoué. |
| MpnIdNotFound | 800015 | PartnerID est introuvable. |
| NotValidIndirectResellerMpnId | 800016 | PartnerID n’est pas un revendeur indirect valide. |
| IdentifiantDeTransfertIntrouvable | 900100 | Demande de transfert introuvable. |
| TransfertNonAutoriséSiLeStatutEstEnCours | 900101 | La demande de transfert est déjà en cours. |
| TransfertNonAutoriséSiStatutTerminé | 900102 | La demande de transfert est déjà terminée. |
| ErreurDeCréationDeCommandeDeTransfert | 900103 | La commande de transfert n’est pas réussie. |
| TransfertTraitéParUneAutreDemande | 900104 | Le transfert est en cours de traitement par une autre requête. |