■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
下記の通り、freee会計APIの仕様変更を予定しております。
ご迷惑をおかけし大変恐れ入りますが、新仕様の確認ならびに必要に応じてアプリの改修などの対応をご検討いただきますよう、よろしくお願い申し上げます。
■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API：[POST] /api/1/manual_journals: 振替伝票の作成
変更種別：[Breaking Change]
変更内容：
- 振替伝票の作成（POST）APIにおいて、レスポンスボディから仕訳番号を示す txn_number フィールドを削除します。
- ※本変更は振替伝票の作成（POST）時のレスポンスのみに影響します。
- 以下の取得（GET）APIに関しては、引き続きレスポンスに txn_number が含まれます。
- [GET] /api/1/manual_journals/{id}（振替伝票の取得）
- [GET] /api/1/manual_journals（振替伝票一覧の取得）
変更理由：
振替伝票の新規登録処理における負荷の軽減、およびAPI全体のレスポンスの高速化・パフォーマンス向上を目的としています。作成完了のレスポンスと仕訳番号の取得（GET）の役割を明確に分離する設計への移行に伴う変更となります。
■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日：2026/05/20
変更リリース予定日：2026/07/01
旧バージョン廃止予定日：2026/07/01（リリースと同時に一斉適用となります）
■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
現在、[POST] /api/1/manual_journals のレスポンスに含まれる txn_number を用いて、作成された振替伝票の仕訳番号を処理・保存しているアプリケーションにおいては、実装の変更が必要となります。
今後は、POST APIのレスポンスに含まれる id（振替伝票ID）をご利用いただき、必要に応じて [GET] /api/1/manual_journals/{id} を個別に呼び出して txn_number を取得する実装への変更をご検討ください。
■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント：[POST] /api/1/manual_journals
リクエスト：※変更ありません
レスポンス例（変更後）：レスポンスボディから txn_number が削除されます。
{
"manual_journal": {
"id": 1,
"company_id": 1,
"issue_date": "2019-12-17",
"adjustment": false,
"details": [
{
"id": 1,
"entry_side": "credit",
"account_item_id": 1,
"tax_code": 1,
"partner_id": 1,
"partner_name": "freee",
"partner_code": "code001",
"partner_long_name": "freee株式会社",
"item_id": 1,
"item_name": "freee会計",
"section_id": 1,
"section_name": "開発部",
"tag_ids": [
1
],
"tag_names": [
"メモタグ"
],
"segment_1_tag_id": 1,
"segment_1_tag_name": "セグメント１",
"segment_2_tag_id": 1,
"segment_2_tag_name": "セグメント２",
"segment_3_tag_id": 1,
"segment_3_tag_name": "セグメント３",
"account_item_code": "string",
"item_code": "string",
"section_code": "string",
"segment_1_tag_code": "string",
"segment_2_tag_code": "string",
"segment_3_tag_code": "string",
"amount": 108000,
"vat": 8000,
"description": "備考"
}
],
"receipt_ids": [
1,
2,
3
]
}
}