--- 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/shipment # Spendint API - POST /sn_spend_intg/spendint/shipment {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：11分 このエンドポイントを使用して、サードパーティからの購入の更新を受け入れます。 データを受領したら、販売注文明細行番号を使用して出荷データを発注書明細行と照合する必要があります。追跡番号を使用して、発注書明細に関連する既存の出荷詳細レコード 検索できます。そのようなレコードが見つからない場合は、新しい出荷詳細レコードを作成します。出荷データの発注書または発注明細が存在しない場合は、この出荷の発注書が存在しないことを示すエラーメッセージが表示されます。 注: 発注書 (PO) と発注書 (PO) 明細行が \[送信待ち\] ステータスで、販売注文明細行と販売注文明細行が入力されていない場合、サードパーティ リセラーからの出荷と請求書の転記は許可されません。これは、発注書と発注書明細のステータスが \[注文済み\] の場合にのみ許可されます。また、出荷と請求書の転記に順次制限はありません。 ## ステータステーブル {#spendint-POST-shipment__section_hrm_qts_knb} 出荷要求のステータスを確認するには、テーブル REST API を使用して ServiceNow データベースへの REST 呼び出しを行います。API からの応答には、出荷の更新に失敗したレコードが一覧表示されます。出荷応答を取得するには、次のパラメーターを使用して出荷エラーテーブルを照会します。 `sysparm_query=outbound_error.supplier_id=^outbound_error.state=20` 顧客 ID、サプライヤー ID、エラータイプ、一意のインポートセット ID、ステータスの詳細は、親エラーテーブルである送信ステータステーブルにあります。 ## URL 形式 {#spendint-POST-shipment__section_ejb_b22_dmb} /api/sn_spend_intg/spendint/shipment ## サポートされている要求パラメーター {#spendint-POST-shipment__table_hqb_pfp_gmb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 1. パスパラメーター] {#spendint-POST-shipment__table_hqb_pfp_gmb} {#spendint-POST-shipment__table_igy_fck_ymb__entry__2} | 名前 | 説明 | |-|-| | mode | サードパーティ統合のための非同期モードと同期モードのサポート。 データタイプ：文字列 有効な値： * async:非同期モード。 * sync:同期モード。 {#spendint-POST-shipment__ul_hdr_tkg_ymb} デフォルト:非同期 | [表 : 2. クエリパラメーター] {#spendint-POST-shipment__table_igy_fck_ymb} {#spendint-POST-shipment__entry__10} | 名前 | 説明 | |-|-| | 顧客_ID | 顧客の識別子。 データタイプ：文字列 最大長:100 | | order_number | 必須。この注文に対して顧客から提供された発注書番号。 データタイプ：文字列 最大長:40 | | sales_order_number | 必須。この注文に対してサプライヤーによって生成された番号または値。 データタイプ：文字列 最大長:40 | | shipment_lines | 資産のシリアル番号、IMEI 番号、および資産タグの詳細を含めることができる出荷ラインのリスト。 データタイプ：アレイ "shipment_lines": [ { "actual_shipment_date": "String", "estimated_arrival_date": "String", "line_number": "String", "planned_shipment_date": "String", "product_details": [Array], "sales_order_line_number": "String", "shipping_address": {Object}, "shipping_carrier": "String", "shipment_quantity": "String", "ship_to": "String", "tracking_number": "String" } ] | | shipment_lines.actual_shipment_date | 出荷がサプライヤーの場所から出荷される日付。 データタイプ：文字列 最大長:40 形式:YYYY-MM-DD | | shipment_lines.estimated_arrival_date | 出荷が指定された場所に到着する予定の日付。 データタイプ：文字列 最大長:40 形式:YYYY-MM-DD | | shipment_lines.line_number | 必須。特定の購入に対して顧客が生成した発注書明細番号。 データタイプ：文字列 最大長:40 | | shipment_lines.planned_shipment_date | 出荷がサプライヤーの場所から出荷される予定の日付。 データタイプ：文字列 最大長:40 形式:YYYY-MM-DD | | shipment_lines.product_details | 出荷される製品に関する詳細を定義するオブジェクトのリスト。オプションには、シリアル番号、IMEI 番号、資産タグの詳細が含まれます。 データタイプ：アレイ "product_details": [ { "asset_tag": "String", "imei": "String", "serial_number": "String" } ] | | shipment_lines.product_details.asset_tag | 出荷された製品の資産タグ。 データタイプ：文字列 最大長:100 | | shipment_lines.product_details.imei | 出荷された製品の IMEI 番号。 データタイプ：文字列 最大長:100 | | shipment_lines.product_details.serial_number | 必須。出荷された製品のシリアル番号。 データタイプ：文字列 最大長:100 | | shipment_lines.sales_order_line_number | サプライヤーによって生成された受注明細行番号。この番号は、この購入のリビジョンにのみ必要です。 データタイプ：文字列 最大長:40 | | shipment_lines.shipping_address | 製品の出荷先の住所。 データタイプ：オブジェクト "shipping_address": { "city": "String", "country": "String", "name": "String", "state": "String", "street": "String", "zip_code": "String" } | | shipment_lines.shipping_address.city | 製品の出荷先の市区町村の名前。 データタイプ：文字列 最大長:1000 | | shipment_lines.shipping_address.country | 製品の出荷先の国。 データタイプ：文字列 最大長:40 | | shipment_lines.shipping_address.name | 製品の出荷先の顧客の名前。 データタイプ：文字列 最大長:1000 | | shipment_lines.shipping_address.state | 製品の出荷先の都道府県。 データタイプ：文字列 最大長:1000 | | shipment_lines.shipping_address.street | 製品の出荷先の番地の名前。 データタイプ：文字列 最大長:1000 | | shipment_lines.shipping_address.zip_code | 製品の出荷先の郵便番号または PIN コード。 データタイプ：文字列 最大長:40 | | shipment_lines.shipment_quantity | 必須。物理的な商品として出荷される製品の数。番号には、出荷されている製品の数量が含まれている必要があります。 データタイプ：文字列 最大長:40 | | shipment_lines.shipping_carrier | FedEx、UPS、USPS などの指定された場所に製品を配送する配送業者。 データタイプ：文字列 最大長:100 | | shipment_lines.ship_to | 製品の配送先の受取人の名前。 データタイプ：文字列 最大長:100 | | shipment_lines.tracking_number | 購入の全部または一部の配送業者から提供される追跡番号。 データタイプ：文字列 最大長:100 | | supplier_id | 必須。顧客が注文できるリセラーまたはサプライヤーの識別子。 データタイプ：文字列 最大長:100 | | supplier_shipment_number | 必須。この出荷に対して生成された識別番号。通常、この数値はエンタープライズリソースプランニング (ERP) または注文追跡システムによって生成されます。 データタイプ：文字列 最大長:100 | | third_party_import_id | インポートされたデータのセットを一意に識別するために文字列値を渡すことをサードパーティに有効にする識別子。 データタイプ：文字列 最大長:100 | [表 : 3. 要求本文パラメーター (XML または JSON)] ## ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。 {#spendint-POST-shipment__entry__66}{#spendint-POST-shipment__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 受容 | 応答本文のデータ形式。サポートされているタイプ: application/json または application/xml。 デフォルト： application/json | [表 : 4. 要求ヘッダー] 注: 調達統合フレームワークでは、 application/json データ形式のみがサポートされています。 {#spendint-POST-shipment__entry__70} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ## ステータスコード この HTTP アクションには、次のステータスコードが適用されます。 {#spendint-POST-shipment__table_lml_1qg_ymb__entry__2} | ステータスコード | 説明 | |-|-| | 成功 | 成功。要求が正常に処理されました。 | | 失敗 | 不成功。要求はエラーで処理されました。 | [表 : 6. ステータスコード] {#spendint-POST-shipment__table_lml_1qg_ymb} ## 応答本文のパラメーター (JSON) {#spendint-POST-shipment__section_hgg_bhk_ymb} これらの応答本文パラメーターは、同期モードでクエリされたときに受信されます。{#spendint-POST-shipment__table_igg_bhk_ymb__entry__2} | 名前 | 説明 | |-|-| | error_response_body | 受注明細行番号、受注番号、仕入先出荷番号、およびエラーメッセージで一覧表示されたエラーの説明。 データタイプ：アレイ | | error_response_body.error_message | 詳細なエラーメッセージ。 データタイプ：文字列 | | status_code | 「成功」や「失敗」などの応答ステータス。 データタイプ：文字列 | [ ] {#spendint-POST-shipment__table_igg_bhk_ymb} ## cURL 要求 curl "https://instance.service-now.com/api/sn_spend_intg/spendint/shipment" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root":[{ "customer_id" : "ACME CORP", "supplier_id" : "SUP-123456", "third_party_import_id": "DEL2134324", "supplier_shipment_number" : "TN-YU67898723", "order_number": "PO0001002", "sales_order_number": "SO00223002", "shipment_lines": [ { "line_number": "POL0001005", "sales_order_line_number": "SOL0231325", "shipment_quantity": "4", "shipping_carrier": "FedEx", "tracking_number": "E-901290092", "shipping_address": { "name" : "1640 Camino Del Rio North #202, San Diego,CA", "street" : "1640 Camino Del Rio North", "city" : "San Diego", "state" : "CA", "zip_code" : "92108-1512", "country" : "US" }, "ship_to": "John doe", "planned_shipment_date": "YYYY-MM-DD", "actual_shipment_date": "YYYY-MM-DD", "estimated_arrival_date": "YYYY-MM-DD", "product_details": [ { "serial_number": "FL1234-23242319001", "imei": "2134890294", "asset_tag": "" },{ "serial_number": "FL1234-23242319110", "imei": "245499003", "asset_tag": "" } ] } ] } ]} 考えられる回答: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "DEL2134324", "status_code": "failure", "error_response_body": [ { "sales_order_line_number": "SOL0231325", "sales_order_number": "SO00223002", "supplier_shipment_number": "TN-YU67898723", "error_message": "The purchase order for this shipment does not exist\nThe purchase order line for this shipment does not exist\n" } ] } ] } }