承認APIの呼び出し例

最後の更新
PDFとして保存

このページは機械翻訳を使用して翻訳されています。

例

この例では、ID 12622の単一承認を照会しました。次のURLにGETを実行しました：//<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-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を使用して承認に対してアクションを実行する方法について説明しています。

承認中

<instance url>/ api / approvals /<approval id> /承認

拒否

<instance url>/ api / approvals /<approval id> /拒否

理由を追加

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

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

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