本文へスキップ
hdknr blog

Misoca

弥生のクラウド請求書サービス。Misoca API v3 では OAuth2 で請求書・見積書・納品書・取引先・品目を操作できる。弥生で公開されている外部 API は調べた範囲で Misoca のみ

概要

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 日に提供終了

リソースと設計の癖

認証の流れ

  1. https://app.misoca.jp/oauth2/applications でアプリ名とコールバック URL を登録し、アプリケーション ID とシークレットを得る
  2. /oauth2/authorize で認可、/oauth2/token でトークン取得
  3. Authorization ヘッダーにトークンを載せて呼ぶ(書式は明記されておらず、一般的な Bearer 形式で試す)。疎通確認は GET /user/me が手堅い

アクセストークンの有効期限は 1 日(2019 年 6 月に 90 日から短縮)。夜間バッチは毎回リフレッシュする前提で作る。

ページングと差分同期

使う前の制約

ドキュメントは「現状有姿」での提供、予告なしの仕様変更あり、サポートなし、損害について弥生は責任を負わない、と明記している。レート制限の記載もない。基幹に組み込むなら、リトライとバックオフ、レスポンスのスキーマ検証、Swagger JSON の定期的な差分取得などを自前で入れる。

freee との比較

観点freee弥生
会計 APIfreee会計 API で取引・振替伝票を登録できる公開 API は見当たらない
請求書 APIfreee請求書 APIMisoca API v3
アクセストークン6 時間(リフレッシュトークン 90 日)1 日(リフレッシュトークンの期限は記載なし)
サポートリファレンス・チュートリアル・リリースノートあり現状有姿・サポートなし

弥生会計へのデータ投入は、口座連携(金融機関 1,100 件以上)、スマート取引取込(ScanSnap Cloud や POS レジアプリ等)、CSV 取込で行い、自社システムから仕訳を直接書き込む公開経路はない。基幹から会計まで API で自動化したいなら freee が向く。

関連ページ

ソース記事