updateAccounts

curl の例

curl -H "Content-Type: text/xml" -d @C:/temp/updateAccounts.xml -X POST https://api.adaptiveplanning.com/api/v20

リクエストのフォーマット

<?xml version='1.0' encoding='UTF-8'?>
<call method="updateAccounts" callerName="a string that identifies your client application">
<credentials login="sampleuser@company.com" password="my_pwd"/>
<accounts proceedWithWarnings="0">
<account id="1441" code="LocalAssets" name="LocalAssets" shortName="" description="Local Assets"
displayAs="CURRENCY" decimalPrecision="0" suppressZeroes="1"
exchangeRateType="E" isIntercompany="0" planBy="DELTA" timeRollup="LAST" hasSalaryDetail="0" dataPrivacy="PRIVATE"
subType="CUMULATIVE" enableActuals="1">
<account id="1610" code="LocalCashAssets" name="Local Cash Assets" shortName="" description="cash assets"
displayAs="CURRENCY" decimalPrecision="0" suppressZeroes="1"
exchangeRateType="E" isIntercompany="0" planBy="DELTA"
timeRollup="LAST" hasSalaryDetail="0" dataPrivacy="PRIVATE"
subType="CUMULATIVE" enableActuals="1" propagateToDescendants="1">
  <attribute name="SEC Reporting" value="Yes" />
  <attribute name="GAAP Reporting" value="No" />
</account>
</account>
</accounts>
</call>

更新対象の科目は内部 ID 番号によって識別されます。
新規科目を作成するには、空白または ID プロパティがない科目を指定します。
既存の (新規ではない) アイテムを移動して、新しいアイテムの子にすることができます。これにより、新しいアイテムが作成され、既存のアイテムが子としてその下に移動します。
API v31 以降の場合、既存の親とその子科目の間に新しい親科目を作成できます。

科目の親を再設定

updateAccounts
子の特性値が新しい親特性と互換性がない場合、エラーが発生します。例: reparentedAccount1 特性の SEC レポート値 = いいえ。newParentAccount2 の SEC レポート値 = はいのため、互換性がありません。
updateAccounts
次の場合に、親の再設定中に互換性のない特性値が新しい親と一致するように修正されます。
proceedWithWarnings=1.
科目の親を再設定すると循環関係を作成できません。
親の再設定は、システムで生成されたルート科目では許可されていません。
Assets, Liabilities and Equities, Net Income, PL Income, Non-Operating Income, PL COGS, PL Expense, Non-Operating Expenses
。

最下位科目の子

最下位科目の最初の子は新しい科目のみにすることができます。既存の GL 科目を既存の最下位科目の下に移動することはできません。
親の再設定中に科目が最初の子を取得すると、"インテグレーション" > "インポート科目マッピング" にある科目マッピングは削除されます。
科目の親を再設定する場合、
balanceType
および
subType
プロパティは親の GL 科目から継承されます。

キューブ科目とキューブ入力データ

キューブ入力科目は、親の再設定が可能です。
親の再設定が可能な科目は、ソースとターゲットのサブツリーにキューブ入力データがない科目のみです。
キューブ/ミックス科目の親の再設定はできません。
キューブ アカウントの下にある新しい科目は許可されていません。STANDARD/mixed ACCOUNT の下の新しい科目を使用できます。

新規科目を作成するためのリクエスト形式

<?xml version='1.0' encoding='UTF-8'?>
<call method="updateAccounts" callerName="Steve C">
<credentials login="sampleuser@company.com" password="my_password"/>
<accounts>
 <account id="1441">
   <account id="" code="newLocalAssets" name="new Local Assets" description="new local assets account for this area" shortName="" >
   </account>
 </account>
</accounts>
</call>

1 回の updateAccounts コールでの複数の名前変更の処理

ID     Unique Value   New Unique Value
1      AA             BB
2      BB             AA

ID     Unique Value   New Unique Value
1      AA             BB
2      BB             CC
3      CC             AA

ID     Unique Value   New Unique Value
4                     AA
1      AA             BB
2      BB             Old BB

上から下へのペイロード処理

Product Line|__A        __A                                
|__B-Ste    __B-Ste
  |__B1      __Product B-1
  |__B2      __Product B-2
  |__B3      __Product B-3

科目属性を含む元のリクエスト XML の例

<accounts>
 <account id="60" code="70140" name="Other Accounts">
 <attribute name="Product Line" value="A"  />
    <account id="91" code="70150" name="Swiss Bank">
       <attribute name="Product Line" value="A"  />
    </account>
 </account>
</accounts>

ペイロード処理の順序の誤りの例

<accounts>
 <account id="60" code="70140" name="Other Accounts">
    <account id="91" code="70150" name="Swiss Bank">
       <attribute name="Product Line" value="B-1"  />
    </account>
    <attribute name="Product Line" value="B-Ste"  /> <!-- Account Attribute change ignored due to placement order-->
 </account>
</accounts>

ペイロード処理の有効な順序の例

<accounts>
 <account id="60" code="70140" name="Other Accounts">
    <attribute name="Product Line" value="B-Ste"  /> <!-- Account Attribute change processed due to correct placement order-->
    <account id="91" code="70150" name="Swiss Bank">
       <attribute name="Product Line" value="B-1"  />
    </account>
 </account>
</accounts>

回答フォーマット

<?xml version="1.0" encoding="UTF-8"?>
<response success="true">
<messages>
<message type="INFO">Accounts were saved successfully.</message>
</messages>
<output>
<accounts>
 <account id="1441" code="LocalAssets" name="LocalAssets" shortName="" description="Local Assets"displayAs="CURRENCY"
 decimalPrecision="0" suppressZeroes="true" exchangeRateType="E" formula="" isIntercompany="0"
 planBy="DELTA" timeRollup="LAST" timeWeightAcctId="" levelDimRollup="SUM" levelDimWeightAcctId="" rollupText=""
 startExpanded="true" hasSalaryDetail="" dataPrivacy="PRIVATE" isBreakbackEligible="" subType="CUMULATIVE" enableActuals="true">
   <account id="1610" code="LocalCashAssets" name="Local Cash Assets" shortName="" description="cash assets" displayAs="CURRENCY"
   decimalPrecision="0" suppressZeroes="true" exchangeRateType="E" formula="" isIntercompany="0" planBy="DELTA" timeRollup="LAST"
   timeWeightAcctId="" levelDimRollup="SUM" levelDimWeightAcctId="" rollupText="" startExpanded="true" hasSalaryDetail=""
   dataPrivacy="PRIVATE" isBreakbackEligible="" subType="CUMULATIVE" enableActuals="true">
   </account>
 </accounts>
</output>
</response>