> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt > Use this file to discover all available pages before exploring further. # CRM API | 商品項目 export const postmanIcon = ; export const ScopesList = ({scopes = [], description = "この API には、次のいずれかのスコープが必要です。"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return

{description}

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


              {scope}

)}

; }; HubSpotにおいて商品項目は、[製品](/api-reference/crm-products-v3/guide)の個々のインスタンスです。製品は取引に紐付けられると、商品項目になります。個別の見積もり上に作成した商品項目は、製品ライブラリーには追加されません。商品項目エンドポイントを使用することにより、商品項目データを管理したり、HubSpotと他のシステムとの間で同期したりできます。 **使用例**: 営業担当者から潜在顧客に送信するための[見積もり](/api-reference/crm-quotes-v3/guide)一式を作成する際に、商品項目APIを使用して、見積もりごとにスタンドアロンの商品項目ならびに既存の製品に関連付けられた商品項目を作成できます。 ## スコープの要件使用するエンドポイントに基づいて、次のスコープを承認する必要があります。 * `crm.objects.line_items.read`：商品項目データを取得するためのアクセス権を提供します。 * `crm.objects.line_items.write`：商品項目を作成および更新するためのアクセス権を提供します。 * `tax_rates.read`：アカウントで設定した税率を取得するためのアクセス権を提供します。 ## 商品項目を作成する商品項目を作成するには、`POST`リクエストを`/crm/v3/objects/line_items`に送信します。POSTリクエスト本文に、商品項目の詳細（名前、数量、価格など）を含めます。リクエスト本文に追加のデータを含めることもできます。 * 既存の製品（[製品API](/api-reference/crm-products-v3/guide)を使用して作成された、または[HubSpot内](https://knowledge.hubspot.com/ja/products/create-and-manage-products)で作成された）に基づく商品項目を作成するには、POSTリクエスト本文に`hs_product_id`を含めます。 * 商品項目の[税率](#retrieve-tax-rates)を含めるには、リクエスト本文の`properties`フィールドにIDを`hs_tax_rate_group_id`として含めます。 * POSTリクエスト本文に`associations`配列を含めることで、商品項目を取引、見積もり、請求書、支払いリンク、サブスクリプションに関連付けることも可能です。例えば、以下のような本文でPOSTリクエストを送信すると、取引（ID：`12345`）が関連付けられた「New standalone line item」という名前の商品項目が作成されます。 ```js theme={null} { "properties": { "price": 10, "quantity": 1, "name": "New standalone line item", "hs_tax_rate_group_id": "2148420997" }, "associations": [ { "to": { "id": 12345 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 20 } ] } ] } ``` ### 注： * 商品項目は、1つの単一親オブジェクトに属します。オブジェクトを関連付ける場合、商品項目はラインアイテムはオブジェクトごとに個別にする必要があります。例えば取引と見積もりを作成する場合は、取引用に1つの商品項目セットを作成し、見積もり用に別の商品項目セットを作成する必要があります。これは、オブジェクト間でCRMデータを合理化し、商品項目を変更する必要があるときに予期しないデータ損失が発生しないようにするのに役立ちます（例えば、見積もりを削除すると見積もりの商品項目が削除され、それらの商品項目が取引に関連付けられている場合には、取引の商品項目も削除されます）。 * `properties`フィールド内で指定された`price`を負の値にすることはできません。 * 商品項目の［期間］プロパティー（`hs_recurring_billing_period`）では、[ISO-8601の期間形式](https://docs.oracle.com/javase/8/docs/api/java/time/Period.html)のPnYnMnDおよびPnWを使用できます。\_ \_ ## 商品項目を取得する商品項目を個別に、または一括で取得できます。 * 特定の商品項目を取得するには、`GET`リクエストを`/crm/v3/objects/line_items/{lineItemId}`に送信します。`lineItemId`は商品項目のIDを指します。 * 全ての商品項目を取得するには、`GET`リクエストを`/crm/v3/objects/line_items`に送信します。リクエストのURLには、次のパラメーターを含めることができます。 | パラメーター | 説明 | | ----------------------- | ------------------------------------------------------------------------------------------ | | `properties` | レスポンスで返されるプロパティーのカンマ区切りリスト。指定したプロパティーのいずれかがリクエスト対象のオブジェクトに存在しない場合、これらのプロパティーは無視されます。 | | `propertiesWithHistory` | 以前の値の履歴と併せて取得するプロパティーのカンマ区切りのリスト。指定したプロパティーのいずれかがリクエスト対象のオブジェクトに存在しない場合、これらのプロパティーは無視されます。 | ## 商品項目を更新する商品項目を更新するには、`PATCH`リクエストを`/crm/v3/objects/line_items/{lineItemId}`に送信します。`lineItemId`は商品項目のIDを指します。リクエスト本文に、更新するプロパティー値を含めます。このメソッドを使用して関連付けを更新することはできません。代わりに、[関連付けAPI](/api-reference/crm-associations-v4/guide)を使用する必要があります。例えば、リクエスト本文は次のようになります。 ```js theme={null} { "properties": { "price": 25, "quantity": 3, "name": "Updated line item" } } ``` ## 商品項目を削除する商品項目を削除するには、`DELETE`リクエストを`/crm/v3/objects/line_items/{lineItemId}`に送信します。`lineItemId`は商品項目のIDを指します。 ## 商品項目のプロパティー商品項目データを管理する場合は、以下の表に示す一般的なプロパティーのいくつかを使用することをお勧めします。全ての商品項目プロパティーを取得するには、`GET`リクエストを`/crm/v3/properties/line_item`に送信します。[プロパティーAPI](/api-reference/crm-properties-v3/guide)の使用について詳細をご確認ください。 | プロパティー名 | UIのラベル | 説明 | | --------------------------------- | ------ | ------------------------------------------------------------------ | | `name` | 名前 | 商品項目の名前 | | `description` | 説明 | 製品の詳細な説明 | | `hs_sku` | SKU | 製品の固有ID | | `hs_recurring_billing_start_date` | 請求開始日 | 商品項目の定期請求開始日 | | `hs_recurring_billing_end_date` | 請求終了日 | 商品項目の定期請求終了日 | | `recurringbillingfrequency` | 請求の頻度 | 定期請求がある商品項目の請求頻度。取引および見積もりの価格計算の情報が取得されます。1回限りの請求がある商品項目は含まれていません。 | | `quantity` | 数量 | この商品項目に含まれる製品の単位数 | | `price` | 単価 | 製品のコスト | | `amount` | 正価 | 商品項目の合計コスト（数量×単価）。 | | `hs_line_item_currency_code` | 通貨 | 商品項目の通貨コード | ## 税率を取得する各商品項目に税率を適用できます（例：マサチューセッツ州の売上税6.26％）。HubSpot[アカウントで税率ライブラリーを設定し](https://knowledge.hubspot.com/ja/payments/set-up-automated-tax-and-tax-rates#add-a-tax-rate-to-the-tax-library)たら、`GET`リクエストを`/tax-rates/v1/tax-rates`へ送信して全ての税率を取得するか、`/tax-rates/v1/tax-rates/{taxRateId}`へ送信してIDを基準にした税率を取得できます。このリクエストを行うには、アプリで`tax_rates.read`スコープが承認されている必要があります。結果の応答は、次のようになります。 ```json theme={null} { "name": "MA Sales tax 2025", "percentageRate": 6.25 "label": "Sales Tax", "active": true, "id": "2148420997", "createdAt": "2024-12-12T23:20:39.923Z", "updatedAt": "2024-12-12T23:20:39.923Z" } ``` 各税率オブジェクトには、次のプロパティーが含まれます。 | プロパティータイプ | 説明 | | ---------------- | ----------------------------------------------------------------------------- | | `name` | 税率の内部記述子。 | | `percentageRate` | パーセントで表される税率の値。 | | `label` | 購入者に表示される税率の説明子。見積もり、請求書、またはその他の親オブジェクトに表示されます。 | | `active` | 税率を新しい見積もりまたは請求書に適用できるかどうかを示すブール値。これは、適用されなくなった前年度の税率に対して`false`に設定することもできます。 | | `id` | 税率のID。 | | `createdAt` | 税率の作成時期を示すISO 8601タイムスタンプ。 | | `updatedAt` | 税率が最後に更新された日付を示すISO 8601タイムスタンプ。 | 適用する税率のIDを取得したら、商品項目を作成する際に`properties`フィールドに`hs_tax_rate_group_id`の`id`を指定します。商品項目の作成の詳細については、[上記のセクション](#create-a-line-item)をご参照ください。