Produtos

Visão geralEndpoints

No HubSpot, produtos consistem nas mercadorias ou nos serviços que você vende. A criação de uma biblioteca de produtos permite adicionar produtos aos negócios, gerar orçamentos e criar relatórios de desempenho do produto com rapidez. Os endpoints dos produtos permitem gerenciar esses dados e sincronizá-los entre o HubSpot e outros sistemas.

Os produtos, assim como as empresas, os contatos, os negócios, os tickets, os itens de linha e os orçamentos, são objetos no HubSpot CRM. Saiba mais sobre propriedades de objeto, associações, relacionamentos e muito mais em nosso guia Noções básicas do CRM.

Exemplo de caso de uso: para que os representantes de vendas possam adicionar com facilidade bens e serviços a negócios, orçamentos e muito mais, use a API de produtos para importar seu catálogo de produtos para o HubSpot.

Criar um produto

Para criar um produto, execute uma solicitação POST para crm/v3/objects/products. No corpo da solicitação, inclua as propriedades do produto que você deseja definir ao criar. Posteriormente, você poderá atualizar as propriedades de um produto por meio de uma solicitação PATCH para o mesmo ponto de extremidade.

Para ver todas as propriedades disponíveis do produto, execute uma solicitação GET para a API de propriedades. Para recuperar as propriedades do produto, o URL da solicitação 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" }
Observe que o valor de hs_recurring_billing_period é formatado como P#M, onde # é o número de meses.

Associar produtos

Os produtos em si não podem ser associados a outros objetos do CRM. No entanto, para associar as informações de um produto a uma oferta ou orçamento, você pode criar um item de linha com base nesse produto. Os itens de linha são instâncias individuais de produtos e são objetos separados dos produtos para que você possa personalizar os bens e serviços em um negócio ou orçamento, conforme necessário, sem a necessidade de atualizar o produto em si.

Por exemplo, ao criar um negócio em que um dos seus produtos é vendido, primeiro crie um item de linha a partir do produto e, em seguida, associe-o ao negócio. Você pode fazer isso executando duas chamadas separadas, ou uma chamada que cria e associa o item de linha. Ambas as opções são mostradas abaixo.

Criar e associar um item de linha (várias chamadas)

Primeiro, você criará um item de linha com base em um produto com o ID 1234567. Para obter a lista completa das propriedades de item de linha disponíveis, execute uma solicitação GET para a API de propriedades. O URL dos itens de linha seria crm/v3/properties/line_items. Como você cria o item de linha a partir de um produto existente, ele herda os valores de propriedade do produto, como preço.

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

A resposta retornará um ID de item de linha que você pode usar para associá-lo a um negócio usando a API de associações. Para este exemplo, suponha que o ID do item de linha retornado seja 7791176460.

Para associar o item de linha a um negócio existente (ID: 14795354663), você executará uma solicitação PUT para /crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663. Esta solicitação usa o tipo de associação padrão. 

Uma resposta 200 retornará informações semelhantes às seguintes:

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

No HubSpot, o registro do negócio exibirá o item de linha no cartão Itens de linha.

deal-record-line-item-association

Criar e associar um item de linha (chamada única)

Para criar um item de linha a partir de um produto existente e associá-lo a um negócio usando uma única chamada, você pode incluir uma matriz associations na solicitação de criação de item de linha. 

Para criar o item de linha, execute uma solicitação POST para crm/v3/objects/line_item. O corpo da sua solicitação será semelhante ao mostrado a seguir. Observe que o associationTypeId da associação de item de linha/negócio é 20. Saiba mais sobre os tipos de associação entre diferentes tipos de registos do 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 } ] } ] }

Uma resposta 200 retornará detalhes sobre o novo item de linha. No HubSpot, o registro do negócio exibirá o item de linha no cartão Itens de linha.

deal-record-line-item-association

Este artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot..