Misoca APIとZapierで請求書自動化する方法

2026年7月26日

バックオフィス職での転職を考えている人

スポンサードリンク

その頑張り、評価されていますか？

バックオフィスの努力が"経営の要"として評価される会社、あります

業務効率化を調べる時間、電子帳簿保存法を勉強する時間、締め作業で残業する夜——バックオフィスを"経営の要"として評価する会社と、"コスト部門"扱いする会社は、驚くほど別世界です。今のあなたの努力は、正しく評価されていますか？

▷「業務改善を頑張るほど、なぜか報われない気がする」あなたへ

Backup Careerは事務職転職に特化した支援サービス。無料の"仕事適性診断"を受けると、今の職種の延長線だけでなく"経理→労務"や"総務→秘書"などの隣接領域を含めた自分の伸びしろが可視化されます。担当のキャリアアドバイザーはマンツーマンで、"大手エージェントで求人メールだけ送られた"経験のある方こそ、肩を張らないカジュアルな相談ができます。ブラック企業を紹介しない方針＋入社後の定着率93.5%で、「今度こそ長く続けられる会社」に出会えます。

Backup Career｜事務職転職に特化のオンライン支援・満足度4.3・定着率93.5%

Backup Careerで無料キャリア相談を予約する

今すぐ辞める必要はありません。まず"適性診断だけ"受けて自分の市場価値を測る場所として使えます。今日の10分が、来年の働き方を変えます。

Contents

1 Misoca API（v3）とは？概要と主要エンドポイント
- 1.1 主要エンドポイント一覧
  - 1.1.1 エンドポイント利用シーンとサンプルレスポンス
2 API 認証とリクエスト設定
- 2.1 API トークン取得手順（2026 年 4 月リニューアル版）
- 2.2 認証ヘッダーの書き方
  - 2.2.1 cURL で請求書一覧を取得する例
  - 2.2.2 JavaScript（Node.js）で同等リクエストを実行（Zapier の Code ステップ用）
3 Zapier と Misoca をつなげる方法（Webhooks & Code）
- 3.1 Webhooks by Zapier の基本設定
- 3.2 Code by Zapier（JavaScript）で柔軟に API 呼び出し
4 実践：Zap 作成ステップバイステップ
5 具体的自動化シナリオ
- 5.1 シナリオ①　新規請求書作成 → Slack へ PDF リンク付き通知
- 5.2 シナリオ②　HubSpot の新規コンタクト → Misoca 取引先へ自動登録
6 運用とベストプラクティス（エラーハンドリング・セキュリティ・チェックリスト）
7 まとめ

スポンサードリンク

Misoca API（v3）とは？概要と主要エンドポイント

Misoca の v3 API は、RESTful な設計で請求書・見積・取引先情報を外部システムから操作できる公式インターフェイスです。本セクションでは、API が提供するリソースの全体像と、実務で頻繁に利用されるエンドポイントを中心に解説します。まずは API の構造を俯瞰し、次に具体的なリクエスト例を確認してください。

主要エンドポイント一覧

以下の表は、Misoca が公式に公開している代表的エンドポイントです。各行には HTTP メソッドと主な利用シーンを記載しています。実装時は https://api.misoca.jp をベース URL とし、認証ヘッダーだけを追加すれば呼び出せます。

エンドポイント	HTTP メソッド	主な用途
`/v3/invoices`	GET / POST	請求書の一覧取得または新規作成
`/v3/invoices/{id}`	GET / PUT / DELETE	個別請求書の詳細取得・更新・削除
`/v3/invoices/{id}/pdf`	GET	PDF 形式で請求書をダウンロード
`/v3/clients`	GET / POST	取引先（顧客）の一覧取得または新規登録
`/v3/clients/{id}`	GET / PUT / DELETE	個別取引先の詳細取得・更新・削除

エンドポイント利用シーンとサンプルレスポンス

