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.
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
.
hs_recurring_billing_period
als P#M
formatiert ist, wobei # die Anzahl der Monate ist.
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.
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.
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:
In HubSpot zeigt der Deal-Datensatz den Artikel in der Artikel-Karte an.
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.
Eine 200
-Antwort gibt Details zum neuen Artikel zurück. In HubSpot zeigt der Deal-Datensatz den Artikel in der Artikel-Karte an.
Vielen Dank, dass Sie Ihr Feedback mit uns geteilt haben.