Acheter des éléments de catalogue

Le scénario suivant illustre le processus générique d’achat d’éléments à partir du catalogue à l’aide de l’API espace partenaires.

Découverte

Sélectionnez les produits et les unités de conservation des stocks (SKU) et vérifiez leur disponibilité à l’aide des modèles d’API de l’Espace partenaires suivants :

• Produit : construction de regroupement pour les biens ou services purchasables. Un produit lui-même n’est pas un élément purchasable.
• Référence SKU : référence SKU purchasable sous un produit. Celles-ci représentent les différentes formes du produit.
• Disponibilité : configuration dans laquelle une référence SKU est disponible pour l’achat (par exemple, pays/région, devise et segment du secteur).

Pour acheter un élément à partir du catalogue, procédez comme suit :

1. Identifiez et récupérez le produit et la référence SKU que vous souhaitez acheter.

   • Obtenir la liste des produits
   • Obtenir un produit à l’aide de l’ID de produit
   • Obtenir la liste des références SKU d’un produit
   • Obtenir une référence SKU à l’aide de l’ID de référence SKU

2. Vérifiez l’inventaire d’une référence SKU. Cette étape est uniquement nécessaire pour les références SKU marquées avec une valeur InventoryCheck dans la propriété purchasePrerequisites .

   • Vérifier le stock

3. Récupérez la disponibilité de la référence SKU. Vous aurez besoin du CatalogItemId de la disponibilité lors du placement de la commande. Pour obtenir cette valeur, utilisez l’une des API suivantes :

   • Obtenir la liste des disponibilités d’une référence SKU
   • Obtenir une disponibilité à l’aide de l’ID de disponibilité

Soumission de commande

Pour soumettre votre commande d’élément de catalogue, procédez comme suit :

1. Créez un panier pour contenir la collection d’éléments de catalogue que vous envisagez d’acheter. Lorsque vous créez un panier, les articles de ligne de panier sont automatiquement regroupés en fonction de ce qui peut être acheté ensemble dans la même commande.

   • Créer un panier d’achat
   • Mettre à jour un panier d’achat

2. Découvrez le panier. L’extraction d’un panier entraîne la création d’une commande.

   • Extraire le panier

Obtenir les détails de la commande

Vous pouvez récupérer les détails d’une commande individuelle à l’aide de l’ID de commande ou obtenir une liste de commandes pour un client. Il y a un délai allant jusqu’à 15 minutes entre le moment où une commande est envoyée et quand elle apparaîtra dans une liste des commandes d’un client.

• Consultez Obtenir une commande par ID pour obtenir les détails d’une commande individuelle à l’aide des ID de commande.

• Consultez Obtenir toutes les commandes d’un client pour obtenir la liste des commandes d’un client à l’aide de l’ID client.

• Consultez Obtenir la liste des commandes par client et par type de cycle de facturation pour obtenir une liste de commandes pour un client par type de cycle de facturation vous permettant de répertorier les commandes d’éléments de catalogue (frais ponctuels) et les commandes facturées annuellement ou mensuellement séparément.

Gestion du cycle de vie

Dans le cadre de la gestion du cycle de vie de vos éléments de catalogue dans l’Espace partenaires, vous pouvez récupérer des informations sur vos droits d’élément de catalogue et obtenir des détails de réservation à l’aide de l’ID de commande de réservation. Pour obtenir des exemples de procédure, consultez Obtenir les droits d’utilisation. ​

Facture et rapprochement

Les scénarios suivants vous montrent comment afficher par programmation les factures de votre client et obtenir les soldes et résumés de votre compte qui incluent des frais ponctuels pour les éléments de catalogue.

Solde et paiement

Pour obtenir le solde du compte actuel dans votre type de devise par défaut qui est un solde des frais récurrents et ponctuels (élément de catalogue), consultez Obtenir votre solde de compte actuel.

Solde multi devise et paiement

Pour obtenir votre solde de compte actuel et une collection de résumés de factures contenant un résumé de facture avec des frais récurrents et ponctuels pour chacun des types de devises de votre client, consultez Obtenir des résumés de facture.

Factures

Pour obtenir une collection de factures qui affichent des frais récurrents et ponctuels, consultez Obtenir une collection de factures. ​

Facture unique

Pour récupérer une facture spécifique à l’aide de l’ID de facture, consultez Obtenir une facture par ID. ​

Réconciliation

Pour obtenir une collection de détails d’élément de ligne de facture (éléments de ligne de rapprochement) pour un ID de facture spécifique, consultez Obtenir les éléments de ligne de facture. ​

Télécharger une facture au format PDF

Pour récupérer un relevé de facture au format PDF à l’aide d’un ID de facture, consultez Obtenir un relevé de facture.