請求書一覧取得（未払いのみ）
GET https://api.misoca.jp/v3/invoices?status=unpaid
json { "invoices": [ { "id": 12345, "amount": 50000, "due_date": "2026-08-15" }, { "id": 12346, "amount": 75000, "due_date": "2026-09-01" } ] }
PDF ダウンロード
GET https://api.misoca.jp/v3/invoices/12345/pdf → バイナリデータが返り、Webhook の「File」フィールドに直接添付可能です。
取引先の新規登録
POST https://api.misoca.jp/v3/clients に顧客情報 JSON を送信すると、即座に Misoca 側のデータベースへ反映されます。

ポイント：上記エンドポイントはすべて GET／POST の組み合わせで完結でき、Zapier の「Webhooks by Zapier」だけでも全機能を操作できます。

API 認証とリクエスト設定

Misoca API はシンプルな Bearer トークン方式で認証します。ここではトークン取得手順の最新 UI に合わせた説明、ヘッダー構成例、および cURL・JavaScript（Node.js）での呼び出しサンプルを示します。

API トークン取得手順（2026 年 4 月リニューアル版）

Misoca にログインし、右上メニューから 「設定」 を選択。
左側ナビゲーションの 「API 設定」 タブをクリック。画面は 2026/04 の UI 改訂に伴い、以前の「開発者設定」から名称が変更されています。
「新規トークン作成」 ボタンを押し、トークン名と有効期限（必要なら）を入力して 「生成」 をクリック。
表示された文字列が API トークンです。※トークンは生成時に一度だけ表示されるため、必ず安全な場所（例：パスワードマネージャ）に保存してください。

注意：Misoca の UI は随時更新されます。上記手順と画面が一致しない場合は、公式ヘルプセンターの「API トークン取得」ガイドをご参照ください。

認証ヘッダーの書き方

ヘッダー	例
`Authorization`	`Bearer <YOUR_API_TOKEN>`
`Content-Type`	`application/json`

cURL で請求書一覧を取得する例

curl -X GET &quot;https://api.misoca.jp/v3/invoices?status=unpaid&quot; \
     -H &quot;Authorization: Bearer abcdef1234567890&quot; \
     -H &quot;Content-Type: application/json&quot;

curl -X GET "https://api.misoca.jp/v3/invoices?status=unpaid" \

-H "Authorization: Bearer abcdef1234567890" \

-H "Content-Type: application/json"

JavaScript（Node.js）で同等リクエストを実行（Zapier の Code ステップ用）

const fetch = require('node-fetch');

exports.handler = async (event, context) =&gt; {
  const token = process.env.MISOCA_API_TOKEN; // Zapier Secrets に保存推奨
  const response = await fetch('https://api.misoca.jp/v3/invoices?status=unpaid', {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    }
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return { invoices: data.invoices };
};

const fetch = require('node-fetch');

exports.handler = async (event, context) => {

const token = process.env.MISOCA_API_TOKEN; // Zapier Secrets に保存推奨

const response = await fetch('https://api.misoca.jp/v3/invoices?status=unpaid', {

method: 'GET',

headers: {

'Authorization': `Bearer ${token}`,

'Content-Type': 'application/json'

}

});

if (!response.ok) throw new Error(`HTTP ${response.status}`);

const data = await response.json();

return { invoices: data.invoices };

};

ポイント：認証情報は環境変数（Zapier の Secrets）で管理すれば、コード中に平文が残らず安全です。

Zapier と Misoca をつなげる方法（Webhooks & Code）

Misoca には公式の Zapier アプリは 現在提供されていません（※2026 年 7 月時点）。しかし「Webhooks by Zapier」と「Code by Zapier」を組み合わせれば、ほぼすべての API 操作が可能です。将来的に公式アプリがリリースされる可能性もあるため、最新情報は Zapier Marketplace と Misoca のヘルプページを定期的に確認してください。

Webhooks by Zapier の基本設定

Zap の Action ステップで 「Webhooks by Zapier」 → 「Custom Request」 を選択。
必要項目（Method、URL、Headers、Data）を入力します。以下は PDF ダウンロードの例です。

項目	設定例
Method	GET
URL	`https://api.misoca.jp/v3/invoices/{{InvoiceID}}/pdf`
Headers	`Authorization: Bearer {{API_TOKEN}}` `Content-Type: application/json`
Data	なし

テスト実行でバイナリが返ってくれば成功です。取得した PDF は次のステップ（Slack、メール等）へそのまま渡せます。

Code by Zapier（JavaScript）で柔軟に API 呼び出し

Code ステップは「条件分岐」や「データ変換」が必要なときに有効です。以下は取引先を新規登録するサンプルです。

const fetch = require('node-fetch');

exports.handler = async (event) =&gt; {
  const token = process.env.MISOCA_API_TOKEN;
  const payload = {
    name: event.name,
    email: event.email,
    phone: event.phone,
    address: event.address
  };

  const response = await fetch('https://api.misoca.jp/v3/clients', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
  });

  if (!response.ok) {
    const err = await response.text();
    throw new Error(`Misoca API error (${response.status}): ${err}`);
  }

  const result = await response.json();
  return { client_id: result.id };
};

