ファインアセット
ファインアセットWebAPIについて説明します。
APIエンドポイントやアクセストークンによる認証についてはファインアセットWebAPI概要をご確認ください。
アクセストークン
POST /ws/s3/v1/authenticate/token  アクセストークンの発行 ▼

目的

API連携キーよりアクセストークンを発行します。

パラメータ

Request body（Content-Type: application/json）

フィールド 必須 説明
grant-type 〇 アクセストークン発行の手続き方法を指定します("client_credentials" を指定してください)
contract-id 〇 契約IDを指定します
api-key 〇 Web画面にて発行したAPI連携キーを指定します

レスポンス

コード 説明
200 
{
    "access_token": "{アクセストークン文字列}",
    "token_type": "bearer",
    "expires_in": 28800
}
資産情報
GET /ws/s3/v1/assetInfo/{assetNumber}  資産情報の取得 ▼

目的

指定した資産管理番号の資産情報を取得します。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します

レスポンス

コード 説明
200
本APIのレスポンスに含まれる value は、資産項目の形式（asset_item_format）によって返却形式が異なります。
・TEXT、TEXTAREA、DATE、NUMBER、MONEY の場合は文字列を返却します
・LIST の場合は、コードおよび名称を含むオブジェクトを返却します
・項目「使用者」の場合は、ログインIDおよび利用者名を含むオブジェクトを返却します
・FILE の場合は、ファイル情報を含むオブジェクトを返却します

FILE形式の項目「画像」については、レスポンス内のfile にBase64エンコードした文字列を返却します。
画像以外のFILE形式の項目については、file に null を返却します。
※ファイルデータを取得する場合は、「添付ファイル取得API」をご利用ください 
{
    "asset_id": 1,
    "item_values": [
        {
            "asset_item_code": "item_001",
            "asset_item_name": "資産管理番号",
            "asset_item_format": "TEXT",
            "value": "000001"
        },
        {
            "asset_item_code": "item_003",
            "asset_item_name": "資産区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "デスクトップパソコン"
            }
        },
        {
            "asset_item_code": "item_004",
            "asset_item_name": "資産名称",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_005",
            "asset_item_name": "状態",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "使用中"
            }
        },
        {
            "asset_item_code": "item_006",
            "asset_item_name": "使用者",
            "asset_item_format": "TEXT",
            "value": {
                "code": "000001",
                "name": "中央 太郎"
            }
        },
        {
            "asset_item_code": "item_007",
            "asset_item_name": "管理部署",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "総務部"
            }
        },
        {
            "asset_item_code": "item_008",
            "asset_item_name": "所在",
            "asset_item_format": "LIST",
            "value": {
                "code": "01",
                "name": "本社"
            }
        },
        {
            "asset_item_code": "item_009",
            "asset_item_name": "導入日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_010",
            "asset_item_name": "導入区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "02",
                "name": "リース"
            }
        },
        {
            "asset_item_code": "item_011",
            "asset_item_name": "契約開始日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_012",
            "asset_item_name": "契約終了日",
            "asset_item_format": "DATE",
            "value": "2027/12/02"
        },
        {
            "asset_item_code": "item_013",
            "asset_item_name": "リース・レンタル会社名",
            "asset_item_format": "TEXT",
            "value": "ファインアセット株式会社"
        },
        {
            "asset_item_code": "item_014",
            "asset_item_name": "リース・レンタル契約番号",
            "asset_item_format": "TEXT",
            "value": "FA-001"
        },
        {
            "asset_item_code": "item_015",
            "asset_item_name": "メーカ名",
            "asset_item_format": "TEXT",
            "value": "FA機器株式会社"
        },
        {
            "asset_item_code": "item_016",
            "asset_item_name": "製品名",
            "asset_item_format": "TEXT",
            "value": "DPC-Seriese 840"
        },
        {
            "asset_item_code": "item_017",
            "asset_item_name": "製品番号",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_018",
            "asset_item_name": "備考",
            "asset_item_format": "TEXT_AREA",
            "value": "修理履歴：なし"
        },
        {
            "asset_item_code": "file_001",
            "asset_item_name": "画像",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "製品イメージ.jpg",
                "file": "{BASE64_ENCODED_DATA}"
            }
        },
        {
            "asset_item_code": "file_002",
            "asset_item_name": "添付",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "操作マニュアル.pdf",
                "file": null
            }
        },	
    ],
    "status": null,
    "update_date": "2026/09/28 11:20:44"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
