承認APIコールの例

例

この例では、IDが12622の承認を1件検索しました。URLにGETしました： //<instance>.coupahost.com/api/requisitions?status=ordered&created-at[gt]=2010-01-01&created-at[lt]=2010-02-01 

承認の返答の取得

<?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を使用して承認に対するアクションを実行する方法について説明します。

承認中

<インスタンスurl>/api/approvals//approve

却下中

<インスタンスurl>/api/approvals//reject

理由を追加しています

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

https://<instance url>/api/approvals/12612/reject?reason=Rejected%20by%20Integration

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