マネーフォワード クラウド請求書API スタートアップガイド

このガイドでは、「マネーフォワード クラウド請求書API v3」を利用する流れについてご説明します。
APIのご利用にあたっては、あらかじめ「マネーフォワード クラウド請求書APIについて」をご確認ください。
マネーフォワード クラウド請求書APIについて

対象ページ

API連携（開発者向け）

対象のお客さま

マネーフォワード クラウド請求書をご利用中のお客さま

目次

• 利用の流れ
• お問い合わせ

利用の流れ

この項では、「請求書の作成」を例にAPIの利用方法を説明します。

1.アプリケーションの作成

はじめに、マネーフォワード クラウドの「アプリポータル」でAPIを利用するアプリケーションを作成します。

1. 「API連携（開発者向け）」画面で「APIの利用を開始する」ボタンをクリックします。
   
2. マネーフォワード クラウドの「アプリポータル」に切り替わります。
   画面の誘導に従ってアプリケーションを作成してください。
   アプリケーションの作成方法については、「アプリポータル」のガイドをご参照ください。
   連携用アプリを作成する

2.アクセストークンの発行

アクセストークンの発行は、マネーフォワード クラウドの「アプリポータル」で取得したアプリ情報を使用します。
詳細については、以下のスタートガイドをご参照ください。
マネーフォワード クラウド APIスタートガイド

3.請求書の作成

1. 請求書を作成するために、PartnerのAPIを使用して取引先を作成します。
   以下の例では、必須項目の取引先名のみを指定しています。

   
   curl -i -H "Authorization: Bearer [ACCESS_TOKEN]" -H "Content-Type: application/json" -d '{ "name" : "サンプル取引先" }' -X POST https://invoice.moneyforward.com/api/v3/partners

   以下のようなレスポンスが表示されるので、[PARTNER_ID]にあたる値を控えてください。

   
   HTTP/1.1 201 Created （略） {"id":"[PARTNER_ID]","code":null,"name":"サンプル取引先","name_kana":null,"name_suffix":"","memo":null,"created_at":"2015-10-23T00:00:00.000+09:00","updated_at":"2015-10-23T00:00:00.000+09:00","departments":[]}

   ※すでにAPIまたは画面から作成した取引先を利用する場合は、開発ドキュメントの取引先一覧取得APIをご利用ください。

2. 次に、取引先の部署を作成するためにリクエストを行います。

   
   curl -i -H "Authorization: Bearer [ACCESS_TOKEN]" -H "Content-Type: application/json" -d '{ "person_dept" : "サンプル部署" }' -X POST https://invoice.moneyforward.com/api/v3/partners/[PARTNER_ID]/departments

   以下のようなレスポンスが表示されるので、[DEPARTMENT_ID]にあたる値を控えてください。

   
   HTTP/1.1 201 Created （略） {"id":"[DEPARTMENT_ID]","zip":null,"tel":null,"prefecture":"東京都","address1":null,"address2":null,"person_dept":"サンプル部署","person_name":null,"person_title":null,"name":null,"email":null,"cc_emails":null,"created_at":"2015-10-23T00:00:00.000+09:00","updated_at":"2015-10-23T00:00:00.000+09:00"}

3. 適格請求書発行事業者登録番号を設定します。
   以下のようなリクエストを行ってください。

   
   curl -i -H "Authorization: BEARER [ACCESS_TOKEN]" -H "Content-Type: application/json" -d '{ "registration_code" : "[REGISTRATION_CODE]" }' -X PUT https://invoice.moneyforward.com/api/v3/office/registration_code

   [REGISTRATION_CODE]は、適格請求書発行事業者登録番号（Tから始まる数字13桁の文字列）に置き換えます。
   適格請求書発行事業者登録番号の設定は任意のため、番号の設定せずに新形式テンプレートを使用することもできます。

4. 新形式テンプレートを使用した請求書を作成します。
   以下のようなリクエストを行ってください。

   
   curl -i -H "Authorization: BEARER [ACCESS_TOKEN]" -H "Content-Type: application/json" -d '{ "department_id" : "[DEPARTMENT_ID]" , "billing_date":"2022-12-23", "sales_date":"2022-12-23" }' -X POST https://invoice.moneyforward.com/api/v3/invoice_template_billings

   これにより、以下のようなレスポンスが返ってきたら請求書の作成は成功です。
   請求書に品目を追加する場合は、BILLING_IDを控えてください。

   
   HTTP/1.1 201 Created （略） {"id":"[BILLING_ID]","pdf_url":"[PDF FILE]","operator_id":"[OPERATOR_ID]","partner_id":"[PARTNER_ID]","department_id":"[DEPARTMENT_ID]",・・・（略）}

5. 請求書に品目を追加します。
   以下のようなリクエストを行ってください。

   
   curl -i -H "Authorization: BEARER [ACCESS_TOKEN]" -H "Content-Type: application/json" -d '{ "item_id" : "[ITEM_ID]" , "delivery_date":"2022-12-23", "delivery_number":"20221223001a" }' -X POST https://invoice.moneyforward.com/api/v3/billings/[BILLING_ID]/items

   これにより、以下のようなレスポンスが返ってきたら請求書への品目の追加は成功です。

   
   HTTP/1.1 201 Created

以上で、請求書の作成が完了です。作成した請求書をダウンロードする場合は、請求書を作成した際に取得したレスポンスにある[PDF FILE]のURLを開いてください。

お問い合わせ

マネーフォワード クラウド請求書APIについては、以下のガイドをご確認ください。
マネーフォワード クラウド請求書APIについて

また、マネーフォワード クラウド請求書APIの詳細に関するお問い合わせは、メールにてご連絡ください。
※返信までは数営業日いただきます。