Produits
Dans HubSpot, les produits représentent les biens ou les services que vous vendez. La création d'une bibliothèque de produits vous permet d'ajouter rapidement votre produit aux transactions et de générer des devis ainsi que des rapports sur les performances du produit. Les points de terminaison des produits vous permettent de gérer ces données et de les synchroniser entre HubSpot et d'autres systèmes.
Les produits ainsi que les entreprises, les contacts, les transactions, les lignes de produit et les devis sont des objets dans le HubSpot CRM. Découvrez-en davantage sur les propriétés d'objet, les associations, les relations et bien plus encore dans le guide Comprendre les objets de CRM.
Exemple de cas d'utilisation : afin que les commerciaux puissent facilement ajouter des biens et des services aux offres, devis, etc., utilisez l'API des produits pour importer votre catalogue de produits dans HubSpot.
Pour créer un produit, effectuez une demande POST
à GRC/v3/objects/products
. Dans le corps de la demande, incluez toutes les propriétés du produit que vous souhaitez définir lors de la création. Vous pouvez ensuite mettre à jour les propriétés d'un produit via une demande PATCH
vers le même point de terminaison.
Pour voir toutes les propriétés de produit disponibles, effectuez une demande GET
à l'API Propriétés. Pour récupérer les propriétés du produit, l'URL de la demande sera /crm/v3/properties/products
.
hs_recurring_billing_period
est formatée comme P#M
, où # est le nombre de mois.
Les produits eux-mêmes ne peuvent pas être associés à d'autres objets de CRM. Cependant, pour associer les informations d'un produit à une transaction ou à un devis, vous pouvez créer une ligne de produit en fonction de ce produit. Les lignes de produit sont des instances individuelles de produits, et sont un objet distinct des produits afin que vous puissiez personnaliser les biens et services sur une transaction ou un devis sans avoir besoin de mettre à jour le produit lui-même.
Par exemple, si vous préparez une transaction où l'un de vos produits est vendu, vous devez d'abord créer une ligne de produit à partir du produit, puis l'associer à la transaction. Vous pouvez le faire soit avec deux appels distincts, soit avec un appel qui crée et associe la ligne de produit. Les deux options sont présentées ci-dessous.
Tout d'abord, vous allez créer une ligne de produit basée sur un produit avec l'ID 1234567
. Pour obtenir une liste complète des propriétés de ligne de produit disponibles, effectuez une demande GET
à l'API Propriétés. L'URL pour les lignes de produit sera crm/v3/properties/line_items
. Étant donné que vous créez la ligne de produit à partir d'un produit existant, elle héritera des valeurs de propriété du produit, telles que le prix.
La réponse renverra un ID de ligne de produit que vous pouvez utiliser pour l'associer à une transaction à l'aide de l'API des associations. Pour cet exemple, supposons que l'ID de ligne de produit renvoyé est 7791176460
.
Pour associer la ligne de produit à une transaction existante (ID : 14795354663
), vous devez effectuer une demande PUT
à /crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663
. Cette demande utilise le type d'association par défaut.
Une réponse 200
renverra des informations similaires à ce qui suit :
Dans HubSpot, la fiche d'informations de transaction affichera la ligne de produit dans la carte Lignes de produit.
Pour créer une ligne de produit à partir d'un produit existant et l'associer à une transaction à l'aide d'un seul appel, vous pouvez inclure un tableau associations
dans la demande de création de ligne de produit.
Pour créer une ligne de produit, effectuez une demande POST
à /crm/v3/objects/ligne_de_produit
. Le corps de votre demande ressemblera à ce qui suit. Notez que associationTypeId
pour l'association ligne de produit-transaction est 20
. Découvrez-en davantage sur les types d'association entre les différents types de fiche d'informations de CRM.
Une réponse 200
renverra des détails sur la nouvelle ligne de produit. Dans HubSpot, la fiche d'informations de transaction affichera la ligne de produit dans la carte Lignes de produit.
Merci d'avoir partagé votre avis.