> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt > Use this file to discover all available pages before exploring further. # API del CRM | Productos export const postmanIcon = ; export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return

{description}

{sortedScopes.map((scope, index) =>


              {scope}

)}

; };

# Productos

En HubSpot, los productos representan los bienes o servicios que vendes. Crear una [biblioteca de productos](https://knowledge.hubspot.com/es/products/create-and-manage-products) te permite agregar rápidamente productos a los negocios, generar cotizaciones y generar informes sobre el rendimiento del producto. Los endpoints de los productos te permiten administrar estos datos y sincronizarlos entre HubSpot y otros sistemas. Los productos, junto con las empresas, los contactos, los negocios, los tickets, los elementos de pedido y las cotizaciones, son objetos en el CRM de HubSpot. Descubre más sobre las propiedades de los objetos, las asociaciones, las relaciones y otros temas en nuestra guía [Comprender los objetos de CRM](/guides/crm/understanding-the-crm). **Ejemplo de uso:** usa la API de productos para importar tu catálogo de productos a HubSpot, así los representantes de ventas podrán agregar fácilmente bienes y servicios a los negocios y las cotizaciones, entre otros. ## Crear un producto Para crear un producto, haz una solicitud `POST` a `crm/v3/objects/products`. En el cuerpo de la solicitud, incluye un objeto `properties` que contenga las propiedades del producto que quieras establecer. Más tarde podrás actualizar las propiedades de un producto mediante una solicitud `PATCH` al mismo endpoint. Para ver todas las propiedades disponibles para el producto, haz una solicitud `GET` a la [API de propiedades](/api-reference/crm-properties-v3/guide). Para recuperar las propiedades del producto, la URL de la solicitud será `/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" } } ``` Ten en cuenta que el valor `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 del CRM. Sin embargo, para asociar la información de un producto con un negocio o cotización, puedes crear un [elemento de pedido](/api-reference/crm-line-items-v3/guide) basado en ese producto. Los elementos de pedido son instancias individuales de los productos y constituyen un objeto separado para que puedas adaptar los bienes y servicios en un negocio o cotización según sea necesario sin necesidad de cambiar el producto en sí. Por ejemplo, si estás definiendo un negocio en el que se vende uno de tus productos, primero debes crear un elemento de pedido a partir del producto y después lo debes asociar con el negocio. Puedes hacerlo mediante dos llamadas independientes o con una llamada para crear y asociar el elemento de pedido. Ambas opciones se muestran a continuación. ### Nota: Los elementos de pedido pertenecen a un único objeto principal. 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, debes crear un conjunto de elementos de pedido para el negocio y otro conjunto para la cotización. Esto permitirá organizar los datos del CRM en todos los objetos y evitará la pérdida inesperada de datos cuando sea necesario modificar elementos de pedido. Por ejemplo, al eliminar una cotización también se eliminarán los elementos de pedido de la cotización. Si esos elementos 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, debes crear un elemento de pedido basado en un producto con el ID `1234567`. Para obtener una lista completa de las propiedades disponibles de los elementos de pedido, haz una solicitud `GET` a la [API de propiedades](/api-reference/crm-properties-v3/guide). La URL de los elementos de pedido sería `crm/v3/properties/line_items`. Debido a que el elemento de pedido se crea a partir de un producto existente, heredará los valores de las propiedades del producto, como el precio. ```json theme={null} { "properties": { "quantity": 1, "hs_object_id": "1234567", //the object ID of the product "name": "New line item (product-based)" } } ``` La respuesta será un ID de elemento de pedido que puedes usar para asociarlo con un negocio utilizando la [API de asociaciones](/api-reference/crm-associations-v4/guide). Para este ejemplo, supongamos que el ID del elemento de pedido en la respuesta es `7791176460`. Para asociar el elemento de pedido con un negocio existente (ID: `14795354663`), debes hacer 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` tendrá información similar a lo siguiente: ```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" } ``` En HubSpot, el registro de negocio 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 del elemento de pedido. Para crear el elemento de pedido, haz una solicitud `POST` a `crm/v3/objects/line_item`. El cuerpo de la solicitud será similar a lo que se ve abajo. Ten en cuenta que la etiqueta `associationTypeId` para la asociación del elemento de pedido del negocio es `20`. Obtén más información sobre los tipos de [asociación entre diferentes tipos de registros del CRM](/api-reference/crm-associations-v4/guide#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 } ] } ] } ``` Una respuesta `200` tendrá detalles sobre el nuevo elemento de pedido. En HubSpot, el registro de negocio mostrará el elemento de pedido en la tarjeta *Elementos de pedido*. deal-record-line-item-association