アカウントAPIの呼び出しの例
質問オプション
アカウントAPIを使用してアカウントのセットをクエリする方法の例を以下に示します。
これにより、すべての非アクティブなアカウントが返されます:
https<instance name> ://.coupahost.com/api/accounts?active=false
セグメント1で「SF」の値を持つすべてのアカウントコードが返されます:
https<instance name> ://.coupahost.com/api/accounts?segment-1=SF
単一アカウントを取得する
この例では、IDが13の単一のアカウントを照会しました。
次のURLにアクセスしました: https<instance> ://.coupahost.com/api/accounts/13
<?xml version="1.0" encoding="UTF-8"?>
<account>
<active type="boolean">偽</active>
SF - Marketing -<code> Indirect</code>
<id type="integer">13</id>
<name />
<segment-1>SF</segment-1>
<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-2>マーケティング</segment-2>
<segment-20 nil="true" />
<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" />
<account-type>
<id type="integer">1</id>
企業の<name>エース</name>
</account-type>
</account>
アカウント名でアカウントを作成
この例では、指定されたアカウント名でアカウントを作成しています。
次のURLに投稿しました。https ://.coupahost.com/api/accounts
<?xml version="1.0" encoding="UTF-8"?>
<account>
<active type="boolean">true</active>
<name>デモ口座名義</name>
<segment-1>SF</segment-1>
<segment-2>マーケティング</segment-2>
<segment-3>経費</segment-3>
<account-type>
企業の<name>エース</name>
</account-type>
</account>
上記の投稿からの返信は次のとおりです。
<?xml version="1.0" encoding="UTF-8"?>
<account>
<active type="boolean">true</active>
SF - Marketing -<code> Expense</code>
<id type="integer">206</id>
<name>デモ口座名義</name>
<segment-1>SF</segment-1>
<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-2>マーケティング</segment-2>
<segment-20 nil="true" />
<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" />
<account-type>
<id type="integer">1</id>
<name>エースコーポレート</name>
</account-type>
</account>
3つのセグメントで勘定科目を作成
この例では、3つのセグメントを持つアカウントを作成しています。
次のURLに投稿しました。https<instance> ://.coupahost.com/api/accounts
<?xml version="1.0" encoding="UTF-8"?>
<account>
<active type="boolean">true</active>
<segment-1>SF</segment-1>
<segment-2>マーケティング</segment-2>
<segment-3>直接</segment-3>
<account-type>
<name>エースコーポレート</name>
</account-type>
</account>
以下は、上記を投稿したときに返信を受け取ったものです。
<?xml version="1.0" encoding="UTF-8"?>
<account>
<active type="boolean">true</active>
SF -マーケティング-<code>ダイレクト</code>
<id type="integer">205</id>
<name nil="true" />
<segment-1>SF</segment-1>
<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-2>マーケティング</segment-2>
<segment-20 nil="true" />
<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" />
<account-type>
<id type="integer">1</id>
<name>エース企業</name>
</account-type>
</account>
勘定科目変更区分2を更新
この例では、アカウントのセグメント2を「9999」に変更してアカウントを更新し
ています。次のURLに投稿しました<account id>。<instance>https ://.coupahost.com/api/accounts/
<?xml version="1.0" encoding="UTF-8"?>
<account>
<segment-2>9999</segment-2>
</account>
アクティブな勘定科目セットの更新
この例では、アカウントを更新し、アクティブに設定しています。
次のURLに投稿しました。https<instance> ://.coupahost.com/api/accounts/<account id>
<?xml version="1.0" encoding="UTF-8"?>
<account>
<active>true</active>
</account>