Ressources TransferEntity
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. |