Sansanとkintoneの連携の概要
概要
「Sansanに登録した名刺情報」および「kintoneに手動登録した会社情報」は、外部サーバーを介してkintoneへ30分に一度自動連携されます。
自動連携の周期
毎時0分と30分にSansan Data Hubとの自動連携処理を実行します。
連携フローの種類
| フロー名 | 内容 |
| 名刺連携取得フロー | 前回の自動連携以降、処理時点までに発生した名刺情報の変更を取得します。 |
| 名刺連携反映フロー(会社) | 会社情報をkintoneに追加します。 ※レコード追加時に「SansanDataHub→kintoneフラグ」を「レ」にします。 |
| 名刺連携反映フロー(拠点) | 拠点情報をkintoneに追加・更新します。(拠点情報を使用している場合のみ) |
| 名刺連携反映フロー(人物) |
人物情報をkintoneに追加・更新します。(人物情報を使用している場合のみ) ※Sansanに「名刺交換日」の値が登録されていない場合、およびkintoneレコードよりも名刺交換日が古い場合は更新しません。(参照:名刺交換日による人物情報レコードの更新ルール) |
| リッチ情報付与フロー |
36分前以降、処理時点までに発生した会社情報の変更を取得して、会社情報(リッチ情報を含む)を更新します。 |
| 未リッチ情報連携フロー | 会社情報(リッチ情報を含む)を付与・更新するために、対象のkintoneレコード情報をSansanDataHubに登録(インポート)します。登録後、「リッチ情報付与フロー」により会社情報(リッチ情報を含む)が更新されます。 ※登録時に「kintone→SansanDataHubフラグ」を「レ」にします。 ※登録の条件は下記「未リッチ情報連携フローによりSansanDataHubに登録されるレコードの条件」参照 |
連携データの流れ

①名刺がSansanに登録されると、「Sansan Data Hub」を経由して、会社情報・拠点情報・人物情報がkintoneに連携されます。
拠点情報と人物情報は名刺情報によりkintoneレコードの追加・更新が行われます。
| プラグインの処理フロー | 内容 | |
| ① | 名刺がSansanに登録されると、「Sansan Data Hub」に名刺データが転送されます。 | |
| ② | 名刺連携取得フロー | 名刺連携取得フローが実行され、Sansan Data Hubから名刺単位の変更情報を取得します。(30分に1回) |
| ③ | 名刺連携反映フロー(会社/拠点/人物) | 名刺連携取得フローで名刺単位の変更情報が取得できた場合、名刺連携取得フローの週雨量直後に名刺連携反映フロー(会社/拠点/人物)が実行され、kintoneのレコードを追加・更新します。 ・拠点/人物情報を作成および更新(キー項目は拠点:SLC、人物:SOC/CI人物ID) ・会社情報を作成(キー項目はSOC) |
| ④ | 未リッチ情報連携フロー | リッチ情報が付与されていない会社情報をSansan Data Hubに取り込みます。kintoneレコードIDが主キーとなります。(30分に1回) |
| ⑤ | Sansan側でSansan Data Hubにあるデータのリッチ化が行われます。 | |
| ⑥ | リッチ情報付与フロー |
Sansan Data Hubがリッチ化した会社の情報をkintone会社情報に付与します。kintoneレコードIDが主キーとなります。 |
名刺交換日による人物情報レコードの更新ルール
| Sansanの名刺交換日が未登録 | Sansanの名刺交換日が登録済 | |
| 名刺交換日フィールドを 追加していない場合 (プラグインver1.1.6の対応をしていない場合) |
更新する | 更新する |
| kintone人物情報レコードの名刺交換日がブランク | 更新しない | 更新する |
| kintone人物情報レコードの名刺交換日が入っている | 更新しない | Sansanの名刺交換日が同じか新しい場合に更新する |
未リッチ情報連携フローによりSansanDataHubに登録されるレコードの条件
未リッチ情報連携フローによりSansanDataHubに登録されるレコードの条件は、下記の(1)および(2)です。
(1)名刺連携で作成された会社レコード
「SansanDataHub→kintoneフラグ」が「レ」かつ
「Sansan組織情報のSansan組織名」に値が入っている かつ
「kintone→SansanDataHubフラグ」に値が入っていない
(2)ユーザーが登録した会社レコード
「SansanDataHub→kintoneフラグ」に値が入っていない
「Sansan登録用_会社名」に値が入っている かつ
「kintone→SansanDataHubフラグ」に値が入っていない