const fetch = require('node-fetch');

exports.handler = async (event) => {

const token = process.env.MISOCA_API_TOKEN;

const payload = {

name: event.name,

email: event.email,

phone: event.phone,

address: event.address

};

const response = await fetch('https://api.misoca.jp/v3/clients', {

method: 'POST',

headers: {

'Authorization': `Bearer ${token}`,

'Content-Type': 'application/json'

body: JSON.stringify(payload)

});

if (!response.ok) {

const err = await response.text();

throw new Error(`Misoca API error (${response.status}): ${err}`);

}

const result = await response.json();

return { client_id: result.id };

};

ポイント：GET/POST のように単純なリクエストは Webhooks が手軽です。一方、JSON 整形やエラーハンドリングを細かく制御したい場合は Code ステップを選択すると保守性が向上します。

実践：Zap 作成ステップバイステップ

この章では、実際に Zap を構築する手順を「トリガー設定」「アクション設定」「テスト・デバッグ」の 3 フェーズに分けて解説します。各フェーズの冒頭で目的と留意点を示すことで、作業漏れや設定ミスを防ぎます。

1. トリガー選定と基本設定

シナリオ例	推奨トリガー
Misoca に新規請求書が追加されたら	Webhooks by Zapier – Catch Hook（Misoca 側で webhook URL を登録）※公式サポートはなしですが、定期 GET でも代替可
HubSpot にコンタクトが追加されたら	HubSpot – New Contact

Zap の「Trigger」画面で上記いずれかを選択し、必要な認証情報（API キーや OAuth）を入力します。
「Test Trigger」を実行し、サンプルデータが取得できたことを確認してください。

2. アクション：Webhooks または Code の設定

Webhooks 設定例（請求書作成）

項目	内容
Method	POST
URL	`https://api.misoca.jp/v3/invoices`
Headers	`Authorization: Bearer {{API_TOKEN}}` `Content-Type: application/json`
Data (JSON)	`{ "client_id": "{{trigger.client_id}}", "amount": {{trigger.amount}}, "due_date": "{{trigger.due_date}}" }`

Code 設定例（取引先データ整形）

// 入力は HubSpot のコンタクト情報
const payload = {
  name: inputData.name,
  email: inputData.email,
  phone: inputData.phone,
  address: `${inputData.street}, ${inputData.city}`
};
return { payload };

// 入力は HubSpot のコンタクト情報

const payload = {

name: inputData.name,

email: inputData.email,

phone: inputData.phone,

address: `${inputData.street}, ${inputData.city}`

};

return { payload };

続くアクションで上記 payload を Webhooks の Body に流し込みます。

3. テスト実行とデバッグポイント

「Test Action」 ボタンを押し、HTTP ステータスが 200 系か確認。
エラーメッセージは Zapier のログに全文表示されるため、response.body をチェックして JSON 構造や認証エラーを特定します。
必要なら 「Filter」 ステップで条件分岐（例：金額が 10,000 円以上）を追加し、不要な API 呼び出しを抑制します。

ベストプラクティス：本番環境へ移行する前に、同一 Zap を少なくとも 10 件以上成功させてから「Enable」してください。失敗が続く場合はリトライ設定やレートリミットの確認が必要です。

具体的自動化シナリオ

以下では、業務で実際に役立つ 2 つのフローをコード例とともに提示します。どちらも「プログラミング不要」ですが、条件分岐やデータ変換が必要な場合は Code ステップを併用するとシンプルに保てます。

シナリオ①　新規請求書作成 → Slack へ PDF リンク付き通知

手順	内容
Trigger	Misoca の未払い請求書取得（定期 GET）
Action 1	Webhooks – Custom Request (`/v3/invoices/{{id}}/pdf`) で PDF URL を取得
Action 2	Slack – Send Channel Message（`新しい請求書が作成されました！PDFはこちら → {{pdf_url}}`）

このフローにより、請求書が生成された瞬間に担当者へ自動通知でき、紙ベースのやり取りを削減できます。

シナリオ②　HubSpot の新規コンタクト → Misoca 取引先へ自動登録

手順	内容
Trigger	HubSpot – New Contact
Action 1	Code by Zapier（顧客情報を Misoca 用 JSON に整形）
Action 2	Webhooks – Custom Request (`POST /v3/clients`) で取引先登録

このシナリオは CRM と請求書管理のデータ同期を実現し、二重入力によるヒューマンエラーを防止します。

ポイント：どちらのフローも「Zapier の公式サポートが無い」ことに起因する不安は、定期的なテストとログ監視で十分カバーできます。将来的に公式アプリが提供された場合は、同等機能を置き換えるだけで済みます。

運用とベストプラクティス（エラーハンドリング・セキュリティ・チェックリスト）

エラーハンドリングとリトライ設定

方法	説明
Zapier 内蔵リトライ	失敗した Webhook は最大 3 回まで自動再試行されます。
カスタムエラー	Code ステップで `throw new Error('…')` を投げると Zap が即座に「Task Failed」状態になり、Slack やメールへ通知できます。

レートリミットと対策

Misoca API のレートリミットは公式ドキュメントの 「利用制限」 ページ（https://api.misoca.jp/docs/limits）に記載されており、1 分間あたり最大 60 リクエスト と定められています。実測でも同様の上限が確認されていますので、以下の対策を推奨します。

バッチ取得：GET /v3/invoices?status=unpaid&page=1&per_page=50 のようにページングし、一度のリクエストで取得件数を最大化。
Zap 内フィルタ：条件外（例：金額が 0 円）のレコードは Filter ステップで除外し、API 呼び出し自体をスキップ。

セキュリティ：トークン管理のベストプラクティス

Zapier Secrets に API トークンを保存し、コード内では process.env.MISOCA_API_TOKEN で参照。
トークンの権限は「請求書閲覧・作成」「取引先管理」のみ付与し、不要なスコープは削除。
定期ローテーション：最低 90 日ごとに新しいトークンを生成し、旧キーは即時無効化してください。

本番移行前のチェックリスト

#	確認項目
1️⃣	API トークンが有効かつヘッダーが正しく設定されていること
2️⃣	Zap が取得したデータと Misoca の実際のレコードが一致しているか
3️⃣	PDF ダウンロード URL が有効で、受信側（Slack 等）で正常に表示できるか
4️⃣	意図的に失敗させたテストでリトライ・通知が期待通り動作するか
5️⃣	1 分間のリクエスト総数が 60 件以下に抑えられているか（レートリミット監視）
6️⃣	API キーが環境変数／Secrets に隠蔽され、外部から露出していないか

上記項目をすべてパスしたら 「Enable Zap」 を実行し、本番運用へ移行します。運用開始後は、毎週または月次で 「タスク成功率」「平均処理時間」 をモニタリングし、必要に応じてフローを最適化してください。

まとめ

Misoca API v3 は RESTful なエンドポイント群で請求書・取引先管理を外部から制御できる。
認証は Bearer トークン方式で、取得手順は UI 更新に注意しつつ公式マニュアルを参照。
Zapier の Webhook と Code ステップを組み合わせれば、公式アプリがなくてもフル機能の自動化が可能。
レートリミット（1 分 60 リクエスト）とセキュリティ対策は必ず実装し、エラーハンドリングと定期テストで信頼性を確保する。

このガイドに沿って設定すれば、請求書発行から通知・顧客データ連携までの一連の業務をシームレスに自動化でき、人的ミスや作業工数を大幅に削減できます。ぜひ実際のプロジェクトで活用し、継続的な改善サイクルを回していってください。

スポンサードリンク

バックオフィス職での転職を考えている人

スポンサードリンク

その頑張り、評価されていますか？

バックオフィスの努力が"経営の要"として評価される会社、あります

▷「業務改善を頑張るほど、なぜか報われない気がする」あなたへ

Backup Careerで無料キャリア相談を予約する

今すぐ辞める必要はありません。まず"適性診断だけ"受けて自分の市場価値を測る場所として使えます。今日の10分が、来年の働き方を変えます。

-Misoca

comment コメントをキャンセル

: Misoca

Misocaと弥生会計Nextの連携設定で業務効率化を実現

Misocaと弥生会計Nextの連携設定により、請求書作成や仕訳処理を自動化。データマッピングルールやAPI認証手順などステップバイステップで解説します。

: Misoca

Misoca無料プランでインボイス制度に完全対応する方法

Misocaの無料プランは月間請求書上限10枚で、インボイス制度に必要な情報を事前設定すれば自動的に反映され、フリーランスでもコストゼロで利用できます。

: Misoca

Misoca無料プランで請求書作成｜中小企業向け操作フローと機能比較

Misoca無料プランの登録から請求書作成までのステップ、テンプレート活用術、無料・有料プランの機能比較を解説。中小企業向け業務効率化のヒントが満載です。

: Misoca

ノーコードでShopifyとMisocaを自動連携｜Yoomによる会計業務効率化

Yoomはプログラミング知識不要でShopifyとMisocaを自動連携させ、会計業務の手間とミスを解消。中小企業向けのノーコードソリューション。

: Misoca

インボイス制度対応の準備とMisoca設定ガイド

インボイス制度対応に必要な適格請求書発行事業者番号の取得手順とMisocaでの設定方法を解説。無料プランの制限やチェックリストも詳しく紹介します。

Zendesk 2026新プランとAI自動解決機能ARの導入ポイント

Dockpitで効率的な競合分析｜中小企業向けガイド

Misoca APIとZapierで請求書自動化する方法

Misoca API（v3）とは？概要と主要エンドポイント

主要エンドポイント一覧

エンドポイント利用シーンとサンプルレスポンス

API 認証とリクエスト設定

API トークン取得手順（2026 年 4 月リニューアル版）

認証ヘッダーの書き方

cURL で請求書一覧を取得する例

JavaScript（Node.js）で同等リクエストを実行（Zapier の Code ステップ用）

Zapier と Misoca をつなげる方法（Webhooks & Code）

Webhooks by Zapier の基本設定

Code by Zapier（JavaScript）で柔軟に API 呼び出し

実践：Zap 作成ステップバイステップ

1. トリガー選定と基本設定

2. アクション：Webhooks または Code の設定

Webhooks 設定例（請求書作成）

Code 設定例（取引先データ整形）

3. テスト実行とデバッグポイント

具体的自動化シナリオ

シナリオ① 新規請求書作成 → Slack へ PDF リンク付き通知

シナリオ② HubSpot の新規コンタクト → Misoca 取引先へ自動登録

運用とベストプラクティス（エラーハンドリング・セキュリティ・チェックリスト）

エラーハンドリングとリトライ設定

レートリミットと対策

セキュリティ：トークン管理のベストプラクティス

本番移行前のチェックリスト

まとめ

シナリオ①　新規請求書作成 → Slack へ PDF リンク付き通知

シナリオ②　HubSpot の新規コンタクト → Misoca 取引先へ自動登録