freee会計の取引先データを取得する

freee会計から取引先データを取得する方法について

前へfreee会計の事業所データを取得する次へfreee会計の取引データを取得する

最終更新 1 か月前

freee会計の取引先データを取得する

freee会計から取引先データを取得する方法について

このレシピについて

このレシピは、を参考に記述されています。

freee会計の「取引先データ」とは

freee会計では、取引先の情報をマスタとして登録することで、取引の際に入力する摘要の管理を効率化できます。（参考：）

freee 会計API を利用することで、指定した事業所に登録された取引先データ（マスタ）の一覧を取得できます。

freee会計の「取引先データ」の構造

{
  "partners": [
    {
      "id": 1,
      "code": "code001",
      "company_id": 1,
      "name": "ABC商店",
      "update_date": "2019-12-17",
      "available": true,
      "shortcut1": "ABC",
      "shortcut2": "501",
      "org_code": 1,
      "country_code": "JP",
      "long_name": "新しい取引先正式名称",
      "name_kana": "アタラシイトリヒキサキメイショウ",
      "default_title": "御中",
      "phone": "03-1234-xxxx",
      "contact_name": "営業担当",
      "email": "[email protected]",
      "payer_walletable_id": 1,
      "transfer_fee_handling_side": "payer",
      "qualified_invoice_issuer": false,
      "invoice_registration_number": "T1000000000001",
      "address_attributes": {
        "zipcode": "000-0000",
        "prefecture_code": 4,
        "street_name1": "ＸＸ区ＹＹ１−１−１",
        "street_name2": "ビル１Ｆ"
      },
      "partner_doc_setting_attributes": {
        "sending_method": "posting"
      },
      "partner_bank_account_attributes": {
        "bank_name": "freee銀行",
        "bank_name_kana": "フリーギンコウ",
        "bank_code": "0001",
        "branch_name": "銀座支店",
        "branch_kana": "ギンザシテン",
        "branch_code": "999",
        "account_type": "ordinary",
        "account_number": "1010101",
        "account_name": "フリータロウ",
        "long_account_name": "freee太郎"
      }
    }
  ]
}

Anyflow Embedで取得する

Anyflow Embedでfreee会計の取引先データを取得する手順を紹介します。

freee会計の取引先データをスプレッドシートに一括追加するというシンプルなソリューションを作成し、取引先に含まれるデータを把握します。

1. Clickトリガーを設定する

Clickトリガーを設定します。

2. freee会計コネクタを設定する

freee会計コネクタを追加します。

3. 事業所の入力アシストを設定する

以下の通りエンドユーザー変数を作成します。

ウィザードの設定に移動します。「事業所」のエンドユーザー変数の入力方法をアシストにし、事業所一覧を取得できるようにします。

4. freee会計のカスタムアクションを設定する

ソリューションエディタに戻り、freee会計コネクタを以下の通りに設定します。

設定項目名

設定値

カスタムアクション名

取引先データを取得

HTTPメソッド

GET

リクエストパス

api/1/partners

リクエストヘッダー

※ 設定不要

リクエストタイプ

※ 設定不要

レスポンスヘッダー定義

※ 設定不要

レスポンスタイプ

json

「リクエストURLパラメータ」ではキーにcompany_idを、値にはエンドユーザー変数の「事業所」を設定します。

また、「レスポンスボディ定義」には以下の設定を行います。

{
  "partners": [
    {
      "id": 1,
      "name": "ABC商店",
      "name_kana": "アタラシイトリヒキサキメイショウ",
      "contact_name": "営業担当",
      "email": "[email protected]"
    }
  ]
}