連携

E-Gestor ERP を接続して、顧客、商品、売上を CRM に取り込む

個人トークンで E-Gestor アカウントを接続し、顧客、仕入先、商品、サービス、売上、財務項目を、重複を作らずに CRM へ取り込みます。

E-Gestor はブラジルのクラウド ERP です。接続すると、CRM が E-Gestor アカウントを読み取り、顧客、仕入先、商品、サービス、売上、財務項目を E-Gestor のコードで結び付けたうえで、ここで最新の状態に保ちます。もう一度同期しても重複は作られず、すでにあるレコードが更新されます。

方式は BYO (「ご自身のアカウントを使う」) です。お客様自身の E-Gestor アカウントと個人トークンを利用します。当社がデータを見ることはなく、当社側の費用も発生しません。連携は何もしない状態から始まり、トークンを貼り付けて有効にするまで何も起こりません。

💡 同期は一方向で、E-Gestor から CRM へ流れます。CRM の操作が ERP に書き込まれることはありません。売上は E-Gestor の API ではそもそも編集できず (公式ドキュメントには削除して作り直すよう書かれています)、ここから ERP にレコードを作成すると帳簿が二重になってしまいます。

必要なもの

E-Gestor のアカウント。サンドボックスはなく、アカウントはそれぞれ独立しているため、本番データにつなぐ前に試したい場合は無料のテスト用アカウントを作成してください。
個人トークン。E-Gestor 内の「設定 (Configurações) → API」で生成します。
Sellio では管理者であること (設定の管理権限)。「設定 → 連携」でトークンを保存するために必要です。

手順 1: E-Gestor で個人トークンを生成する

E-Gestor にサインインし、設定 (Configurações) メニューを開きます。
API タブに移動し、個人トークンを生成します。
トークンをコピーします。長い文字列 (JWT) で、これが唯一の長期有効な認証情報です。CRM はこれを使って短命のアクセストークンを自分で発行します。

手順 2: CRM にトークンを貼り付ける

「設定 → 連携」を開き、「E-Gestor ERP」のカードを探します。
個人トークンを貼り付けて保存します。暗号化して保存され、二度と表示されません。あとで現在のトークンをそのまま使う場合は、この欄を空欄のままにしてください。
「接続をテスト」をクリックします。E-Gestor から会社情報を読み取ってアカウント名を表示するので、何かを有効にする前に正しい会社かどうかを確認できます。
「取り込む対象」で、CRM が読み取る 6 つのグループを選びます。顧客、商品、売上は最初から有効で、サービス、売掛金、買掛金は無効です。
「有効にする」をクリックします。最初の同期は次回の定期実行で走ります。すぐに実行したい場合は「今すぐ同期」を使ってください。

CRM のどこに入るか

CNPJ (14 桁) を持つ顧客は会社になり、CPF を持つ顧客は連絡先になります。仕入先または運送業者としてのみ登録されている相手は仕入先になります。顧客と仕入先の両方として登録されている場合は、顧客として取り込まれます。
商品とサービスは商品になります。サービスは商品タイプ「サービス」として区別されます。
売上は受注になり、その顧客がすでに同期済みであれば顧客に紐づきます。ステータス 10 (見積) は下書き、50 (売上) は確定、キャンセルされた売上はキャンセル済みになります。
売掛金と買掛金は、対応する顧客または仕入先のタイムライン上のメモになります。

取り込まないものと、その理由

在庫残高。CRM には入出庫の台帳を持つ独自の在庫モジュールがあり、ERP の数値をそこに書き込むと、2 つのシステムが同じ残高を主張することになります。
請求書 (NF-e と NFS-e)、仕入、価格表、支払方法、勘定科目表。E-Gestor の API では取得できますが、こちらに対応するオブジェクトがなく、コネクタのために新しく作れば製品の形を外から変えてしまいます。
E-Gestor のカスタム項目。コネクタは各リソースのドキュメント化された項目を読み取ります。
個人の CPF は連絡先オブジェクトに標準項目がないため、tax_id という名前で保存されます。レコード上で見たい場合は、連絡先にちょうどこの名前のカスタム項目を作成してください。会社と仕入先にはすでにこの項目があります。

リアルタイム更新 (webhook)

E-Gestor はレコードが変わるたびに CRM を呼び出せるので、次の定期同期を待つ必要がありません。

Sellio のカードに表示されている webhook URL をコピーします。
E-Gestor で「設定 (Configurações) → API → Webhooks」を開いてその URL を登録し、連絡先 (Contatos)、商品 (Produtos)、売上 (Vendas) のモジュールを有効にします。
Sellio に戻って、もう一度「接続をテスト」をクリックします。E-Gestor が webhook 用に生成したセキュリティトークンを取得し、暗号化して保存します。それ以降、このトークンを正しく持たない呼び出しはすべて破棄されます。

💡 webhook のユーザーモジュールと財務モジュールは、意図的に使っていません。財務のイベントはコードしか運ばず、そのコードが売掛金なのか買掛金なのかを示さないため、それをもとに動くと誤ったレコードに触れる恐れがあります。これらの項目は、各行がどのリソース由来かを把握している定期同期で取り込まれます。E-Gestor で削除されたレコードは CRM でも削除されません。こちらでチームが情報を追加していることが多いためです。

速度と上限

E-Gestor は 1 分あたり 60 リクエストまでで、1 ページあたり 50 件を返します。コネクタは意図的にその上限より手前で止まるため、大きなアカウントの初回取り込みは途中で失敗せず、数回の実行に分けて完了します。各実行は前回止まった箇所から再開し、すべてが E-Gestor のコードを基準にしているので、実行が重なっても重複ではなく更新になります。

トラブルシューティング

「E-Gestor が個人トークンを拒否しました」: ERP 側でトークンが失効したか、作り直されています。「設定 (Configurações) → API」で新しいトークンを生成し、もう一度貼り付けてください。
有効にしても何も表示されない: 目的のグループが「E-Gestor から取り込む」になっているかを確認し、日次の実行を待たずに「今すぐ同期」を使ってください。
webhook が動いていないように見える: 連絡先 (Contatos)、商品 (Produtos)、売上 (Vendas) のモジュールを有効にして E-Gestor に URL を登録したか、そして登録後に「接続をテスト」をクリックしてセキュリティトークンが一致しているかを確認してください。
数値の小数点がずれて見える: CRM は E-Gestor が送ってきたとおりに価格を小数で保存します。こちらの価格が誤っている場合は、向こうでも誤っています。

この記事をシステム内で開く →