【Zoho CRM】カスタム関数:郵便番号を元に住所情報を更新する

【Zoho CRM】カスタム関数:郵便番号を元に住所情報を更新する

対象タブは見込み客、連絡先、取引先の3つでございますが、
各タブでカスタム関数が所々異なっております。ご了承ください。

見込み客編
引数
recordID =  「見込み客」の「見込み客のID」
zipCode =  「見込み客」の「郵便番号」

関数の内容
zipRes = getUrl(" http://zipcloud.ibsnet.co.jp/api/search?zipcode= " + input.zipCode);
prefecture = zipRes.executeXPath("/root/results/address1/text()");
city = zipRes.executeXPath("/root/results/address2/text()");
street = zipRes.executeXPath("/root/results/address3/text()");
mp=map();
mp.put("State",prefecture);
mp.put("City",city);
mp.put("Street",street);
resp = zoho.crm.updateRecord("Leads",recordID,mp); 

上記の関数をワークフローで呼び出すように設定してください。

オススメのワークフローの設定
実行するタイミング:追加/編集 もしくは 項目更新(「郵便番号」)
条件:「郵便番号」「が空でない」

連絡先編
引数
recordID =  「連絡先」の「連絡先のID」
zipCode =  「連絡先」の「郵便番号」

関数の内容
zipRes = getUrl(" http://zipcloud.ibsnet.co.jp/api/search?zipcode= " + zipCode);
prefecture = zipRes.executeXPath("/root/results/address1/text()");
city = zipRes.executeXPath("/root/results/address2/text()");
street = zipRes.executeXPath("/root/results/address3/text()");
mp = Map();
mp.put("Mailing_State",prefecture);
mp.put("Mailing_City",city);
mp.put("Mailing_Street",street);
resp = zoho.crm.updateRecord("Contacts",recordID,mp);

上記の関数をワークフローで呼び出すように設定してください。

オススメのワークフローの設定
実行するタイミング:追加/編集  もしくは 項目更新(「郵便番号」)
条件:「郵便番号」「が空でない」

取引先編
引数
recordID =  「取引先」の「取引先のID」
zipCodeShipping =  「取引先」の「郵便番号(納品先)」
zipCodeBilling =  「取引先」の「郵便番号(請求先)」

関数の内容
zipRes1 = getUrl(" http://zipcloud.ibsnet.co.jp/api/search?zipcode= " + zipCodeShipping);
prefecture = zipRes1.executeXPath("/root/results/address1/text()");
city = zipRes1.executeXPath("/root/results/address2/text()");
street = zipRes1.executeXPath("/root/results/address3/text()");
mp = Map();
mp.put("Shipping_State",prefecture);
mp.put("Shipping_City",city);
mp.put("Shipping_Street",street);
zipRes2 = getUrl(" http://zipcloud.ibsnet.co.jp/api/search?zipcode= " + zipCodeBilling);
prefecture = zipRes2.executeXPath("/root/results/address1/text()");
city = zipRes2.executeXPath("/root/results/address2/text()");
street = zipRes2.executeXPath("/root/results/address3/text()");
mp.put("Billing_State",prefecture);
mp.put("Billing_City",city);
mp.put("Billing_Street",street);
resp = zoho.crm.updateRecord("Accounts",recordID,mp);

上記の関数をワークフローで呼び出すように設定してください。

オススメのワークフローの設定
実行するタイミング:
 追加/編集  もしくは 項目更新(「郵便番号(納品先)」、「郵便番号(請求先)」のいずれか)

条件:
 (1)「郵便番号(納品先)」「が空でない」
  または
 (2)「郵便番号(請求先)」「が空でない」


今回用いたAPIについて

郵便番号から住所情報を取得するために外部のAPIを使用しています。
同様のAPIは複数ありますが、上記のサンプルでは以下のサイトのAPIを利用しています。
こちらのAPIについての動作を保証することはできかねますのでご了承ください。
また、ご利用になる場合は、APIの利用規約等にしたがってください。

参考情報



      • Related Articles

      • 【Zoho CRM】カスタム関数の作成

        カスタム関数はエンタープライズプランの機能です。 [設定] > [自動化] > [アクション] > [カスタム関数]に移動してください。 表示された画面で「自分で作成する」をクリックしてください。 カスタム関数の作成画が表示されます。 カスタム関数についての詳細は以下をご参照ください。 https://www.zoho.com/jp/crm/help/automation/custom-functions-programming-dre.html
      • 【Zoho CRM】カスタム関数:1年分の商談の金額を月別に分割して計上する

        サンプルの設定内容は以下です。 タブ 商談 引数 Deal_Name=  商談.商談名 accountID =  商談.取引先のID Closing_Date=  商談.完了予定日 amount =  商談.総額 stage =  商談.ステージ 関数の内容 //登録用のマップ m=map(); //繰り返し処理用のリスト monthIndex={0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11}; //月あたりの金額 monthlyAmount=(amount  / ...
      • 【Zoho CRM】複数のレコードに対してカスタム関数を実行したい

        Q. データの一覧から、複数のデータを選択してカスタム関数をボタンから実行したいです。 このとき、関数にデータのIDを引数として渡しますが、各データのIDはどう扱うべきでしょうか? A. 複数のデータを選択してカスタム関数を実行する場合、 引数として渡されるデータのIDは、「|||」で 繋ぐ形で 下記のように、一つの文字列で扱われます。 1000000001|||1000000002|||1000000003|||1000000004 ...
      • 【Zoho CRM】Call Intelligence(コール・インテリジェンス)の情報をZoho CRMへ連携する

        概要 「Call Intelligence(以下コール・インテリジェンス)」とZoho CRMを連携させる方法です。Call Intelligence(コール・インテリジェンス)の通話情報をZoho CRMのスケジュール処理で定期的に取り込み、キャンペーン、見込み客/連絡先、商談と関連付けます。 コール・インテリジェンスとは? 楽天コミュニケーションズ株式会社が提供する電話の効果測定ツールです。電話でお問い合わせの受付をする広告施策や広告価値の見える化が可能です。 設定 Zoho ...
      • 【Zoho CRM】Sansanの名刺データを取得して見込み客データを更新する

        引数 SansanAPIKey = カスタム値(SansanのAPIキー) leadID =  「見込み客」の「見込み客のID」 email = 「見込み客」の「メール」 関数の内容 //認証用ヘッダー h={ "X-Sansan-Api-Key" : input.SansanAPIKey }; //リクエストURL u="https://api.sansan.com/v2.7/bizCards/search"; //範囲(me|all) range="all"; //パラメーターのエンコード ...

      Zoho Community

      Zoho ユーザーが集うオンラインフォーラムでは、サービスの使いこなしに関する活発な議論や情報交換が行われています。