> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # API du CRM | Produits > Dans HubSpot, les produits représentent les biens ou les services que vous vendez. Les points de terminaison des produits vous permettent de gérer et de synchroniser ces données. export const postmanIcon = ; export const ScopesList = ({scopes = [], description = "Cette API requiert l'une des portées suivantes :"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return

{description}

{sortedScopes.map((scope, index) =>


              {scope}

)}

; };

# Produits

Dans HubSpot, les produits représentent les biens ou les services que vous vendez. La création d'une [bibliothèque de produits](https://knowledge.hubspot.com/fr/products/create-and-manage-products) 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 CRM de HubSpot. 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](/docs/guides/crm/understanding-the-crm). **Exemple de cas d'utilisation :** afin que les commerciaux puissent facilement ajouter des biens et des services aux transactions, 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 requête `POST` à `crm/v3/objects/products`. Dans le corps de la requête, incluez un objet `properties` contenant 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 requête `PATCH` vers le même point de terminaison. Pour voir toutes les propriétés de produit disponibles, effectuez une requête `GET` à l'API [Propriétés](/docs/api-reference/crm-properties-v3/guide). Pour récupérer les propriétés du produit, l'URL de la requête sera `/crm/v3/properties/products`. ```json theme={null} { "properties": { "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](/docs/api-reference/crm-line-items-v3/guide) 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. ### Remarque : Les lignes de produit appartiennent à un seul objet parent. Si vous associez des objets, les lignes de produit doivent être individuelles à chaque objet. Par exemple, si vous créez une transaction et un devis, vous devez créer un ensemble de lignes de produit pour la transaction et un autre ensemble pour le devis. Cela aidera à rationaliser les données CRM entre les objets et à prévenir la perte de données inattendue lorsque vous devez modifier des lignes de produit. Par exemple, la suppression d'un devis supprimera également les lignes de produit du devis. Si ces lignes de produit sont également associées à une transaction, les lignes de produit de la transaction seront également supprimées. ### 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 requête `GET` à l'API [Propriétés](/docs/api-reference/crm-properties-v3/guide). 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. ```json theme={null} { "properties": { "quantity": 1, "hs_object_id": "1234567", //the object ID of the product "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](/docs/api-reference/crm-associations-v4/guide). 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 requête `PUT` à `/crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663`. Cette requête utilise le type d'association par défaut. Une réponse `200` renverra des informations similaires à celles-ci : ```json theme={null} { "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 requête de création de ligne de produit. Pour créer la ligne de produit, effectuez une requête `POST` à `crm/v3/objects/line_item`. Le corps de votre requête ressemblera à ce qui suit. Notez que le `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](/docs/api-reference/crm-associations-v4/guide#association-type-id-values). ```json theme={null} { "properties": { "quantity": 1, "hs_object_id": "1234567", //the object ID of the product "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