承認APIの呼び出しの例

例

この例では、IDが12622の単一の承認を照会しました。次のURLにアクセスしました。//.coupahost.com/api/requisitions?status=ordered&created-at [<instance>gt ]= 2010 -01 -01 & created - at [lt ]= 2010 -02 -01 

承認は応答を取得します

<?xml version="1.0" encoding="UTF-8"?>

<approval>

	 <id type="integer">12622</id>

	 2012 <created-at type="datetime">-02 -15 T 14:56:22 - 08:00</created-at>

	 <updated-at type="datetime">2012 -04 -23 T 11:49:25 - 07:00</updated-at>

	 <position type="integer">1</position>

	 <approval-chain-id nil="true" />

	 <status>承認済み</status>

	 2012 <approval-date type="datetime">-02 -15 T 14:56:59 - 08:00</approval-date>

	 <note />

	 <type>ManagementHierarchyApproval</type>

	 請求<approvable-type>ヘッダー</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>ピエール</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>ボブ(購買・調達部長)</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>指標</lastname>

			<salesforce-id nil="true" />

	 </updated-by>

</approval>

承認または却下

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

承認中

<instance url>/api/approvals<approval id> // approve

却下中

<instance url>/api/approvals<approval id> // reject

理由を追加

どちらの場合も、アクションを有効にするには、承認は保留中（まだ承認または却下されていない）でなければなりません。また、XMLリクエストを介して、拒否の「理由」を直接提供することも可能です。たとえば、ID 12612による承認を拒否し、「インテグレーションによって拒否された」理由を提供するには、次のリクエストを使用します。

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

 要求が成功すると、HTTP 200応答が返されます。レスポンスの本文には、作成された申請書が含まれます。要求が失敗すると、HTTP 400 Bad Requestが返されます。応答の本文には、XML形式の検証エラーが含まれます。