POST /ws/s3/v1/assetInfo/regist  資産情報の登録 ▼

目的

資産情報を新規登録します。
操作元は"WebAPI"として記録されます。

パラメータ

Request body（Content-Type: application/json）

フィールド 必須 説明
item_values 〇 資産項目および値を指定します
List<T>　配列 
"item_values": [
    {
        "asset_item_code": "item_001",
        "value": "000001"
    },
    {
        "asset_item_code": "item_003",
        "value": "001"
    },
    {
        "asset_item_code": "item_004",
        "value": "DPC00171"
    },
    {
        "asset_item_code": "item_005",
        "value": "001"
    },
    {
        "asset_item_code": "item_006",
        "value": "000001"
    },
    {
        "asset_item_code": "item_007",
        "value": "001"
    },
    {
        "asset_item_code": "item_008",
        "value": "01"
    },
    {
        "asset_item_code": "item_009",
        "value": "2026/12/02"
    },
    {
        "asset_item_code": "item_010",
        "value": "02"
    },
    {
        "asset_item_code": "item_011",
        "value": "2026/12/02"
    },
    {
        "asset_item_code": "item_012",
        "value": "2027/12/02"
    },
    {
        "asset_item_code": "item_013",
        "value": "ファインアセット株式会社"
    },
    {
        "asset_item_code": "item_014",
        "value": "FA-001"
    },
    {
        "asset_item_code": "item_015",
        "value": "FA機器株式会社"
    },
    {
        "asset_item_code": "item_016",
        "value": "DPC-Seriese 840"
    },
    {
        "asset_item_code": "item_017",
        "value": "DPC00171"
    },
    {
        "asset_item_code": "item_018",
        "value": "修理履歴：なし"
    },
    {
        "asset_item_code": "file_001",
        "value": {
            "file_name": "製品イメージ.jpg",
            "file": "{BASE64_ENCODED_DATA}"
        }
    },
    {
        "asset_item_code": "file_002",
        "value": {
            "file_name": "操作マニュアル.pdf
            "file": "{BASE64_ENCODED_DATA}"
        }
    }
]
exec_user_login_id 〇 資産登録を実施する利用者のログインIDを指定します
memo 資産の登録理由を指定します

レスポンス

コード 説明
200
本APIのレスポンスに含まれる value は、資産項目の形式（asset_item_format）によって返却形式が異なります。
・TEXT、TEXTAREA、DATE、NUMBER、MONEY の場合は文字列を返却します
・LIST の場合は、コードおよび名称を含むオブジェクトを返却します
・項目「使用者」の場合は、ログインIDおよび利用者名を含むオブジェクトを返却します
・FILE の場合は、ファイル情報を含むオブジェクトを返却します

