Misoca API連携セットアップガイド

マーケティング本部の請求書管理を Misoca と自動連携するための設定手順です。

ℹ️ Misoca 管理者の方へ: このページの「Step 1」を Misoca 管理者に対応いただき、取得した 4 つの値を AX 開発チームに共有してください。「Step 2 以降」は AX 開発チームが設定します。

Misoca 管理者への依頼テンプレート

以下を Misoca 管理者にそのまま送ってください:

お疲れ様です。マーケティング本部の請求書管理を AX システムと自動連携するため、 Misoca API の設定をお願いしたくご連絡しました。【お願いしたいこと】 Misoca の管理画面で「APIアプリケーション」を 1 つ作成し、以下の 4 つの値を共有してください。【アプリ作成時の設定値】・アプリケーション名: HJ マーケティング自動連携・リダイレクトURI: urn:ietf:wg:oauth:2.0:oob ・アクセス権限: 読み取り + 書き込み（全てチェック）【共有してほしい値】 1. クライアント ID 2. クライアントシークレット 3. アクセストークン（認証後に取得） 4. リフレッシュトークン（認証後に取得）共有先: AX 開発チーム (aifarm@hj-co.com) ※ 詳細な手順は以下のページを参照してください: https://hj-admin.kousuke-ito-316.workers.dev/setup-misoca.html

事前に必要なもの

項目	説明	担当
Misoca アカウント	管理者権限のあるアカウント	Misoca 管理者
GAS プロジェクト	HJ マーケティング用 (設定済み)	AX 開発チーム
所要時間	約 10 分	—

Step 1: Misoca API アプリケーション登録 (Misoca 管理者が実施)

Misoca にログイン

ブラウザで https://app.misoca.jp にアクセスし、管理者アカウントでログイン。

API 設定画面を開く

右上のアカウントメニュー → 「アプリケーション管理」または以下の URL にアクセス:

https://app.misoca.jp/oauth2/applications

新しいアプリケーションを作成

「新しいアプリケーション」ボタンをクリックし、以下を入力:

項目	入力値
アプリケーション名	`HJ マーケティング自動連携`
リダイレクト URI	`urn:ietf:wg:oauth:2.0:oob`
アクセス権限	全てにチェック (読み取り + 書き込み)

クライアント ID / シークレットを取得

作成後の画面で表示される 2 つの値をメモ。

認証してトークン取得

以下の URL を組み立ててブラウザでアクセス (CLIENT_ID は上記で取得した値):

https://app.misoca.jp/oauth2/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=urn:ietf:wg:oauth:2.0:oob&scope=read+write

承認後、画面に表示される「認可コード」をメモ → AX 開発チームに 4 つの値を一括共有してください。

Step 2 以降 (AX 開発チームが実施)

💡 Step 2 以降は AX 開発チーム側で GAS Script Properties に設定するため、 Misoca 管理者の作業は Step 1 のみです。

Step 2: 取得したアクセストークンを GAS Script Properties (MISOCA_ACCESS_TOKEN) に登録
Step 3: テスト invoice 取得 / 同期 dry-run
Step 4: 定期同期 (毎日 03:00) を有効化
Step 5: エラー通知 Slack channel 設定

Misoca API連携 セットアップガイド