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

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

Alert
下記はサンプルコードです。カスタム関数のカスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。

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

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

関数の内容
targetUrl =" http://zipcloud.ibsnet.co.jp/api/search?zipcode=" + input.zipCode;
zipRes = invokeUrl
[ 
 url:targetUrl
 type: GET
];
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); 

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

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

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

関数の内容
targetUrl =" http://zipcloud.ibsnet.co.jp/api/search?zipcode=" + input.zipCode;
zipRes = invokeUrl
[ 
 url:targetUrl
 type: GET
];
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);

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

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

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

関数の内容
targetUrl1 =" http://zipcloud.ibsnet.co.jp/api/search?zipcode=" + input. zipCodeShipping;
zipRes1 = invokeUrl
[ 
 url:targetUrl1
 type: GET
];
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);
targetUrl2 =" http://zipcloud.ibsnet.co.jp/api/search?zipcode=" + input. zipCodeBilling;
zipRes2 = invokeUrl
[ 
 url:targetUrl2
 type: GET
];
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);

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

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

条件：
　（１）「郵便番号（納品先）」「が空でない」
　　または
　（２）「郵便番号（請求先）」「が空でない」


Notes
今回用いたAPIについて

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




    • Related Articles

    • 【Zoho CRM】カスタム関数：1年分の商談の金額を月別に分割して計上する

      下記はサンプルコードです。カスタム関数のカスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。 タブ 商談 引数 Deal_Name= 商談.商談名 accountID = 商談.取引先のID Closing_Date= 商談.完了予定日 amount = 商談.総額 stage = 商談.ステージ 関数の内容 //登録用のマップ m=map(); //繰り返し処理用のリスト ...

    • 【Zoho CRM】複数のレコードに対してカスタム関数を実行したい

      Q. データの一覧から、複数のデータを選択してカスタム関数をボタンから実行したいです。 このとき、関数にデータのIDを引数として渡しますが、各データのIDはどう扱うべきでしょうか？ A. 複数のデータを選択してカスタム関数を実行する場合、 引数として渡されるデータのIDは、「|||」で 繋ぐ形で 下記のように、一つの文字列で扱われます。 1000000001|||1000000002|||1000000003|||1000000004 ...

    • 【Zoho CRM】筆まめクラウド住所録に連絡先データを登録する

      下記はサンプルコードです。カスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。 引数 access_token = 筆まめアプリケーション認証で取得した「アクセストークン」（カスタム値） refresh_token = 筆まめアプリケーション認証で取得した「リフレッシュトークン」（カスタム値） group_id = 筆まめクラウド住所録の住所録ID（カスタム値） lastname = ...

    • 【Zoho CRM】Sansanの名刺データを取得して見込み客データを更新する

      下記はサンプルコードです。カスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。 引数 SansanAPIKey = カスタム値（SansanのAPIキー） leadID = 「見込み客」の「見込み客のID」 email = 「見込み客」の「メール」 関数の内容 //認証用ヘッダー h={ "X-Sansan-Api-Key" : input.SansanAPIKey }; //リクエストURL ...

    • 【Zoho CRM】商談の項目に自動的に取引先の項目を反映させることはできますか

      Q. 商談の項目に自動的に取引先の項目を反映させることはできますか？ A. ルックアップ項目の連動項目で反映可能です。 詳細は、こちらのヘルプをご確認ください。

    Zoho Community

    オンライン掲示板やユーザー交流会など、Zoho活用に役立つコンテンツが満載！


      Zoho CRM 管理者向けオンライントレーニング

      Zoho CRM 導入後の動き出しをスムーズに。初期設定から操作方法、便利機能まで… Zoho の講師がデモを交えて解説。CRM管理者の必須スキルを短期間で習得しましょう。


        ウェビナー情報はこちら！

        さまざまな企業で業務改善にあたるエキスパートたちの事例セミナーをご提供しております。最新の予定や、配信済みのウェビナー動画はこちらをご確認ください。