BlueAI 会計 データ構造
会計 API で返却される主要オブジェクトのフィールド定義です。
|
ID 形式
各リソースは prefix 付き public ID（例: deal_..., inv_..., form_..., ak_...）を利用します。
全プロダクト共通の ID 規約共通カラム
主要オブジェクトは共通して `object`, `external_id`, `source_system`, `metadata`, `livemode`, `version`, `system_updated_at`, `created_by`, `updated_by`, `deleted_at` を持ちます。
JournalEntry object
仕訳を表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 仕訳 ID |
object | string | 必須 | オブジェクト種別（`accounting.journal_entry`） |
organization_id | string | 必須 | 組織 ID |
external_id | string | null | 任意 | 外部連携ID |
source_system | "salesforce" | "import" | "api" | "manual" | 必須 | 登録元システム |
fiscal_year_id | string | 必須 | 会計年度 ID |
date | string | 必須 | 仕訳日 (YYYY-MM-DD) |
description | string | null | 任意 | 摘要 |
status | "draft" | "posted" | "void" | 必須 | ステータス |
metadata | object | null | 任意 | 拡張メタデータ |
livemode | boolean | 必須 | 本番モードフラグ |
version | number | 必須 | リビジョン番号 |
created_by | string | null | 任意 | 作成者 ID |
updated_by | string | null | 任意 | 更新者 ID |
deleted_at | string | null | 任意 | 削除日時 (ISO 8601) |
created_at | string | 必須 | 作成日時 (ISO 8601) |
system_updated_at | string | 必須 | システム更新日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "je_01JQ3KXYZ",
"object": "accounting.journal_entry",
"organization_id": "org_01HZXYZ",
"external_id": "ext_org_01HZXYZ",
"source_system": "api",
"fiscal_year_id": "fy_01JQ3KABC",
"date": "2026-02-15",
"description": "Office supplies purchase",
"status": "posted",
"metadata": {
"source": "manual"
},
"livemode": false,
"version": 4,
"created_by": "usr_99999999999999999999999999999999",
"updated_by": "usr_99999999999999999999999999999999",
"deleted_at": null,
"created_at": "2026-02-15T10:00:00Z",
"system_updated_at": "2026-02-15T10:00:00Z",
"updated_at": "2026-02-15T10:00:00Z"
}Account object
勘定科目を表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 勘定科目 ID |
object | string | 必須 | オブジェクト種別（`accounting.account`） |
organization_id | string | 必須 | 組織 ID |
external_id | string | null | 任意 | 外部連携ID |
source_system | "salesforce" | "import" | "api" | "manual" | 必須 | 登録元システム |
code | string | 必須 | 勘定科目コード |
name | string | 必須 | 勘定科目名 |
category | "asset" | "liability" | "equity" | "revenue" | "expense" | 必須 | 勘定区分 |
is_active | boolean | 必須 | 有効フラグ |
metadata | object | null | 任意 | 拡張メタデータ |
livemode | boolean | 必須 | 本番モードフラグ |
version | number | 必須 | リビジョン番号 |
created_by | string | null | 任意 | 作成者 ID |
updated_by | string | null | 任意 | 更新者 ID |
deleted_at | string | null | 任意 | 削除日時 (ISO 8601) |
created_at | string | 必須 | 作成日時 (ISO 8601) |
system_updated_at | string | 必須 | システム更新日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "acct_01JQ3KDEF",
"object": "accounting.account",
"organization_id": "org_01HZXYZ",
"external_id": "ext_org_01HZXYZ",
"source_system": "api",
"code": "1100",
"name": "Cash",
"category": "asset",
"is_active": true,
"metadata": {
"source": "seed"
},
"livemode": false,
"version": 1,
"created_by": "usr_99999999999999999999999999999999",
"updated_by": "usr_99999999999999999999999999999999",
"deleted_at": null,
"created_at": "2026-01-01T00:00:00Z",
"system_updated_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}FiscalYear object
会計年度を表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 会計年度 ID |
object | string | 必須 | オブジェクト種別（`accounting.fiscal_year`） |
organization_id | string | 必須 | 組織 ID |
external_id | string | null | 任意 | 外部連携ID |
source_system | "salesforce" | "import" | "api" | "manual" | 必須 | 登録元システム |
name | string | 必須 | 年度名 |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
is_closed | boolean | 必須 | 締め済みフラグ |
metadata | object | null | 任意 | 拡張メタデータ |
livemode | boolean | 必須 | 本番モードフラグ |
version | number | 必須 | リビジョン番号 |
created_by | string | null | 任意 | 作成者 ID |
updated_by | string | null | 任意 | 更新者 ID |
deleted_at | string | null | 任意 | 削除日時 (ISO 8601) |
created_at | string | 必須 | 作成日時 (ISO 8601) |
system_updated_at | string | 必須 | システム更新日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "fy_01JQ3KABC",
"object": "accounting.fiscal_year",
"organization_id": "org_01HZXYZ",
"external_id": "ext_org_01HZXYZ",
"source_system": "api",
"name": "FY2026",
"start_date": "2026-04-01",
"end_date": "2027-03-31",
"is_closed": false,
"metadata": {
"region": "JP"
},
"livemode": false,
"version": 2,
"created_by": "usr_99999999999999999999999999999999",
"updated_by": "usr_99999999999999999999999999999999",
"deleted_at": null,
"created_at": "2026-03-01T09:00:00Z",
"system_updated_at": "2026-03-01T09:00:00Z",
"updated_at": "2026-03-01T09:00:00Z"
}