Produkte

In HubSpot stellen Produkte die Waren oder Dienstleistungen dar, die Sie verkaufen. Durch das Erstellen einer Produktbibliothek 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 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. Geben Sie im Anfragetext alle Produkteigenschaften an, 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 durch. Um Produkteigenschaften abzurufen, lautet die Anfrage-URL /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" }
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 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 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.

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 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.

// 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)" } }

Die Antwort gibt eine Antwort-ID zurück, die Sie verwenden können, um sie über die Zuordnungen-API 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:

// 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" }

In HubSpot zeigt der Deal-Datensatz den Artikel in der Artikel-Karte an.

deal-record-line-item-association

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.

// 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 } ] } ] }

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


War dieser Artikel hilfreich?
Dieses Formular dient dazu, Feedback zu unserer Entwicklerdokumentation zu sammeln. Wenn Sie uns Ihre Meinung zu HubSpot-Produkten mitteilen möchten, teilen Sie diese bitte im Ideenforum der Community.