FILE形式の項目「画像」については、レスポンス内のfile にBase64エンコードした文字列を返却します。
画像以外のFILE形式の項目については、file に null を返却します。
※ファイルデータを取得する場合は、「添付ファイル取得API」をご利用ください 
{
    "asset_id": 1,
    "item_values": [
        {
            "asset_item_code": "item_001",
            "asset_item_name": "資産管理番号",
            "asset_item_format": "TEXT",
            "value": "000001"
        },
        {
            "asset_item_code": "item_003",
            "asset_item_name": "資産区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "デスクトップパソコン"
            }
        },
        {
            "asset_item_code": "item_004",
            "asset_item_name": "資産名称",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_005",
            "asset_item_name": "状態",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "使用中"
            }
        },
        {
            "asset_item_code": "item_006",
            "asset_item_name": "使用者",
            "asset_item_format": "TEXT",
            "value": {
                "code": "000001",
                "name": "中央 太郎"
            }
        },
        {
            "asset_item_code": "item_007",
            "asset_item_name": "管理部署",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "総務部"
            }
        },
        {
            "asset_item_code": "item_008",
            "asset_item_name": "所在",
            "asset_item_format": "LIST",
            "value": {
                "code": "01",
                "name": "本社"
            }
        },
        {
            "asset_item_code": "item_009",
            "asset_item_name": "導入日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_010",
            "asset_item_name": "導入区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "02",
                "name": "リース"
            }
        },
        {
            "asset_item_code": "item_011",
            "asset_item_name": "契約開始日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_012",
            "asset_item_name": "契約終了日",
            "asset_item_format": "DATE",
            "value": "2027/12/02"
        },
        {
            "asset_item_code": "item_013",
            "asset_item_name": "リース・レンタル会社名",
            "asset_item_format": "TEXT",
            "value": "ファインアセット株式会社"
        },
        {
            "asset_item_code": "item_014",
            "asset_item_name": "リース・レンタル契約番号",
            "asset_item_format": "TEXT",
            "value": "FA-001"
        },
        {
            "asset_item_code": "item_015",
            "asset_item_name": "メーカ名",
            "asset_item_format": "TEXT",
            "value": "FA機器株式会社"
        },
        {
            "asset_item_code": "item_016",
            "asset_item_name": "製品名",
            "asset_item_format": "TEXT",
            "value": "DPC-Seriese 840"
        },
        {
            "asset_item_code": "item_017",
            "asset_item_name": "製品番号",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_018",
            "asset_item_name": "備考",
            "asset_item_format": "TEXT_AREA",
            "value": "修理履歴：なし"
        },
        {
            "asset_item_code": "file_001",
            "asset_item_name": "画像",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "製品イメージ.jpg",
                "file": "{BASE64_ENCODED_DATA}"
            }
        },
        {
            "asset_item_code": "file_002",
            "asset_item_name": "添付",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "操作マニュアル.pdf",
                "file": null
            }
        },
    ],
    "status": null,
    "update_date": "2026/09/28 11:20:44"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・登録実施者として指定したログインIDの利用者が在籍していない、または未登録
・資産登録の件数上限を超過
・指定した項目値にてバリデーションエラー（validationにエラー原因を返します）
・資産管理番号の自動採番エラー（採番ルール未設定 / 採番ルールが未割当 / 連番桁数の上限超過）
・資産情報のインポート処理が実行中
POST /ws/s3/v1/assetInfo/{assetNumber}/update  資産情報の更新 ▼

目的

指定した資産管理番号の資産情報を更新します。
操作元は"WebAPI"として記録されます。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します

Request body（Content-Type: application/json）

フィールド 必須 説明
item_values 〇 更新する資産項目および値を指定します
List<T>　配列 
"item_values": [
    {
        "asset_item_code": "item_004",
        "value": "DPC00171"
    },
    {
        "asset_item_code": "item_005",
        "value": "002"
    },
    {
        "asset_item_code": "item_006",
        "value": "000001"
    },
    {
        "asset_item_code": "item_007",
        "value": "001"
    },
    {
        "asset_item_code": "file_001",
        "value": {
            "file_name": "製品イメージ.jpg",
            "file": "{BASE64_ENCODED_DATA}"
        }
    }
]
exec_user_login_id 〇 資産更新を実施する利用者のログインIDを指定します
memo 資産の更新理由を指定します

レスポンス

