MFクラウド会計API連携

この機能を利用可能なユーザー権限新しいタブで開く

マスターアカウント	管理者	責任者	リーダー	担当者	カスタム権限新しいタブで開く
○	○	○	×	×	設定次第

boardから「MFクラウド会計新しいタブで開く」へ自動的に売上・支払のデータを連携することができます。

会計連携機能では、いくつかの会計システムに対応していますが、当ヘルプはMFクラウド会計に特化して解説します。会計連携機能全体については、下記をご覧ください。

• 会計連携機能の概要
• 会計システム向けデータ出力の共通設定
• 会計データ設定の設定例

目次

1. 連携の概要
2. 連携前にMFクラウド会計側で行う設定
3. 連携を有効にする
4. 最初にboard側で行う設定
5. デフォルトでの出力内容
6. MFクラウド会計固有のデータ連携設定
7. 連携するタイミング
8. エラーおよびエラー時の再送方法

連携の概要

boardの請求・支払データをMFクラウド会計の「仕訳」に連携します。

請求データは請求ステータスが「請求済」に変更されたタイミングで、支払データは支払ステータスが「請求書受領済」に変更されたタイミングで、API経由で「売掛金」「買掛金」の仕訳が自動的に連携されます。

＊案件編集画面で登録できる「案件原価」は連携対象に含まれません。

boardでは、案件・発注を登録するメインユーザーは、日常的に勘定科目などを使っているユーザーではないと想定しているため、案件・発注に直接勘定科目などの会計用の情報を入力する仕組みにはなっていません。

しかし、MFクラウド会計の「仕訳」の登録にあたっては、勘定科目等の情報が必要になりますので、「会計システム向けデータ出力の共通設定」の定義に基づき、請求や支払のデータから仕訳のデータに変換して連携する仕組みになっています。

連携前にMFクラウド会計側で行う設定

アプリ連携権限の付与

後述の「連携を有効にする」を行うMFクラウド会計側のユーザーに対して、「アプリ連携権限」の付与が必要です。

MFクラウド会計のヘルプ「Q. 外部サービスとの連携方法を教えてください。新しいタブで開く」を参考に、対象の連携操作を行うユーザーに対して、「アプリ連携権限」のうち以下の権限を付与してください。

• 事業者情報
• クラウド会計・確定申告

【重要】上記のMFクラウド会計のヘルプのスクリーンショットでは「クラウド会計・確定申告」のみチェックが入っていますが、boardからの連携には「事業者情報」の権限も必要になりますので、必ず両方の権限を付与してください。

この設定を行っていない場合、次の「連携を有効にする」の操作の際に、権限がないためエラーになります。

連携を有効にする

連携の設定は、上メニューの「設定→外部サービス連携」で行います。

「外部サービス連携」で、「MFクラウド会計と連携」ボタンをクリックします。

MFクラウド会計の画面へ移動します。MFクラウド会計にログインしていない場合はログイン画面が出るので、ログイン後に操作を行ってください。ログインしますと、自動的に連携が許可され、boardの画面へ戻ります。

上記が完了すると連携が有効になり、以下のように表示されます。

上図の「設定」では、後述の連携内容のカスタマイズができます。

「連携履歴」では、連携した履歴や連携がエラーになった場合のエラー内容を確認できます。

最初にboard側で行う設定

会計データ設定での設定内容の確認・変更

デフォルトでは、後述の「デフォルトでの出力内容」の内容でMFクラウド会計へ連携されます。勘定科目等の各項目をデフォルトと異なる内容で連携したい場合も、会計データ設定の内容を変更してください。

デフォルトでの出力内容

デフォルトの設定では、以下の内容で連携されます。なお、会計データ設定で「勘定科目」「補助科目」「税区分」「部門」「インボイス」「計上日」「摘要」「仕訳メモ」「タグ」の連携内容を変更できますので、必要に応じて設定を変更してください。

＊複数の税率を含む場合は税率ごとに出力されるため、下記は一例です。詳しくはヘルプ「会計連携機能の概要」内の「複数税率が混在する請求」の項目をご覧ください。

案件

借方			貸方			共通
勘定科目	取引先	税区分	勘定科目	取引先	税区分	計上日	摘要
売掛金	顧客名	対象外	売上高		課税売上 10%	請求日	No.xxxx 案件名

発注

借方			貸方			共通
勘定科目	取引先	税区分	勘定科目	取引先	税区分	計上日	摘要
仕入高		課税仕入 10%	買掛金	発注先名	対象外	請求日	No.xxxx 発注名

MFクラウド会計固有のデータ連携設定

会計データ全般に関する設定のヘルプは「会計システム向けデータ出力の共通設定」をご覧ください。

以下、MFクラウド会計固有の設定に関する説明です。

連携対象

会計データ設定画面の「その他設定」タブで、「売上（案件）」「支払（発注）」を連携対象とするか設定できます。デフォルトではONになっているので、連携対象から外したい場合はOFFにしてください。

取引先自動追加

MFクラウド会計側に存在しない顧客・発注先を連携する場合、自動的にMFクラウド会計の取引先として登録するかどうかの設定です。デフォルトではONになっています。

取引先を登録する場合は、「取引先名」「適格請求書発行事業者登録番号」「法人番号」を連携しますが、MFクラウド会計側が登録番号は正規の番号のみ受け付けるため、boardの顧客・発注先登録画面で「番号チェック」が完了しているもののみが連携されます。番号チェックが未完了の場合は、「登録番号」は空欄の状態で連携されます。

