Approvals API（/approvals）

承認APIを使用して、ドキュメントの承認を作成、更新、または照会します。これには、アクション（却下/保留/承認）を実行する特定のエンドポイントと、申請者、品目、発送詳細などの申請書の詳細が含まれます。

承認APIにアクセスするためのURLは次のとおりです。 https://<instance>/api/approvals/<approval id>

詳細については、 「インテグレーションのベストプラクティス 」を参照してください。

アクション

要素

これらは承認APIで使用できる要素です

例

この例では、IDが12622の承認を1件検索しました。URLにGETしました： 

https://<instance url>/api/approvals/12622 

承認の返答の取得

<?xml version="1.0" encoding="UTF-8"?>
<approval>
	 <id type="integer">12622</id>
	 <created-at type="datetime">2012-02-15T14:56:22-08:00</created-at>
	 <updated-at type="datetime">2012-04-23T11:49:25-07:00</updated-at>
	 <position type="integer">1</position>
	 <approval-chain-id nil="true" />
	 <status>approved</status>
	 <approval-date type="datetime">2012-02-15T14:56:59-08:00</approval-date>
	 <note />
	 <type>ManagementHierarchyApproval</type>
	 <approvable-type>RequisitionHeader</approvable-type>
	 <approvable-id type="integer">2696</approvable-id>
	 <approver>
			<id type="integer">3</id>
			<login>vpierre</login>
			<email>upgrade+vp@coupa.com</email>
			<employee-number />
			<firstname>Victor (CFO)</firstname>
			<lastname>Pierre</lastname>
			<salesforce-id nil="true" />
	 </approver>
	 <created-by>
			<id type="integer">9</id>
			<login>bjenkins</login>
			<email>upgrade+bj@coupa.com</email>
			<employee-number />
			<firstname>Bob (VP Procurement)</firstname>
			<lastname>Jenkins</lastname>
			<salesforce-id nil="true" />
	 </created-by>
<updated-by>
			<id type="integer">17</id>
			<login>coupa_metrics_gatherer</login>
			<email>do_not_reply_metrics@coupa.com</email>
			<employee-number nil="true" />
			<firstname>Coupa</firstname>
			<lastname>Metrics</lastname>
			<salesforce-id nil="true" />
	 </updated-by>
</approval>

承認または却下

以下では、Coupa APIを使用して承認に対するアクションを実行する方法について説明します。

承認中

/api/approvals/{id}/approve

却下中

/api/approvals/{id}/reject

理由を追加しています

どちらの場合も、アクションを有効にするには、承認を[保留中]（およびまだ承認または却下されていない）にする必要があります。XMLリクエストを介して却下の「理由」を直接提供することもできます。たとえば、12612というIDで承認を却下し、「インテグレーションによって却下」という理由を入力するには、次のリクエストを使用します。  

PUT https://{instance url}/api/approvals/12612/reject?reason=Rejected%20by%20Integration

成功したリクエストは返り HTTP 200 Responseます。回答の本文には、作成された申請書が含まれます。失敗したリクエストは返 HTTP 400 Bad Requestされる。応答の本文には、XMLとしてフォーマットされた検証エラーが含まれます。