コード 説明
200
本APIのレスポンスに含まれる value は、資産項目の形式（asset_item_format）によって返却形式が異なります。
・TEXT、TEXTAREA、DATE、NUMBER、MONEY の場合は文字列を返却します
・LIST の場合は、コードおよび名称を含むオブジェクトを返却します
・項目「使用者」の場合は、ログインIDおよび利用者名を含むオブジェクトを返却します
・FILE の場合は、ファイル情報を含むオブジェクトを返却します

FILE形式の項目「画像」については、レスポンス内のfile にBase64エンコードした文字列を返却します。
画像以外のFILE形式の項目については、file に null を返却します。
※ファイルデータを取得する場合は、「添付ファイル取得API」をご利用ください 
{
    "asset_id": 1,
    "item_values": [
        {
            "asset_item_code": "item_001",
            "asset_item_name": "資産管理番号",
            "asset_item_format": "TEXT",
            "value": "000001"
        },
        {
            "asset_item_code": "item_003",
            "asset_item_name": "資産区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "デスクトップパソコン"
            }
        },
        {
            "asset_item_code": "item_004",
            "asset_item_name": "資産名称",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_005",
            "asset_item_name": "状態",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "使用中"
            }
        },
        {
            "asset_item_code": "item_006",
            "asset_item_name": "使用者",
            "asset_item_format": "TEXT",
            "value": {
                "code": "000001",
                "name": "中央 太郎"
            }
        },
        {
            "asset_item_code": "item_007",
            "asset_item_name": "管理部署",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "総務部"
            }
        },
        {
            "asset_item_code": "item_008",
            "asset_item_name": "所在",
            "asset_item_format": "LIST",
            "value": {
                "code": "01",
                "name": "本社"
            }
        },
        {
            "asset_item_code": "item_009",
            "asset_item_name": "導入日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_010",
            "asset_item_name": "導入区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "02",
                "name": "リース"
            }
        },
        {
            "asset_item_code": "item_011",
            "asset_item_name": "契約開始日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_012",
            "asset_item_name": "契約終了日",
            "asset_item_format": "DATE",
            "value": "2027/12/02"
        },
        {
            "asset_item_code": "item_013",
            "asset_item_name": "リース・レンタル会社名",
            "asset_item_format": "TEXT",
            "value": "ファインアセット株式会社"
        },
        {
            "asset_item_code": "item_014",
            "asset_item_name": "リース・レンタル契約番号",
            "asset_item_format": "TEXT",
            "value": "FA-001"
        },
        {
            "asset_item_code": "item_015",
            "asset_item_name": "メーカ名",
            "asset_item_format": "TEXT",
            "value": "FA機器株式会社"
        },
        {
            "asset_item_code": "item_016",
            "asset_item_name": "製品名",
            "asset_item_format": "TEXT",
            "value": "DPC-Seriese 840"
        },
        {
            "asset_item_code": "item_017",
            "asset_item_name": "製品番号",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_018",
            "asset_item_name": "備考",
            "asset_item_format": "TEXT_AREA",
            "value": "修理履歴：なし"
        },
        {
            "asset_item_code": "file_001",
            "asset_item_name": "画像",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "製品イメージ.jpg",
                "file": "{BASE64_ENCODED_DATA}"
            }
        },
        {
            "asset_item_code": "file_002",
            "asset_item_name": "添付",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "操作マニュアル.pdf",
                "file": null
            }
        },	
    ],
    "status": null,
    "update_date": "2026/09/28 11:20:44"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
・指定した資産管理番号の資産が廃棄済み
・更新実施者として指定したログインIDの利用者が在籍していない、または未登録
・資産情報の更新がない
・指定した項目値にてバリデーションエラー（validationにエラー原因を返します）
・資産情報のインポート処理が実行中
POST /ws/s3/v1/assetInfo/{assetNumber}/discard  資産情報の廃棄 ▼

目的

指定した資産管理番号の資産情報を廃棄します。
操作元は"WebAPI"として記録されます。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します

