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.

Créer un produit

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.

// POST request to crm/v3/objects/products { "name": "Implementation Service", "price": "6000.00", "hs_sku": "123456", "description": "Onboarding service for data product", "hs_cost_of_goods_sold": "600.00", "hs_recurring_billing_period": "P12M" }
Notez que la valeur de hs_recurring_billing_period est formatée comme P#M, où # est le nombre de mois.

Associer des produits

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.

Créer et associer une ligne de produit (appels multiples)

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.

// POST request to https://api.hubapi.com/crm/v3/objects/line_item { "properties": { "quantity": 1, "hs_product_id": "1234567", "name": "New line item (product-based)" } }

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 :

// PUT request to crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663 { "status": "COMPLETE", "results": [ { "from": { "id": "14795354663" }, "to": { "id": "7791176460" }, "associationSpec": { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 19 } }, { "from": { "id": "7791176460" }, "to": { "id": "14795354663" }, "associationSpec": { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 20 } } ], "startedAt": "2023-12-21T20:06:52.083Z", "completedAt": "2023-12-21T20:06:52.192Z" }

Dans HubSpot, la fiche d'informations de transaction affichera la ligne de produit dans la carte Lignes de produit.

deal-record-line-item-association

Créer et associer une ligne de produit (appel unique)

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.

// POST request to https://api.hubapi.com/crm/v3/objects/line_item { "properties": { "quantity": 1, "hs_product_id": "1234567", "name": "New line item (product-based)" }, "associations": [ { "to": { "id": "14795354663" }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 20 } ] } ] }

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.

deal-record-line-item-association


Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.