Quality Collaboration API
外部の品質管理システムを統合して、品質検査に協力します。
品質コラボレーションを使用すると、品質検査、特にサプライヤーが実施した検査の中心的なコラボレーションポイントとしてCoupaを使用できます。
このAPIを使用すると、次のことができます。
新しい品質検査リクエストをインポートまたはトリガーします。
バイヤーとサプライヤーのコラボレーションプロセスが完了した後、最終検査結果とステータスを受け取ります。
検査とその特性に関連する添付ファイルを管理します。
品質検査プロセスでは、インバウンドデータフローとアウトバウンドデータフローの両方にAPIを使用します。
Coupaで新しいオープン品質検査を作成するには、POSTリクエストを送信します。
バイヤーとサプライヤーは、Coupa UIとCSPを使用してコラボレーションし、コメントの交換、結果の記入、添付ファイルのアップロードを行います。
購入者が検査を承認または拒否したら、GETリクエストを使用して最終ステータスと解決策を読み取ります。
注:
このAPIは、 早期アクセスプログラム（ EAP ）に参加しているお客様のみが利用できます EAPに参加するには、Coupa担当者にお問い合わせください。
アクション
| 動詞 | パス | 説明 |
|---|---|---|
GET |
| すべての品質検査を受ける |
GET |
| クオリティチェックの詳細を見る |
POST |
| 新しい品質検査を作成する |
POST |
| 品質検査をエクスポート済みとしてマークする |
POST |
| 品質検査のエクスポートされたフラグをリセットする |
GET |
| 検査のすべての添付ファイルを取得する（ヘッダー） |
POST |
| 検査レベルで新しい添付ファイルを追加する（ヘッダー） |
| GET | /qualitycollaboration/api/v 1/quality - inspections/{inspection_id}/characteristics/{characteristic_id}/attachments/{attachment_id} | 特性の特定の添付ファイルを取得する |
| GET | /qualitycollaboration/api/v 1/quality - inspections/{inspection_id}/attachments/{attachment_id} | 品質検査の特定の添付ファイルを取得する |
DELETE |
| 検査レベルで添付ファイルを削除する（ヘッダー） |
GET |
| 特性のすべての添付ファイルを取得する（ライン） |
POST |
| 特性レベル（ライン）で新しい添付ファイルを追加する |
DELETE |
| 特性レベル（ライン）で添付ファイルを削除する |
スコープ
このAPIには、次のスコープが必要です。
quality_collaboration.quality_inspection.readquality_collaboration.quality_inspection.write
Elements
| 要素 | 説明 | 必須 | 一意 | 許容値 | 入力 | 出力 | データタイプ |
|---|---|---|---|---|---|---|---|
| ID | 検査ID. | no | no | no | yes | 整数 | |
| type | 検査の種類。 | no | 検査 | yes | yes | 文字列 | |
| ステータス | 検査のステータス。 | no |
| no | yes | 文字列 | |
| reviewDecision | レビューで下された決定。 | no |
| no | yes | 文字列 | |
| resolutionReasonText | 解決の理由のテキスト。 | no | no | yes | 文字列 | ||
| resolutionReasonType | 問題解決の理由の種類。 | no | no | yes | 文字列 | ||
| resolutionReasonCode | 解決の理由コード。 | no | no | yes | 文字列 | ||
| requestDate | リクエストの日付。 | no | yes | yes | datetime | ||
| dueDate | 期日. | yes | yes | yes | datetime | ||
| supplierId | サプライヤーのID. | yes | yes | yes | 整数 | ||
| itemId | アイテムのID。 | no | yes | yes | 整数 | ||
| itemName | アイテムの名前。 | no | yes | yes | 文字列 | ||
| itemDescription | アイテムの説明. | no | yes | yes | 文字列 | ||
| warehouseId | 倉庫ID. | no | no | yes | 整数 | ||
| buyerBatchNumber | バイヤーバッチ番号。 | no | yes | yes | 文字列 | ||
| supplierPartNumber | サプライヤー品番. | no | yes | yes | 文字列 | ||
| buyerPartNumber | バイヤー品番. | no | yes | yes | 文字列 | ||
| itemQuantity | アイテムの数量。 | yes | yes | yes | 整数 | ||
| sampleSize | サンプルサイズ。 | no | yes | yes | 整数 | ||
| uom | 数量単位. | yes | yes | yes | 整数 | ||
| requestedBy | クオリティチェックを依頼したユーザー。 | yes | yes | yes | 整数 | ||
| refDocumentType | 文書タイプ. | no | 購買 | yes | yes | 文字列 | |
| refDocumentId | 文書ID. | no | yes | yes | 文字列 | ||
| refDocumentItem | 文書項目。 | no | yes | yes | 文字列 | ||
| reviewedDate | レビューの日付 | no | no | yes | datetime | ||
| reviewedBy | レビューしたユーザー。 | no | no | yes | 文字列 | ||
| submittedDate | 送信日。 | no | no | yes | datetime | ||
| submittedBy | 送信したユーザー。 | no | no | yes | 文字列 | ||
| externalInspectionId | 外部検査のID。 | no | yes | yes | 文字列 | ||
| createdAt | クオリティチェックが作成されたとき。 | no | no | yes | datetime | ||
| createdBy | インスペクションを作成したユーザー。 | no | no | yes | 整数 | ||
| modifiedAt | 日付が変更されました。 | no | no | yes | datetime | ||
| modifiedBy | 変更したユーザー。 | no | no | yes | 整数 | ||
| exported | レコードがエクスポートされるかどうか。 | no | no | yes | boolean | ||
| 特性 | 検査に関連する特性記録。 | no | yes | yes | 特徴 |
クオリティチェックを受ける
- メソッド
GET
/qualitycollaboration/api/v 1/quality - inspections/{id}- cURLリクエスト例
curl -- location 'https ://<your-instance>.com/qualitycollaboration/api/v 1/quality - inspections/1 '\-- header' Accept: application/json '\-- header 'Accept: application/xml '\-- header'承認: • • • • • •'- レスポンス例
{" id ": 1, "type ":" Inspection ", "status ":" Closed ", "resolutionReasonText ":" accepted ", "dueDate ":" 2025 -11 -20 T 10:00:00 Z ", "supplierId ": 1," itemId ": 1, "itemName ":" Inspection Material ", "itemDescription ":" Inspection material ", "supplierPartNumber ":" SLNG -123 ", "buyerPartNumber ":" BLNG -123 ", "itemQuantity ": 50.000000 "," uom ": 1, "requestedBy ": 10," refDocumentType ": ": "Purchase Order "," refDocumentId ": "EXTPO_003 "," refDocumentItem ": "0010 "," createdAt ": "2025 -11 -04 T 16:07:02 Z "," modifiedAt ": ": "2025 -11 -04 T 16:17:49 Z "," exported ": false ", "characteristics ":[" id ": 1," lineNum ": 1, "inspectionId ": 1," name ": "Color" Color ", "type ": ":" isQuantitative ": "false," specification ": "clearless "" value ":" value "," characteristicVues ":" 1, "domainId ": 1," COLOR "value ":" value ", "value" 2 "value ": "," COLOR ": "2" value ", "value "" 2 ":" value" 2 ":"": "light yellow "}, {" id ": 3, "characteristicId ": 1," code ": "3 "," domain ": "COLOR "," value ": "No colour "}]," expectedResults ": {"id ": 1," characteristicId ": 1, "numericValue ": 3.000000}," expectedLimits ": [], "recordedCharacteristic ": {" id ": 1, "characteristicId ": 1," code ": "1 "}}, {" id ": 2, "lineNum ": 2," inspectionId ": 1, "name ":" non - volatile residue ", "type ":" required ", "isQuantitative ": true," specification ": "Not more than 0.1%"," valueType ": ": "numeric "," characteristicValues ":[], "expectedResults ": {" id ": 2, "characteristicId ": 2," numericValue ": 0.320000000, "valuePrecision ": 2}," expectedLimits ": [" id ": 1, "characteristicId ": 2," limitType "min "," comparisonOperator ": "gt," comparisonValue: 0.0000}, "id ": 2," maxId ": 2, "comparison ":" max ": Oper ":" 0%以下"," valueType ": ":" numericValue ": 0.32000000 ": 2, "expectedLimits ": 2," expectedLimits ": {": 1, "characteristicId ": 2," limitType ", "min ":" ": 2 ," numericValue ": 0.050000000 }},{" id ": 3 ," lineNum ": 3 ," inspectionId ": 1 ," name ":" Reducing substances "," type ":" required "," isQuantitative ": true ," specification ":" Not more than 70 mg/kg as sulfur dioxide "," valueType ":" numeric "," characteristicValues ":[]," expectedResults ":{" id ": 3 ," characteristicId ": 3 ," numericValue ": 55.000000000 ," valuePrecision ": 2 }," expectedLimits ":[{" id ": 3 ," characteristicId ": 3 ," limitType ":" min "," comparisonOperator ":" gt "," comparisonValue ": 0.000000 },{" id ": 4 ," characteristicId ": 3 ," limitType ":" max "," comparisonOperator ":" lt "," comparisonValue ": 70.000000 }]," recordedCharacteristic ":{" id: 3 ," characteristicId ": 3 ," numericValue ": 69.000000}}
品質検査を作成する
- メソッド
POST
/qualitycollaboration/api/v1/quality-inspections- cURLリクエスト例
curl --location 'https://<your-instance>/qualitycollaboration/api/v1/quality-inspections' \ --header 'Accept: application/json' \ --header 'Accept: application/xml' \ --header 'Content-Type: application/json' \ --header 'Authorization: ••••••' \ --data '{ "type": "inspection", "dueDate": "2025-12-20T10:00:00Z", "supplierId": 1, "itemId": 1, "supplierPartNumber": "SLNG-123", "buyerPartNumber": "BLNG-123", "buyerBatchNumber": "MPNBATCHNO-LNG456", "itemQuantity": 50.0, "sampleSize": 1, "uom": 1, "requestedBy": 10, "refDocumentType": "Purchase Order", "refDocumentId": "EXTPO_004", "refDocumentItem": "0010", "externalInspectionId": "EXT_QI_004", "characteristics": [ { "name": "Color", "type": "REQUIRED", "isQuantitative": false, "requirement": "Clear colourless ", "valueType": "CHOICE", "characteristicValues": [ { "code": "1", "domain": "COLOR", "value": "Yellow" }, { "code": "2", "domain": "COLOR", "value": "light yellow" }, { "code": "3", "domain": "COLOR", "value": "No colour" } ], "expectedResults": { "targetValue": "3" }, "expectedLimits": [] }, { "name": "Non-volatile residue", "type": "REQUIRED", "isQuantitative": true, "requirement": "Not more than 0.1%", "valueType": "NUMERIC", "characteristicValues": [], "expectedResults": { "targetValue": ".32", "valuePrecision": "2" }, "expectedLimits": [ { "limitType": "MIN", "comparisonOperator": "GT", "comparisonValue": "0" }, { "limitType": "MAX", "comparisonOperator": "LT", "comparisonValue": "0.1" } ] }, { "name": "Reducing substances", "type": "REQUIRED", "isQuantitative": true, "requirement": "Not more than 70 mg/kg as sulfur dioxide", "valueType": "NUMERIC", "characteristicValues": [], "expectedResults": { "targetValue": "55", "valuePrecision": "2" }, "expectedLimits": [ { "limitType": "MIN", "comparisonOperator": "GT", "comparisonValue": "0" }, { "limitType": "MAX", "comparisonOperator": "LT", "comparisonValue": "70" } ] } ] }'- レスポンス例
{ "id": 606, "type": "Inspection", "status": "Open", "dueDate": "2025-12-20T10:00:00Z", "supplierId": 1, "itemId": 1, "itemName": "Inspection Material", "itemDescription": "Inspection material", "supplierPartNumber": "SLNG-123", "buyerPartNumber": "BLNG-123", "itemQuantity": 50.0, "uom": 1, "requestedBy": 10, "refDocumentType": "Purchase Order", "refDocumentId": "EXTPO_004", "refDocumentItem": "0010", "createdAt": "2025-12-02T16:55:45.416467Z", "modifiedAt": "2025-12-02T16:55:51.185949Z", "exported": false, "characteristics": [ { "id": 2976, "lineNum": 1, "inspectionId": 606, "name": "Color", "type": "required", "isQuantitative": false, "specification": "Clear colourless ", "valueType": "choice", "characteristicValues": [ { "id": 3193, "code": "1", "domain": "COLOR", "value": "Yellow" }, { "id": 3194, "code": "2", "domain": "COLOR", "value": "light yellow" }, { "id": 3195, "code": "3", "domain": "COLOR", "value": "No colour" } ], "expectedResults": { "id": 2976, "characteristicId": 2976, "numericValue": 3 }, "recordedCharacteristic": { "id": 2976, "characteristicId": 2976 } }, { "id": 2977, "lineNum": 2, "inspectionId": 606, "name": "Non-volatile residue", "type": "required", "isQuantitative": true, "specification": "Not more than 0.1%", "valueType": "numeric", "expectedResults": { "id": 2977, "characteristicId": 2977, "numericValue": 0.32, "valuePrecision": 2 }, "expectedLimits": [ { "id": 3339, "limitType": "min", "comparisonOperator": "gt", "comparisonValue": 0 }, { "id": 3340, "limitType": "max", "comparisonOperator": "lt", "comparisonValue": 0.1 } ], "recordedCharacteristic": { "id": 2977, "characteristicId": 2977 } }, { "id": 2978, "lineNum": 3, "inspectionId": 606, "name": "Reducing substances", "type": "required", "isQuantitative": true, "specification": "Not more than 70 mg/kg as sulfur dioxide", "valueType": "numeric", "expectedResults": { "id": 2978, "characteristicId": 2978, "numericValue": 55, "valuePrecision": 2 }, "expectedLimits": [ { "id": 3341, "limitType": "min", "comparisonOperator": "gt", "comparisonValue": 0 }, { "id": 3342, "limitType": "max", "comparisonOperator": "lt", "comparisonValue": 70 } ], "recordedCharacteristic": { "id": 2978, "characteristicId": 2978 } } ] }