Request body（Content-Type: application/json）

フィールド 必須 説明
exec_user_login_id 〇 資産廃棄を実施する利用者のログインIDを指定します
memo 資産の廃棄理由を指定します

レスポンス

コード 説明
200
本APIのレスポンスに含まれる value は、資産項目の形式（asset_item_format）によって返却形式が異なります。
・TEXT、TEXTAREA、DATE、NUMBER、MONEY の場合は文字列を返却します
・LIST の場合は、コードおよび名称を含むオブジェクトを返却します
・項目「使用者」の場合は、ログインIDおよび利用者名を含むオブジェクトを返却します
・FILE の場合は、ファイル情報を含むオブジェクトを返却します

FILE形式の項目「画像」については、レスポンス内のfile にBase64エンコードした文字列を返却します。
画像以外のFILE形式の項目については、file に null を返却します。
※ファイルデータを取得する場合は、「添付ファイル取得API」をご利用ください 
{
    "asset_id": 1,
    "item_values": [
        {
            "asset_item_code": "item_001",
            "asset_item_name": "資産管理番号",
            "asset_item_format": "TEXT",
            "value": "000001"
        },
        {
            "asset_item_code": "item_003",
            "asset_item_name": "資産区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "デスクトップパソコン"
            }
        },
        {
            "asset_item_code": "item_004",
            "asset_item_name": "資産名称",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_005",
            "asset_item_name": "状態",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "使用中"
            }
        },
        {
            "asset_item_code": "item_006",
            "asset_item_name": "使用者",
            "asset_item_format": "TEXT",
            "value": {
                "code": "000001",
                "name": "中央 太郎"
            }
        },
        {
            "asset_item_code": "item_007",
            "asset_item_name": "管理部署",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "総務部"
            }
        },
        {
            "asset_item_code": "item_008",
            "asset_item_name": "所在",
            "asset_item_format": "LIST",
            "value": {
                "code": "01",
                "name": "本社"
            }
        },
        {
            "asset_item_code": "item_009",
            "asset_item_name": "導入日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_010",
            "asset_item_name": "導入区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "02",
                "name": "リース"
            }
        },
        {
            "asset_item_code": "item_011",
            "asset_item_name": "契約開始日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_012",
            "asset_item_name": "契約終了日",
            "asset_item_format": "DATE",
            "value": "2027/12/02"
        },
        {
            "asset_item_code": "item_013",
            "asset_item_name": "リース・レンタル会社名",
            "asset_item_format": "TEXT",
            "value": "ファインアセット株式会社"
        },
        {
            "asset_item_code": "item_014",
            "asset_item_name": "リース・レンタル契約番号",
            "asset_item_format": "TEXT",
            "value": "FA-001"
        },
        {
            "asset_item_code": "item_015",
            "asset_item_name": "メーカ名",
            "asset_item_format": "TEXT",
            "value": "FA機器株式会社"
        },
        {
            "asset_item_code": "item_016",
            "asset_item_name": "製品名",
            "asset_item_format": "TEXT",
            "value": "DPC-Seriese 840"
        },
        {
            "asset_item_code": "item_017",
            "asset_item_name": "製品番号",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_018",
            "asset_item_name": "備考",
            "asset_item_format": "TEXT_AREA",
            "value": "修理履歴：なし"
        },
        {
            "asset_item_code": "file_001",
            "asset_item_name": "画像",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "製品イメージ.jpg",
                "file": "{BASE64_ENCODED_DATA}"
            }
        },
        {
            "asset_item_code": "file_002",
            "asset_item_name": "添付",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "操作マニュアル.pdf",
                "file": null
            }
        },	
    ],
    "status": "discard",
    "update_date": "2026/09/28 11:20:44"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