なお、この項目をOFFにした場合、MFクラウド側の取引先とboard側の顧客・発注先を名称でマッチングして、一致するものがない場合は、取引先が未設定の状態で連携されますのでご注意ください。

証憑PDF添付

ONにすると、請求書PDFを仕訳の証憑として添付します。

なお、連携される請求書の押印状態は、以下の条件によって変わります。

• 請求済への変更の操作を行ったユーザーが捺印権限を有している場合は、社印が表示された状態で連携されます。
• 捺印申請が承認済の場合は、操作ユーザーにかかわらず社印が表示された状態で連携されます。
• それ以外の場合は、社印が表示されない状態で連携されます。

連携粒度

連携粒度については、ヘルプ「連携粒度の設定」をご覧ください。

MFクラウド会計の勘定科目等のデータのキャッシュ

会計データ設定画面では、勘定科目・補助科目・税区分・部門は、MFクラウド会計から取得したリストになっています。これらのデータを毎回MFクラウド会計から取得すると画面表示が遅くなる可能性があるため、一定期間キャッシュし、毎回取得しに行かないようになっています。

そのため、これらのデータをMFクラウド会計側で追加・変更・削除した場合、会計データ設定画面上のリストと相違が発生します。この場合は、下図のリンクをクリックすることで、最新のデータを取得できます。

その他、MFクラウド会計固有の注意事項

• 会計データ設定画面上では、APIでMFクラウド会計から取得した勘定科目・部門等を選択できるようになっています。そのため、MFクラウド会計APIがメンテナンス等で利用できない場合は、当画面も利用できなくなります。
• CSV連携と異なり、未実現仕訳の連携には対応していません。
• 「タグ」は、MFクラウド会計側に存在しないタグを送信した場合、自動的にMFクラウド会計側でタグが作成されます。
• 「メモ」に「board」という文字列が入りますが、これはMFクラウド会計側の仕組みにより自動的に入るもので、入らないようにすることはできません。

連携するタイミング

MFクラウド会計へのデータの連携は、「連携する」というボタンを手動でクリックしてデータを送信するような仕組みではなく、普段の業務を行っていれば自動的に連携されるよう、以下の操作をトリガーとして自動的に送信される仕組みになっています。

• 売上の連携：請求ステータスを「請求済」に変更したタイミングで自動的に連携されます。
• 費用の連携：支払ステータスを「請求書受領済」に変更したタイミングで自動的に連携されます。

なお、boardからMFクラウド会計への連携は、画面上で「請求済」に変更したタイミングで即時送信されるのではなく、画面上での操作完了後、バックグラウンドで送信されます。通常は数秒〜数十秒程度で送信されますが、処理が混み合っている場合などは、数分〜数十分程度かかる可能性があります。

連携に関する注意事項

• 当連携機能は仕訳の新規登録のみで、更新には対応していません。一度連携が完了したデータを再度「請求済」や「請求書受領済」にしても連携は行われません。また、MFクラウド会計側で仕訳を削除した場合でも、再度連携することはできませんので、その場合はMFクラウド会計側で直接登録してください。

連携履歴

MFクラウド会計へ連携した履歴は、上メニューの「設定→外部サービス連携→連携履歴」画面にて確認できます。

連携履歴に「仕訳ID」が表示されていますが、これは仕訳登録が完了した際にMFクラウド会計側で発番される一意のIDです。この仕訳IDを直接利用することはありませんが、連携の記録として表示しているものになります。

エラーおよびエラー時の再送方法

何らかの原因で連携に失敗した場合、上メニューの「設定→外部サービス連携→連携履歴」画面の送信ステータスが「エラー」と表示されています。「エラーログ」に、MFクラウド会計APIから返ってきたエラーメッセージが表示されますので、内容をご確認ください。

以下、よくあるエラーについて解説します。

エラーになった場合は、下記を参考に問題を解消した後、一度別のステータスに変更してから、再度「請求済」「請求書受領済」に戻してください。これにより、データが再送されます。

なお、以下の「エラーメッセージ」は、MFクラウド会計APIから返ってきたエラーメッセージをそのまま表示しているため、MFクラウド会計側で変更が行われた場合は文言が異なる可能性があります。この場合、当ヘルプでも差異を認識次第、更新しますが、それまでは連携履歴のエラーメッセージと以下の文言が異なっている可能性がありますので、ご注意ください。

連携履歴の「エラーメッセージ」を起点にした対応方法

エラーメッセージは多くのパターンがあるため、以下に、エラーメッセージからは対応方法がわかりにくいものについて、代表的なものをまとめました。以下にないエラーメッセージの場合は、エラーメッセージの内容をご確認ください。

エラーメッセージ	対応方法
Access token supplied is not active or it is invalid.	MFクラウド会計の連携許可が無効になっている可能性があります。上メニューの「設定→外部サービス連携」から再連携を行ってください。
指定された取引先コードは存在しません Target: trade_partner_code TargetValue: xxxxxxxx	一度連携した後、MFクラウド会計側で取引先を削除した場合に発生する可能性があります。この場合は、顧客・発注先編集画面の「MFクラウド会計取引先」で解除した上で、再送信してください。
インボイスは不正な値です。 Target: invoice_kind	「借方インボイス」「貸方インボイス」の値が正しくない可能性があります。この項目は勘定科目・税区分との組み合わせで登録可否が変わります。会計データ設定を見直してください。
[取引先]The target registration number does not exist on the National Tax Agency website. Target: invoice_registration_number TargetValue: T1234567890123	顧客・発注先に登録されている適格請求書発行事業者の登録番号が正しくない可能性があります。登録番号を修正後、再送信してください。