承認APIの呼び出し例

例

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

承認GETレスポンス
<?xml version="1.0" encoding="UTF-8"?> <approval> <id type="integer">12622</id> <created-at type="datetime">2012 -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> <approval-date type="datetime">2012 -02 -15 T 14: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を使って承認に対してアクションを実行する方法の説明です。

承認中

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

却下中

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

理由の追加

どちらの場合も、アクションを有効にするには、承認が保留中(まだ承認または却下されていない)である必要があります。 また、XMLリクエストを介して、却下の「理由」を直接提供することも可能です。 たとえば、ID 12612による承認を拒否し、「連携によって拒否された」理由を提供するには、次のリクエストを使用します。

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

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