Budget Lines APIの呼び出し例
予算明細クエリオプションの取得
予算明細APIを使用して、必要な結果セットをクエリして取得する方法の詳細な例を次に示します。
このクエリは、予算期間名が既に定義されているすべての予算明細を返します
https ://.coupa.com/api/budget_lines?period [name<instance>] = 2009年度第3四半期
このクエリは、予算オーナーのすべての予算明細をラストネーム「カールトン」で返し、このオーナーも承認プロセスの一部であり、予算に影響を与える申請があることを返します。
https ://.coupahost.com/api/budget_lines?owner [<instance>lastname] = Carlton&owner_is_approver = true
このクエリは、名前の付いた勘定科目、勘定科目表、および会計期間が開いている勘定科目のセットに属するすべての予算項目を返します。
https ://.coupahost.com/api/budget_lines?period [account<instance> - type] [name] = chart + of + accounts&period [is_open] = true
予算品目の取得
この例では、次のIDを持つ単一の予算明細レコードを照会しました。
URLへのアクセスを行いました。
https :///api<instance url>/budget_lines/3
または
https :///api<instance url>/budget_lines? id = 3
検索条件に一致する回答は次のとおりです。
<?xml version="1.0" encoding="UTF-8"?>
<budget-line>
<id type="integer">577</id>
2009 <created-at type="datetime">-05 -04 T 18:00:58 - 07:00</created-at>
2014 <updated-at type="datetime">-04 -29 T 09:55:19 - 07:00</updated-at>
<notes />
会社のために購入した<description>新しいIT機器</description>
<amount type="decimal">128000.00</amount>
<remaining type="decimal">66883.00</remaining>
<owner-is-approver nil="true" />
<segment-1>本社</segment-1>
<segment-2>開発</segment-2>
<segment-3>資産</segment-3>
<segment-4 nil="true" />
<segment-5 nil="true" />
<segment-6 nil="true" />
<segment-7 nil="true" />
<segment-8 nil="true" />
<segment-9 nil="true" />
<segment-10 nil="true" />
<segment-11 nil="true" />
<segment-12 nil="true" />
<segment-13 nil="true" />
<segment-14 nil="true" />
<segment-15 nil="true" />
<segment-16 nil="true" />
<segment-17 nil="true" />
<segment-18 nil="true" />
<segment-19 nil="true" />
<segment-20 nil="true" />
<error-on-overrun type="boolean">true</error-on-overrun>
<period>
<id type="integer">2</id>
2008 <created-at type="datetime">-10 -28 T 11:27:45 - 07:00</created-at>
2011 <updated-at type="datetime">-06 -07 T 11:24:05 - 07:00</updated-at>
2009 <start-date type="datetime">-01 -01 T 00:00:00 - 08:00</start-date>
<end-date type="datetime">2009 -03 -31 T 01:00:00 - 07:00</end-date>
<is-open type="boolean">偽</is-open>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
<segment-1 type="boolean">true</segment-1>
<segment-2 type="boolean">true</segment-2>
<segment-3 type="boolean">true</segment-3>
<segment-4 nil="true" />
<segment-5 nil="true" />
<segment-6 nil="true" />
<segment-7 nil="true" />
<segment-8 nil="true" />
<segment-9 nil="true" />
<segment-10 nil="true" />
<segment-11 nil="true" />
<segment-12 nil="true" />
<segment-13 nil="true" />
<segment-14 nil="true" />
<segment-15 nil="true" />
<segment-16 nil="true" />
<segment-17 nil="true" />
<segment-18 nil="true" />
<segment-19 nil="true" />
<segment-20 nil="true" />
<name>Q 1 FY 09</name>
<account-type>
<id type="integer">1</id>
2008 <created-at type="datetime">-10 -27 T 13:10:01 - 07:00</created-at>
2014 <updated-at type="datetime">-03 -17 T 14:59:59 - 07:00</updated-at>
<name>エースコーポレート</name>
<active type="boolean">true</active>
<currency>
<id type="integer">1</id>
<code>USD</code>
</currency>
<primary-contact>
<id type="integer">14</id>
2008 <created-at type="datetime">-10 -27 T 13:10:01 - 07:00</created-at>
<updated-at type="datetime">2012 -01 -18 T 11:01:36 - 08:00</updated-at>
<email>upgrade@coupa.com</email>
<name-prefix nil="true" />
<name-suffix nil="true" />
<name-additional nil="true" />
<name-given>JILL</name-given>
<name-family>ハーカー</name-family>
<name-fullname nil="true" />
<notes nil="true" />
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</primary-contact>
<primary-address>
<id type="integer">17</id>
2008 <created-at type="datetime">-10 -27 T 13:10:01 - 07:00</created-at>
<updated-at type="datetime">2012 -01 -18 T 11:01:36 - 08:00</updated-at>
<name nil="true" />
<street1>28 Nevada Blvd</street1>
<street2 />
<city>ラフリン</city>
<state>NV</state>
<postal-code>94301</postal-code>
<attention nil="true" />
<active type="boolean">true</active>
<business-group-name nil="true" />
<country>
<id type="integer">223</id>
<code>米国</code>
<name>米国</name>
</country>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</primary-address>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">69</id>
<login>coupasupport+rohitdemo@coupa.com</login>
<email>coupasupport+rohitdemo@coupa.com</email>
<employee-number nil="true" />
<firstname>連携</firstname>
<lastname>ユーザー</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</account-type>
</period>
<owner>
<id type="integer">73</id>
<login>tri</login>
<email>trishanth.vallurupalli@coupa.com</email>
<employee-number />
<firstname>Trishanth</firstname>
<lastname>Vallurupalli</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</owner>
<currency>
<id type="integer">1</id>
<code>USD</code>
</currency>
<created-by>
<id type="integer">1</id>
<login>coupasupport</login>
<email>upgrade@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>サポート</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</created-by>
<updated-by>
<id type="integer">69</id>
<login>coupasupport+rohitdemo@coupa.com</login>
<email>coupasupport+rohitdemo@coupa.com</email>
<employee-number nil="true" />
<firstname>連携</firstname>
<lastname>ユーザー</lastname>
<salesforce-id nil="true" />
<mycustom-userfield />
</updated-by>
</budget-line>予算明細作成
この例では、既存の期間の予算明細を作成し、50000の金額を計算しています。参照オブジェクトにはCoupaシステムIDを使用していません。
次のURLに投稿しました。<instance>https ://.coupahost.com/api/budget_lines
<?xml version="1.0" encoding="UTF-8"?>
<budget_lines>
<segment_1>SAN_FRANCISCO</segment_1>
<segment_2>マーケティング</segment_2>
<segment_3>事務用品</segment_3>
maryの<description>予算</description>
<period>
<name>Q 2 2012</name>
</period>
<amount>50000</amount>
<owner>
<firstname>メアリー（マネージャー）</firstname>
<lastname>雪</lastname>
<login>msnow</login>
</owner>
</budget_lines>予算品目の更新-完全な更新
これらの例では、予算明細レコードのさまざまな情報を更新しています。
Https://coupahost.com/api/budget_lines/のURLを入力しまし<instance>た<budget line id>
たとえば、予算明細ID 616の予算の所有者を更新するには、次のようにします。
URL: https<instance> ://.coupahost.com/api/budget_lines/616
<?xml version="1.0" encoding="UTF-8"?>
<budget_lines>
<notes>Carltonは予算の所有者です</notes>
<description>これは2010年第2四半期の予算期間です</description>
<owner>
<login>マカールトン</login>
</owner>
</budget_lines>予算明細の更新-シンプルな更新
これらの例では、予算明細レコードの1つの属性を更新しています。
次のURLに置きました: https ://<instance url>/api/budget_lines/<budget line id>
たとえば、この予算明細に割り当てられた金額を予算明細ID 616で7500に更新するには
URL: https ://<instance url>/api/budget_lines/616
<?xml version="1.0" encoding="UTF-8"?>
<budget_lines>
<amount>7500</amount>
</budget_lines>