--- sourceDocument: 横浜ファイナンス&サプライチェーン sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/source-to-pay-operations Release : - yokohama ft:locale : - ja-JP ft:publication_title : - 横浜ファイナンス&サプライチェーン ft:clusterId : - stpop bundleId : - stpop workflow : - Creator --- # Spendint API - POST /sn_spend_intg/spendint/catalog # Spendint API - POST /sn_spend_intg/spendint/catalog {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：14分 サプライヤーが複数のカタログを投稿して、サプライヤー製品、モデル製品、契約、および価格設定レコードを作成できるようにします。 カタログ API 統合では、サードパーティカタログからデータを受信すると、次のことができます。 1. 新しいサードパーティカテゴリを作成し、これらのカテゴリをモデルカテゴリにマッピングします。 * 利用可能な場合は、国連標準製品およびサービスコード (UNSPSC) を使用してからカテゴリ名を使用します。 * UNSPSC が利用できない場合は、カテゴリ名のみを使用します。 {#spendint-POST-catalog__ul_jds_5yl_kmb} 2. サードパーティカテゴリをモデルカテゴリにマッピングした後、メーカー品番 (MPN) を使用して、既存の製品モデルを検索します (利用可能な場合)。 1. MPN の製品モデルが見つかった場合は、変更を加えて製品モデルを更新してから、製品モデルに関連するサプライヤー製品を作成または更新します。 2. MPN の製品モデルが存在しない場合は、次の操作を行います。 1. 製品モデルクラスは、通常、製品のサードパーティカテゴリによって参照されるモデルカテゴリで使用できます。この製品モデルクラスを使用して、製品モデルを作成する必要がある製品モデルテーブル (ハードウェア、ソフトウェア、消耗品など) を取得します。利用可能な製品モデルクラスがない場合は、ベース製品モデルテーブルに製品モデルを作成します。 2. 正しい製品モデルクラスが特定されたら、次のように正しいクラスに新しい製品モデルを作成します。 * メーカー、パブリッシャー、またはプロバイダーは、製品モデルのメーカーにマッピングする必要があります。 * API の製品名は、製品モデルの名前にマッピングする必要があります。 * API の MPN はモデル番号を更新する必要があります。 * API からの製品説明によって、製品モデルの説明が更新されます。 * モデルカテゴリは、サードパーティカテゴリレコードで参照されている製品カテゴリで更新する必要があります。 * 製品カテゴリは、サードパーティカテゴリレコードで参照されている製品カテゴリで更新する必要があります。 * API に代替製品に値がある場合は、現在の製品モデルと他の製品モデルの間に代替製品レコードを作成します。 * API の互換性のある製品に値がある場合は、現在の製品モデルと他の製品モデルの間で互換性のある製品レコードを作成します。 * API の製品属性は、製品モデルの製品属性関連リストで作成または更新する必要があります。 {#spendint-POST-catalog__ul_wvr_jdk_mnb} {#spendint-POST-catalog__ol_trv_qck_mnb} {#spendint-POST-catalog__ol_rtb_hck_mnb} 3. 製品モデルが利用可能な場合は、サプライヤー品番を使用して、製品モデルに関連するサプライヤー製品を作成または更新します。 {#spendint-POST-catalog__ol_oqw_3dd_dmb} ## サードパーティマッピング {#spendint-POST-catalog__section_w4v_nfn_n4b} サードパーティのカテゴリ、モデル、および単位のマッピングを実行するには、次のテーブルを使用します。 * サードパーティカテゴリ:ShoppingHub アドミニストレーターが内部の既存のモデルカテゴリとマッピングできるように、すべてのサードパーティカテゴリレコードを保存します。 * サードパーティモデルマッピング:製品モデルとサードパーティモデルカテゴリ間のすべてのマッピング情報を保存します。 * サードパーティユニット:ShoppingHub アドミニストレーターがサプライヤー製品ユニットとマッピングできるように、すべてのサードパーティユニットレコードを保存します。 * サードパーティユニットマッピング:製品モデルとサードパーティユニット間のすべてのマッピング情報を保存します。 {#spendint-POST-catalog__ul_mgg_dbt_knb} 注: サードパーティ統合製品は、サードパーティカテゴリとサードパーティユニットの両方が適切にマッピングされている場合に自動公開されます。 ## サプライヤー製品の販売日 {#spendint-POST-catalog__section_mxc_phn_n4b} サプライヤー製品は販売終了日に達すると製造中止となり、カタログに公開されなくなります。\[サプライヤー製品\] フォームの \[販売開始日 \] フィールドと \[販売終了日\] フィールドは、カタログ API からのサードパーティ統合によって入力されます。 ## ステータステーブル {#spendint-POST-catalog__section_hrm_qts_knb} 製品の一括インポート要求のステータスを確認するには、Table REST API を使用して ServiceNow データベースへの REST 呼び出しを行います。API からの応答には、一括インポート要求が失敗したレコードが一覧表示されます。製品の一括インポート応答の場合は、次のパラメーターを使用してカタログエラーテーブルをクエリします。 `sysparm_query=outbound_error.supplier_id=^outbound_error.state=20` 顧客 ID、サプライヤー ID、エラータイプ、一意のインポートセット ID、およびステータスの詳細については、親エラーテーブルである送信ステータステーブルで確認できます。 ## URL 形式 /api/sn_spend_intg/spendint/catalog ## サポートされている要求パラメーター {#spendint-POST-catalog__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 1. パスパラメーター] {#spendint-POST-catalog__entry__6} | 名前 | 説明 | |-|-| | mode | サードパーティ統合のための非同期モードと同期モードのサポート。 データタイプ：文字列 有効な値： * async:非同期モード。 * sync:同期モード。 {#spendint-POST-catalog__ul_hdr_tkg_ymb} デフォルト:非同期 | [表 : 2. クエリパラメーター] {#spendint-POST-catalog__entry__10} | 名前 | 説明 | |-|-| | 顧客_ID | 顧客の識別子。 データタイプ：文字列 最大長:100 | | catalog_id | 顧客が購入できるカタログコンテンツの識別子。 データタイプ：文字列 最大長:100 | | 製品 | 作成または更新する製品を定義するオブジェクトのリスト。各トランザクションには 1000 個の製品制限があります。 データタイプ：アレイ "products": [ { "available_units": "String", "available_for_country": [Array], "bundled_components": [Array], "contract_agreement": {Object}, "delivery_time": "String", "images": [Array], "manufacturer": "String", "mpn": "String", "parent_bundle": "String", "product_attributes": {Object}, "product_category_name": "String", "product_description": "String", "product_name": "String", "sku": "String", "unit": "String", "unspsc": "String", } ] | | products.available_units | 在庫のある製品に必要です。この値は、この製品で使用可能なユニットの数量を示します。 データタイプ：文字列 最大長:40 | | products.available_for_country | サプライヤー製品を購入できる国コードのリスト。国が指定されていない場合は、どの国のユーザーでも製品を購入できます。 データタイプ：アレイ "available_for_country": ["US","IN","GB"] | | products.bundled_components | 製品バンドルをカタログペイロードの一部として送信するシナリオでのみ有効であり、親バンドルペイロードにのみ適用されます。この値には、子バンドルコンポーネントへの参照が含まれています。子バンドルコンポーネントの MPN と数量のリストは、ここで維持されます。 注: バンドル内に同じ子バンドルコンポーネントを複数回追加できるため、入力された数量が同じ子バンドルコンポーネント間の差別化要素となります。 子バンドルコンポーネントとその詳細 (MPN と数量) は、同じサプライヤーにマッピングする必要があります。 データタイプ：アレイ "bundled_components": [ { "mpn": "String", "quantity": "String" } ] | | products.contract_agreement | 製品の契約の詳細。 注: これは、子バンドルコンポーネントには必要ありません。 データタイプ：オブジェクト "contract_agreement": { "contract_end_date": "String", "contract_number": "String", "contract_start_date": "String", "negotiated_currency ": "String", "negotiated_price": "String" } | | products.contract_agreement.contract_end_date | 契約期間が終了する日付。 データタイプ：文字列 最大長:40 形式:YYYY-MM-DD | | products.contract_agreement.contract_number | 必須。製品に関連付けられているアクティブな契約の番号。 データタイプ：文字列 最大長:100 | | products.contract_agreement.contract_start_date | 契約期間が開始される日付。 データタイプ：文字列 最大長:40 形式:YYYY-MM-DD | | products.contract_agreement.negotiated_currency | 必須。交渉価格の通貨。 データタイプ：文字列 最大長:40 | | products.contract_agreement.negotiated_price | 必須。サプライヤーまたはリセラーとの契約を通じて交渉された製品の単価。 データタイプ：文字列 最大長:40 | | products.delivery_time | 製品を顧客に出荷するのにかかる推定日数。この値は日数を表し、整数である必要があります。 データタイプ：文字列 最大長:40 | | products.images | サプライヤー製品の画像 URL を指定する文字列のリスト。 データタイプ：アレイ | | products.manufacturer | 必須。製品を製造、公開、または提供する会社。これは製品のサプライヤーまたは再販業者ではありません。 データタイプ：文字列 最大長:100 | | products.mpn | 必須。メーカー、パブリッシャー、またはプロバイダーによって提供される製品の識別子。 注: SKU 値が利用可能な場合、これはリセラーの親バンドルには必要ありません。 データタイプ：文字列 最大長:100 | | products.parent_bundle | 製品バンドルをカタログペイロードの一部として送信するシナリオでのみ有効であり、子バンドルコンポーネントペイロードにのみ適用されます。子バンドルコンポーネントの場合、親への参照はここで維持されます。親 MPN と SKU の値もここで設定されます。 データタイプ：文字列 最大長:100 | | products.product_attributes | 製品属性を定義するキーと値のペアのリストです。例`:「色」:「スペースグレー」。`製品には複数の属性を使用できます。ただし、価格設定または在庫状況に影響を与える属性のみを API を介して指定する必要があります。 データタイプ：オブジェクト | | products.product_category_name | 必須。unspscプロパティを設定しない場合に入力する名前。この名前は、製品が属するカテゴリです。このカテゴリ名は、コマース シナリオで製品を購入するために使用できます。たとえば、電源タップ製品はオフィス機器カテゴリに属することができます。 データタイプ：文字列 最大長:100 | | products.product_description | コマースエクスペリエンス内で購入者に表示される製品の完全な説明。 注: 特に子バンドルコンポーネントがある製品バンドルカタログアイテムの場合、ここではサプライヤーをできるだけ詳しく説明することをお勧めします。 データタイプ：文字列 最大長:65000 | | products.product_name | 必須。製品の名前。 データタイプ：文字列 最大長:1000 | | products.sku | 必須。サプライヤーによって販売される製品を一意に識別するためにサプライヤーによって生成された番号。 データタイプ：文字列 最大長:100 | | products.unit | 必須。サプライヤーが製品を販売する単位またはレート。たとえば、個数や時間などです。 データタイプ：文字列 最大長:40 | | products.unspsc | 必須。product_category_nameプロパティを設定していない場合に入力する識別子。この識別子は、製品が属するカテゴリの UNSPSC です。たとえば、UNSPSC コード 43210000 は、製品カテゴリ「コンピューター」の識別子です。 データタイプ：文字列 最大長:100 | | supplier_id | 必須。顧客が注文できるリセラーまたはサプライヤーの識別子。 データタイプ：文字列 最大長:100 | | third_party_import_id | インポートされたデータのセットを一意に識別するために文字列値を渡すことをサードパーティに有効にする識別子。 データタイプ：文字列 最大長:100 | [表 : 3. 要求本文パラメーター (XML または JSON)] ## ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。 {#spendint-POST-catalog__entry__64}{#spendint-POST-catalog__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 受容 | 応答本文のデータ形式。サポートされているタイプ: application/json または application/xml。 デフォルト： application/json | [表 : 4. 要求ヘッダー] 注: 調達統合フレームワークでは、 application/json データ形式のみがサポートされています。 {#spendint-POST-catalog__entry__68} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ## ステータスコード この HTTP アクションには、次のステータスコードが適用されます。 {#spendint-POST-catalog__table_lml_1qg_ymb__entry__2} | ステータスコード | 説明 | |-|-| | 成功 | 成功。要求が正常に処理されました。 | | 失敗 | 不成功。要求はエラーで処理されました。 | [表 : 6. ステータスコード] {#spendint-POST-catalog__table_lml_1qg_ymb} ## 応答本文のパラメーター (JSON) これらの応答本文パラメーターは、同期モードでクエリされたときに受信されます。{#spendint-POST-catalog__entry__78} | 名前 | 説明 | |-|-| | error_response_body | sku、mpn、およびエラーメッセージ別に一覧表示されるエラーの説明。 データタイプ：アレイ | | error_response_body.error_message | 詳細なエラーメッセージ。 データタイプ：文字列 | | status_code | 「成功」や「失敗」などの応答ステータス。 データタイプ：文字列 | [ ] ## cURL 要求 curl "https://instance.service-now.com/api/sn_spend_intg/spendint/catalog" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root": [{ "customer_id": "AB-1234323", "catalog_id": "ACME CORP-12347898", "supplier_id": "SUP-123456", "third_party_import_id": "DELL1234567", "products": [ { "product_name": "Apple MacBook Pro 13 Core i7", "mpn": "Z0WQ-20004301931", "sku": "55788741", "manufacturer": "Apple", "product_category_name": "Computer", "parent_bundle": "920-0045362002", "bundled_components": { "mpn": "Z0WQ-20004301931", "quantity": "4", }, "unspsc": "43211500", "product_description": "Apple MacBook Pro 13 Core i7 2.8GHz 16GB 512GB - Touch Bar - Space Gray", "product_attributes": { "Color": "Space Grey", "RAM": "16GB", "Screen Size": "13inch" }, "images": ["http://test123.image1.png", "http://test123.image2.jpeg"], "unit": "Each", "available_units": "4", "available_for_country": ["US","IN","GB"], "delivery_time": "4", "contract_agreement": { "contract_number": "34567892", "contract_start_date": "YYYY-MM-DD", "contract_end_date": "YYYY-MM-DD", "negotiated_price": "456", "negotiated_currency ": "USD" } } ] } ]} 考えられる回答: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "AB-1234323", "supplier_id": "SUP-123456", "third_party_import_id": "DELL1234567", "status_code": "failure", "error_response_body": [ { "sku": "55788741", "mpn": "Z0WQ-20004301931", "error_message": "Field Value empty/Formatting issue Negotiated currency \n" } ] } ] } }