Productos

En HubSpot, los productos representan los bienes o servicios que vendes. Crear una biblioteca de productos te permite agregar rápidamente productos a negocios, generar cotizaciones e informar sobre el rendimiento del producto. Los puntos de terminación de los productos te permiten administrar estos datos y sincronizarlos entre HubSpot y otros sistemas.

Los productos, junto con empresas, contactos, negocios, tickets, elementos de línea y cotizaciones, son objetos en HubSpot CRM. Obtén más información sobre las propiedades de los objetos, las asociaciones, las relaciones y más en nuestra guía Comprender los objetos de CRM.

Ejemplo de caso de uso: para que los representantes de ventas puedan agregar fácilmente bienes y servicios a negocios, cotizaciones y más, usa la API de productos para importar tu catálogo de productos a HubSpot.

Crear un producto

Para crear un producto, haz una solicitud POST a crm/v3/objects/products. En el cuerpo de la solicitud, incluye las propiedades del producto que quieras establecer al crear. Más tarde puedes actualizar las propiedades de un producto a través de una solicitud de PATCH al mismo punto de terminación.

Para ver todas las propiedades disponibles del producto, haz una solicitud GET a la API de propiedades. Para recuperar las propiedades del producto, la URL de la solicitud será/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" }
Ten en cuenta que el valor de hs_recurring_billing_period tiene el formato P#M, donde # es el número de meses.

Asociar productos

Los productos en sí no se pueden asociar con otros objetos de CRM. Sin embargo, para asociar la información de un producto con un negocio o cotización, puedes crear un elemento de pedido basado en ese producto. Los elementos de pedido son instancias individuales de productos y son un objeto separado de los productos para que puedas adaptar los bienes y servicios en un negocio o cotización según sea necesario sin necesidad de actualizar el producto en sí.

Por ejemplo, si estás armando un negocio en el que se vende uno de tus productos, primero crearías un elemento de pedido a partir del producto y luego lo asociarías con el negocio. Puedes hacerlo con dos llamadas separadas o con una llamada que crea y asocia el elemento de pedido. Ambas opciones se muestran a continuación.

Nota: los elementos de pedido pertenecen a un único objeto padre. Si se asocian objetos, los elementos de pedido deben ser individuales para cada objeto. Por ejemplo, si estás creando un negocio y una cotización, debe crear un conjunto de elementos de pedido para el negocio y otro conjunto para la cotización. Esto ayudará a agilizar los datos de CRM en todos los objetos y evitará la pérdida inesperada de datos cuando sea necesario modificar los elementos de pedido. Por ejemplo, eliminar una cotización también eliminará los elementos de pedido de la cotización. Si esos elementos de pedido también están asociados con un negocio, los elementos de pedido del negocio también se eliminarán.

Crear y asociar un elemento de pedido (varias llamadas)

Primero, crearás un elemento de pedido basado en un producto con el ID de 1234567. Para obtener una lista completa de las propiedades de líneas de elementos de pedido disponibles, haz una solicitud GET a la API de propiedades. La URL de los elementos de pedido sería crm/v3/properties/line_items. Debido a que creas el elemento de pedido a partir de un producto existente, heredará los valores de propiedad del producto, como el precio.

// 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 respuesta devolverá un ID de elemento de pedido que puedes usar para asociarlo con un negocio utilizando la API de asociaciones. Para este ejemplo, supongamos que el ID de elemento de pedido devuelto es 7791176460.

Para asociar el elemento de pedido con un negocio existente (ID: 14795354663), realizarás una solicitud PUT a /crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663. Esta solicitud utiliza el tipo de asociación predeterminado. 

Una respuesta 200 devolverá información similar a la siguiente:

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

En HubSpot, el registro de transacciones mostrará el elemento de pedido en la tarjeta Elementos de pedido.

deal-record-line-item-association

Crear y asociar un elemento de pedido (llamada única)

Para crear un elemento de pedido a partir de un producto existente y asociarlo con un negocio mediante una sola llamada, puedes incluir una matriz associations en la solicitud de creación de elementos de pedido. 

El elemento de pedido, haz una solicitud POST a/crm/v3/objects/line_item. El cuerpo de tu solicitud será similar al siguiente. Ten en cuenta que el associationTypeId para la asociación elemento de pedido-negocio es 20. Obtén más información sobre los tipos de asociación entre diferentes tipos de registros del 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 } ] } ] }

Una respuesta 200 devolverá detalles sobre el nuevo elemento de pedido. En HubSpot, el registro de transacciones mostrará el elemento de pedido en la tarjeta Elementos de pedido.

deal-record-line-item-association


¿Te resultó útil este artículo?
Con este formulario puedes enviar tu opinión sobre nuestros documentos para desarrolladores. Si tienes comentarios sobre el producto de HubSpot, puedes enviarlos al Foro de ideas.