・指定した資産管理番号の資産が廃棄済み
・指定した資産管理番号の資産が子資産
・廃棄実施者として指定したログインIDの利用者が在籍していない、または未登録
・資産情報のインポート処理が実行中
POST /ws/s3/v1/assetInfo/{assetNumber}/discardCancel  資産情報の廃棄取消し ▼

目的

指定した資産管理番号の資産情報の廃棄を取消しします。
操作元は"WebAPI"として記録されます。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します

Request body（Content-Type: application/json）

フィールド 必須 説明
exec_user_login_id 〇 資産の廃棄取消しを実施する利用者のログインIDを指定します
memo 資産の廃棄取消し理由を指定します

レスポンス

コード 説明
200
本APIのレスポンスに含まれる value は、資産項目の形式（asset_item_format）によって返却形式が異なります。
・TEXT、TEXTAREA、DATE、NUMBER、MONEY の場合は文字列を返却します
・LIST の場合は、コードおよび名称を含むオブジェクトを返却します
・項目「使用者」の場合は、ログインIDおよび利用者名を含むオブジェクトを返却します
・FILE の場合は、ファイル情報を含むオブジェクトを返却します

FILE形式の項目「画像」については、レスポンス内のfile にBase64エンコードした文字列を返却します。
画像以外のFILE形式の項目については、file に null を返却します。
※ファイルデータを取得する場合は、「添付ファイル取得API」をご利用ください 
{
    "asset_id": 1,
    "item_values": [
        {
            "asset_item_code": "item_001",
            "asset_item_name": "資産管理番号",
            "asset_item_format": "TEXT",
            "value": "000001"
        },
        {
            "asset_item_code": "item_003",
            "asset_item_name": "資産区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "デスクトップパソコン"
            }
        },
        {
            "asset_item_code": "item_004",
            "asset_item_name": "資産名称",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_005",
            "asset_item_name": "状態",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "使用中"
            }
        },
        {
            "asset_item_code": "item_006",
            "asset_item_name": "使用者",
            "asset_item_format": "TEXT",
            "value": {
                "code": "000001",
                "name": "中央 太郎"
            }
        },
        {
            "asset_item_code": "item_007",
            "asset_item_name": "管理部署",
            "asset_item_format": "LIST",
            "value": {
                "code": "001",
                "name": "総務部"
            }
        },
        {
            "asset_item_code": "item_008",
            "asset_item_name": "所在",
            "asset_item_format": "LIST",
            "value": {
                "code": "01",
                "name": "本社"
            }
        },
        {
            "asset_item_code": "item_009",
            "asset_item_name": "導入日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_010",
            "asset_item_name": "導入区分",
            "asset_item_format": "LIST",
            "value": {
                "code": "02",
                "name": "リース"
            }
        },
        {
            "asset_item_code": "item_011",
            "asset_item_name": "契約開始日",
            "asset_item_format": "DATE",
            "value": "2026/12/02"
        },
        {
            "asset_item_code": "item_012",
            "asset_item_name": "契約終了日",
            "asset_item_format": "DATE",
            "value": "2027/12/02"
        },
        {
            "asset_item_code": "item_013",
            "asset_item_name": "リース・レンタル会社名",
            "asset_item_format": "TEXT",
            "value": "ファインアセット株式会社"
        },
        {
            "asset_item_code": "item_014",
            "asset_item_name": "リース・レンタル契約番号",
            "asset_item_format": "TEXT",
            "value": "FA-001"
        },
        {
            "asset_item_code": "item_015",
            "asset_item_name": "メーカ名",
            "asset_item_format": "TEXT",
            "value": "FA機器株式会社"
        },
        {
            "asset_item_code": "item_016",
            "asset_item_name": "製品名",
            "asset_item_format": "TEXT",
            "value": "DPC-Seriese 840"
        },
        {
            "asset_item_code": "item_017",
            "asset_item_name": "製品番号",
            "asset_item_format": "TEXT",
            "value": "DPC00171"
        },
        {
            "asset_item_code": "item_018",
            "asset_item_name": "備考",
            "asset_item_format": "TEXT_AREA",
            "value": "修理履歴：なし"
        },
        {
            "asset_item_code": "file_001",
            "asset_item_name": "画像",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "製品イメージ.jpg",
                "file": "{BASE64_ENCODED_DATA}"
            }
        },
        {
            "asset_item_code": "file_002",
            "asset_item_name": "添付",
            "asset_item_format": "FILE",
            "value": {
                "file_name": "操作マニュアル.pdf",
                "file": null
            }
        },	
    ],
    "status": null,
    "update_date": "2026/09/28 11:20:44"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
