Ressources TransferEntity

  • Article

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 un transferEntity pour les nouveaux transferts commerciaux.

Propriété Type Description
id string Identificateur transferEntity fourni lors de la création réussie du transferEntity.
statut string É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.
transferType string Nombre représentant le type de transfert. 3 résout modernAzure et 5 est résolu en NewCommerce. Les partenaires qui exécutent un partenaire pour les nouveaux transferts commerciaux peuvent utiliser l’une ou l’autre, mais doivent normaliser sur 5.
customerEmailId string Identifie l’e-mail du client utilisé pour les notifications.
createdTime Date/Heure Date de création de transferEntity au format date-heure. Appliqué lors de la création réussie de transferEntity.
lastModifiedTime 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.
completedTime Date/Heure Date à laquelle le transferEntity a été terminé, au format date-heure. Appliqué lors de la réussite du transfertEntity.
customerName string facultatif. Nom du client dont les abonnements sont transférés.
customerTenantId string ID client au format GUID qui identifie le client. Appliqué lors de la création réussie de transferEntity.
partnertenantid string ID partenaire au format GUID qui identifie le partenaire.
sourcePartnerName string facultatif. Nom de l’organisation du partenaire qui lance le transfert.
targetPartnerName string facultatif. Nom de l’organisation du partenaire auquel le transfert est ciblé.
targetPartnerTenantId string ID partenaire au format GUID qui identifie le partenaire auquel le transfert est ciblé.
targetPartnerEmailId string Guid mis en forme pid qui identifie le partenaire auquel le transfert est ciblé. Cet ID est identique à targetPartnerTenantId
transferDirection string Nombre représentant la direction du transfert. 1 représente un transfert entrant pour le partenaire qui accepte le transfert. 2 représente le transfert sortant pour le partenaire qui crée le transfert.
ignoreEligibilityCheck string Cette valeur doit être false.
lastModifiedUser string ID d’utilisateur au format GUID qui identifie le dernier utilisateur pour modifier le transfert
lineItems Tableau d’objets Tableau de ressources TransferLineItem .

TransferLineItem

Représente un élément contenu dans un nouveau transferEntity de commerce. 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 ID d’élément de ligne pour comprendre les abonnements nouvellement créés résultant du transfert.

Propriété Type Description
id string Identificateur unique d’un élément de ligne de transfert. Appliqué lors de la création réussie de transferEntity.
subscriptionId string Identificateur de l’abonnement.
quantité int Nombre de licences ou d’instances.
billingCycle Object Type de cycle de facturation défini pour la période actuelle.
productType string Chaîne représentant le type de produit transféré.
statut string État de l’élément de ligne dans transferEntity.

TransferEntity pour les transferts basés sur des licences traditionnels

Décrit un transferEntity.

Propriété Type Description
id string Identificateur 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.
lastModifiedTime 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.
lastModifiedUser string Utilisateur qui a mis à jour le transferEntity pour la dernière fois. Appliqué lors de la création réussie de transferEntity.
customerName string facultatif. Nom du client dont les abonnements sont transférés.
customerTenantId string ID client au format GUID qui identifie le client. Appliqué lors de la création réussie de transferEntity.
partnertenantid string ID partenaire au format GUID qui identifie le partenaire.
sourcePartnerName string facultatif. Nom de l’organisation du partenaire qui lance le transfert.
sourcePartnerTenantId string ID partenaire au format GUID qui identifie le partenaire qui lance le transfert.
targetPartnerName string facultatif. Nom de l’organisation du partenaire auquel le transfert est ciblé.
targetPartnerTenantId string ID partenaire au format GUID qui identifie le partenaire auquel le transfert est ciblé.
lineItems Tableau d’objets Tableau de ressources TransferLineItem .
statut string É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é Type Description
id string Identificateur unique d’un élément de ligne de transfert. Appliqué lors de la création réussie de transferEntity.
subscriptionId string Identificateur de l’abonnement.
quantité int Nombre de licences ou d’instances.
billingCycle Object Type de cycle de facturation défini pour la période actuelle.
friendlyName string facultatif. Nom convivial de l’élément défini par le partenaire pour aider à lever l’ambiguïté.
partnerIdOnRecord string PartnerId sur enregistrement sur l’achat qui se produit lorsque le transfert est accepté.
offerId string Identificateur de l’offre.
addonItems 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.
transferError string Appliqué une fois transferEntity accepté en cas d’erreur.
statut string État de l’élément de ligne dans transferEntity.

TransferSubmitResult

Représente le résultat d’une acceptation de transfert pour les transferts basés sur des licences traditionnelles.

Propriété Type Description
orders Liste des objets Order . Collection de commandes.
transferErrors 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é Type Description
transferGroupId string ID du groupe de commandes de l’ordre avec l’erreur.
code int Code d’erreur.
description string 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 Position Description
PartnerTokenMissing 800001 Jeton partenaire manquant dans le contexte de la demande.
InvalidInput 800002 Entrée de demande non valide.
ServiceException 800003 Erreur de service inattendue.
InvalidOfferId 800004 ID d’offre non valide.
CreateOrderError 800005 L’ordre de création n’est pas réussi.
MpnIdNotFound 800015 PartnerID est introuvable.
NotValidIndirectResellerMpnId 800016 PartnerID n’est pas un revendeur indirect valide.
TransferIdNotFound 900100 Demande de transfert introuvable.
TransferNotAllowedIfStatusIsInProgress 900101 La demande de transfert est déjà en cours.
TransferNotAllowedIfStatusIsCompleted 900102 La demande de transfert est déjà terminée.
TransferCreateOrderError 900103 La commande de transfert n’est pas réussie.
TransferProcessedByAnotherRequest 900104 Le transfert est en cours de traitement par une autre requête.