> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt > Use this file to discover all available pages before exploring further. # CRM-API | Produkte > **[Run in Postman](https://app.getpostman.com/run-collection/b4ad6241d1138c449a57)** > **Bereichsanforderungen** # Produkte In HubSpot stellen Produkte die Waren oder Dienstleistungen dar, die Sie verkaufen. Durch das Erstellen einer [Produktbibliothek](https://knowledge.hubspot.com/de/products/create-and-manage-products) können Sie schnell Produkte zu Deals hinzufügen, Angebote erstellen und Berichte zur Produkt-Performance erstellen. Produkt-Endpunkte ermöglichen es Ihnen, diese Daten zu verwalten und zwischen HubSpot und anderen Systemen zu synchronisieren. Produkte stellen zusammen mit Unternehmen, Kontakten, Deals, Tickets, Artikeln und Angeboten Objekte im HubSpot-CRM dar. In unserem Leitfaden [Grundlegendes zum CRM](https://developers.hubspot.de/docs/guides/crm/understanding-the-crm) finden Sie Informationen zu Objekteigenschaften, -zuordnungen, -beziehungen und mehr. **Beispiel für einen Anwendungsfall:** Damit Vertriebsmitarbeiter problemlos Waren oder Dienstleistungen zu Deals, Angeboten und mehr hinzufügen können, verwenden Sie die Produkte-API, um Ihren Produktkatalog in HubSpot zu importieren. ## Produkt erstellen Um ein Produkt zu erstellen, führen Sie eine `POST`-Anfrage an `crm/v3/objects/products` durch. Berücksichtigen Sie im Anfragetext ein `properties`-Objekt, das alle Produkteigenschaften enthält, die Sie beim Erstellen festlegen möchten. Sie können die Eigenschaften eines Produkts später durch eine `PATCH`-Anfrage an denselben Endpunkt aktualisieren. Um alle verfügbaren Produkteigenschaften anzuzeigen, führen Sie eine `GET`-Anfrage an die [Eigenschaften-API](https://developers.hubspot.de/docs/api-reference/crm-properties-v3/guide.md) durch. Um Produkteigenschaften abzurufen, lautet die Anfrage-URL `/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" } } ``` > [!NOTE] > > Beachten Sie, dass der Wert für `hs_recurring_billing_period` als `P#M` formatiert ist, wobei # die Anzahl der Monate ist. ## Produkte zuordnen Produkte selbst können nicht mit anderen CRM-Objekten verknüpft werden. Um jedoch die Informationen eines Produkts mit einem Deal oder einem Angebot zu verknüpfen, können Sie einen [Artikel](https://developers.hubspot.de/docs/api-reference/crm-line-items-v3/guide.md) basierend auf diesem Produkt erstellen. Artikel sind einzelne Instanzen von Produkten und stellen ein separates Objekt von Produkten dar, sodass Sie die Waren und Dienstleistungen in einem Deal oder Angebot nach Bedarf anpassen können, ohne das Produkt selbst aktualisieren zu müssen. Wenn Sie beispielsweise einen Deal zusammenstellen, bei dem eines Ihrer Produkte verkauft wird, erstellen Sie in der Regel zunächst einen Artikel aus dem Produkt und ordnen ihn dann dem Deal zu. Sie können dies entweder mit zwei separaten Aufrufen oder mit einem Aufruf tun, der den Artikel erstellt und zuordnet. Beide Optionen sind unten dargestellt. > [!WARNING] > > ### Hinweis: > > Artikel gehören zu einem einzelnen übergeordneten Objekt. Wenn Objekte zugeordnet werden, sollten Artikel für jedes Objekt individuell sein. Wenn Sie beispielsweise einen Deal und ein Angebot erstellen, sollten Sie einen Satz von Artikeln für den Deal und einen anderen Satz für das Angebot erstellen. Dies trägt dazu bei, CRM-Daten über Objekte hinweg zu optimieren und unerwarteten Datenverlust zu verhindern, wenn Artikel geändert werden müssen. Wenn Sie beispielsweise ein Angebot löschen, werden auch die Artikel des Angebots gelöscht. Wenn diese Artikel auch mit einem Deal verknüpft sind, werden auch die Artikel des Deals gelöscht. ### Einen Artikel erstellen und zuordnen (mehrere Aufrufe) Zuerst erstellen Sie einen Artikel basierend auf einem Produkt mit der ID `1234567`. Um eine vollständige Liste der verfügbaren Artikeleigenschaften zu erhalten, führen Sie eine `GET`-Anfrage an die [Eigenschaften-API](https://developers.hubspot.de/docs/api-reference/crm-properties-v3/guide.md) durch. Die URL für Artikel wäre `crm/v3/properties/line_items`. Da Sie den Artikel aus einem vorhandenen Produkt erstellen, übernimmt er Eigenschaftswerte vom Produkt, z. B. den Preis. ```json theme={null} { "properties": { "quantity": 1, "hs_object_id": "1234567", //the object ID of the product "name": "New line item (product-based)" } } ``` Die Antwort gibt eine Antwort-ID zurück, die Sie verwenden können, um sie über die [Zuordnungen-API](https://developers.hubspot.de/docs/api-reference/crm-associations-v4/guide.md) einem Deal zuzuordnen. Nehmen Sie für dieses Beispiel an, dass die zurückgegebene Artikel-ID `7791176460` ist. Um den Artikel einem bestehenden Deal (ID: `14795354663`) zuzuordnen, führen Sie eine `PUT`-Anfrage an `/crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663` durch. Diese Anfrage verwendet den Standardzuordnungstyp. Eine `200`-Antwort gibt Informationen zurück, die den folgenden ähneln: ```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" } ``` In HubSpot zeigt der Deal-Datensatz den Artikel in der *Artikel*-Karte an. ![deal-record-line-item-association](https://www.hubspot.de/hubfs/Knowledge_Base_2023/deal-record-line-item-association.png) ### Einen Artikel erstellen und zuordnen (einzelner Aufruf) Um einen Artikel aus einem vorhandenen Produkt zu erstellen und ihn einem Deal mit einem einzigen Anruf zuzuordnen, können Sie ein `associations`-Array in die Anfrage zum Erstellen eines Artikels einfügen. Um den Artikel zu erstellen, führen Sie eine `POST`-Anfrage an `crm/v3/objects/line_item` durch. Ihr Anfragetext sieht wie folgt aus. Beachten Sie, dass die `associationTypeId` für die Artikel-Deal-Zuordnung `20` ist. Erfahren Sie mehr über [Zuordnungstypen zwischen verschiedenen Typen von CRM-Datensätzen](https://developers.hubspot.de/docs/api-reference/crm-associations-v4/guide.md#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 } ] } ] } ``` Eine `200`-Antwort gibt Details zum neuen Artikel zurück. In HubSpot zeigt der Deal-Datensatz den Artikel in der *Artikel*-Karte an. ![deal-record-line-item-association](https://www.hubspot.de/hubfs/Knowledge_Base_2023/deal-record-line-item-association.png)