Spendia Open API

コストセンター値作成

OpenAPI説明

本APIはコストセンター値の作成に利用します

OpenAPI権限

本APIはグループモードの権限が必要です

旧バージョンの入口

既に古いバージョンでコストセンター値のマネージャーを登録するお客様は、続けて古いバージョンを利用可能です。

【Ver1.0 バージョン】へ

リクエストURI

/api/openapi/cost/center/items/V2

リクエスト形式

POST

リクエスト例

{
  "costCenterCode": "PROJECT",
  "name": "SpendiaDep",
  "code": "costCenterItemCode",
  "parentCode": "CCI_001",
  "sequenceNumber": "1",
  "setOfBooksCode": "DEFAULT_SOB",
  "isEnabled": true,
  "isPublic": false,
  "startDate": "2021-01-01",
  "endDate": "2021-01-02",
  "isApplyAllCompanies": true,
  "primaryDepartmentCode":"dept001",
  "secondaryDepartmentCodes":"dept002",
  "remarkForInquiry":"カスタマイズ項目情報",
  "customFields":[
    {
      "fieldCode":"Test",
      "value":"1"
    }
  ]
}

リクエスト項目

項目 タイプ 必須 キー 制限 説明
costCenterCode String ○ ○ 最大36文字 コストセンターコード
name String ○ 最大150文字 コストセンター値名称
code String ○ ○ 最大36文字 コストセンター値コード
parentCode String 最大36文字 上級コストセンター値コード。上級コストセンター値に関連付けた場合は、Nullにしてはいけません
sequenceNumber Long 正整数で最大10桁 表示順
setOfBooksCode String ○ ○ 最大36文字 所属元帳コード
isEnabled Boolean 有効/無効(デフォルト有効)
startDate Date 日付フォーマット：yyyy-MM-dd 有効開始日
endDate Date 日付フォーマット：yyyy-MM-dd 有効終了日
isPublic Boolean 共通項目かどうか。デフォルトfalse
isApplyAllCompanies Boolean 全ての会社に適用するかどうか。デフォルトtrue
primaryDepartmentCode String 主要部門コード
secondaryDepartmentCodes String 子部門コード。 複数ある場合は、カンマで区切る
remarkForInquiry String 最大50文字 備考(検索用)
customFields List <FormField> カスタマイズ項目

CustomField

パラメータ名 タイプ 必須 キー 規則 説明
fieldCode String ○ ○ 最大50文字 カスタマイズ項目コード
value String 最大500文字 カスタマイズ項目値、カスタマイズ項目の設定が必須の場合はカスタマイズ項目値は必須入力です

OpenAPIリターン例

成功例

{
  "message": "success",
  "oid": "6e060119-c09e-4d6d-b226-b490e229346b",
  "key": "costCenterItemCode"
}

失敗例

{
    "message": "コストセンターは存在しません",
    "errorCode": "120402"
}

項目説明

項目 タイプ 説明
message String エラーメッセージ
oid UUID コストセンター値OID
key String コストセンター値コード
errorCode String エラーコード

エラーコード説明

errorCode message 説明
0013 {0}は{1}文字以内で指定してください
120003 {0}は指定必須の項目です
120004 パラメタ桁数超過{0}、長さは{1}から{2}の文字の間で設定をお願いします
120112 部門は存在しない{0}
120402 コストセンターは存在しません
120504 コストセンター値が既に存在しています
120515 コストセンター値のNo. は正整数かつ10文字以下です
120526 上級コストセンター値を入力してください
120527 当該上級コストセンター値は対応上級コストセンターに存在しません
120528 上級コストセンターを設定してください
120529 上級コストセンター値は無効です
120540 部門もう無効になりました:{0}
121802 指定した元帳は存在しません
6061006 カスタマイズ項目:{0} の値は正しくありません
60390022 有効な所属情報（主務）が登録されていません(従業員番号{0}、氏名{1}、基準日{2})。管理者に確認してください。
120237 コストセンター値カスタマイズ項目コードは存在しません：{0}
120238 コストセンター値カスタマイズ項目は最大10個まで可能です。
120239 コストセンター値カスタマイズ項目コードを指定ください。
120240 コストセンター値カスタマイズ項目値を入力してください。
120241 コストセンター値カスタマイズ項目コードは既に存在します。
120007 指定したコードに半角英数字、.（ピリオド）、_（アンダーバー）、-（ハイフン）以外の文字が含まれています
6013009 日付フォーマットはyyyy-MM-ddです
6049010 有効日（至）は有効日（自）より過去に指定できません。
6061008 カスタマイズ項目:{0} の整数部は{0}桁以内で指定してください
6061009 カスタマイズ項目:{0} の小数部は{0}桁以内で指定してください
6061011 カスタマイズ項目:{0} は日付フォーマットyyyy-MM-ddで指定してください

コストセンター値更新 →