設定 / freee 連携
freee 連携
freee 会計(または freee 請求書)と接続して、案件明細から請求書を直接発行できます。 請求・入金・売掛は freee 側を正本とし、本アプリ側の billing_status は同期されます。
freee 連携の環境変数が未設定です
以下の環境変数を設定すると、freee と接続できます:
FREEE_CLIENT_IDFREEE_CLIENT_SECRETFREEE_REDIRECT_URI(例:https://example.com/api/freee/auth/callback)FREEE_ENCRYPTION_KEY(32 byte の hex / base64 / 任意文字列。トークン暗号化用)
接続状態
環境変数が未設定のため接続できません。
freee と接続取引先マッピング
freee 側の取引先 ID(数値)をここに紐付けると、案件詳細から「freee で請求書発行」が使えるようになります。 未マッピングの取引先には請求書を作成できません。
読み込み中…
設定手順
- freee 側でアプリ登録(OAuth2)→ client_id / client_secret を取得
- 本サーバの環境変数に
FREEE_CLIENT_ID/FREEE_CLIENT_SECRET/FREEE_REDIRECT_URI/FREEE_ENCRYPTION_KEYを設定 - migration
044_freee_integration.sqlを適用 - 「freee と接続」で OAuth 認可 → 接続完了
- 取引先マッピングを設定 → 案件詳細「帳票」タブから請求書発行
詳細は migration 044 view /
docs/freee-invoicing.md を参照。