概要
Misoca(ミソカ)は、弥生株式会社が提供するクラウド請求書サービス。外部 API の仕様が doc.misoca.jp で公開されており、販売管理システムや CRM から請求書・見積書・納品書を自動で起こす用途に使える。
弥生会計そのものには外部開発者向けの公開 API が見当たらないため、弥生を使う場合に API で自動化できるのは請求(Misoca)までというのが実務上の線になる。
詳細
Misoca API v3 の基本
| 項目 | 内容 |
|---|---|
| 現行バージョン | v3(2016 年 12 月 1 日公開。2024 年 1 月に納品書・品目 API を追加) |
| エンドポイント | https://app.misoca.jp/api/v3/ |
| 認証 | OAuth2 認可コードフロー(スコープ read / write、write は read を含む) |
| 仕様書 | Swagger 2.0(/api/v3/swagger_doc) |
| 旧版 | v1 は 2021 年 4 月 1 日に提供終了 |
リソースと設計の癖
- 請求書・見積書・納品書・取引先(
contact_group)・送り先(contact)・品目(dealing_item)・ユーザー(/user/me)を扱える - 一覧は複数形(
/invoices)、1 件の取得・作成は単数形(/invoice/{id})。Rails 系でよく見る/invoices/{id}と違うので間違えやすい - 支払済み・送付済み・ゴミ箱などの状態はサブリソースへの
PUT(オン)とDELETE(オフ)の組で切り替える(例:PUT /invoice/{id}/paid)。本体をDELETEで消すのではなくフラグを立て倒しする設計 - PDF 取得に加え、請求書の郵送(
send_by_postal_mail)や見積書のメール送付(distribute)も API で指示できる
認証の流れ
https://app.misoca.jp/oauth2/applicationsでアプリ名とコールバック URL を登録し、アプリケーション ID とシークレットを得る/oauth2/authorizeで認可、/oauth2/tokenでトークン取得Authorizationヘッダーにトークンを載せて呼ぶ(書式は明記されておらず、一般的なBearer形式で試す)。疎通確認はGET /user/meが手堅い
アクセストークンの有効期限は 1 日(2019 年 6 月に 90 日から短縮)。夜間バッチは毎回リフレッシュする前提で作る。
ページングと差分同期
page(既定 1)とper_page(既定 25、最大 100)。次・最後のページはLinkヘッダーのrel="next"/rel="last"に入るので、全件取得はこれをたどるGET /invoicesは請求日・支払期限・更新日の範囲、payment_status、invoice_status、contact_group_idで絞り込めるupdated_at_fromで差分同期が書けるが日付単位なので、同じ請求書を再取得しうる。ID で重複除去を入れる
使う前の制約
ドキュメントは「現状有姿」での提供、予告なしの仕様変更あり、サポートなし、損害について弥生は責任を負わない、と明記している。レート制限の記載もない。基幹に組み込むなら、リトライとバックオフ、レスポンスのスキーマ検証、Swagger JSON の定期的な差分取得などを自前で入れる。
freee との比較
| 観点 | freee | 弥生 |
|---|---|---|
| 会計 API | freee会計 API で取引・振替伝票を登録できる | 公開 API は見当たらない |
| 請求書 API | freee請求書 API | Misoca API v3 |
| アクセストークン | 6 時間(リフレッシュトークン 90 日) | 1 日(リフレッシュトークンの期限は記載なし) |
| サポート | リファレンス・チュートリアル・リリースノートあり | 現状有姿・サポートなし |
弥生会計へのデータ投入は、口座連携(金融機関 1,100 件以上)、スマート取引取込(ScanSnap Cloud や POS レジアプリ等)、CSV 取込で行い、自社システムから仕訳を直接書き込む公開経路はない。基幹から会計まで API で自動化したいなら freee が向く。
関連ページ
- JWT Bearer Grant — OAuth のトークン発行方式の一つ
- Google API の OAuth 設定 — OAuth 必須の API で refresh_token の失効に対処する例
ソース記事
- 弥生の Misoca API v3 を読む — OAuth2 で請求書・見積書・納品書を操作する — 2026-11-06