{
  "paths": {
    "/api/1/partners": {
      "get": {
        "summary": "取引先一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に登録されている取引先の一覧を取得します。取引・請求書・支払依頼などの取引先マスタとして参照する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>アーカイブされた取引先は含まれません。</li>\n  <li>keyword は、取引先コード・取引先名・正式名称・カナ名称・ショートカット1・2 のいずれかへの部分一致で絞り込みます。半角スペース・全角スペース・タブで区切ると AND 検索になります。</li>\n  <li>start_update_date / end_update_date で更新日を範囲指定できます。JST の日付を <code>yyyy-mm-dd</code> で指定してください。</li>\n  <li>取引先コード（code）は、事業所設定で「取引先コードの利用」が有効な場合のみ実際の値が返り、無効な場合は null が返ります。</li>\n  <li>振込元口座ID（payer_walletable_id）、振込手数料負担（transfer_fee_handling_side）は法人スタータープラン（および旧法人プロフェッショナルプラン）以上の事業所でのみ返却されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む開始日 (yyyy-mm-dd, JST)。指定日以降に更新された取引先を対象にします。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む終了日 (yyyy-mm-dd, JST)。指定日以前に更新された取引先を対象にします。"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)。ページング用に、スキップする件数を指定します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 3000)。1 回のリクエストで取得する上限件数を指定します。"
          },
          {
            "name": "keyword",
            "in": "query",
            "type": "string",
            "description": "検索キーワード。取引先コード・取引先名・正式名称・カナ名称・ショートカットキー1・2 のいずれかに対する部分一致で絞り込みます。\n以下のいずれかで区切って複数キーワードを指定した場合は AND 検索になります。\n<ul>\n<li>半角スペース</li>\n<li>全角スペース</li>\n<li>タブ</li>\n</ul>\n"
          }
        ]
      },
      "post": {
        "summary": "取引先の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に新しい取引先を作成します。取引や請求書で参照する取引先マスタを新規登録する用途で利用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引先名称（name）は事業所内で重複できません。すでに同名の取引先が存在するとエラーになります。</li>\n  <li>code は、事業所設定で「取引先コードの利用」を有効にしている場合のみ利用可能です。\n    <ul>\n      <li>有効時は code の指定が必須で、name・code いずれも重複不可です。</li>\n      <li>無効時に code を指定するとエラーになります。</li>\n    </ul>\n  </li>\n  <li>作成された取引先の available（使用可能フラグ）は常に true になります。</li>\n  <li>以下の属性は法人スタータープラン（および旧法人プロフェッショナルプラン）以上の事業所でのみ設定・返却されます。無料プラン等では指定しても無視されます。\n    <ul>\n      <li>振込元口座ID（payer_walletable_id）</li>\n      <li>振込手数料負担（transfer_fee_handling_side）</li>\n      <li>支払期日設定（payment_term_attributes）</li>\n      <li>請求の入金期日設定（invoice_payment_term_attributes）</li>\n    </ul>\n  </li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/partners/{id}": {
      "get": {
        "summary": "取引先の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引先 1 件を ID を指定して取得します。取引先の詳細確認や、更新前の現在値取得に利用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引先コード（code）は、事業所設定で「取引先コードの利用」が有効な場合のみ実際の値が返り、無効な場合は null が返ります。</li>\n  <li>アーカイブ済みの取引先は取得対象になり得ますが、更新・削除はできません。</li>\n  <li>以下の属性は法人スタータープラン（および旧法人プロフェッショナルプラン）以上の事業所でのみ返却されます。\n    <ul>\n      <li>振込元口座ID（payer_walletable_id）</li>\n      <li>振込手数料負担（transfer_fee_handling_side）</li>\n      <li>支払期日設定（payment_term_attributes）</li>\n      <li>請求の入金期日設定（invoice_payment_term_attributes）</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引先ID。取得対象の取引先を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取引先が属する事業所を指定します。"
          }
        ]
      },
      "put": {
        "summary": "取引先の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した取引先の情報を更新します。id で更新対象を特定します。取引先コード（code）をキーに更新したい場合は <code>PUT /api/1/partners/code/{code}</code> を利用してください。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引先名称（name）は事業所内で重複できません。</li>\n  <li>取引先コード（code）は本 API では指定・更新できません（指定するとエラーになります）。code をキーに更新したい場合は <code>PUT /api/1/partners/code/{code}</code> を、code 自体を新しい値に変更する用途は本 API ではサポートしていません。</li>\n  <li>本 API は PATCH 相当の挙動をします。リクエストに含まれていない属性は更新されず、既存値が保持されます。属性を「未設定に戻したい」場合は、payment_term_attributes / invoice_payment_term_attributes のみ null を指定できます（他の属性は未設定化の指定不可）。</li>\n  <li>以下の属性は法人スタータープラン（および旧法人プロフェッショナルプラン）以上の事業所でのみ設定できます。無料プラン等では指定しても無視されます。\n    <ul>\n      <li>振込元口座ID（payer_walletable_id）</li>\n      <li>振込手数料負担（transfer_fee_handling_side）</li>\n      <li>支払期日設定（payment_term_attributes）</li>\n      <li>請求の入金期日設定（invoice_payment_term_attributes）</li>\n    </ul>\n  </li>\n  <li>アーカイブ済みの取引先は更新できません。Web 画面からアーカイブを解除してから再度お試しください。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引先ID。更新対象の取引先を指定します。"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "取引先の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引先を削除します。取引で参照されている取引先は削除できないため、削除に失敗した場合は該当取引先の参照を先に解消してください。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>削除された取引先は復元できません。使用停止のみ行いたい場合は、代わりに PUT で <code>available</code> を <code>false</code> に更新することを検討してください。</li>\n  <li>アーカイブ済みの取引先は削除できません。Web 画面からアーカイブを解除してから再度お試しください。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引先ID。削除対象の取引先を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取引先が属する事業所を指定します。"
          }
        ]
      }
    },
    "/api/1/partners/code/{code}": {
      "put": {
        "summary": "取引先コードでの取引先の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>取引先コード（code）をキーに、指定した取引先の情報を更新します。取引先 ID を持たず取引先コードで運用しているシステムからの更新用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本 API を利用するには、事業所設定で「取引先コードの利用」を有効にしている必要があります。無効な事業所への呼び出しはエラーになります。</li>\n  <li>code に日本語や記号を含む場合は、URL エンコードして URL に含めてください。</li>\n  <li>取引先名称（name）は事業所内で重複できません。</li>\n  <li>本 API では id の指定はできません（指定するとエラーになります）。</li>\n  <li>本 API は PATCH 相当の挙動をします。リクエストに含まれていない属性は更新されず、既存値が保持されます。payment_term_attributes / invoice_payment_term_attributes に null を指定すると期日設定を未設定に戻せます。</li>\n  <li>以下の属性は法人スタータープラン（および旧法人プロフェッショナルプラン）以上の事業所でのみ設定できます。\n    <ul>\n      <li>振込元口座ID（payer_walletable_id）</li>\n      <li>振込手数料負担（transfer_fee_handling_side）</li>\n      <li>支払期日設定（payment_term_attributes）</li>\n      <li>請求の入金期日設定（invoice_payment_term_attributes）</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "取引先コード。更新対象の取引先を特定するキー。日本語・記号を含む場合は URL エンコードして指定してください。"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/partners/upsert_by_code": {
      "put": {
        "summary": "取引先の更新（存在しない場合は作成）",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>取引先コード（code）をキーに、指定した取引先の情報を更新します。該当する取引先が存在しない場合は新規作成します（upsert）。同期処理を伴う外部システムとの連携で、取引先マスタを一括で登録・更新する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本 API を利用するには、事業所設定で「取引先コードの利用」を有効にしている必要があります。無効な事業所への呼び出しはエラーになります。</li>\n  <li>取引先名称（name）は事業所内で重複できません。</li>\n  <li>partner オブジェクト内で code を指定することはできません（変更不可）。URL パスの code のみが有効です。</li>\n  <li>更新レスポンスは 200 OK、新規作成レスポンスは 201 Created で返ります。作成・更新のどちらが行われたかは HTTP ステータスコードで判別してください。</li>\n  <li>更新時は PATCH 相当の挙動をします。リクエストに含まれていない属性は既存値が保持されます。payment_term_attributes / invoice_payment_term_attributes に null を指定すると期日設定を未設定に戻せます。</li>\n  <li>以下の属性は法人スタータープラン（および旧法人プロフェッショナルプラン）以上の事業所でのみ設定できます。\n    <ul>\n      <li>振込元口座ID（payer_walletable_id）</li>\n      <li>振込手数料負担（transfer_fee_handling_side）</li>\n      <li>支払期日設定（payment_term_attributes）</li>\n      <li>請求の入金期日設定（invoice_payment_term_attributes）</li>\n    </ul>\n  </li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/forms/selectables": {
      "get": {
        "summary": "フォーム用選択項目情報の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所で勘定科目の入力フォームを構築するための、勘定科目カテゴリー、勘定科目、デフォルト税区分、決算書表示名を取得します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n  <li><code>includes</code> に <code>account_item</code> を指定した場合に、<code>account_categories</code> と <code>account_groups</code> を返します。</li>\n  <li><code>includes</code> を指定しない場合、レスポンスは空のオブジェクトになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "includes",
            "in": "query",
            "type": "string",
            "description": "取得する選択項目\n* `account_item` - 勘定科目カテゴリー、勘定科目、デフォルト税区分、決算書表示名"
          }
        ]
      }
    },
    "/api/1/account_items/{id}": {
      "get": {
        "summary": "勘定科目の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した勘定科目を取得する</p>\n<p>事業所の設定で勘定科目コードを使用する設定にしている場合、レスポンスで勘定科目コード(code)を返します</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勘定科目ID"
          }
        ]
      },
      "put": {
        "summary": "勘定科目の更新",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した勘定科目を更新する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<p>tax_codeは、指定した事業所の税区分一覧の取得APIでavailableの値がtrue、かつ経過措置税区分ではない5%の税区分を確認して、そのcodeを指定して勘定科目の更新をしてください。例 課対仕入の場合、34を指定してください</p>\n<p>codeを利用するには、事業所の設定で勘定科目コードを使用する設定にする必要があります。</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勘定科目ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "勘定科目の削除",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した勘定科目を削除する</p>\n<h2 id=\"\">注意点</h2>\n<ul>\n  <li>削除できる勘定科目は、追加で作成したカスタム勘定科目のみです。</li>\n  <li>デフォルトで存在する勘定科目や口座の勘定科目は削除できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "勘定科目ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/account_items": {
      "get": {
        "summary": "勘定科目一覧の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の勘定科目一覧を取得する</p>\n\n<h2 id=\"_2\">定義</h2>\n\n<ul>\n<li>default_tax_code : リクエストした日時を基準とした税区分コード</li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<p>default_tax_code は勘定科目作成・更新時に利用するものではありません</p>\n<p>事業所の設定で勘定科目コードを使用する設定にしている場合、レスポンスで勘定科目コード(code)を返します</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "base_date",
            "in": "query",
            "type": "string",
            "description": "基準日(yyyy-mm-dd)。指定した場合、勘定科目に紐づく税区分(default_tax_code)が、基準日の税率に基づいて返ります。指定しない場合はリクエスト日が基準日になります。"
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞込：開始日(yyyy-mm-dd)。指定した日以降に更新された勘定科目を返します。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞込：終了日(yyyy-mm-dd)。指定した日以前に更新された勘定科目を返します。"
          },
          {
            "name": "keyword",
            "in": "query",
            "type": "string",
            "description": "検索キーワード。勘定科目コード・勘定科目名・ショートカット1・2 のいずれかに対する部分一致で絞り込みます。\n未指定または空文字の場合は絞り込みません。\n以下のいずれかで区切って複数キーワードを指定した場合は AND 検索になります。\n<ul>\n<li>半角スペース</li>\n<li>全角スペース</li>\n<li>タブ</li>\n</ul>\n"
          }
        ]
      },
      "post": {
        "summary": "勘定科目の作成",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の勘定科目を作成する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<p>tax_codeは、指定した事業所の税区分一覧の取得APIでavailableの値がtrue、かつ経過措置税区分ではない5%の税区分を確認して、そのcodeを指定して勘定科目の作成をしてください。例 課対仕入の場合、34を指定してください</p>\n<p>codeを利用するには、事業所の設定で勘定科目コードを使用する設定にする必要があります。</p>",
        "hasJsonBody": true
      }
    },
    "/api/1/account_items/code/upsert": {
      "put": {
        "summary": "勘定科目の更新（存在しない場合は作成）",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>勘定科目コードをキーに、指定した勘定科目の情報を更新（存在しない場合は作成）する</p>\n<p>リクエストのトップレベルのcodeに指定した勘定科目コードに一致する勘定科目が存在する場合は更新（ステータスコード200）、存在しない場合は作成（ステータスコード201）します</p>\n\n<h2 id=\"_2\">注意点</h2>\n<p>本APIを利用するには、事業所の設定で勘定科目コードを使用する設定にする必要があります。設定が無効の場合はエラー（ステータスコード400）になります。</p>\n<p>更新対象を特定する勘定科目コードはトップレベルのcodeで指定してください。account_item.codeは指定できません（指定した場合はエラーになります）。</p>\n<p>tax_codeは、指定した事業所の税区分一覧の取得APIでavailableの値がtrue、かつ経過措置税区分ではない5%の税区分を確認して、そのcodeを指定して勘定科目の更新をしてください。例 課対仕入の場合、34を指定してください</p>",
        "hasJsonBody": true
      }
    },
    "/api/1/tags": {
      "get": {
        "summary": "メモタグ一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に登録されているメモタグの一覧を取得します。取引や口座振替の明細に付与するメモタグを確認する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>start_update_date / end_update_date でメモタグの更新日を範囲指定して絞り込めます。JST の日付を <code>yyyy-mm-dd</code> で指定してください（どちらも指定日を含みます）。</li>\n  <li>結果はメモタグIDの昇順で返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む開始日 (yyyy-mm-dd, JST)。指定日を含む、それ以降に更新されたメモタグを対象にします。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む終了日 (yyyy-mm-dd, JST)。指定日を含む、それ以前に更新されたメモタグを対象にします。"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)。ページング用に、スキップする件数を指定します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 3000)。1 回のリクエストで取得する上限件数を指定します。"
          }
        ]
      },
      "post": {
        "summary": "メモタグの作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に新しいメモタグを作成します。作成したメモタグは取引や口座振替の明細に付与できます。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>メモタグ名（name）は事業所内で重複できません。既に同名のメモタグが存在する場合は 400 エラーになります。</li>\n  <li>shortcut1 / shortcut2 は、Web画面などでメモタグを検索する際のキーワードとして使用します。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/tags/{id}": {
      "get": {
        "summary": "メモタグの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所のメモタグを 1 件取得します。メモタグID（id）はメモタグ一覧の取得 API で確認できます。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>存在しないか既に削除されたメモタグIDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "メモタグID。メモタグ一覧の取得 API のレスポンスに含まれる id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          }
        ]
      },
      "put": {
        "summary": "メモタグの更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所のメモタグを更新します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>リクエストボディで shortcut1 / shortcut2 を省略した場合は未設定（null）に更新されます。値を維持したい場合は、現在の値も含めて指定してください。</li>\n  <li>メモタグ名（name）は事業所内で重複できません。別のメモタグと同名になる更新は 400 エラーになります。</li>\n  <li>存在しないか既に削除されたメモタグIDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "メモタグID。メモタグ一覧の取得 API のレスポンスに含まれる id を指定します。"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "メモタグの削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所のメモタグを削除します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引または配賦基準で使用されているメモタグは削除できず、400 エラーになります。</li>\n  <li>存在しないか既に削除されたメモタグIDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "メモタグID。メモタグ一覧の取得 API のレスポンスに含まれる id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。削除対象のメモタグが属する事業所を指定します。"
          }
        ]
      }
    },
    "/api/1/sections": {
      "get": {
        "summary": "部門一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に登録されている部門の一覧を取得します。取引や振替伝票の明細に付与する部門マスタを参照する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>start_update_date / end_update_date で部門の更新日を範囲指定して絞り込めます。JST の日付を <code>yyyy-mm-dd</code> で指定してください（どちらも指定日を含みます）。部門階層を利用している場合、階層構造を維持するため、更新日が範囲外の親部門を含むことがあります。</li>\n  <li>部門階層を利用できるプランでは indent_count と parent_id を返します。利用できないプランでは、これらのキー自体が返りません。</li>\n  <li>部門コード（code）は、事業所の設定で部門コードを使用する設定にしている場合のみレスポンスに含まれます。設定が無効の場合は code キー自体が返りません。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む開始日 (yyyy-mm-dd, JST)。指定日を含む、それ以降に更新された部門を対象にします。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む終了日 (yyyy-mm-dd, JST)。指定日を含む、それ以前に更新された部門を対象にします。"
          }
        ]
      },
      "post": {
        "summary": "部門の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に新しい部門を作成します。作成された部門は使用設定（available）が true の状態で登録され、取引作成時などに指定できるようになります。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>部門名（name）は事業所内で重複できません。既に同名の部門が存在する場合は 400 エラーになります。</li>\n  <li>部門コード（code）を利用するには、事業所の設定で部門コードを使用する設定にする必要があります。設定が無効の場合、code を指定しても無視され保存されません。</li>\n  <li>親部門ID（parent_id）は部門階層を利用できるプランでのみ反映されます。利用できないプランでは指定しても親子関係は作成されません。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/sections/{id}": {
      "get": {
        "summary": "部門の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の部門を 1 件取得します。部門ID（id）は部門一覧の取得APIで確認できます。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>部門階層を利用できるプランでは indent_count と parent_id を返します。利用できないプランでは、これらのキー自体が返りません。</li>\n  <li>部門コード（code）は、事業所の設定で部門コードを使用する設定にしている場合のみレスポンスに含まれます。設定が無効の場合は code キー自体が返りません。</li>\n  <li>存在しないか既に削除された部門IDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "部門ID。部門一覧の取得APIのレスポンスに含まれる id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          }
        ]
      },
      "put": {
        "summary": "部門の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の部門を更新します。このAPIは部門の作成は行いません。部門コードをキーに更新（存在しない場合は作成）したい場合は PUT /api/1/sections/code/upsert を利用してください。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>部門名（name）は事業所内で重複できません。別の部門と同名になる更新は 400 エラーになります。</li>\n  <li>long_name と parent_id は、省略した場合に現在の値・親子関係を維持します。null を指定すると未設定・親部門なしに更新します。</li>\n  <li>shortcut1 / shortcut2 / code は、省略または null を指定した場合に未設定（null）へ更新されます。値を維持したい場合は現在の値を指定してください。</li>\n  <li>部門コード（code）は、事業所の設定で部門コードを使用する設定にしている場合のみ更新されます。設定が無効の場合、code を指定しても無視されます。</li>\n  <li>親部門ID（parent_id）は部門階層を利用できるプランでのみ反映されます。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "部門ID。部門一覧の取得APIのレスポンスに含まれる id を指定します。"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "部門の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の部門を削除します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引明細・申請・配賦設定などで使用されている部門は削除できず、400 エラーになります。部門を入力候補から外したい場合は、Web画面から使用設定（available）を「使用しない」に変更してください。</li>\n  <li>存在しないか既に削除された部門IDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "部門ID。部門一覧の取得APIのレスポンスに含まれる id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。削除対象の部門が属する事業所を指定します。"
          }
        ]
      }
    },
    "/api/1/sections/code/upsert": {
      "put": {
        "summary": "部門の更新（存在しない場合は作成）",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>部門コード（code）をキーに、指定した部門の情報を更新します。該当する部門が存在しない場合は新規作成します（upsert）。外部システムとの連携で、部門マスタを一括で登録・更新する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIを利用するには、事業所の設定で部門コードを使用する設定にする必要があります。設定が無効な事業所への呼び出しは 400 エラーになります。</li>\n  <li>section オブジェクト内で code を指定することはできません（部門コードは変更不可）。指定した場合は 400 エラーになります。リクエストボディ直下の code のみが有効です。</li>\n  <li>更新レスポンスは 200 OK、新規作成レスポンスは 201 Created で返ります。作成・更新のどちらが行われたかは HTTP ステータスコードで判別してください。</li>\n  <li>long_name と parent_code は、省略した場合に現在の値・親子関係を維持します。null を指定すると未設定・親部門なしに更新します。</li>\n  <li>shortcut1 / shortcut2 は、省略または null を指定した場合に未設定（null）へ更新されます。値を維持したい場合は現在の値を指定してください。</li>\n  <li>部門名（name）は事業所内で重複できません。別の部門と同名になる場合は 400 エラーになります。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/invoices": {
      "get": {
        "summary": "請求書一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の請求書一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>partner_id と partner_code は同時に指定できません。どちらか一方のみ指定してください。</li>\n<li>partner_code は、事業所で取引先コードの利用設定が有効な場合のみ指定できます。無効な事業所で指定した場合はエラーになります。</li>\n<li>APIを利用するユーザーに閲覧権限のない部門が紐づく請求書は、取得結果に含まれません。</li>\n</ul>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（partner_code と同時に指定することはできません）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所で取引先コードの利用設定が有効な場合のみ利用できます。partner_id と同時に指定することはできません）"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "請求日の開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "請求日の終了日(yyyy-mm-dd)"
          },
          {
            "name": "start_due_date",
            "in": "query",
            "type": "string",
            "description": "期日の開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_due_date",
            "in": "query",
            "type": "string",
            "description": "期日の終了日(yyyy-mm-dd)"
          },
          {
            "name": "invoice_number",
            "in": "query",
            "type": "string",
            "description": "請求書番号"
          },
          {
            "name": "description",
            "in": "query",
            "type": "string",
            "description": "概要"
          },
          {
            "name": "invoice_status",
            "in": "query",
            "type": "string",
            "description": "請求書ステータス  (draft: 下書き, applying: 申請中, remanded: 差し戻し, rejected: 却下, approved: 承認済み, unsubmitted: 送付待ち, submitted: 送付済み)"
          },
          {
            "name": "payment_status",
            "in": "query",
            "type": "string",
            "description": "入金ステータス  (unsettled: 入金待ち, settled: 入金済み)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最大: 100) "
          }
        ]
      }
    },
    "/api/1/invoices/{id}": {
      "get": {
        "summary": "請求書の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の請求書を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>APIを利用するユーザーに閲覧権限のない部門が紐づく請求書を指定した場合は、存在しない請求書としてエラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "請求書ID"
          }
        ]
      }
    },
    "/api/1/quotations": {
      "get": {
        "summary": "見積書一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の見積書一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>partner_id と partner_code は同時に指定できません。どちらか一方のみ指定してください。</li>\n<li>partner_code は、事業所で取引先コードの利用設定が有効な場合のみ指定できます。無効な事業所で指定した場合はエラーになります。</li>\n<li>APIを利用するユーザーに閲覧権限のない部門が紐づく見積書は、取得結果に含まれません。</li>\n</ul>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（partner_code と同時に指定することはできません）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所で取引先コードの利用設定が有効な場合のみ利用できます。partner_id と同時に指定することはできません）"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "見積日の開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "見積日の終了日(yyyy-mm-dd)"
          },
          {
            "name": "quotation_number",
            "in": "query",
            "type": "string",
            "description": "見積書番号"
          },
          {
            "name": "description",
            "in": "query",
            "type": "string",
            "description": "概要"
          },
          {
            "name": "quotation_status",
            "in": "query",
            "type": "string",
            "description": "見積書ステータス  (unsubmitted: 送付待ち, submitted: 送付済み, all: 全て)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最大: 100) "
          }
        ]
      }
    },
    "/api/1/quotations/{id}": {
      "get": {
        "summary": "見積書の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の見積書詳細を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>APIを利用するユーザーに閲覧権限のない部門が紐づく見積書を指定した場合は、存在しない見積書としてエラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "見積書ID"
          }
        ]
      }
    },
    "/api/1/deals": {
      "get": {
        "summary": "取引（収入・支出）一覧の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）一覧を取得する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li>\n<p>details : 取引の明細行</p>\n</li>\n<li>\n<p>accruals : 取引の債権債務行</p>\n</li>\n<li>\n<p>renews : 取引の+更新行</p>\n</li>\n<li>\n<p>payments : 取引の支払行</p>\n</li>\n<li>\n<p>from_walletable_type</p>\n<ul>\n<li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"_3\">注意点</h2>\n<ul>\n<li>セグメントタグ情報は法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で利用可能です。利用可能なセグメントの数は、法人アドバンスプラン（および旧法人プロフェッショナルプラン）の場合は1つ、法人エンタープライズプランの場合は3つです。</li>\n<li>partner_codeを利用するには、事業所の設定から取引先コードの利用を有効にする必要があります。またpartner_codeとpartner_idは同時に指定することはできません。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込"
          },
          {
            "name": "account_item_id",
            "in": "query",
            "type": "integer",
            "description": "勘定科目IDで絞込"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "決済状況で絞込 (未決済: unsettled, 完了: settled)"
          },
          {
            "name": "type",
            "in": "query",
            "type": "string",
            "description": "収支区分 (収入: income, 支出: expense)"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "start_due_date",
            "in": "query",
            "type": "string",
            "description": "支払期日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_due_date",
            "in": "query",
            "type": "string",
            "description": "支払期日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "start_renew_date",
            "in": "query",
            "type": "string",
            "description": "+更新日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_renew_date",
            "in": "query",
            "type": "string",
            "description": "+更新日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最大: 100) "
          },
          {
            "name": "accruals",
            "in": "query",
            "type": "string",
            "description": "取引の債権債務行の表示（without: 表示しない(デフォルト), with: 表示する）。withを指定した場合、債権債務行が存在する取引のレスポンスにaccrualsが含まれます。"
          }
        ]
      },
      "post": {
        "summary": "取引（収入・支出）の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）を作成する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li>\n<p>ref_number : 管理番号</p>\n</li>\n<li>\n<p>details : 取引の明細行(最大100行)</p>\n</li>\n<li>\n<p>payments : 取引の支払行</p>\n</li>\n<li>\n<p>receipt_ids : ファイルボックス（証憑ファイル）ID</p>\n</li>\n<li>\n<p>from_walletable_type</p>\n<ul>\n<li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"_3\">注意点</h2>\n<ul>\n    <li><p>本APIでは+更新行(renews)の操作ができません。取引（収入・支出）の+更新の作成APIをご利用ください。</p></li>\n    <li><p>セグメントタグ情報は法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で利用可能です。利用可能なセグメントの数は、法人アドバンスプラン（および旧法人プロフェッショナルプラン）の場合は1つ、法人エンタープライズプランの場合は3つです。</p></li>\n    <li>\n        <p>partner_codeを利用するには、事業所の設定から取引先コードの利用を有効にする必要があります。またpartner_codeとpartner_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>account_item_codeを利用するには、事業所の設定から勘定科目コードの利用を有効にする必要があります。またaccount_item_codeとaccount_item_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>item_codeを利用するには、事業所の設定から品目コードの利用を有効にする必要があります。またitem_codeとitem_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>section_codeを利用するには、事業所の設定から部門コードの利用を有効にする必要があります。またsection_codeとsection_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>segment_1_tag_codeを利用するには、事業所の設定からセグメントタグコードの利用を有効にする必要があります。またsegment_1_tag_codeとsegment_1_tag_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>segment_2_tag_codeを利用するには、事業所の設定からセグメントタグコードの利用を有効にする必要があります。またsegment_2_tag_codeとsegment_2_tag_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>segment_3_tag_codeを利用するには、事業所の設定からセグメントタグコードの利用を有効にする必要があります。またsegment_3_tag_codeとsegment_3_tag_idは同時に指定することはできません。</p></li>\n    <li>\n        <p>本APIでは取引の明細行(details)は、最大100行までになります。</p>\n    </li>\n</ul>\n",
        "hasJsonBody": true
      }
    },
    "/api/1/deals/{id}": {
      "get": {
        "summary": "取引（収入・支出）の取得",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）を取得する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li>\n<p>details : 取引の明細行</p>\n</li>\n<li>\n<p>accruals : 取引の債権債務行</p>\n</li>\n<li>\n<p>renews : 取引の+更新行</p>\n</li>\n<li>\n<p>payments : 取引の支払行</p>\n</li>\n<li>\n<p>from_walletable_type</p>\n<ul>\n<li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"_3\">注意点</h2>\n<ul>\n<li>セグメントタグ情報は法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で利用可能です。利用可能なセグメントの数は、法人アドバンスプラン（および旧法人プロフェッショナルプラン）の場合は1つ、法人エンタープライズプランの場合は3つです。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          },
          {
            "name": "accruals",
            "in": "query",
            "type": "string",
            "description": "取引の債権債務行の表示（without: 表示しない(デフォルト), with: 表示する）。withを指定した場合、債権債務行が存在する取引のレスポンスにaccrualsが含まれます。"
          }
        ]
      },
      "put": {
        "summary": "取引（収入・支出）の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）を更新する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li>\n<p>details : 取引の明細行(最大100行)</p>\n</li>\n<li>\n<p>renews : 取引の+更新行</p>\n</li>\n<li>\n<p>payments : 取引の支払行</p>\n</li>\n<li>\n<p>from_walletable_type</p>\n<ul>\n<li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul>\n</li>\n<li>\n<p>receipt_ids : ファイルボックス（証憑ファイル）ID</p>\n</li>\n</ul>\n<h2 id=\"_3\">注意点</h2>\n<ul>\n    <li><p>本APIでは支払行(payments)の操作ができません。取引（収入・支出）の支払行の作成・更新・削除APIをご利用ください。</p></li>\n    <li><p>本APIでは+更新行(renews)の操作ができません。取引（収入・支出）の+更新の作成・更新・削除APIをご利用ください。</p></li>\n    <li><p>本APIでは収入／支出の切替えができません。既存の取引を削除後、再度作成してください。</p></li>\n    <li><p>本APIで取引を更新すると、消費税の計算方法は必ず内税方式が選択されます。</p></li>\n    <li><p>セグメントタグ情報は法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で利用可能です。利用可能なセグメントの数は、法人アドバンスプラン（および旧法人プロフェッショナルプラン）の場合は1つ、法人エンタープライズプランの場合は3つです。</p></li>\n    <li><p>partner_codeを利用するには、事業所の設定から取引先コードの利用を有効にする必要があります。またpartner_codeとpartner_idは同時に指定することはできません。</p></li>\n    <li><p>freee請求書から登録された取引は品目・部門・メモタグ・セグメント1、2、3のみ更新可能です。</p></li>\n    <li>\n        <p>本APIでは取引の明細行(details)は、最大100行までになります。</p>\n    </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "取引（収入・支出）の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した取引（収入・支出）を削除する</p>\n",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/deals/{id}/renews": {
      "post": {
        "summary": "取引（収入・支出）の+更新の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）の+更新を作成する</p>\n<h2 id=\"_2\">定義</h2>\n<ul> <li> <p>issue_date : 発生日</p> </li>\n<li> <p>due_date : 支払期日</p> </li>\n<li> <p>amount : 金額</p> </li>\n<li> <p>due_amount : 支払残額</p> </li>\n<li> <p>type</p>\n<ul> <li>income : 収入</li>\n<li>expense : 支出</li> </ul> </li>\n<li> <p>details : 取引の明細行</p> </li>\n<li> <p>accruals : 取引の債権債務行</p> </li>\n<li> <p>renews : 取引の+更新行</p> </li>\n<li> <p>payments : 取引の支払行</p> </li>\n<li> <p>from_walletable_type</p>\n<ul> <li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul> </li> </ul>\n<h2 id=\"_3\">注意点</h2>\n<ul> <li>本APIではdetails(取引の明細行)、accruals(債権債務行)、renewsのdetails(+更新の明細行)のみ操作可能です。</li>\n<li>本APIで取引を更新すると、消費税の計算方法は必ず内税方式が選択されます。</li> </ul>\n",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/deals/{id}/renews/{renew_id}": {
      "put": {
        "summary": "取引（収入・支出）の+更新の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）の+更新を更新する</p>\n<h2 id=\"_2\">定義</h2>\n<ul> <li> <p>issue_date : 発生日</p> </li>\n<li> <p>due_date : 支払期日</p> </li>\n<li> <p>amount : 金額</p> </li>\n<li> <p>due_amount : 支払残額</p> </li>\n<li> <p>type</p>\n<ul> <li>income : 収入</li>\n<li>expense : 支出</li> </ul> </li>\n<li> <p>details : 取引の明細行</p> </li>\n<li> <p>accruals : 取引の債権債務行</p> </li>\n<li> <p>renews : 取引の+更新行</p> </li>\n<li> <p>payments : 取引の支払行</p> </li>\n<li> <p>from_walletable_type</p>\n<ul> <li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul> </li> </ul>\n<h2 id=\"_3\">注意点</h2>\n<ul> <li>本APIでは+更新の更新のみ可能です。取引や支払行に対する更新はできません。</li> <li>renew_idにはrenewsのid(+更新ID)を指定してください。renewsのdetailsのid(+更新の明細行ID)を指定できません。</li> <li>月締めされている仕訳に紐づく＋更新行の編集・削除はできません。</li> <li>承認済み仕訳に紐づく＋更新行の編集・削除は管理者権限のユーザーのみ可能です。</li>\n<li>本APIで取引を更新すると、消費税の計算方法は必ず内税方式が選択されます。</li> </ul>\n",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          },
          {
            "name": "renew_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "+更新ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "取引（収入・支出）の+更新の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）の+更新を削除する</p>\n<h2 id=\"_3\">注意点</h2>\n<ul> <li>本APIでは+更新の削除のみ可能です。取引や支払行に対する削除はできません。</li> <li>renew_idにはrenewsのid(+更新ID)を指定してください。renewsのdetailsのid(+更新の明細行ID)を指定できません。</li>\n<li>月締めされている仕訳に紐づく＋更新行の編集・削除はできません。</li> <li>承認済み仕訳に紐づく＋更新行の編集・削除は管理者権限のユーザーのみ可能です。</li>\n<li>本APIで取引を更新すると、消費税の計算方法は必ず内税方式が選択されます。</li> </ul>\n",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          },
          {
            "name": "renew_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "+更新ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/deals/{id}/payments": {
      "post": {
        "summary": "取引（収入・支出）の支払行の作成",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）の支払行を作成する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li> <p>details : 取引の明細行</p> </li>\n<li> <p>renews : 取引の+更新行</p> </li>\n<li> <p>payments : 取引の支払行</p> </li>\n<li>\n<p>from_walletable_type</p>\n<ul>\n<li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul>\n</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/deals/{id}/payments/{payment_id}": {
      "put": {
        "summary": "取引（収入・支出）の支払行の更新",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）の支払行を更新する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li>\n<p>details : 取引の明細行</p>\n</li>\n<li>\n<p>renews : 取引の+更新行</p>\n</li>\n<li>\n<p>payments : 取引の支払行</p>\n</li>\n<li>\n<p>from_walletable_type</p>\n<ul>\n<li>bank_account : 銀行口座</li>\n<li>credit_card : クレジットカード</li>\n<li>wallet : 現金</li>\n<li>private_account_item : プライベート資金（法人の場合は役員借入金もしくは役員借入金、個人の場合は事業主貸もしくは事業主借）</li>\n</ul>\n</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          },
          {
            "name": "payment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "支払行ID（取引のレスポンスのpayments配列のid）"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "取引（収入・支出）の支払行の削除",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の取引（収入・支出）の支払行を削除する</p>\n<h2 id=\"_2\">定義</h2>\n<ul>\n<li>\n<p>issue_date : 発生日</p>\n</li>\n<li>\n<p>due_date : 支払期日</p>\n</li>\n<li>\n<p>amount : 金額</p>\n</li>\n<li>\n<p>due_amount : 支払残額</p>\n</li>\n<li>\n<p>type</p>\n<ul>\n<li>income : 収入</li>\n<li>expense : 支出</li>\n</ul>\n</li>\n<li>\n<p>details : 取引の明細行</p>\n</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引ID"
          },
          {
            "name": "payment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "支払行ID（取引のレスポンスのpayments配列のid）"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/manual_journals": {
      "get": {
        "summary": "振替伝票一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の振替伝票を、発生日・勘定科目・金額・取引先などの条件で絞り込んで取得します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>振替伝票は売掛・買掛レポートには反映されません。債権・債務データの登録には取引APIを使用してください。</li>\n  <li>事業所の仕訳番号形式が有効な場合のみ、<code>txn_number</code>に仕訳番号が入ります。</li>\n  <li>セグメントタグは法人アドバンスプラン（旧法人プロフェッショナルプランを含む）以上で利用できます。法人アドバンスプランではセグメント1、法人エンタープライズプランではセグメント1〜3を利用できます。</li>\n  <li><code>partner_code</code>を利用するには、事業所の取引先コード利用設定を有効にしてください。<code>partner_id</code>と<code>partner_code</code>は同時に指定できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "entry_side",
            "in": "query",
            "type": "string",
            "description": "貸借区分で絞込（credit: 貸方、debit: 借方）"
          },
          {
            "name": "account_item_id",
            "in": "query",
            "type": "integer",
            "description": "勘定科目IDで絞込"
          },
          {
            "name": "min_amount",
            "in": "query",
            "type": "integer",
            "description": "取引金額（税込・円）の下限で絞込"
          },
          {
            "name": "max_amount",
            "in": "query",
            "type": "integer",
            "description": "取引金額（税込・円）の上限で絞込"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択の貸借行を絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択の貸借行を絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択の貸借行を絞り込めます）"
          },
          {
            "name": "segment_1_tag_id",
            "in": "query",
            "type": "integer",
            "description": "セグメント１タグIDで絞込（0を指定すると、セグメント１タグが未選択の貸借行を絞り込めます）"
          },
          {
            "name": "segment_2_tag_id",
            "in": "query",
            "type": "integer",
            "description": "セグメント２タグIDで絞込（0を指定すると、セグメント２タグが未選択の貸借行を絞り込めます）"
          },
          {
            "name": "segment_3_tag_id",
            "in": "query",
            "type": "integer",
            "description": "セグメント３タグIDで絞込（0を指定すると、セグメント３タグが未選択の貸借行を絞り込めます）"
          },
          {
            "name": "comment_status",
            "in": "query",
            "type": "string",
            "description": "コメント状態で絞込\n* `posted_with_mention` - 自分宛のコメントあり\n* `raised_with_mention` - 自分宛の未解決コメントあり\n* `resolved_with_mention` - 自分宛の解決済みコメントあり\n* `posted` - コメントあり\n* `raised` - 未解決コメントあり\n* `resolved` - 解決済みコメントあり\n* `none` - コメントなし"
          },
          {
            "name": "comment_important",
            "in": "query",
            "type": "boolean",
            "description": "お気に入りコメント付きの振替伝票を絞込"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳で絞込（only: 決算整理仕訳のみ、without: 日常仕訳のみ）"
          },
          {
            "name": "txn_number",
            "in": "query",
            "type": "string",
            "description": "仕訳番号で絞込（事業所の仕訳番号形式が有効な場合のみ）"
          },
          {
            "name": "ref_number",
            "in": "query",
            "type": "string",
            "description": "管理番号で絞込（前方一致）"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最小: 1, 最大: 500) "
          }
        ]
      },
      "post": {
        "summary": "振替伝票の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所に、貸借が一致する振替伝票を作成します。各貸借行の金額は税込・円で指定します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>振替伝票は売掛・買掛レポートには反映されません。債権・債務データの登録には取引APIを使用してください。</li>\n  <li>貸借行は貸方・借方の合計で100行まで指定でき、貸方と借方の金額合計を一致させる必要があります。</li>\n  <li>勘定科目は<code>account_item_id</code>または<code>account_item_code</code>のどちらか一方を指定してください。コードを利用するには事業所の勘定科目コード利用設定を有効にしてください。</li>\n  <li>取引先・品目・部門・セグメントタグも、IDとコードを同時に指定できません。各コードを利用するには、対応する事業所のコード利用設定を有効にしてください。</li>\n  <li>セグメントタグは法人アドバンスプラン（旧法人プロフェッショナルプランを含む）以上で利用できます。</li>\n</ul>\n\n",
        "hasJsonBody": true
      }
    },
    "/api/1/manual_journals/{id}": {
      "get": {
        "summary": "振替伝票の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所と振替伝票IDに一致する振替伝票を取得します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>事業所の仕訳番号形式が有効な場合のみ、<code>txn_number</code>に仕訳番号が入ります。</li>\n  <li>セグメントタグは契約プランで利用可能なものだけがレスポンスに含まれます。</li>\n  <li>各種コードは、対応する事業所のコード利用設定が有効な場合だけレスポンスに含まれます。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "振替伝票ID"
          }
        ]
      },
      "put": {
        "summary": "振替伝票の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した振替伝票を、リクエストに含めた貸借行の内容で更新します。各貸借行の金額は税込・円で指定します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li><code>details</code>に含まれない既存の貸借行は削除されます。残す行は貸借行IDを指定して必ず<code>details</code>に含めてください。</li>\n  <li>貸借行IDを指定した行は更新され、指定しない行は新規行として追加されます。</li>\n  <li>貸借行は貸方・借方の合計で100行まで指定でき、貸方と借方の金額合計を一致させる必要があります。</li>\n  <li>勘定科目・取引先・品目・部門・セグメントタグは、IDとコードを同時に指定できません。コードを利用するには、対応する事業所のコード利用設定を有効にしてください。</li>\n  <li>承認済みの振替伝票は、事業所設定と操作ユーザーの権限によって更新できない場合があります。</li>\n</ul>\n\n",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "振替伝票ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "振替伝票の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所と振替伝票IDに一致する振替伝票を削除します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>承認済みの振替伝票は、事業所設定と操作ユーザーの権限によって削除できない場合があります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "振替伝票ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/users": {
      "get": {
        "summary": "事業所に所属するユーザー一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に所属するユーザーの一覧を取得する</p>\n\n<p>事業所のメンバーのユーザーID・メールアドレス・氏名を確認できます。取引や申請などの担当者（user_id）を指定する前に、対象ユーザーのIDを調べる用途で使用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>各ユーザーの権限は返りません。ログインユーザー自身の権限を確認する場合は「ログインユーザーの権限の取得 (/api/1/users/capabilities)」を使用してください。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 3000)"
          }
        ]
      }
    },
    "/api/1/users/me": {
      "get": {
        "summary": "ログインユーザーの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>アクセストークンに紐づくログインユーザーの情報を取得する</p>\n\n<p>API連携アプリの認可後に、操作しているユーザー本人の情報（ユーザーID・メールアドレス・氏名）や、そのユーザーが所属する事業所の一覧を確認する用途で使用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>companiesパラメータを指定しない場合は、ユーザーの基本情報のみが返ります（レスポンスにcompaniesは含まれません）。</li>\n  <li>advisorパラメータはcompaniesと同時に指定してください。companiesを指定せずにadvisorを指定した場合は400エラーになります。</li>\n  <li>companies・advisorはパラメータの指定有無で判定されます。falseを指定した場合もtrueと同様に扱われるため、事業所一覧が不要な場合はパラメータ自体を省略してください。</li>\n</ul>",
        "parameters": [
          {
            "name": "companies",
            "in": "query",
            "type": "boolean",
            "description": "ユーザーが所属する事業所一覧をレスポンスに含めるかどうか (true: 含める、未指定: 含めない)。指定有無で判定されるため、falseを指定した場合もtrueと同様に扱われます。"
          },
          {
            "name": "advisor",
            "in": "query",
            "type": "boolean",
            "description": "事業所ごとのアドバイザープロファイルID (advisor_id) をレスポンスの事業所一覧に含めるかどうか (true: 含める、未指定: 含めない)。companiesと同時に指定してください。指定有無で判定されるため、falseを指定した場合もtrueと同様に扱われます。"
          }
        ]
      },
      "put": {
        "summary": "ログインユーザーの更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>アクセストークンに紐づくログインユーザーの基本情報（表示名・氏名・カナ氏名）を更新する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>更新できるのはログインユーザー自身の情報のみです。他のユーザーの情報は更新できません（ユーザーIDの指定はありません）。</li>\n  <li>リクエストボディでキーを省略した項目は更新されません。項目を未設定に戻す場合は空文字を指定してください。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/users/capabilities": {
      "get": {
        "summary": "ログインユーザーの権限の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所におけるログインユーザーの権限を取得する</p>\n\n<p>機能（レスポンスの各キー）ごとに、閲覧 (read)・作成 (create)・更新 (update)・削除 (destroy) などの操作が許可されているかどうかがbooleanで返ります。APIで取引や申請などを操作する前に、必要な権限があるかを確認する用途で使用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>ログインユーザーが所属していない事業所のcompany_idを指定した場合は404エラーになります。</li>\n  <li>一部の機能では、read/create/update/destroy以外のキー（例: 操作可能な範囲を表すallowed_target、操作可否を表すwrite/confirm）が返ります。各機能のスキーマを参照してください。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/companies": {
      "get": {
        "summary": "事業所一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>アクセストークンのユーザーが所属するすべての事業所の一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIで取得できるのは事業所の基本情報（ID・名称・事業所番号・ユーザー権限）のみです。会計年度や設定情報を含む詳細は事業所の取得（GET /api/1/companies/{id}）を利用してください。</li>\n  <li>他のAPIのパラメータとして利用する事業所ID（company_id）は、本APIのレスポンスの id を指定します。</li>\n</ul>"
      }
    },
    "/api/1/companies/{id}": {
      "get": {
        "summary": "事業所の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の詳細情報（名称・連絡先・各種設定・会計年度の一覧）を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>クエリパラメータを指定しない場合は事業所の基本情報と会計年度の一覧のみを返します。勘定科目・税区分コード・品目・取引先・部門・メモタグ・口座の一覧が必要な場合は、details または対応する個別のクエリパラメータを指定してください。</li>\n  <li>details および個別指定のクエリパラメータに指定できる値は true のみです。一覧を含めない場合は、false を指定するのではなくパラメータ自体を省略してください。</li>\n  <li>アクセストークンのユーザーが所属していない事業所IDを指定した場合は 400 (存在しない事業所のid) を返します。所属する事業所のIDは事業所一覧の取得（GET /api/1/companies）で確認できます。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "事業所ID。事業所一覧の取得（GET /api/1/companies）のレスポンスの id を指定する"
          },
          {
            "name": "details",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに勘定科目 (account_items)・税区分コード (tax_codes)・品目 (items)・取引先 (partners)・部門 (sections)・メモタグ (tags)・口座 (walletables) の一覧をまとめて含める。一覧を含めない場合はパラメータ自体を省略する"
          },
          {
            "name": "account_items",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに勘定科目一覧 (account_items) を含める"
          },
          {
            "name": "taxes",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに税区分コード一覧 (tax_codes) を含める"
          },
          {
            "name": "items",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに品目一覧 (items) を含める"
          },
          {
            "name": "partners",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに取引先一覧 (partners) を含める"
          },
          {
            "name": "sections",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに部門一覧 (sections) を含める"
          },
          {
            "name": "tags",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスにメモタグ一覧 (tags) を含める"
          },
          {
            "name": "walletables",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに口座一覧 (walletables) を含める"
          }
        ]
      }
    },
    "/api/1/items": {
      "get": {
        "summary": "品目一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に登録されている品目の一覧を取得します。取引や振替伝票の明細に付与する品目マスタとして参照する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>使用設定（available）が false の品目も含めて返します。</li>\n  <li>start_update_date / end_update_date で品目の更新日を範囲指定して絞り込めます。JST の日付を <code>yyyy-mm-dd</code> で指定してください（どちらも指定日を含みます）。</li>\n  <li>品目コード（code）は、事業所の設定で品目コードを使用する設定にしている場合のみレスポンスに含まれます。設定が無効の場合は code キー自体が返りません。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む開始日 (yyyy-mm-dd, JST)。指定日を含む、それ以降に更新された品目を対象にします。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む終了日 (yyyy-mm-dd, JST)。指定日を含む、それ以前に更新された品目を対象にします。"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)。ページング用に、スキップする件数を指定します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 3000)。1 回のリクエストで取得する上限件数を指定します。"
          }
        ]
      },
      "post": {
        "summary": "品目の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に新しい品目を作成します。作成された品目は使用設定（available）が true の状態で登録され、取引作成時などに指定できるようになります。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>品目名（name）は事業所内で重複できません。既に同名の品目が存在する場合は 400 エラーになります。</li>\n  <li>品目コード（code）を利用するには、事業所の設定で品目コードを使用する設定にする必要があります。設定が無効の場合、code を指定しても無視され保存されません。</li>\n  <li>品目コード（code）は事業所内で重複できません。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/items/{id}": {
      "get": {
        "summary": "品目の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の品目を 1 件取得します。品目ID（id）は品目一覧の取得 API で確認できます。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>品目コード（code）は、事業所の設定で品目コードを使用する設定にしている場合のみレスポンスに含まれます。設定が無効の場合は code キー自体が返りません。</li>\n  <li>存在しないか既に削除された品目IDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。取得対象の事業所を指定します。"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "品目ID。品目一覧の取得 API のレスポンスに含まれる id を指定します。"
          }
        ]
      },
      "put": {
        "summary": "品目の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の品目を更新します。この API は品目の作成は行いません。品目コードをキーに更新（存在しない場合は作成）したい場合は <code>PUT /api/1/items/code/upsert</code> を利用してください。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>リクエストボディで省略した任意項目（shortcut1・shortcut2・code）は未設定（null）に更新されます。値を維持したい場合は、現在の値も含めてすべての項目を指定してください。</li>\n  <li>品目名（name）は事業所内で重複できません。別の品目と同名になる更新は 400 エラーになります。</li>\n  <li>品目コード（code）は、事業所の設定で品目コードを使用する設定にしている場合のみ更新されます。設定が無効の場合、code を指定しても無視されます。</li>\n  <li>存在しない品目IDを指定した場合はエラーになります。品目IDは品目一覧の取得 API で事前に確認してください。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "品目ID。品目一覧の取得 API のレスポンスに含まれる id を指定します。"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "品目の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の品目を削除します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引などで既に使用されている品目は削除できず、400 エラーになります。品目を無効にしたい場合は、Web 画面から使用設定（available）を「使用しない」に変更してください。</li>\n  <li>存在しないか既に削除された品目IDを指定した場合は 404 を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "品目ID。品目一覧の取得 API のレスポンスに含まれる id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。削除対象の品目が属する事業所を指定します。"
          }
        ]
      }
    },
    "/api/1/items/code/upsert": {
      "put": {
        "summary": "品目の更新（存在しない場合は作成）",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>品目コード（code）をキーに、指定した品目の情報を更新します。該当する品目が存在しない場合は新規作成します（upsert）。外部システムとの連携で、品目マスタを一括で登録・更新する用途を想定しています。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本 API を利用するには、事業所の設定で品目コードを使用する設定にする必要があります。設定が無効な事業所への呼び出しは 400 エラーになります。</li>\n  <li>item オブジェクト内で code を指定することはできません（品目コードは変更不可）。指定した場合は 400 エラーになります。リクエストボディ直下の code のみが有効です。</li>\n  <li>更新レスポンスは 200 OK、新規作成レスポンスは 201 Created で返ります。作成・更新のどちらが行われたかは HTTP ステータスコードで判別してください。</li>\n  <li>更新時、item オブジェクト内で省略した任意項目（shortcut1・shortcut2）は未設定（null）に更新されます。値を維持したい場合は、現在の値も含めてすべての項目を指定してください。</li>\n  <li>品目名（name）は事業所内で重複できません。別の品目と同名になる場合は 400 エラーになります。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/taxes/codes": {
      "get": {
        "summary": "税区分一覧の取得（廃止予定）",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>税区分一覧を取得する</p>\n\n<p>税区分コード（code）は、取引の作成（POST /api/1/deals）や振替伝票の作成（POST /api/1/manual_journals）などで税区分を指定する際に tax_code として利用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>このAPIは廃止予定のため非推奨です。/api/1/taxes/companies/{company_id}（指定した事業所の税区分一覧の取得）をご利用ください。</li>\n  <li>本APIは事業所の設定に依存しない共通の税区分マスタを返します。事業所ごとの使用設定（available）や表示カテゴリ（display_category）を確認する場合は /api/1/taxes/companies/{company_id} をご利用ください。</li>\n  <li>API利用上の非推奨税区分（課税、非課税、不課税、輸出等、未選択、課税8%）は返りません。</li>\n</ul>"
      }
    },
    "/api/1/taxes/codes/{code}": {
      "get": {
        "summary": "税区分の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定したコードに対応する税区分を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>存在しないコード、またはAPI利用上の非推奨税区分（課税、非課税、不課税、輸出等、未選択、課税8%）のコードを指定した場合は404エラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "税区分コード。/api/1/taxes/codes（税区分一覧の取得）または /api/1/taxes/companies/{company_id}（指定した事業所の税区分一覧の取得）で取得できる code を指定します。"
          }
        ]
      }
    },
    "/api/1/taxes/companies/{company_id}": {
      "get": {
        "summary": "指定した事業所の税区分一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の税区分一覧を取得する</p>\n\n<p>税区分コード（code）は、取引の作成（POST /api/1/deals）や振替伝票の作成（POST /api/1/manual_journals）などで税区分を指定する際に tax_code として利用します。事業所で利用できる税区分と使用設定（available）を確認するために本APIをご利用ください。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>一覧には事業所の設定で「使用しない」となっている税区分も含まれます。available=true を指定すると、使用する設定の税区分のみに絞り込めます。</li>\n  <li>display_category が null の税区分は、税率を持たない税区分（未選択、対象外など）です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          },
          {
            "name": "display_category",
            "in": "query",
            "type": "string",
            "description": "指定した表示カテゴリの税区分のみに絞り込みます。未指定の場合は全ての税区分が返ります。税区分の表示カテゴリ（ tax_5: 5%表示の税区分、 tax_8: 8%表示の税区分、 tax_r8: 軽減税率8%表示の税区分、 tax_10: 10%表示の税区分、 tax_5_e80: インボイス経過措置5%表示80%控除の税区分、 tax_5_e70: インボイス経過措置5%表示70%控除の税区分、 tax_5_e50: インボイス経過措置5%表示50%控除の税区分、 tax_5_e30: インボイス経過措置5%表示30%控除の税区分、 tax_8_e80: インボイス経過措置8%表示80%控除の税区分、 tax_8_e70: インボイス経過措置8%表示70%控除の税区分、 tax_8_e50: インボイス経過措置8%表示50%控除の税区分、 tax_8_e30: インボイス経過措置8%表示30%控除の税区分、 tax_r8_e80: インボイス経過措置軽減税率8%表示80%控除の税区分、 tax_r8_e70: インボイス経過措置軽減税率8%表示70%控除の税区分、 tax_r8_e50: インボイス経過措置軽減税率8%表示50%控除の税区分、 tax_r8_e30: インボイス経過措置軽減税率8%表示30%控除の税区分、 tax_10_e80: インボイス経過措置10%表示80%控除の税区分、 tax_10_e70: インボイス経過措置10%表示70%控除の税区分、 tax_10_e50: インボイス経過措置10%表示50%控除の税区分、 tax_10_e30: インボイス経過措置10%表示30%控除の税区分）"
          },
          {
            "name": "available",
            "in": "query",
            "type": "boolean",
            "description": "指定した使用設定の税区分のみに絞り込みます。未指定の場合は全ての税区分が返ります。税区分の使用設定（true: 使用する、false: 使用しない）"
          }
        ]
      }
    },
    "/api/1/walletables": {
      "get": {
        "summary": "口座一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の口座（銀行口座・クレジットカード・その他の決済口座）の一覧を取得する</p>\n\n<p>取得できる口座は、リクエストしたユーザーが所属するグループ管理（work_group）で参照可能な口座に限られます。</p>\n\n<p>ここで取得できる口座IDと種別（type）は、取引の作成（POST /api/1/deals）・口座振替（POST /api/1/transfers）・入出金明細の取得（GET /api/1/wallet_txns）などで from_walletable_type / to_walletable_type と ID を指定する際に利用します。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>type を指定しない場合は、bank_account・credit_card・wallet の全種別を返します。</li>\n  <li>残高情報（walletable_balance / last_balance）、最終同期成功日時（last_synced_at）、同期ステータス（sync_status）は、いずれもオプションのため、それぞれ with_balance / with_last_synced_at / with_sync_status を true にした場合のみレスポンスに含まれます。</li>\n  <li>同期に対応した金融機関の口座（銀行口座・クレジットカード）は本APIでは作成できません。web画面で登録してください。</li>\n  <li>walletable_balance（登録残高）・last_balance（同期残高）はいずれも円単位です。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          },
          {
            "name": "type",
            "in": "query",
            "type": "string",
            "description": "口座種別で絞り込みます。未指定の場合は全種別を返します。\n* `bank_account` - 銀行口座\n* `credit_card` - クレジットカード\n* `wallet` - その他の決済口座（現金・電子マネー・売掛/買掛など）"
          },
          {
            "name": "with_balance",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに walletable_balance（登録残高、円）と last_balance（同期残高、円）を含めます。デフォルトは false です。"
          },
          {
            "name": "with_last_synced_at",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに last_synced_at（最終同期成功日時、ISO 8601 形式）を含めます。同期成功実績がない場合は null になります。デフォルトは false です。"
          },
          {
            "name": "with_sync_status",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに sync_status（同期ステータス）を含めます。デフォルトは false です。"
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞込：開始日（yyyy-mm-dd、JST）。指定した日以降に更新された口座のみを返します。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞込：終了日（yyyy-mm-dd、JST）。指定した日以前に更新された口座のみを返します。"
          }
        ]
      },
      "post": {
        "summary": "口座の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所に口座を作成する</p>\n\n<p>作成した口座は、取引の作成（POST /api/1/deals）や口座振替（POST /api/1/transfers）などで from_walletable_type / to_walletable_type と ID を指定して利用できます。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>同期に対応した金融機関の口座はこのAPIでは作成できません。web画面で登録してください。</li>\n  <li>type に bank_account / credit_card を指定する場合は bank_id が必須です。type に wallet を指定する場合は bank_id を省略できます。</li>\n  <li>type に wallet を指定し、かつ bank_id を省略した場合のみ、is_asset で資産口座（true）と負債口座（false）を選択できます。bank_id を指定した場合は、資産口座か負債口座かは bank_id で指定したサービスに応じて自動判定され、is_asset は無視されます。</li>\n  <li>既存の口座と重複する口座名を指定した場合は 400 エラーが返ります。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/walletables/{type}/{id}": {
      "get": {
        "summary": "口座の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の口座を1件取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>指定した口座が存在しない、またはリクエストしたユーザーのグループ管理（work_group）で参照できない口座を指定した場合は 404 エラーが返ります。</li>\n  <li>残高情報（walletable_balance / last_balance）は常に含まれます。最終同期成功日時（last_synced_at）と同期ステータス（sync_status）は、それぞれ with_last_synced_at / with_sync_status を true にした場合のみレスポンスに含まれます。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "口座ID。/api/1/walletables（口座一覧の取得）で取得できます。"
          },
          {
            "name": "type",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "口座種別。\n* `bank_account` - 銀行口座\n* `credit_card` - クレジットカード\n* `wallet` - その他の決済口座（現金・電子マネー・売掛/買掛など）"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          },
          {
            "name": "with_last_synced_at",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに last_synced_at（最終同期成功日時、ISO 8601 形式）を含めます。同期成功実績がない場合は null になります。デフォルトは false です。"
          },
          {
            "name": "with_sync_status",
            "in": "query",
            "type": "boolean",
            "description": "true を指定すると、レスポンスに sync_status（同期ステータス）を含めます。デフォルトは false です。"
          }
        ]
      },
      "put": {
        "summary": "口座の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の口座の口座名を更新する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>更新できるのは口座名（name）のみです。type や bank_id、資産/負債区分の変更はできません。</li>\n  <li>既存の口座と重複する口座名を指定した場合は 400 エラーが返ります。</li>\n  <li>指定した口座が存在しない、またはリクエストしたユーザーのグループ管理（work_group）で参照できない口座を指定した場合は 404 エラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "口座ID。/api/1/walletables（口座一覧の取得）で取得できます。"
          },
          {
            "name": "type",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "口座種別。\n* `bank_account` - 銀行口座\n* `credit_card` - クレジットカード\n* `wallet` - その他の決済口座（現金・電子マネー・売掛/買掛など）"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "口座の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の口座を削除する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>削除を実行するには、当該口座に関連する仕訳データを事前に削除する必要があります。仕訳が残っている場合は 400 エラーが返ります。</li>\n  <li>当該口座に仕訳が残っていないか確認するには、レポートの「仕訳帳」等を参照し、必要に応じて、「取引」や「口座振替」も削除します。</li>\n  <li>指定した口座が存在しない、またはリクエストしたユーザーのグループ管理（work_group）で参照できない口座を指定した場合は 404 エラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "口座ID。/api/1/walletables（口座一覧の取得）で取得できます。"
          },
          {
            "name": "type",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "口座種別。\n* `bank_account` - 銀行口座\n* `credit_card` - クレジットカード\n* `wallet` - その他の決済口座（現金・電子マネー・売掛/買掛など）"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          }
        ]
      }
    },
    "/api/1/banks": {
      "get": {
        "summary": "連携サービス一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>freee会計に口座として登録できる連携サービス（銀行口座・クレジットカード・その他の決済口座）の一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>連携サービスはfreeeが管理する事業所に依存しないマスタデータのため、company_idパラメータの指定は不要です。</li>\n\n<li>typeパラメータは指定必須です。未指定または定義されていない値を指定した場合は、ステータスコード400のエラーが返ります。</li>\n\n<li>取得結果は連携サービス名(カナ)の昇順（name_kanaが同一の場合はidの昇順）で返ります。</li>\n\n<li>取得したidは、口座の作成（POST /api/1/walletables）のbank_idパラメータに指定して利用します。</li>\n</ul>",
        "parameters": [
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)。limitと組み合わせてページングに利用します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最小: 1, 最大: 500)"
          },
          {
            "name": "type",
            "in": "query",
            "type": "string",
            "description": "連携サービス種別\n* `bank_account` - 銀行口座\n* `credit_card` - クレジットカード\n* `wallet` - その他の決済口座\n\nこのパラメータは指定必須です。未指定または上記以外の値を指定した場合は、ステータスコード400のエラーが返ります。"
          }
        ]
      }
    },
    "/api/1/banks/{id}": {
      "get": {
        "summary": "連携サービスの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定したIDの連携サービス（銀行口座・クレジットカード・その他の決済口座）を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>連携サービスはfreeeが管理する事業所に依存しないマスタデータのため、company_idパラメータの指定は不要です。</li>\n\n<li>存在しないID、または連携が終了したサービスのIDを指定した場合は、ステータスコード404のエラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "連携サービスID。連携サービス一覧の取得（GET /api/1/banks）で取得したidを指定します。"
          }
        ]
      }
    },
    "/api/1/transfers": {
      "get": {
        "summary": "取引（振替）一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引（振替）一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>振替元・振替先に指定できる口座のIDと口座区分（type）は、口座一覧の取得（GET /api/1/walletables）で確認できます。</li>\n  <li>振替先口座はレスポンスの to_walletables（複数行）で返します。amount / to_walletable_type / to_walletable_id / description は振替先の複数指定に対応していない旧形式のフィールド（廃止予定）で、振替先が複数ある場合、amount は全行の合計金額（支払手数料が設定されている場合は手数料分を加算した金額）、to_walletable_type / to_walletable_id は金額が最大の行の値、description は各行の備考を結合した文字列を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "振替日で絞込：開始日 (yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "振替日で絞込：終了日 (yyyy-mm-dd)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最小: 1, 最大: 100) "
          }
        ]
      },
      "post": {
        "summary": "取引（振替）の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引（振替）を作成する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>振替元・振替先に指定できる口座のIDと口座区分（type）は、口座一覧の取得（GET /api/1/walletables）で確認できます。</li>\n  <li>振替先が1つの場合は to_walletable_type / to_walletable_id / amount（必要に応じて description）を指定します。振替先が複数の場合は to_walletables（最大50行）を指定します。両方を同時に指定することはできません。</li>\n  <li>to_walletables を指定する場合、振替元は from_walletable_type / from_walletable_id で共通指定し、各行の amount には0円より大きい金額を指定します。複数行で同一の振替先口座は指定できません。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/transfers/{id}": {
      "get": {
        "summary": "取引（振替）の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引（振替）を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>振替先口座はレスポンスの to_walletables（複数行）で返します。amount / to_walletable_type / to_walletable_id / description は振替先の複数指定に対応していない旧形式のフィールド（廃止予定）で、振替先が複数ある場合、amount は全行の合計金額（支払手数料が設定されている場合は手数料分を加算した金額）、to_walletable_type / to_walletable_id は金額が最大の行の値、description は各行の備考を結合した文字列を返します。</li>\n  <li>指定したIDの取引（振替）が存在しない場合や、削除済み・権限がない場合は404を返します。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引(振替)ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "取引（振替）の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引（振替）を更新する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>部分更新ではありません。作成時と同様に、更新後の取引（振替）の内容全体をリクエストで指定します。</li>\n  <li>振替先が複数ある取引（振替）を更新する場合は to_walletables の指定が必要です。to_walletables を指定せず旧形式の単一フィールド（to_walletable_type / to_walletable_id / amount）のみで更新しようとするとエラーになります（複数の振替先を意図せず1件に置き換えることを防ぐためです）。</li>\n  <li>受取利息や振込手数料が設定された取引（振替）は本APIでは更新できません。</li>\n  <li>承認済みの取引（振替）は、事業所の設定や実行ユーザーの権限によっては更新できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引(振替)ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "取引（振替）の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の取引（振替）を削除する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>指定したIDの取引（振替）が存在しない場合や、削除済み・権限がない場合は404を返します。</li>\n  <li>取引（振替）の状態により削除できない場合は400を返します。エラーメッセージに削除できない理由を含みます。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "取引(振替)ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/wallet_txns": {
      "get": {
        "summary": "口座明細一覧の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の口座明細（銀行口座・クレジットカード・その他の決済口座の入出金明細）一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>デフォルトでは取引日（date）の降順で返されます。sort_type に created_at_desc を指定すると、明細の作成日時の降順で返されます。</li>\n<li>取得件数は limit と offset で制御します（デフォルト: 20件、最大: 100件）。</li>\n</ul>\n\n<h2 id=\"_3\">定義</h2>\n\n<ul>\n<li>\n<p>amount : 取引金額（単位: 円）</p>\n</li>\n\n<li>\n<p>due_amount : 取引登録待ち金額（明細に対してまだ取引が登録されていない金額）</p>\n</li>\n\n<li>\n<p>balance : 残高（銀行口座等）</p>\n</li>\n\n<li>\n<p>entry_side</p>\n\n<ul>\n<li>income : 入金</li>\n\n<li>expense : 出金</li>\n</ul>\n</li>\n\n<li>\n<p>walletable_type</p>\n\n<ul>\n<li>bank_account : 銀行口座</li>\n\n<li>credit_card : クレジットカード</li>\n\n<li>wallet : 現金・その他の決済口座</li>\n</ul>\n</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "walletable_type",
            "in": "query",
            "type": "string",
            "description": "口座区分で絞り込みます。walletable_type と walletable_id は同時に指定が必要です（片方のみ指定した場合、この条件は無視されます）。\n* `bank_account` - 銀行口座\n* `credit_card` - クレジットカード\n* `wallet` - 現金・その他の決済口座"
          },
          {
            "name": "walletable_id",
            "in": "query",
            "type": "integer",
            "description": "口座IDで絞り込みます。walletable_type と walletable_id は同時に指定が必要です（片方のみ指定した場合、この条件は無視されます）。口座IDは口座一覧の取得API（GET /api/1/walletables）で確認できます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "取引日で絞込：開始日 (yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "取引日で絞込：終了日 (yyyy-mm-dd)"
          },
          {
            "name": "entry_side",
            "in": "query",
            "type": "string",
            "description": "入金・出金の区分で絞り込みます。\n* `income` - 入金\n* `expense` - 出金"
          },
          {
            "name": "sort_type",
            "in": "query",
            "type": "string",
            "description": "並び順の指定（未指定の場合は取引日の降順で返されます）\n* `created_at_desc` - 明細の作成日時の降順"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最小: 1, 最大: 100) "
          }
        ]
      },
      "post": {
        "summary": "口座明細の作成",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の口座明細を作成する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n<li>登録時に<a target=\"_blank\" href=\"https://support.freee.co.jp/hc/ja/articles/202848350-明細の自動登録ルールを設定する\">自動登録ルールの設定</a>の条件に一致した場合はルールが適用され、取引の登録などが自動で行われることがあります。ルールが適用され登録処理が実行された場合、レスポンスの rule_matched が true になります。</li>\n</ul>\n\n<h2 id=\"_3\">定義</h2>\n\n<ul>\n<li>\n<p>amount : 取引金額（単位: 円）</p>\n</li>\n\n<li>\n<p>due_amount : 取引登録待ち金額（明細に対してまだ取引が登録されていない金額）</p>\n</li>\n\n<li>\n<p>balance : 残高（銀行口座等）</p>\n</li>\n\n<li>\n<p>entry_side</p>\n\n<ul>\n<li>income : 入金</li>\n\n<li>expense : 出金</li>\n</ul>\n</li>\n\n<li>\n<p>walletable_type</p>\n\n<ul>\n<li>bank_account : 銀行口座</li>\n\n<li>credit_card : クレジットカード</li>\n\n<li>wallet : 現金・その他の決済口座</li>\n</ul>\n</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/wallet_txns/{id}": {
      "get": {
        "summary": "口座明細の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の口座明細を取得する</p>\n\n<h2 id=\"_2\">定義</h2>\n\n<ul>\n<li>\n<p>amount : 取引金額（単位: 円）</p>\n</li>\n\n<li>\n<p>due_amount : 取引登録待ち金額（明細に対してまだ取引が登録されていない金額）</p>\n</li>\n\n<li>\n<p>balance : 残高（銀行口座等）</p>\n</li>\n\n<li>\n<p>entry_side</p>\n\n<ul>\n<li>income : 入金</li>\n\n<li>expense : 出金</li>\n</ul>\n</li>\n\n<li>\n<p>walletable_type</p>\n\n<ul>\n<li>bank_account : 銀行口座</li>\n\n<li>credit_card : クレジットカード</li>\n\n<li>wallet : 現金・その他の決済口座</li>\n</ul>\n</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "明細ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "delete": {
        "summary": "口座明細の削除",
        "description": "\n<h2 id=\"\">概要</h2>\n<p>指定した事業所の口座明細を削除する</p>\n\n<h2 id=\"\">注意点</h2>\n<ul>\n  <li>同期をして取得したデータが「明細」の場合は、削除および再取得はできません。</li>\n  <li>詳細は<a target=\"_blank\" href=\"https://support.freee.co.jp/hc/ja/articles/360015892332\">freeeヘルプセンター</a>をご確認ください。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "明細ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/journals": {
      "get": {
        "summary": "仕訳帳のダウンロード要求",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の仕訳帳ファイルの作成を依頼する（非同期処理）</p>\n\n<p>本APIはファイル作成のリクエストを受け付けるのみで、ファイルは非同期で作成されます。レスポンスの id（受け付けID）を使って、仕訳帳のステータスの取得（GET /api/1/journals/reports/{id}/status）でステータスを確認し、uploaded になったら仕訳帳のダウンロード（GET /api/1/journals/reports/{id}/download）でファイルを取得してください。</p>\n\n<p>生成されるファイルのファイル形式と出力項目に関しては、<a href=\"https://support.freee.co.jp/hc/ja/articles/204615564#other\">ヘルプページ</a>をご参照ください。download_type ごとの詳細は以下をご参照ください。</p>\n\n<ul>\n  <li>generic <a href=\"https://support.freee.co.jp/hc/ja/articles/204615564#2\">(旧CSV)</a></li>\n  <li>generic_v2 <a href=\"https://support.freee.co.jp/hc/ja/articles/204615564#h_01GEDXEY3SQP8Y7S58CM2H4CKH\">(新CSV（freee汎用形式）)</a></li>\n  <li>csv <a href=\"https://support.freee.co.jp/hc/ja/articles/204599604#2\">(弥生会計)</a></li>\n  <li>pdf <a href=\"https://support.freee.co.jp/hc/ja/articles/204615564#3\">(PDF)</a></li>\n</ul>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>start_date・end_date を指定しない場合は、当期の会計年度の開始日・終了日が自動で設定されます。</li>\n  <li>encoding は download_type が generic・generic_v2 の場合のみ指定できます。未指定の場合は sjis になります。download_type が csv・pdf の場合に指定すると 400 エラーになります（csv は常に sjis で出力されるため、レスポンスの encoding には sjis が返ります。pdf の場合は null が返ります）。</li>\n  <li>visible_tags は download_type が generic・csv・pdf の場合のみ指定できます（generic_v2 に指定すると 400 エラーになります）。指定しない場合は従来の仕様の仕訳帳が出力されます。</li>\n  <li>segment_1_tag・segment_2_tag・segment_3_tag は download_type が generic の場合のみ指定でき、対応するセグメントが利用可能なプランの契約と設定を完了している必要があります。詳細は<a href=\"https://support.freee.co.jp/hc/ja/articles/360020679611\" target=\"_blank\">セグメント（分析用タグ）の設定</a>をご参照ください。</li>\n  <li>visible_ids は download_type が generic の場合のみ指定できます（それ以外に指定すると 400 エラーになります）。</li>\n</ul>",
        "parameters": [
          {
            "name": "download_type",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "ダウンロード形式\n* `generic` - 旧CSV形式\n* `generic_v2` - 新CSV形式（freee汎用形式）\n* `csv` - 弥生会計形式のCSV\n* `pdf` - PDF形式"
          },
          {
            "name": "encoding",
            "in": "query",
            "type": "string",
            "description": "出力ファイルの文字コード。download_type が generic・generic_v2 の場合のみ指定できます。未指定の場合は sjis になります。\n* `sjis` - Shift_JIS\n* `utf-8` - UTF-8"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          },
          {
            "name": "visible_tags[]",
            "in": "query",
            "type": "array",
            "description": "補助科目やコメントとして出力する項目。download_type が generic・csv・pdf の場合のみ指定できます。\n* `partner` - 取引先タグ\n* `item` - 品目タグ\n* `tag` - メモタグ\n* `section` - 部門タグ\n* `description` - 備考欄\n* `wallet_txn_description` - 明細の備考欄\n* `segment_1_tag` - セグメント１タグ（download_type:generic のみ）\n* `segment_2_tag` - セグメント２タグ（download_type:generic のみ）\n* `segment_3_tag` - セグメント３タグ（download_type:generic のみ）\n* `all` - セグメントタグを除く上記すべてを有効として扱います。セグメントが必要な場合は all ではなく segment_1_tag・segment_2_tag・segment_3_tag を個別に指定してください。",
            "style": "form",
            "explode": true
          },
          {
            "name": "visible_ids[]",
            "in": "query",
            "type": "array",
            "description": "追加出力するID項目。download_type が generic の場合のみ指定できます。\n* `deal_id` - 取引ID\n* `transfer_id` - 取引（振替）ID\n* `manual_journal_id` - 振替伝票ID",
            "style": "form",
            "explode": true
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "取得開始日（yyyy-mm-dd）。未指定の場合は当期の会計年度の開始日になります。"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "取得終了日（yyyy-mm-dd）。未指定の場合は当期の会計年度の終了日になります。"
          }
        ]
      }
    },
    "/api/1/journals/reports/{id}/status": {
      "get": {
        "summary": "仕訳帳のステータスの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>仕訳帳のダウンロードリクエストのステータスを取得する</p>\n\n<p>仕訳帳のダウンロード要求（GET /api/1/journals）のレスポンスで返る id（受け付けID）を指定します。status が uploaded になると、レスポンスに download_url（仕訳帳のダウンロード（GET /api/1/journals/reports/{id}/download）のURL）が含まれます。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>status が failed の場合はファイルの作成に失敗しています。仕訳帳のダウンロード要求（GET /api/1/journals）から再度やり直してください。</li>\n  <li>指定した id が存在しない場合は 404 エラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "受け付けID。仕訳帳のダウンロード要求（GET /api/1/journals）のレスポンスで返る id を指定します。"
          }
        ]
      }
    },
    "/api/1/journals/reports/{id}/download": {
      "get": {
        "summary": "仕訳帳のダウンロード",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>作成が完了した仕訳帳ファイルをダウンロードする</p>\n\n<p>仕訳帳のステータスの取得（GET /api/1/journals/reports/{id}/status）で status が uploaded になった後に呼び出してください。ファイルは仕訳帳のダウンロード要求（GET /api/1/journals）で指定した download_type に応じて CSV（text/csv）または PDF（application/pdf）で返ります。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>ファイルの作成が完了していない場合や、指定した id が存在しない場合は 404 エラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "受け付けID。仕訳帳のダウンロード要求（GET /api/1/journals）のレスポンスで返る id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID。/api/1/companies（事業所一覧の取得）で取得できます。"
          }
        ]
      }
    },
    "/api/1/reports/trial_bs": {
      "get": {
        "summary": "貸借対照表の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の貸借対照表（Balance Sheet, BS）を取得します。決算作業や月次の残高確認、取引先・品目・部門・セグメント単位のBS内訳集計に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>opening_balance : 期首残高（円）</p></li>\n  <li><p>debit_amount : 期間中の借方金額（円）</p></li>\n  <li><p>credit_amount : 期間中の貸方金額（円）</p></li>\n  <li><p>closing_balance : 期末残高（円）</p></li>\n  <li><p>composition_ratio : 構成比（百分率、%。BSの区分合計（資産の部合計、または負債及び純資産の部合計）に対する当該行の残高割合を 100 換算した値。相殺科目などで基準額を超える場合は 100 を超え得る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_bs?company_id=1&amp;fiscal_year=2019&amp;breakdown_display_type=partner</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_bs&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;breakdown_display_type&quot;: &quot;partner&quot;,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1000,\n        &quot;account_item_name&quot;: &quot;現金&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;流動資産&quot;,\n        &quot;opening_balance&quot;: 100000,\n        &quot;debit_amount&quot;: 50000,\n        &quot;credit_amount&quot;: 20000,\n        &quot;closing_balance&quot;: 130000,\n        &quot;composition_ratio&quot;: 25.0,\n        &quot;partners&quot;: [\n          {\n            &quot;id&quot;: 123,\n            &quot;name&quot;: &quot;freee&quot;,\n            &quot;opening_balance&quot;: 100000,\n            &quot;debit_amount&quot;: 50000,\n            &quot;credit_amount&quot;: 20000,\n            &quot;closing_balance&quot;: 130000,\n            &quot;composition_ratio&quot;: 25.0\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_bs_two_years": {
      "get": {
        "summary": "貸借対照表(前年比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の貸借対照表(前年比較)を取得します。当年度と前年度の期末残高を並べて比較し、前年比を確認する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>last_year_closing_balance : 前年度期末残高（円）</p></li>\n  <li><p>closing_balance : 当年度期末残高（円）</p></li>\n  <li><p>year_on_year : 前年比（百分率、%。100 は前年と同額、200 は前年比 2 倍、50 は前年比 0.5 倍。前年度期末残高が 0 以下、または当年度期末残高が負数の場合は 0 が返る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_bs_two_years?company_id=1&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_bs_two_years&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1000,\n        &quot;account_item_name&quot;: &quot;現金&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;流動資産&quot;,\n        &quot;last_year_closing_balance&quot;: 25000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;year_on_year&quot;: 400.0\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_bs_three_years": {
      "get": {
        "summary": "貸借対照表(３期間比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の貸借対照表(３期間比較)を取得します。当年度・前年度・前々年度の期末残高を並べて比較し、中期の推移や前年比を確認する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>two_years_before_closing_balance : 前々年度期末残高（円）</p></li>\n  <li><p>last_year_closing_balance : 前年度期末残高（円）</p></li>\n  <li><p>closing_balance : 当年度期末残高（円）</p></li>\n  <li><p>year_on_year : 前年比（百分率、%。100 は前年と同額、200 は前年比 2 倍、50 は前年比 0.5 倍。前年度期末残高が 0 以下、または当年度期末残高が負数の場合は 0 が返る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_bs_three_years?company_id=1&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_bs_three_years&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1000,\n        &quot;account_item_name&quot;: &quot;現金&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;流動資産&quot;,\n        &quot;two_years_before_closing_balance&quot;: 50000,\n        &quot;last_year_closing_balance&quot;: 25000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;year_on_year&quot;: 400.0\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl": {
      "get": {
        "summary": "損益計算書の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書（Profit and Loss statement, PL）を取得します。月次・期間指定での損益確認や、取引先・品目・部門・セグメント単位のPL内訳集計に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>opening_balance : 期首残高（円）</p></li>\n  <li><p>debit_amount : 期間中の借方金額（円）</p></li>\n  <li><p>credit_amount : 期間中の貸方金額（円）</p></li>\n  <li><p>closing_balance : 期末残高（円）</p></li>\n  <li><p>composition_ratio : 構成比（百分率、%。PLの基準額（法人の場合は売上高の合計、個人の場合は収入金額の合計）に対する当該行の金額割合を 100 換算した値。基準額を超える行では 100 を超え得る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl?company_id=1&amp;fiscal_year=2019&amp;breakdown_display_type=partner</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;breakdown_display_type&quot;: &quot;partner&quot;,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;opening_balance&quot;: 0,\n        &quot;debit_amount&quot;: 50000,\n        &quot;credit_amount&quot;: 150000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;composition_ratio&quot;: 100.0,\n        &quot;partners&quot;: [\n          {\n            &quot;id&quot;: 123,\n            &quot;name&quot;: &quot;freee&quot;,\n            &quot;opening_balance&quot;: 0,\n            &quot;debit_amount&quot;: 50000,\n            &quot;credit_amount&quot;: 150000,\n            &quot;closing_balance&quot;: 100000,\n            &quot;composition_ratio&quot;: 100.0\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl_two_years": {
      "get": {
        "summary": "損益計算書(前年比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書(前年比較)を取得します。当年度と前年度の期末残高を並べて比較し、前年比を確認する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>last_year_closing_balance : 前年度期末残高（円）</p></li>\n  <li><p>closing_balance : 当年度期末残高（円）</p></li>\n  <li><p>year_on_year : 前年比（百分率、%。100 は前年と同額、200 は前年比 2 倍、50 は前年比 0.5 倍。前年度期末残高が 0 以下、または当年度期末残高が負数の場合は 0 が返る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl_two_years?company_id=1&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl_two_years&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;last_year_closing_balance&quot;: 25000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;year_on_year&quot;: 400.0\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl_three_years": {
      "get": {
        "summary": "損益計算書(３期間比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書(３期間比較)を取得します。当年度・前年度・前々年度の期末残高を並べて比較し、前年比を確認する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>two_years_before_closing_balance : 前々年度期末残高（円）</p></li>\n  <li><p>last_year_closing_balance : 前年度期末残高（円）</p></li>\n  <li><p>closing_balance : 当年度期末残高（円）</p></li>\n  <li><p>year_on_year : 前年比（百分率、%。100 は前年と同額、200 は前年比 2 倍、50 は前年比 0.5 倍。前年度期末残高が 0 以下、または当年度期末残高が負数の場合は 0 が返る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl_three_years?company_id=1&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl_three_years&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;two_years_before_closing_balance&quot;: 50000,\n        &quot;last_year_closing_balance&quot;: 25000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;year_on_year&quot;: 400.0\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl_sections": {
      "get": {
        "summary": "損益計算書(部門比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書(部門比較)を取得します。指定した部門（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定した部門の合計、sections 配下の値は各部門の金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl_sections?company_id=1&amp;section_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl_sections&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;section_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;sections&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;営業部&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;広報部&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;人事部&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "section_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較する部門IDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択の部門で比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].sections[]` の各部門要素配下の `partners` / `items` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 部門比較では `section` は指定できない\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl_segment_1_tags": {
      "get": {
        "summary": "損益計算書(セグメント１比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書(セグメント1比較)を取得します。指定したセグメント1タグ（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定したセグメント1タグの合計、segment_1_tags 配下の値は各タグの金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl_segment_1_tags?company_id=1&amp;segment_1_tag_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl_segment_1_tags&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;segment_1_tag_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;segment_1_tags&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;プロジェクトA&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;プロジェクトB&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;プロジェクトC&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "segment_1_tag_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較するセグメント1タグIDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択のセグメント1タグで比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].segment_1_tags[]` の各セグメント1タグ要素配下の `partners` / `items` / `sections` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、部門 の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl_segment_2_tags": {
      "get": {
        "summary": "損益計算書(セグメント２比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書(セグメント2比較)を取得します。指定したセグメント2タグ（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定したセグメント2タグの合計、segment_2_tags 配下の値は各タグの金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl_segment_2_tags?company_id=1&amp;segment_2_tag_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl_segment_2_tags&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;segment_2_tag_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;segment_2_tags&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;プロジェクトA&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;プロジェクトB&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;プロジェクトC&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "segment_2_tag_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較するセグメント2タグIDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択のセグメント2タグで比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].segment_2_tags[]` の各セグメント2タグ要素配下の `partners` / `items` / `sections` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、部門 の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_pl_segment_3_tags": {
      "get": {
        "summary": "損益計算書(セグメント３比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の損益計算書(セグメント3比較)を取得します。指定したセグメント3タグ（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定したセグメント3タグの合計、segment_3_tags 配下の値は各タグの金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_pl_segment_3_tags?company_id=1&amp;segment_3_tag_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_pl_segment_3_tags&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;segment_3_tag_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;売上高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;営業収益&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;segment_3_tags&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;プロジェクトA&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;プロジェクトB&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;プロジェクトC&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "segment_3_tag_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較するセグメント3タグIDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択のセグメント3タグで比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].segment_3_tags[]` の各セグメント3タグ要素配下の `partners` / `items` / `sections` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、部門 の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr": {
      "get": {
        "summary": "製造原価報告書の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書（Cost Report, CR）を取得します。材料費・労務費・製造経費など製造原価の期間集計や、取引先・品目・部門・セグメント単位の内訳集計に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>opening_balance : 期首残高（円）</p></li>\n  <li><p>debit_amount : 期間中の借方金額（円）</p></li>\n  <li><p>credit_amount : 期間中の貸方金額（円）</p></li>\n  <li><p>closing_balance : 期末残高（円）</p></li>\n  <li><p>composition_ratio : 構成比（百分率、%。製造原価報告書の基準額（勘定科目カテゴリー「製造原価」の金額。法人・個人共通）に対する当該行の金額割合を 100 換算した値。基準額を超える行では 100 を超え得る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr?company_id=1&amp;fiscal_year=2019&amp;breakdown_display_type=partner</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;breakdown_display_type&quot;: &quot;partner&quot;,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;opening_balance&quot;: 0,\n        &quot;debit_amount&quot;: 150000,\n        &quot;credit_amount&quot;: 50000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;composition_ratio&quot;: 10.0,\n        &quot;partners&quot;: [\n          {\n            &quot;id&quot;: 123,\n            &quot;name&quot;: &quot;freee&quot;,\n            &quot;opening_balance&quot;: 0,\n            &quot;debit_amount&quot;: 150000,\n            &quot;credit_amount&quot;: 50000,\n            &quot;closing_balance&quot;: 100000,\n            &quot;composition_ratio&quot;: 10.0\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr_two_years": {
      "get": {
        "summary": "製造原価報告書(前年比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書(前年比較)を取得します。当年度と前年度の期末残高を並べて比較し、前年比を確認する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>last_year_closing_balance : 前年度期末残高（円）</p></li>\n  <li><p>closing_balance : 当年度期末残高（円）</p></li>\n  <li><p>year_on_year : 前年比（百分率、%。100 は前年と同額、200 は前年比 2 倍、50 は前年比 0.5 倍。前年度期末残高が 0 以下、または当年度期末残高が負数の場合は 0 が返る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr_two_years?company_id=1&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr_two_years&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;last_year_closing_balance&quot;: 25000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;year_on_year&quot;: 400.0\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr_three_years": {
      "get": {
        "summary": "製造原価報告書(３期間比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書(３期間比較)を取得します。当年度・前年度・前々年度の期末残高を並べて比較し、前年比を確認する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>two_years_before_closing_balance : 前々年度期末残高（円）</p></li>\n  <li><p>last_year_closing_balance : 前年度期末残高（円）</p></li>\n  <li><p>closing_balance : 当年度期末残高（円）</p></li>\n  <li><p>year_on_year : 前年比（百分率、%。100 は前年と同額、200 は前年比 2 倍、50 は前年比 0.5 倍。前年度期末残高が 0 以下、または当年度期末残高が負数の場合は 0 が返る）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr_three_years?company_id=1&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr_three_years&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;two_years_before_closing_balance&quot;: 50000,\n        &quot;last_year_closing_balance&quot;: 25000,\n        &quot;closing_balance&quot;: 100000,\n        &quot;year_on_year&quot;: 400.0\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。それぞれ各行の `balances[].partners` / `items` / `sections` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外（例: `account_item_display_type=group` かつ `partner` / `item` / `section` / `segment_*_tag`）は validation error になる\n\n取引先、品目、部門、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr_sections": {
      "get": {
        "summary": "製造原価報告書(部門比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書(部門比較)を取得します。指定した部門（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定した部門の合計、sections 配下の値は各部門の金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr_sections?company_id=1&amp;section_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr_sections&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;section_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;sections&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;営業部&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;広報部&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;人事部&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "section_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較する部門IDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択の部門で比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `segment_1_tag` / `segment_2_tag` / `segment_3_tag` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].sections[]` の各部門要素配下の `partners` / `items` / `segment_1_tags` / `segment_2_tags` / `segment_3_tags` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 部門比較では `section` は指定できない\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、セグメント の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr_segment_1_tags": {
      "get": {
        "summary": "製造原価報告書(セグメント１比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書(セグメント1比較)を取得します。指定したセグメント1タグ（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定したセグメント1タグの合計、segment_1_tags 配下の値は各タグの金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr_segment_1_tags?company_id=1&amp;segment_1_tag_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr_segment_1_tags&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;segment_1_tag_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;segment_1_tags&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;プロジェクトA&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;プロジェクトB&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;プロジェクトC&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "segment_1_tag_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較するセグメント1タグIDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択のセグメント1タグで比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].segment_1_tags[]` の各セグメント1タグ要素配下の `partners` / `items` / `sections` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、部門 の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr_segment_2_tags": {
      "get": {
        "summary": "製造原価報告書(セグメント２比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書(セグメント2比較)を取得します。指定したセグメント2タグ（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定したセグメント2タグの合計、segment_2_tags 配下の値は各タグの金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr_segment_2_tags?company_id=1&amp;segment_2_tag_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr_segment_2_tags&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;segment_2_tag_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;segment_2_tags&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;プロジェクトA&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;プロジェクトB&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;プロジェクトC&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "segment_2_tag_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較するセグメント2タグIDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択のセグメント2タグで比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].segment_2_tags[]` の各セグメント2タグ要素配下の `partners` / `items` / `sections` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、部門 の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/trial_cr_segment_3_tags": {
      "get": {
        "summary": "製造原価報告書(セグメント３比較)の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の製造原価報告書(セグメント3比較)を取得します。指定したセグメント3タグ（最大5つ）ごとの期末残高を並べて比較する用途に利用できます。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li><p>created_at : 作成日時（ISO 8601, JST）</p></li>\n  <li><p>account_item_name : 勘定科目名</p></li>\n  <li><p>hierarchy_level : 階層レベル（1が最上位、値が大きいほど深い階層）</p></li>\n  <li><p>parent_account_category_name : 上位勘定科目カテゴリー名</p></li>\n  <li><p>closing_balance : 期末残高（円。行直下の値は比較対象に指定したセグメント3タグの合計、segment_3_tags 配下の値は各タグの金額）</p></li>\n</ul>\n\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li>対象の会計年度で製造業向け機能を使用する設定になっている必要があります。無効の場合はエラー（400）になります。</li>\n  <li>会計年度が指定されない場合、現在の会計年度がデフォルトとなります。</li>\n  <li>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</li>\n  <li>配賦仕訳の絞り込み（cost_allocation）は法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能です。</li>\n  <li>partner_codeとpartner_idは同時に指定することはできません。</li>\n  <li>start_date / end_date を指定した場合、以下を同時に指定することはできません。\n  <ul>\n    <li>fiscal_year</li>\n    <li>start_month</li>\n    <li>end_month</li>\n  </ul>\n  </li>\n  <li>0を指定すると未選択で絞り込めます\n  <ul>\n    <li>partner_idに0を指定して絞り込んだ場合\n    <ul>\n      <li>取引先が設定されていない取引、振替伝票の金額がレスポンスに返却されます</li>\n    </ul>\n    </li>\n  </ul>\n  </li>\n</ul>\n\n<h2 id=\"_4\">レスポンスの例</h2>\n<blockquote>\n<p>GET https://api.freee.co.jp/api/1/reports/trial_cr_segment_3_tags?company_id=1&amp;segment_3_tag_ids=1,2,3&amp;fiscal_year=2019</p>\n</blockquote>\n\n<pre><code>{\n  &quot;trial_cr_segment_3_tags&quot;: {\n    &quot;company_id&quot;: 1,\n    &quot;segment_3_tag_ids&quot;: &quot;1,2,3&quot;,\n    &quot;fiscal_year&quot;: 2019,\n    &quot;created_at&quot;: &quot;2019-12-17T12:00:50+09:00&quot;,\n    &quot;balances&quot;: [\n      {\n        &quot;account_item_id&quot;: 1500,\n        &quot;account_item_name&quot;: &quot;[製]期首材料棚卸高&quot;,\n        &quot;hierarchy_level&quot;: 2,\n        &quot;account_category_name&quot;: &quot;期首原材料棚卸&quot;,\n        &quot;closing_balance&quot;: 600000,\n        &quot;segment_3_tags&quot;: [\n          {\n            &quot;id&quot;: 1,\n            &quot;name&quot;: &quot;プロジェクトA&quot;,\n            &quot;closing_balance&quot;: 100000\n          },\n          {\n            &quot;id&quot;: 2,\n            &quot;name&quot;: &quot;プロジェクトB&quot;,\n            &quot;closing_balance&quot;: 200000\n          },\n          {\n            &quot;id&quot;: 3,\n            &quot;name&quot;: &quot;プロジェクトC&quot;,\n            &quot;closing_balance&quot;: 300000\n          }\n        ]\n      }\n    ]\n  },\n  &quot;up_to_date&quot;: true\n}</code></pre>\n",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "segment_3_tag_ids",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "比較するセグメント3タグIDの指定。半角数字のIDを半角カンマ区切り（スペースなし）で1〜5つ指定してください。同じIDを重複して指定することはできません。0を指定すると、未選択のセグメント3タグで比較できます。"
          },
          {
            "name": "fiscal_year",
            "in": "query",
            "type": "integer",
            "description": "会計年度（会計期間の開始日が属する年。例: 会計期間が 2019-04-01 開始なら 2019）。会計年度の作成後に期間を変更した場合などに、指定した年と実際に集計対象となる会計年度がずれることがあります。意図した期間が集計されない場合は、fiscal_year ではなく start_date・end_date で期間を指定してください。"
          },
          {
            "name": "start_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：開始会計月(1-12)。指定されない場合、現在の会計年度の期首月が指定されます。"
          },
          {
            "name": "end_month",
            "in": "query",
            "type": "integer",
            "description": "発生月で絞込：終了会計月(1-12)(会計年度が10月始まりでstart_monthが11なら11, 12, 1, ... 9のいずれかを指定する)。指定されない場合、現在の会計年度の期末月が指定されます。"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "account_item_display_type",
            "in": "query",
            "type": "string",
            "description": "勘定科目の表示。指定されない場合、`account_item` が指定されます。\n* `account_item` - 勘定科目単位で表示\n* `group` - 決算書表示単位で表示\n"
          },
          {
            "name": "breakdown_display_type",
            "in": "query",
            "type": "string",
            "description": "内訳の表示。`account_item_display_type` と組み合わせ制約がある。\n* `partner` / `item` / `section` は `account_item_display_type=account_item`（または省略）のときのみ指定可能。`balances[].segment_3_tags[]` の各セグメント3タグ要素配下の `partners` / `items` / `sections` に内訳配列を返す\n* `account_item` は `account_item_display_type=group` のときのみ指定可能。他の値と異なり内訳配列は返らず、決算書表示名行に続けて勘定科目行が同じ `balances[]` に展開される\n* 上記の組み合わせ以外は validation error になる\n\n取引先、品目、部門 の各項目が単独で5,000以上登録されている場合は、breakdown_display_type で該当項目を指定するとエラーになります。\n\n例）取引先の登録数が5,000以上、品目の登録数が4,999以下の場合\n* breakdown_display_type: 取引先を指定 → エラーになる\n* breakdown_display_type: 品目を指定 → エラーにならない\n"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（0を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込（事業所設定で取引先コードの利用を有効にしている場合のみ利用可能です）"
          },
          {
            "name": "item_id",
            "in": "query",
            "type": "integer",
            "description": "品目IDで絞込（0を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（0を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳の絞り込み条件。指定されない場合、決算整理仕訳を含む金額が返却されます。\n* `only` - 決算整理仕訳のみを集計\n* `without` - 決算整理仕訳を除外して集計\n"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳の絞り込み条件。指定されない場合、配賦仕訳を含む金額が返却されます。法人スタンダードプラン（および旧法人ベーシックプラン）以上で利用可能で、利用できないプランで指定した場合はエラー（403）になります。\n* `only` - 配賦仕訳のみを集計\n* `without` - 配賦仕訳を除外して集計\n"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスの絞り込み条件。プレミアムプラン、法人アドバンスプラン（および旧法人プロフェッショナルプラン）以上で、かつ事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n* `without_in_progress` - 未承認を除く（デフォルト）\n* `all` - 全ての承認ステータスを含む\n"
          }
        ]
      }
    },
    "/api/1/reports/general_ledgers": {
      "get": {
        "summary": "総勘定元帳一覧の取得（β版）",
        "description": "<h2 id=\"\">概要</h2>\n<p>指定した事業所の総勘定元帳一覧を取得する</p>\n<br>\n※このAPIはβ版として提供しています。\n<ul>\n  <li>このAPIは法人アドバンスプラン（および旧法人プロフェッショナルプラン）・法人エンタープライズプランに加入している事業所のみが利用できます。</li>\n  <li>利用状況によって事前の告知なく提供プラン・コール数の上限を変更する可能性があります。</li>\n  <li>他エンドポイントと比べてレスポンスタイムが遅い場合があります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "期間で絞込：開始日 (yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "期間で絞込：終了日 (yyyy-mm-dd)"
          },
          {
            "name": "account_item_name",
            "in": "query",
            "type": "string",
            "description": "勘定科目名で絞込"
          },
          {
            "name": "tax_name",
            "in": "query",
            "type": "string",
            "description": "税区分名で絞込"
          },
          {
            "name": "tax_rate",
            "in": "query",
            "type": "string",
            "description": "税率で絞込"
          },
          {
            "name": "adjustment",
            "in": "query",
            "type": "string",
            "description": "決算整理仕訳で絞込（決算整理仕訳のみ：only, 決算整理仕訳以外：without）。指定されない場合、決算整理仕訳を含む金額が返却されます。"
          },
          {
            "name": "cost_allocation",
            "in": "query",
            "type": "string",
            "description": "配賦仕訳で絞込（配賦仕訳のみ：only,配賦仕訳以外：without）。指定されない場合、配賦仕訳を含む金額が返却されます。"
          },
          {
            "name": "partner_name",
            "in": "query",
            "type": "string",
            "description": "取引先で絞込（未選択を指定すると、取引先が未選択で絞り込めます）"
          },
          {
            "name": "item_name",
            "in": "query",
            "type": "string",
            "description": "品目で絞込（未選択を指定すると、品目が未選択で絞り込めます）"
          },
          {
            "name": "section_name",
            "in": "query",
            "type": "string",
            "description": "部門で絞込（未選択を指定すると、部門が未選択で絞り込めます）"
          },
          {
            "name": "tag_name",
            "in": "query",
            "type": "string",
            "description": "メモタグで絞込<br>\n取引数が多すぎる場合はタイムアウトする場合があります。<br>\nその場合はWeb画面よりPDF/CSV出力をご利用ください。\n"
          },
          {
            "name": "segment_tag_1_name",
            "in": "query",
            "type": "string",
            "description": "セグメント１タグ名で絞込（未選択を指定すると、セグメント１タグが未選択で絞り込めます）"
          },
          {
            "name": "segment_tag_2_name",
            "in": "query",
            "type": "string",
            "description": "セグメント２タグ名で絞込（未選択を指定すると、セグメント２タグが未選択で絞り込めます）"
          },
          {
            "name": "segment_tag_3_name",
            "in": "query",
            "type": "string",
            "description": "セグメント３タグ名で絞込（未選択を指定すると、セグメント３タグが未選択で絞り込めます）"
          },
          {
            "name": "approval_flow_status",
            "in": "query",
            "type": "string",
            "description": "承認ステータスで絞込 (未承認を除く: without_in_progress (デフォルト)、全てのステータス: all)<br>\n事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。\n"
          }
        ]
      }
    },
    "/api/1/receipts": {
      "get": {
        "summary": "ファイルボックス（証憑ファイル）一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所のファイルボックス（証憑ファイル）一覧を取得する</p>\n<p>アップロード日（start_date〜end_date）の期間を指定して取得します。ファイルの実体（バイナリ）は本APIでは取得できないため、ファイルボックス（証憑ファイル）のダウンロードAPI（GET /api/1/receipts/{id}/download）を利用してください。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>一度に取得できる件数は最大3000件です（デフォルト: 50件）。それを超えるファイルを取得する場合は、offsetとlimitを利用してページングしてください。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "start_date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "アップロード日で絞込：開始日 (yyyy-mm-dd)"
          },
          {
            "name": "end_date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "アップロード日で絞込：終了日 (yyyy-mm-dd)"
          },
          {
            "name": "user_name",
            "in": "query",
            "type": "string",
            "description": "アップロードしたユーザーで絞込。ユーザーの表示名またはメールアドレスの部分一致で指定します。"
          },
          {
            "name": "number",
            "in": "query",
            "type": "integer",
            "description": "アップロードファイルNo（ファイルボックス上でファイルごとに表示される番号）で絞込"
          },
          {
            "name": "comment_type",
            "in": "query",
            "type": "string",
            "description": "ファイルに付けられたコメントの状態で絞込（posted:コメントあり, raised:未解決, resolved:解決済）"
          },
          {
            "name": "comment_important",
            "in": "query",
            "type": "boolean",
            "description": "trueを指定した場合、お気に入りコメントが付いたファイルのみが対象になります"
          },
          {
            "name": "category",
            "in": "query",
            "type": "string",
            "description": "ファイルの取引への登録状態で絞込（all:すべて, without_deal:未登録, with_expense_application_line:経費申請中, with_deal:登録済み, ignored:無視。デフォルト: all）"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 3000)"
          }
        ]
      },
      "post": {
        "summary": "ファイルボックス（証憑ファイル）のアップロード",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>ファイルボックス（証憑ファイル）をアップロードする</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>リクエストヘッダーの Content-Type は、multipart/form-dataにのみ対応しています。</li>\n  <li>インボイス制度適格請求書発行事業者登録番号はOCR解析結果が採用されます。OCR解析結果を確認する場合は、Web画面にてご確認ください。上書きする場合は、ファイルボックス（証憑ファイル）の更新APIをご利用ください。</li>\n  <li>以下の制限を満たさない場合アップロードに失敗します。</li>\n  <ul>\n      <li>ファイルサイズの制限： 64MBまで</li>\n      <li>月間アップロード容量の制限： 月間合計10GBまで</li>\n      <li>1分間あたりのアップロード数制限： 300ファイルまで</li>\n      <li>プランによる月間アップロード数の制限： 以下のリンクからご確認ください</li>\n      <ul>\n          <li>\n              <a href=\"https://support.freee.co.jp/hc/ja/articles/213726523--%E5%80%8B%E4%BA%BA-freee%E4%BC%9A%E8%A8%88%E3%81%AE%E3%83%97%E3%83%A9%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6\" target=\"_blank\">【個人】freee会計のプランについて</a>\n          </li>\n          <li>\n              <a href=\"https://support.freee.co.jp/hc/ja/articles/27975180546713--%E6%B3%95%E4%BA%BA-freee%E4%BC%9A%E8%A8%88%E3%81%AE%E3%83%97%E3%83%A9%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6-2024%E5%B9%B47%E6%9C%88%E4%BB%A5%E9%99%8D\" target=\"_blank\">【法人】freee会計のプランについて（2024年7月以降）</a>\n          </li>\n      </ul>\n  </ul>\n</ul>"
      }
    },
    "/api/1/receipts/{id}": {
      "get": {
        "summary": "ファイルボックス（証憑ファイル）の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所のファイルボックス（証憑ファイル）を取得する</p>\n<p>ファイルの実体（バイナリ）は本APIでは取得できないため、ファイルボックス（証憑ファイル）のダウンロードAPI（GET /api/1/receipts/{id}/download）を利用してください。</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "ファイルボックス（証憑ファイル）ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "ファイルボックス（証憑ファイル）の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>ファイルボックス（証憑ファイル）を更新する</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、証憑ファイルの再アップロードはできません。</li>\n  <li>リクエストボディに含めたフィールドのみが更新されます。含めなかったフィールドの値は変更されません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "ファイルボックス（証憑ファイル）ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "ファイルボックス（証憑ファイル）の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>ファイルボックス（証憑ファイル）を削除する</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "ファイルボックス（証憑ファイル）ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/receipts/{id}/download": {
      "get": {
        "summary": "ファイルボックス（証憑ファイル）のダウンロード",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所のファイルボックス（証憑ファイル）をダウンロードする</p>\n<p>レスポンスのContent-Typeは、アップロードされたファイルの形式（ファイルボックス（証憑ファイル）の取得APIで返るmime_type）に応じて返ります。</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "ファイルボックス（証憑ファイル）ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/expense_applications": {
      "get": {
        "summary": "経費申請一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費申請一覧を取得する</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、経費申請の一覧を取得することができます。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス(draft:下書き, in_progress:申請中, approved:承認済, rejected:却下, feedback:差戻し)、 取引ステータス(unsettled:清算待ち, settled:精算済み)"
          },
          {
            "name": "payroll_attached",
            "in": "query",
            "type": "boolean",
            "description": "true:給与連携あり、false:給与連携なし、未指定時:絞り込みなし"
          },
          {
            "name": "start_transaction_date",
            "in": "query",
            "type": "string",
            "description": "発生日(経費申請項目の日付)で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_transaction_date",
            "in": "query",
            "type": "string",
            "description": "発生日(経費申請項目の日付)で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No."
          },
          {
            "name": "title",
            "in": "query",
            "type": "string",
            "description": "申請タイトル"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "申請日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "承認者のユーザーID"
          },
          {
            "name": "min_amount",
            "in": "query",
            "type": "integer",
            "description": "経費申請の合計金額で絞込：下限金額 (単位:円、以上)"
          },
          {
            "name": "max_amount",
            "in": "query",
            "type": "integer",
            "description": "経費申請の合計金額で絞込：上限金額 (単位:円、以下)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 500)"
          }
        ]
      },
      "post": {
        "summary": "経費申請の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費申請を作成する</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    申請者がどの所属部門として申請するかは applicant_group_id で指定します。申請者が複数の部門に所属している場合は必須です。1段階目の承認ステップが部門選択型の場合は approval_flow_group_id を指定してください。\n  </li>\n  <li>申請時には、申請タイトル(title)に加え、項目行については金額(amount)、日付(transaction_date)、内容(description)が必須項目となります。申請時の業務効率化のため、API入力をお勧めします。</li>\n  <li>本APIは駅すぱあと連携 (出発駅と到着駅から金額を自動入力する機能)には非対応です。駅すぱあと連携を使用した経費申請は作成できません。</li>\n  <li>本APIは外貨には非対応です。外貨を利用する経費申請は作成できません。</li>\n  <li>本APIはカスタム申請項目には非対応です。カスタム申請項目を使用した経費申請は作成できません。</li>\n  <li>本APIは金額計算方法には非対応です。金額計算方法を設定した経費申請は作成できません。</li>\n  <li>本APIは条件分岐を含む申請経路にも対応しています。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/expense_applications/{id}": {
      "get": {
        "summary": "経費申請詳細の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の経費申請を取得する</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIは外貨には非対応です。外貨を利用する経費申請は取得できません。</li>\n  <li>本APIはカスタム申請項目には非対応です。カスタム申請項目を使用した経費申請は取得できません。</li>\n  <li>本APIは金額計算方法には非対応です。金額計算方法を設定した経費申請は取得できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "経費申請の更新",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の経費申請を更新する</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、経費申請を更新することができます。</li>\n  <li>本APIでは、status(申請ステータス): draft:下書き, feedback:差戻しのみ更新可能です。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    申請者がどの所属部門として申請するかは applicant_group_id で指定します。申請者が複数の部門に所属している場合は必須です。1段階目の承認ステップが部門選択型の場合は approval_flow_group_id を指定してください。\n  </li>\n  <li>申請時には、申請タイトル(title)に加え、項目行については金額(amount)、日付(transaction_date)、内容(description)が必須項目となります。申請時の業務効率化のため、API入力をお勧めします。</li>\n  <li>本APIは駅すぱあと連携 (出発駅と到着駅から金額を自動入力する機能)には非対応です。駅すぱあと連携を使用した経費申請は更新できません。</li>\n  <li>本APIは外貨には非対応です。外貨を利用する経費申請は更新できません。</li>\n  <li>本APIはカスタム申請項目には非対応です。カスタム申請項目を使用した経費申請は更新できません。</li>\n  <li>本APIは金額計算方法には非対応です。金額計算方法を設定した経費申請は更新できません。</li>\n  <li>本APIは条件分岐を含む申請経路にも対応しています。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "経費申請の削除",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の経費申請を削除する</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n      <li>自分が申請者でない申請の削除が可能なのはユーザーの権限が管理者権限、且つ申請ステータスが差し戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>本APIは駅すぱあと連携 (出発駅と到着駅から金額を自動入力する機能)には非対応です。駅すぱあと連携を使用した経費申請は削除できません。</li>\n  <li>本APIはカスタム申請項目には非対応です。カスタム申請項目を使用した経費申請は削除できません。</li>\n  <li>本APIは金額計算方法には非対応です。金額計算方法を設定した経費申請は削除できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/expense_applications/{id}/actions": {
      "post": {
        "summary": "経費申請の承認操作",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費申請の承認操作を行う</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、経費申請の承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）を行うことができます。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    次の承認ステップが部門選択型の場合は next_group_id を指定してください。\n  </li>\n  <li>本APIは駅すぱあと連携 (出発駅と到着駅から金額を自動入力する機能)には非対応です。駅すぱあと連携を使用した経費申請は承認操作できません。</li>\n  <li>本APIはカスタム申請項目には非対応です。カスタム申請項目を使用した経費申請は承認操作できません。</li>\n  <li>本APIは金額計算方法には非対応です。金額計算方法を設定した経費申請は承認操作できません。</li>\n  <li>本APIは条件分岐を含む申請経路にも対応しています。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/expense_applications/{id}/parent_approvable_requests": {
      "put": {
        "summary": "経費申請に関連付ける各種申請の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費申請に関連付ける各種申請の更新を行う</p>\n\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、経費申請に関連付ける各種申請を更新することができます。</li>\n  <li>本APIでは、status(申請ステータス): in_progress:申請中, approved:承認済みのみ更新可能です。</li>\n  <li>parent_idにnullを指定すると、現在設定されている各種申請との関連付けを解除できます。</li>\n  <li>\n    申請ステータスが申請中の経費申請に対して関連付ける各種申請を更新するためには、以下の全てに当てはまる必要があります。\n    <ul>\n      <li>現在の承認ステップで承認者として指定されている、または特権承認ができる</li>\n      <li>申請フォームの設定で、承認者による経費申請に関連付ける各種申請の更新が許可されている</li>\n    </ul>\n  </li>\n  <li>\n    申請ステータスが承認済みの経費申請に対して関連付ける各種申請を更新するためには、以下の全てに当てはまる必要があります。\n    <ul>\n      <li>経費精算に対する閲覧および編集の権限を持ち、自分の経費申請のみに限定する制限がかかっていない</li>\n      <li>申請フォームの設定で、管理者による経費申請に関連付ける各種申請の更新が許可されている</li>\n    </ul>\n  </li>\n  <li>本APIは駅すぱあと連携 (出発駅と到着駅から金額を自動入力する機能)には非対応です。駅すぱあと連携を使用した経費申請は関連付ける各種申請を更新できません。</li>\n  <li>申請フォームの設定はWeb画面よりご利用ください。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/expense_applications/currencies": {
      "get": {
        "summary": "経費精算の外貨一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費精算で利用する外貨の一覧を取得します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "search_status",
            "in": "query",
            "type": "string",
            "description": "利用状態での絞り込み (usable: 利用可能, unusable: 利用不可)"
          }
        ]
      },
      "post": {
        "summary": "経費精算の外貨の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費精算で利用する外貨を作成します。</p>",
        "hasJsonBody": true
      }
    },
    "/api/1/expense_applications/currencies/{id}": {
      "get": {
        "summary": "経費精算の外貨の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費精算で利用する外貨を取得します。</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "外貨ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "経費精算の外貨の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費精算で利用する外貨を更新します。</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "外貨ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "経費精算の外貨の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費精算で利用する外貨を削除します。</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "外貨ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/expense_applications/form": {
      "get": {
        "summary": "経費申請フォームの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費申請フォームの設定を取得します。設定が未作成の場合は初期値を返します。</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "経費申請フォームの更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費申請フォームの設定を更新します。設定が未作成の場合は作成します。</p>",
        "hasJsonBody": true
      }
    },
    "/api/1/expense_application_line_templates": {
      "get": {
        "summary": "経費科目一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費科目一覧を取得する</p>\n\n<p>経費科目は、経費申請の作成時に申請者が選択する項目で、勘定科目・税区分・品目などの組み合わせをあらかじめ設定したものです。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>カスタム申請項目を含むなど、Web版freee会計専用の設定を含む経費科目も一覧には含まれます。ただし、これらの経費科目は経費科目の取得・更新APIでは404エラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最小: 1, 最大: 100)"
          }
        ]
      },
      "post": {
        "summary": "経費科目の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費科目を作成する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>作成された経費科目のsource_line_template_idには、作成された経費科目自身のIDが設定されます。</li>\n  <li>required_receiptを未指定で作成した場合、添付ファイルは任意（false）になります。</li>\n  <li>item_idで品目を紐付けた場合でも、レスポンスに品目IDは含まれません。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/expense_application_line_templates/{id}": {
      "get": {
        "summary": "経費科目の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費科目を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>\n    以下のいずれかに該当する経費科目はWeb版freee会計専用のため、本APIでは404エラーになります（経費科目一覧の取得APIでは取得できます）。\n    <ul>\n      <li>カスタム申請項目を含む</li>\n      <li>内容の入力設定が「必須」以外</li>\n      <li>金額の設定が「なし」以外</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費科目ID、または経費科目のsource_line_template_id。\n経費科目は設定内容を変更すると経費科目IDが変わることがあります。変更前に取得した経費科目IDと、設定を変更しても変わらないsource_line_template_idのどちらを指定しても、最新の経費科目を操作できます。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "経費科目の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費科目を更新する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIはリクエストボディで指定した内容への全置換で更新します。任意パラメータ（item_id, description, line_description, required_receipt）を未指定にした場合、その項目は未設定（required_receiptは任意 = false）にリセットされます。更新前の値を維持したい場合は、経費科目の取得APIで現在の値を確認し、すべてのパラメータを指定してください。</li>\n  <li>\n    以下のいずれかに該当する経費科目はWeb版freee会計専用のため、本APIでは404エラーになります。\n    <ul>\n      <li>カスタム申請項目を含む</li>\n      <li>内容の入力設定が「必須」以外</li>\n      <li>金額の設定が「なし」以外</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費科目ID、または経費科目のsource_line_template_id。\n経費科目は設定内容を変更すると経費科目IDが変わることがあります。変更前に取得した経費科目IDと、設定を変更しても変わらないsource_line_template_idのどちらを指定しても、最新の経費科目を操作できます。"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "経費科目の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の経費科目を削除する</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "経費科目ID、または経費科目のsource_line_template_id。\n経費科目は設定内容を変更すると経費科目IDが変わることがあります。変更前に取得した経費科目IDと、設定を変更しても変わらないsource_line_template_idのどちらを指定しても、最新の経費科目を操作できます。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/payment_requests": {
      "get": {
        "summary": "支払依頼一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の支払依頼一覧を取得する</p>\n\n<p>支払依頼APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-payment-requests\" target=\"_blank\">freee会計支払依頼APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、支払依頼の一覧を取得することができます。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス、または取引ステータス\n申請ステータス:\n* `draft` - 下書き\n* `in_progress` - 申請中\n* `approved` - 承認済\n* `rejected` - 却下\n* `feedback` - 差戻し\n\n取引ステータス (status が `approved` の支払依頼に対して):\n* `unsettled` - 支払待ち\n* `settled` - 支払済み\n\napprover_id を指定した場合は無効です。"
          },
          {
            "name": "start_application_date",
            "in": "query",
            "type": "string",
            "description": "申請日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_application_date",
            "in": "query",
            "type": "string",
            "description": "申請日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "start_issue_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_issue_date",
            "in": "query",
            "type": "string",
            "description": "発生日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No."
          },
          {
            "name": "title",
            "in": "query",
            "type": "string",
            "description": "申請タイトル"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "承認者のユーザーID (`/api/1/users` のレスポンス id と同じ値)\napprover_id を指定した場合は `in_progress` (申請中) の支払依頼のみを返します。"
          },
          {
            "name": "min_amount",
            "in": "query",
            "type": "integer",
            "description": "金額で絞込 (下限金額)"
          },
          {
            "name": "max_amount",
            "in": "query",
            "type": "integer",
            "description": "金額で絞込 (上限金額)"
          },
          {
            "name": "partner_id",
            "in": "query",
            "type": "integer",
            "description": "取引先IDで絞込（`/api/1/partners` のレスポンス id と同じ値）"
          },
          {
            "name": "partner_code",
            "in": "query",
            "type": "string",
            "description": "取引先コードで絞込。事業所側で「取引先コードを利用する」設定が有効な場合に利用できます。"
          },
          {
            "name": "payment_method",
            "in": "query",
            "type": "string",
            "description": "支払方法で絞込\n* `none` - 指定なし\n* `domestic_bank_transfer` - 国内振込\n* `abroad_bank_transfer` - 国外振込\n* `account_transfer` - 口座振替\n* `credit_card` - クレジットカード"
          },
          {
            "name": "start_payment_date",
            "in": "query",
            "type": "string",
            "description": "支払期限で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_payment_date",
            "in": "query",
            "type": "string",
            "description": "支払期限で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "document_code",
            "in": "query",
            "type": "string",
            "description": "請求書番号で絞込"
          },
          {
            "name": "section_id",
            "in": "query",
            "type": "integer",
            "description": "部門IDで絞込（`/api/1/sections` のレスポンス id と同じ値）"
          },
          {
            "name": "partner_name",
            "in": "query",
            "type": "string",
            "description": "取引先名で絞込"
          },
          {
            "name": "approval_flow_route_id",
            "in": "query",
            "type": "integer",
            "description": "申請経路IDで絞込（`/api/1/approval_flow_routes` のレスポンス id と同じ値）"
          },
          {
            "name": "observing",
            "in": "query",
            "type": "string",
            "description": "共有された申請の絞り込み\n* `ignore_observing` - 共有された申請を含めない\n* `only_observing` - 共有された申請のみ"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 500)"
          }
        ]
      },
      "post": {
        "summary": "支払依頼の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の支払依頼を作成する</p>\n\n<p>支払依頼APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-payment-requests\" target=\"_blank\">freee会計支払依頼APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    申請者がどの所属部門として申請するかは applicant_group_id で指定します。申請者が複数の部門に所属している場合は必須です。1段階目の承認ステップが部門選択型の場合は approval_flow_group_id を指定してください。\n  </li>\n  <li>本APIは条件分岐を含む申請経路には非対応です。条件分岐を含む申請経路を使用した支払依頼は作成できません。</li>\n  <li>本APIでは支払依頼の項目行一覧(payment_request_lines)は、最大100行までになります。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/payment_requests/{id}": {
      "get": {
        "summary": "支払依頼の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の支払依頼を取得する</p>\n\n<p>支払依頼APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-payment-requests\" target=\"_blank\">freee会計支払依頼APIの使い方</a>をご参照ください</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "支払依頼ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "支払依頼の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の支払依頼を更新する</p>\n\n<p>支払依頼APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-payment-requests\" target=\"_blank\">freee会計支払依頼APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、支払依頼を更新することができます。</li>\n  <li>本APIでは、status(申請ステータス): draft:下書き, in_progress:申請中, feedback:差戻しのみ更新可能です。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    申請者がどの所属部門として申請するかは applicant_group_id で指定します。申請者が複数の部門に所属している場合は必須です。1段階目の承認ステップが部門選択型の場合は approval_flow_group_id を指定してください。\n  </li>\n  <li>本APIは条件分岐を含む申請経路には非対応です。条件分岐を含む申請経路を使用した支払依頼は更新できません。</li>\n  <li>申請ステータスが申請中の場合には、申請タイトル(title)、申請日(application_date)、申請経路ID(approval_flow_route_id)、承認者のユーザーID(approver_id)は更新ができません。</li>\n  <li>本APIでは支払依頼の項目行一覧(payment_request_lines)は、最大100行までになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "支払依頼ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "支払依頼の削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の支払依頼を削除する</p>\n\n<p>支払依頼APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-payment-requests\" target=\"_blank\">freee会計支払依頼APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、支払依頼の承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）を行うことができます。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "支払依頼ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/payment_requests/{id}/actions": {
      "post": {
        "summary": "支払依頼の承認操作",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の支払依頼の承認操作を行う</p>\n\n<p>支払依頼APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-payment-requests\" target=\"_blank\">freee会計支払依頼APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、支払依頼の承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）を行うことができます。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    次の承認ステップが部門選択型の場合は next_group_id を指定してください。\n  </li>\n  <li>本APIは条件分岐を含む申請経路には非対応です。条件分岐を含む申請経路を使用した支払依頼は承認操作できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "支払依頼ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/approval_requests": {
      "get": {
        "summary": "各種申請一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の各種申請一覧を取得する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、各種申請一覧を取得することができます。</li>\n  <li>\n    申請フォームの項目に契約書（freeeサイン連携）が利用されている各種申請については、API経由で参照は可能ですが、作成と更新ができません。\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "description": "申請ステータス(draft:下書き, in_progress:申請中, approved:承認済, rejected:却下, feedback:差戻し)\n承認者指定時には無効です。"
          },
          {
            "name": "application_number",
            "in": "query",
            "type": "integer",
            "description": "申請No."
          },
          {
            "name": "title",
            "in": "query",
            "type": "string",
            "description": "申請タイトル"
          },
          {
            "name": "form_id",
            "in": "query",
            "type": "integer",
            "description": "申請フォームID"
          },
          {
            "name": "start_application_date",
            "in": "query",
            "type": "string",
            "description": "申請日で絞込：開始日(yyyy-mm-dd)"
          },
          {
            "name": "end_application_date",
            "in": "query",
            "type": "string",
            "description": "申請日で絞込：終了日(yyyy-mm-dd)"
          },
          {
            "name": "applicant_id",
            "in": "query",
            "type": "integer",
            "description": "申請者のユーザーID"
          },
          {
            "name": "min_amount",
            "in": "query",
            "type": "integer",
            "description": "金額で絞込：以上"
          },
          {
            "name": "max_amount",
            "in": "query",
            "type": "integer",
            "description": "金額で絞込：以下"
          },
          {
            "name": "approver_id",
            "in": "query",
            "type": "integer",
            "description": "承認者のユーザーID\n承認者指定時には申請ステータスが申請中のものだけが取得可能です。"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 500)"
          }
        ]
      },
      "post": {
        "summary": "各種申請の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の各種申請を作成する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、各種申請を作成することができます。</li>\n  <li>\n    申請項目(request_items)については、申請フォームで設定された項目のIDとそれに対応する値を入力してください。\n    <ul>\n      <li>タイトル(title)：文字列(必須項目, 255文字まで, 改行なし) 例)予算申請</li>\n      <li>1行コメント(single_line)：文字列(255文字まで, 改行なし) 例)予算に関する申請</li>\n      <li>複数行コメント(multi_line)：文字列(1000文字まで, 改行あり)\n      <br>\n      &nbsp;&nbsp;例)<br>\n      &nbsp;&nbsp;予算に関する申請<br>\n      &nbsp;&nbsp;申請日 2019-12-17<br>\n      </li>\n      <li>プルダウン(select)： プルダウンの選択肢の名前(改行なし) 例)開発部</li>\n      <li>複数選択(checkbox)： 選択肢名の JSON 配列文字列 例)[\"関東\",\"九州\"]</li>\n      <li>日付(date)： 日付形式 例)2019-12-17</li>\n      <li>金額(amount)： 数値(申請フォームで設定した上限・下限金額内の値, 改行なし) 例)10000</li>\n      <li>添付ファイル(receipt)： ファイルボックス（証憑ファイル）APIのID 例)1\n        <ul>\n          <li>ファイルボックスを参照できる権限が必要</li>\n          <li>自分のアップロードしたファイルのみ参照可能な権限のユーザーの場合、他ユーザーがアップロードしたファイルを指定できません</li>\n        </ul>\n      </li>\n      <li>部門ID(section)： 部門APIのID 例)1</li>\n        <ul>\n          <li>親部門は入力できません</li>\n          <li>ユーザーの所属するグループで利用不可な部門は入力できません</li>\n        </ul>\n      <li>取引先ID(partner)： 取引先APIのID 例)1</li>\n    </ul>\n  </li>\n  <li>申請項目に項目ID, 項目タイプの組み合わせが重複したものを入力できません</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    申請者がどの所属部門として申請するかは applicant_group_id で指定します。申請者が複数の部門に所属している場合は必須です。1段階目の承認ステップが部門選択型の場合は approval_flow_group_id を指定してください。\n  </li>\n  <li>本APIは条件分岐を含む申請経路にも対応しています。</li>\n  <li>\n    申請フォームの項目に契約書（freeeサイン連携）が利用されている各種申請については、API経由で参照は可能ですが、作成と更新ができません。\n  </li>\n  <li>Web画面やAPIを通じて申請フォームが変更されると、本APIで使用する項目ID（request_itemsで指定するid）も変更されます。本API利用前に各種申請の取得APIを利用し、最新の申請フォームを取得することを推奨します。</li>\n  <li>申請中の申請を作成に成功した場合、申請者へメール、モバイルプッシュ、slack による通知をします\n    <ul>\n      <li>Webhook を有効にした事業所の場合は Webhook にも通知をします</li>\n    </ul>\n  </li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/approval_requests/{id}": {
      "get": {
        "summary": "各種申請の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の各種申請を取得する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>\n    申請フォームの項目に契約書（freeeサイン連携）が利用されている各種申請については、API経由で参照は可能ですが、作成と更新ができません。\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "各種申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "各種申請の更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の各種申請を更新する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、各種申請を更新することができます。</li>\n  <li>\n    申請項目(request_items)については、各種申請の取得APIで取得したrequest_items.idとそれに対応する値を入力してください。\n    <ul>\n      <li>タイトル(title)：文字列(必須項目, 255文字まで, 改行なし) 例)予算申請</li>\n      <li>1行コメント(single_line)：文字列(255文字まで, 改行なし) 例)予算に関する申請</li>\n      <li>複数行コメント(multi_line)：文字列(1000文字まで, 改行あり)\n      <br>\n      &nbsp;&nbsp;例)<br>\n      &nbsp;&nbsp;予算に関する申請<br>\n      &nbsp;&nbsp;申請日 2019-12-17<br>\n      </li>\n      <li>プルダウン(select)： プルダウンの選択肢の名前(改行なし) 例)開発部</li>\n      <li>複数選択(checkbox)： 選択肢名の JSON 配列文字列 例)[\"関東\",\"九州\"]</li>\n      <li>日付(date)： 日付形式 例)2019-12-17</li>\n      <li>金額(amount)： 数値(申請フォームで設定した上限・下限金額内の値, 改行なし) 例)10000</li>\n      <li>添付ファイル(receipt)： ファイルボックス（証憑ファイル）APIのID 例)1\n        <ul>\n          <li>ファイルボックスを参照できる権限が必要</li>\n          <li>自分のアップロードしたファイルのみ参照可能な権限のユーザーの場合、他ユーザーがアップロードしたファイルを指定できません</li>\n        </ul>\n      </li>\n      <li>部門ID(section)： 部門APIのID 例)1</li>\n        <ul>\n          <li>親部門は入力できません</li>\n          <li>ユーザーの所属するグループで利用不可な部門は入力できません</li>\n        </ul>\n      <li>取引先ID(partner)： 取引先APIのID 例)1</li>\n    </ul>\n  </li>\n  <li>申請項目に項目ID, 項目タイプの組み合わせが重複したものを入力できません</li>\n  <li>本APIでは、status(申請ステータス): draft:下書き, feedback:差戻しのみ更新可能です。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    申請者がどの所属部門として申請するかは applicant_group_id で指定します。申請者が複数の部門に所属している場合は必須です。1段階目の承認ステップが部門選択型の場合は approval_flow_group_id を指定してください。\n  </li>\n  <li>本APIは条件分岐を含む申請経路にも対応しています。</li>\n  <li>\n    申請フォームの項目に契約書（freeeサイン連携）が利用されている各種申請については、API経由で参照は可能ですが、作成と更新ができません。\n  </li>\n  <li>Web画面やAPIを通じて申請フォームが変更されると、本APIで使用する項目ID（request_itemsで指定するid）も変更されます。本APIで使用する項目IDは申請作成時点の項目IDです。本API利用前に各種申請の取得APIを利用し、申請作成時点の項目IDを取得することを推奨します。</li>\n  <li>申請中の申請を作成に成功した場合、申請者へメール、モバイルプッシュ、slack による通知をします\n    <ul>\n      <li>申請を共有している場合、共有者へメール、slack による通知をします</li>\n      <li>Webhook を有効にした事業所の場合は Webhook にも通知をします</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "各種申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "各種申請の削除",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の各種申請を削除する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "各種申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/approval_requests/{id}/actions": {
      "post": {
        "summary": "各種申請の承認操作",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の各種申請の承認操作を行う</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIでは、各種申請の承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）を行うことができます。</li>\n  <li>\n    申請ステータス(下書き、申請中)の指定と変更、及び承認操作（承認する、却下する、申請者へ差し戻す、特権承認する、承認済み・却下済みを取り消す）は以下を参考にして行ってください。\n    <ul>\n      <li>\n        承認操作は申請ステータスが申請中、承認済み、却下のものだけが対象です。\n        <ul>\n          <li>\n            初回申請の場合\n            <ul><li>申請の作成（POST）</li></ul>\n          </li>\n          <li>\n            作成済みの申請の申請ステータス変更・更新する場合\n            <ul><li>申請の更新（PUT）</li></ul>\n          </li>\n          <li>\n            申請中、承認済み、却下の申請の承認操作を行う場合\n            <ul><li>承認操作の実行（POST）</li></ul>\n          </li>\n        </ul>\n      </li>\n      <li>申請の削除（DELETE）が可能なのは申請ステータスが下書き、差戻しの場合のみです</li>\n    </ul>\n  </li>\n  <li>\n    承認者の指定に部門役職データ連携を活用した、以下のいずれかの承認ステップを含む申請経路にも対応しています。\n    <ul>\n      <li>役職指定（申請者の所属部門）</li>\n      <li>役職指定（申請時に部門指定）</li>\n      <li>部門および役職指定</li>\n    </ul>\n    次の承認ステップが部門選択型の場合は next_group_id を指定してください。\n  </li>\n  <li>本APIは条件分岐を含む申請経路にも対応しています。</li>\n  <li>\n    申請フォームの項目に契約書（freeeサイン連携）が利用されている各種申請については、API経由で参照は可能ですが、作成と更新ができません。\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "各種申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/approval_requests/forms": {
      "get": {
        "summary": "各種申請の申請フォーム一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の各種申請の申請フォーム一覧を取得する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/approval_requests/forms/{id}": {
      "get": {
        "summary": "各種申請の申請フォームの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の各種申請の申請フォームを取得する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申請フォームID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/purchase_requests": {
      "get": {
        "summary": "購買申請一覧の取得",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n  <li>レスポンスの amount は非推奨です。同じ値を返す budget_amount を使用してください。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "1ページあたりの取得件数（20, 50, 100, 200, 500）"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得開始位置（0から始まる）"
          }
        ]
      },
      "post": {
        "summary": "購買申請の作成",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請を作成する</p>",
        "hasJsonBody": true
      }
    },
    "/api/1/purchase_requests/{id}": {
      "get": {
        "summary": "購買申請の取得",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請を取得する</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "購買申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "購買申請の更新",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請を更新する</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "購買申請ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "購買申請の削除",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請を削除する</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "購買申請ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/purchase_requests/forms": {
      "get": {
        "summary": "購買申請の申請フォーム一覧の取得",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請の申請フォーム一覧を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n  <li>status を指定しない場合、削除済み（deleted）の申請フォームも含めて返します。申請で使用できる申請フォームのみを取得する場合は、status に active を指定してください。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "status",
            "in": "query",
            "type": "string",
            "required": false,
            "description": "ステータス(draft: 申請で使用しない、active: 申請で使用する、deleted: 削除済み)。未指定の場合はすべてのステータスの申請フォームを返します。"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "1ページあたりの取得件数（1〜500）"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "取得開始位置（0から始まる）"
          }
        ]
      }
    },
    "/api/1/purchase_requests/forms/{id}": {
      "get": {
        "summary": "購買申請の申請フォーム詳細の取得",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請の申請フォーム詳細を取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n\n<ul>\n  <li>購買申請の作成・更新時に指定する approval_flow_route_id には、本APIのレスポンスの flow_routes の id を指定してください。申請経路一覧の取得API（/api/1/approval_flow_routes）のレスポンスの id は本APIの flow_routes の src_id に対応しており、flow_routes の id とは異なる値です。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申請フォームID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/purchase_requests/{id}/actions": {
      "post": {
        "summary": "購買申請の承認操作",
        "description": "<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の購買申請の承認操作を行う</p>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "購買申請ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/approval_flow_routes": {
      "get": {
        "summary": "申請経路一覧の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の申請経路一覧を取得する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計の経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"\">注意点</h2>\n\n<ul>\n  <li>\n    <p>承認ステップの詳細（steps）は本APIのレスポンスには含まれません。承認方法や分岐条件を確認する場合は、申請経路の取得（GET /api/1/approval_flow_routes/{id}）をご利用ください。</p>\n  </li>\n  <li>\n    <p>支払依頼では、条件分岐を含む申請経路を指定した作成・更新・承認操作はできません。</p>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "included_user_id",
            "in": "query",
            "type": "integer",
            "description": "経路に含まれるユーザーのユーザーID（指定したユーザーが承認ステップの承認者に含まれる申請経路に絞り込めます）"
          },
          {
            "name": "usage",
            "in": "query",
            "type": "string",
            "description": "申請種別（各申請種別が使用できる申請経路に絞り込めます。例えば、ApprovalRequest を指定すると、各種申請が使用できる申請経路に絞り込めます。未指定の場合は全ての申請種別の申請経路が対象になります。）\n* `TxnApproval` - 仕訳承認\n* `ExpenseApplication` - 経費精算\n* `PaymentRequest` - 支払依頼\n* `ApprovalRequest` - 各種申請\n* `DocApproval` - 請求書等 (見積書・納品書・請求書・発注書)"
          },
          {
            "name": "request_form_id",
            "in": "query",
            "type": "integer",
            "description": "申請フォームID（指定した申請フォームが使用できる申請経路に絞り込めます。usage に ApprovalRequest を指定した場合のみ有効で、usage が ApprovalRequest 以外または未指定の場合、このパラメータは無視されます。指定した申請フォームが存在しない場合や無効な場合は空配列が返ります。）"
          }
        ]
      }
    },
    "/api/1/approval_flow_routes/{id}": {
      "get": {
        "summary": "申請経路の取得",
        "description": "\n<h2 id=\"\">概要</h2>\n\n<p>指定した事業所の申請経路を取得する</p>\n\n<p>各種申請APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-approval-requests\" target=\"_blank\">freee会計の各種申請APIの使い方</a>をご参照ください</p>\n<p>経費精算APIの使い方については、<a href=\"https://developer.freee.co.jp/tips/accounting-expense-applications\" target=\"_blank\">freee会計の経費精算APIの使い方</a>をご参照ください</p>\n\n<h2 id=\"\">注意点</h2>\n\n<ul>\n  <li>\n    <p>承認ステップごとの承認方法は steps[].resource_type で判別できます。役職で承認者を指定する承認ステップ（and_position / or_position）では steps[].approver_determination_type、steps[].group、steps[].position_types を、条件分岐の承認ステップ（switchable）では steps[].switching_rules をご参照ください。</p>\n  </li>\n  <li>\n    <p>支払依頼では、条件分岐を含む申請経路を指定した作成・更新・承認操作はできません。</p>\n  </li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申請経路ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    },
    "/api/1/segments/{segment_id}/tags": {
      "get": {
        "summary": "セグメントタグ一覧の取得",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>指定した事業所に登録されているセグメントタグの一覧を取得します。取引や振替伝票の明細に付与するセグメントタグを参照する用途を想定しています。</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>segment_id にはセグメント区分（1、2、3）を指定します。利用できるセグメント区分は事業所の契約プランによって異なり、利用できない区分を指定した場合はエラーになります。</li>\n  <li>start_update_date / end_update_date でセグメントタグの更新日を範囲指定して絞り込めます。JST の日付を yyyy-mm-dd で指定してください（どちらも指定日を含みます）。</li>\n  <li>セグメントタグコード（code）は、事業所の設定でセグメントタグコードを使用する設定にしている場合のみレスポンスに含まれます。設定が無効の場合は code キー自体が返りません。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "取得対象の事業所ID"
          },
          {
            "name": "segment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "セグメント区分（1、2、3のいずれか）。利用できる区分は事業所の契約プランによって異なります。"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 20, 最小: 1, 最大: 500) "
          },
          {
            "name": "start_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む開始日 (yyyy-mm-dd, JST)。指定日を含む、それ以降に更新されたセグメントタグを対象にします。"
          },
          {
            "name": "end_update_date",
            "in": "query",
            "type": "string",
            "description": "更新日で絞り込む終了日 (yyyy-mm-dd, JST)。指定日を含む、それ以前に更新されたセグメントタグを対象にします。"
          }
        ]
      },
      "post": {
        "summary": "セグメントタグの作成",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>指定した事業所のセグメント区分に、新しいセグメントタグを作成します。作成したタグは取引や振替伝票の明細に付与できます。</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>segment_id にはセグメント区分（1、2、3）を指定します。利用できない区分を指定した場合はエラーになります。</li>\n  <li>セグメントタグ名（name）は、事業所内の同じセグメント区分で重複できません。</li>\n  <li>セグメントタグコード（code）は、事業所の設定でセグメントタグコードを使用する設定にしている場合のみ保存されます。設定が無効の場合は指定しても保存されません。</li>\n</ul>",
        "parameters": [
          {
            "name": "segment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "セグメント区分（1、2、3のいずれか）。利用できる区分は事業所の契約プランによって異なります。"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/segments/{segment_id}/tags/{id}": {
      "put": {
        "summary": "セグメントタグの更新",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>セグメントタグIDを指定して、セグメントタグの情報を更新します。このAPIはセグメントタグの作成は行いません。</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>セグメントタグ名（name）は、事業所内の同じセグメント区分で重複できません。</li>\n  <li>description / shortcut1 / shortcut2 / code は、省略した場合に未設定（null）へ更新されます。値を維持したい場合は現在の値を指定してください。</li>\n  <li>セグメントタグコード（code）は、事業所の設定でセグメントタグコードを使用する設定にしている場合のみ更新されます。設定が無効の場合は指定しても保存されません。</li>\n  <li>存在しないか既に削除されたセグメントタグIDを指定した場合は 404 エラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "segment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "セグメント区分（1、2、3のいずれか）。利用できる区分は事業所の契約プランによって異なります。"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "更新対象のセグメントタグID。一覧取得APIのレスポンスに含まれる id を指定します。"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "セグメントタグの削除",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>セグメントタグIDを指定して、セグメントタグを削除します。</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>取引明細や振替伝票などで使用されているセグメントタグは削除できず、400 エラーになります。</li>\n  <li>存在しないか既に削除されたセグメントタグIDを指定した場合は 404 エラーになります。</li>\n</ul>",
        "parameters": [
          {
            "name": "segment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "セグメント区分（1、2、3のいずれか）。利用できる区分は事業所の契約プランによって異なります。"
          },
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "削除対象のセグメントタグID。一覧取得APIのレスポンスに含まれる id を指定します。"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "削除対象のセグメントタグが属する事業所ID"
          }
        ]
      }
    },
    "/api/1/segments/{segment_id}/tags/code/upsert": {
      "put": {
        "summary": "セグメントタグの更新（作成）",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>セグメントタグコード（code）をキーにセグメントタグを更新し、該当するタグが存在しない場合は新規作成します。外部システムとの連携でセグメントタグマスタを登録・更新する用途を想定しています。</p>\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIを利用するには、事業所の設定でセグメントタグコードを使用する設定にする必要があります。設定が無効な事業所への呼び出しは 400 エラーになります。</li>\n  <li>segment_tag オブジェクト内で code を指定することはできません。セグメントタグコードは変更できないため、リクエストボディ直下の code のみを指定してください。</li>\n  <li>更新した場合は 200 OK、新規作成した場合は 201 Created を返します。処理結果は HTTP ステータスコードで判別してください。</li>\n  <li>description / shortcut1 / shortcut2 は、省略した場合に未設定（null）へ更新されます。値を維持したい場合は現在の値を指定してください。</li>\n  <li>セグメントタグ名（name）は、事業所内の同じセグメント区分で重複できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "segment_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "セグメント区分（1、2、3のいずれか）。利用できる区分は事業所の契約プランによって異なります。"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/fixed_assets": {
      "get": {
        "summary": "固定資産一覧の取得",
        "description": "<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の固定資産一覧を取得する</p>\n<p>target_dateで指定した会計期間に償却データが存在する固定資産を、固定資産IDの昇順で返します。</p>\n\n<h2 id=\"_2\">定義</h2>\n<ul>\n  <li>このAPIは法人エンタープライズに加入している事業所のみが利用できます。</li>\n  <li><p>target_date : 表示したい会計期間の開始年月日。開始年月日以外を指定した場合は、その日付が含まれる会計期間が対象となります。</p></li>\n  <li><p>depreciation_amount : 本年分の償却費合計</p></li>\n  <li><p>depreciation_method : 償却方法</p></li>\n  <li><p>depreciation_account_item_id : 減価償却に使う勘定科目</p></li>\n  <li><p>acquisition_cost : 取得価額</p></li>\n  <li><p>opening_balance : 期首残高</p></li>\n  <li><p>undepreciated_balance : 未償却残高。土地などの償却しない固定資産はnullが返ります。</p></li>\n  <li><p>opening_accumulated_depreciation : 期首減価償却累計額</p></li>\n  <li><p>closing_accumulated_depreciation : 期末減価償却累計額</p></li>\n</ul>\n<h2 id=\"_3\">注意点</h2>\n<ul>\n  <li><p>up_to_dateがfalseの場合、残高の集計が完了していません。最新の集計結果を確認したい場合は、時間を空けて再度取得する必要があります。</p></li>\n  <li><p>このAPIはfreee会計の固定資産台帳を取得します。freee固定資産で登録した固定資産は取得できませんのでご注意ください。<a href=\"https://docs.google.com/presentation/d/1LDrOH1d8FJeCA_qTJuIXwcou1kh00dCLR_X8nacPb98/edit?usp=sharing\">freee固定資産の詳細はこちらをご覧ください。</a></p></li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "target_date",
            "in": "query",
            "type": "string",
            "required": true,
            "description": "表示したい会計期間の開始年月日 (yyyy-mm-dd)。開始年月日以外を指定した場合は、その日付が含まれる会計期間が対象となります。"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)。2ページ目以降を取得する場合に、先頭からスキップする件数を指定します"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 50, 最小: 1, 最大: 200)"
          }
        ]
      }
    },
    "/api/1/account_groups": {
      "post": {
        "summary": "決算書表示名の作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n<p>指定した事業所の決算書表示名（小カテゴリー）を作成する</p>\n<p>決算書表示名は、貸借対照表・損益計算書などの決算書上で勘定科目をまとめて表示するための表示名です。勘定科目カテゴリー（中分類）の配下に作成され、勘定科目の作成・更新時に決算書表示名として指定できるようになります。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>nameは同一年度内で一意である必要があります。すでに存在する決算書表示名と同じnameを指定した場合は400エラーになります。</li>\n  <li>account_category_idには、決算書表示名を配下に作成できる勘定科目カテゴリーのみ指定できます。指定可能な値はSelectablesフォーム用選択項目情報エンドポイント(account_groups.account_category_id)で取得してください。</li>\n  <li>indexを指定しない場合、決算書表示名は同一勘定科目カテゴリー内の末尾に追加されます。</li>\n</ul>",
        "hasJsonBody": true
      }
    },
    "/api/1/user_matchers": {
      "get": {
        "summary": "自動登録ルール一覧の取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の自動登録ルール一覧を取得する</p>\n\n<p>自動登録ルールとは、口座から同期された明細（入出金データ）の内容をもとに、取引や振替の登録・推測を自動で行うためのルールです。</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>activeパラメータを指定しない場合は、有効な自動登録ルールのみが返ります。無効なルールも含めて取得する場合はactive=allを指定してください。</li>\n  <li>一覧は自動登録ルールID（id）の降順で返ります。</li>\n  <li>walletableパラメータは口座名の完全一致で絞り込みます。指定した名前の口座が事業所に存在しない場合は空の一覧が返ります。</li>\n  <li>offsetはlimitの倍数である必要があります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          },
          {
            "name": "limit",
            "in": "query",
            "type": "integer",
            "description": "取得レコードの件数 (デフォルト: 30, 最大: 100)"
          },
          {
            "name": "offset",
            "in": "query",
            "type": "integer",
            "description": "取得レコードのオフセット (デフォルト: 0)。offsetはlimitの倍数である必要があります。"
          },
          {
            "name": "walletable",
            "in": "query",
            "type": "string",
            "description": "口座名で絞込 (完全一致)。指定した名前の口座が事業所に存在しない場合は空の一覧が返ります。"
          },
          {
            "name": "description",
            "in": "query",
            "type": "string",
            "description": "説明文で絞込 (部分一致)"
          },
          {
            "name": "active",
            "in": "query",
            "type": "string",
            "description": "有効/無効/全てで絞込 (有効: active, 無効: inactive, 全て: all)。未指定の場合は有効なルールのみが返ります。"
          },
          {
            "name": "act",
            "in": "query",
            "type": "integer",
            "description": "登録タイプで絞込\n* 0: 取引を推測する(manual_standard)\n* 1: 取引を登録する(auto_standard)\n* 2: 振替を推測する(manual_transfer)\n* 3: 振替を登録する(auto_transfer)\n* 4: 無視する取引を登録する(auto_ignore)\n* 5: 取引テンプレートを推測する(manual_template)\n* 6: 未決済取引の消込を推測する(manual_scrub)\n* 7: 未決済取引の消込を登録する(auto_scrub)\n* 8: 一括振込ファイル消込を推測する(manual_output_zengin_scrub)\n* 9: 一括振込ファイル消込を登録する(auto_output_zengin_scrub)\n* 10: 無視する取引を推測する(manual_ignore)\n* 11: プライベート取引を推測する(manual_private)\n* 12: プライベート取引を登録する(auto_private)\n"
          },
          {
            "name": "created_by",
            "in": "query",
            "type": "integer",
            "description": "作成経由で絞込\n* 0: ユーザーが作成(user)\n* 1: freeeが作成(freee)\n"
          },
          {
            "name": "min_amount",
            "in": "query",
            "type": "integer",
            "description": "最小金額で絞込 (単位: 円)。ルールに設定された最小金額(min_amount)が指定値以上のルールを返します。"
          },
          {
            "name": "max_amount",
            "in": "query",
            "type": "integer",
            "description": "最大金額で絞込 (単位: 円)。ルールに設定された最大金額(max_amount)が指定値以下のルールを返します。"
          },
          {
            "name": "min_priority",
            "in": "query",
            "type": "integer",
            "description": "最小優先度で絞込。優先度(priority)が指定値以上のルールを返します。"
          },
          {
            "name": "max_priority",
            "in": "query",
            "type": "integer",
            "description": "最大優先度で絞込。優先度(priority)が指定値以下のルールを返します。"
          },
          {
            "name": "min_corrected_wallet_txn_count",
            "in": "query",
            "type": "integer",
            "description": "最小正答件数で絞込。適用明細数(corrected_wallet_txn_count)が指定値以上のルールを返します。"
          },
          {
            "name": "max_corrected_wallet_txn_count",
            "in": "query",
            "type": "integer",
            "description": "最大正答件数で絞込。適用明細数(corrected_wallet_txn_count)が指定値以下のルールを返します。"
          },
          {
            "name": "min_corrected_wallet_txn_count_percentage",
            "in": "query",
            "type": "integer",
            "description": "最小正答率で絞込 (単位: パーセント)。適用率(corrected_wallet_txn_count_percentage)が指定値以上のルールを返します。"
          },
          {
            "name": "max_corrected_wallet_txn_count_percentage",
            "in": "query",
            "type": "integer",
            "description": "最大正答率で絞込 (単位: パーセント)。適用率(corrected_wallet_txn_count_percentage)が指定値以下のルールを返します。"
          },
          {
            "name": "card_label_id",
            "in": "query",
            "type": "integer",
            "description": "カードラベルIDで絞込"
          },
          {
            "name": "entry_side_str",
            "in": "query",
            "type": "string",
            "description": "入金/出金で絞込 (入金: income, 出金: expense)"
          }
        ]
      },
      "post": {
        "summary": "自動登録ルールの作成",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の自動登録ルールを作成する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>company_idはリクエストボディではなくクエリパラメータで指定します。</li>\n  <li>act=0,1（取引を推測/登録）の場合は、tax_name（税区分名）とaccount_item_name（勘定科目名）の指定が必須です。</li>\n  <li>登録タイプ（act）が5(manual_template), 6(manual_scrub), 7(auto_scrub), 8(manual_output_zengin_scrub), 9(auto_output_zengin_scrub)の自動登録ルールは、このAPIでは作成できません。</li>\n  <li>同じ内容の自動登録ルールが既に存在する場合は、400エラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ],
        "hasJsonBody": true
      }
    },
    "/api/1/user_matchers/{id}": {
      "get": {
        "summary": "自動登録ルールの取得",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の自動登録ルールを取得する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>登録タイプ（act）が5(manual_template), 6(manual_scrub), 7(auto_scrub), 8(manual_output_zengin_scrub), 9(auto_output_zengin_scrub)の自動登録ルールは取得できません。該当するルールのIDを指定した場合は400エラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "自動登録ルールID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      },
      "put": {
        "summary": "自動登録ルールの更新",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の自動登録ルールを更新する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>本APIは更新後の状態をすべて指定するPUT APIです。リクエストで指定しなかった任意項目は未設定（null）で上書きされるため、変更しない項目も含めてすべての項目を指定してください。</li>\n  <li>act=0,1（取引を推測/登録）の場合は、tax_name（税区分名）とaccount_item_name（勘定科目名）の指定が必須です。</li>\n  <li>登録タイプ（act）に5(manual_template), 6(manual_scrub), 7(auto_scrub), 8(manual_output_zengin_scrub), 9(auto_output_zengin_scrub)を指定することはできません。</li>\n  <li>更新の結果、同じ内容の自動登録ルールが既に存在する場合は、400エラーが返ります。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "自動登録ルールID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ],
        "hasJsonBody": true
      },
      "delete": {
        "summary": "自動登録ルールの削除",
        "description": "\n<h2 id=\"_1\">概要</h2>\n\n<p>指定した事業所の自動登録ルールを削除する</p>\n\n<h2 id=\"_2\">注意点</h2>\n<ul>\n  <li>登録タイプ（act）が5(manual_template), 6(manual_scrub), 7(auto_scrub), 8(manual_output_zengin_scrub), 9(auto_output_zengin_scrub)の自動登録ルールは削除できません。</li>\n</ul>",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "自動登録ルールID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID"
          }
        ]
      }
    }
  }
}