・指定した資産管理番号の資産が有効
・指定した資産管理番号の資産が子資産
・廃棄取消し実施者として指定したログインIDの利用者が在籍していない、または未登録
・資産登録の件数上限を超過
・資産情報のインポート処理が実行中
GET /ws/s3/v1/assetInfo/{assetNumber}/{assetItemCode}/attachment  添付ファイルの取得 ▼

目的

指定した資産管理番号、資産項目コードの添付ファイルを取得します。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します
assetItemCode 〇 資産項目コードを指定します

レスポンス

コード 説明
200 
{
    "asset_id": 1,
    "asset_number": "000001",
    "file_name": "操作マニュアル.pdf",
    "file": "{BASE64_ENCODED_DATA}"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
・指定した資産項目コードの資産項目が未登録
・添付ファイルが未登録
棚卸
POST /ws/s3/v1/inventory/{assetNumber}  棚卸 ▼

目的

指定した資産管理番号の資産情報を棚卸します。
操作元は"WebAPI"として記録されます。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します

Request body（Content-Type: application/json）

フィールド 必須 説明
exec_user_login_id 〇 棚卸を実施する利用者のログインIDを指定します
memo 棚卸メモを指定します

レスポンス

コード 説明
200 
{
    "asset_id": 1,
    "asset_number": "000001",
    "exec_date": "2026/09/28 11:20:44",
    "scan_date": null,
    "exec_user_name": "中央 太郎",
    "inventory_image_filename": null,
    "inventory_image_file": null,
    "exec_term_id": null,
    "exec_term_name": null,
    "inventory_memo": "現物確認済み"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
・棚卸実施者として指定したログインIDの利用者が在籍していない、または未登録
GET /ws/s3/v1/inventory/{assetNumber}/history  棚卸履歴の取得 ▼

目的

指定した資産管理番号の最新の棚卸履歴を取得します。

パラメータ

パスパラメータ（URLを書き換え）

フィールド 必須 説明
assetNumber 〇 資産管理番号を指定します

レスポンス

コード 説明
200 
{
    "asset_id": 1,
    "asset_number": "000001",
    "exec_date": "2026/09/28 11:20:44",
    "scan_date": "2026/09/28 11:18:32",
    "exec_user_name": "中央 太郎",
    "inventory_image_filename": "2D0FAA829495.jpeg",
    "inventory_image_file": "{BASE64_ENCODED_DATA}",
    "exec_term_id": "e83ae449cca5f809",
    "exec_term_name": "貸与スマホ_taro",
    "inventory_memo": "現物確認済み"
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・指定した資産管理番号の資産が未登録
マスタ設定
GET /ws/s3/v1/config/assetItemConfigs  資産項目設定の取得 ▼

目的

資産項目設定を取得します。

パラメータ

クエリパラメータ（URLに付与）

フィールド 必須 説明
page ページ数を指定します
※未指定の場合は1
limit 表示件数を1～100以内で指定します
※未指定の場合は10

レスポンス

コード 説明
200
本APIのレスポンスは登録されている全ての資産項目が返却されます。
レスポンス内の資産項目設定はWeb画面で設定された表示順で返却されます。
本APIのレスポンスに含まれる validatesオブジェクト は、資産項目の形式（asset_item_format）によって返却される項目が異なります。 
{
    "asset_item_configs": [
        {
            "asset_item_code": "item_001",
            "asset_item_kbn": "INIT",
            "asset_item_name": "資産管理番号",
            "asset_item_format": "TEXT",
            "kbn_config_id": null,
            "display_option": "ALL",
            "display_target_asset_kbn_id": null,
            "validates": {
                "required": true,
                "unique": true,
                "max_length": 100,
                "min_length": null,
                "char_type": ALPHA,NUMBER,SYMBOL"
            },
            "description": "自動採番のため、入力不要です",
            "enabled": true,
            "update_date": "2026/09/28 11:18:32"
        },
        {
            "asset_item_code": "item_003",
            "asset_item_kbn": "INIT",
            "asset_item_name": "資産区分",
            "asset_item_format": "LIST",
            "kbn_config_id": 1,
            "display_option": "ALL",
            "display_target_asset_kbn_id": null,
            "validates": {
                "required": true
            },
            "description": null,
            "enabled": true,
            "update_date": "2026/09/28 11:18:32"
        },
        {
            "asset_item_code": "item_020",
            "asset_item_kbn": "INIT",
            "asset_item_name": "数量",
            "asset_item_format": "NUMBER",
            "kbn_config_id": null,
            "display_option": "SELECT",
            "display_target_asset_kbn_id": "1,2",
            "validates": {
                "required": true,
                "max_value": null,
                "min_value": 0
            },
            "description": null,
            "enabled": true,
            "update_date": "2026/09/28 11:18:32"
        }
    ]
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・表示件数が1～100の範囲外
GET /ws/s3/v1/config/kbnConfigs  区分設定の取得 ▼

目的

区分設定および区分を取得します。

パラメータ

クエリパラメータ（URLに付与）

フィールド 必須 説明
page ページ数を指定します
※未指定の場合は1
limit 表示件数を1～100以内で指定します
※未指定の場合は10

レスポンス

コード 説明
200
レスポンス内の区分設定および区分はWeb画面で設定された表示順で返却されます。 
{
    "kbn_configs": [
        {
            "kbn_config_id": 1,
            "kbn_config_name": "資産区分",
            "kbns": [
                {
                    "kbn_id": 1,
                    "kbn_code": "001",
                    "kbn_name": "デスクトップパソコン"
                }
            ],
            "update_date": "2026/09/28 11:18:32"
        }
    ]
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・表示件数が1～100の範囲外
GET /ws/s3/v1/config/departments  部署区分設定の取得 ▼

目的

部署区分設定を取得します。

パラメータ

クエリパラメータ（URLに付与）

フィールド 必須 説明
page ページ数を指定します
※未指定の場合は1
limit 表示件数を1～100以内で指定します
※未指定の場合は10

レスポンス

コード 説明
200
レスポンス内の部署区分設定はWeb画面で設定された表示順で返却されます。 
{
    "departments": [
        {
            "department_id": 1,
            "department_code": "001",
            "department_name": "管理本部",
            "child_departments": [
                {
                    "department_id": 2,
                    "department_code": "002",
                    "department_name": "人事総務部",
                    "child_departments": [
                        {
                            "department_id": 3,
                            "department_code": "003",
                            "department_name": "人事課",
                            "child_departments": [],
                            "update_date": "2026/04/17 09:24:46"
                        },
                        {
                            "department_id": 4,
                            "department_code": "004",
                            "department_name": "総務課",
                            "child_departments": [],
                            "update_date": "2025/06/22 15:45:22"
                        }
                    ],
                    "update_date": "2026/02/11 12:11:23"
                }
            ],
            "update_date": "2026/09/28 11:18:32"
        }
    ]
}

エラーレスポンス

コード type 説明
422 unprocessable_entity ・表示件数が1～100の範囲外
© 2021 Chuo System Corporation