Bling ERPを接続して顧客・商品・注文・請求書を同期する

Blingアカウント(ブラジルのERP)をOAuthでCRMに接続し、顧客・商品・受注・請求書を重複なく双方向で同期します。

BlingアカウントをCRMに接続できます。接続すると、CRMはBlingから顧客(取引先担当者または取引先として)、商品、受注、請求書を取り込み、すべてBlingのIDで紐付けたまま管理します。再同期しても重複は作成されず、既存のレコードが更新されます。

このモデルはBYO(「自分のアカウントを持ち込む」)方式です。ご自身のBlingアカウントとOAuthアプリを使用し、認証情報は当社では一切把握せず、費用も発生しません。連携は最初は休止状態で、認証情報を設定して有効化するまで何も起こりません。

要件

• API v3にアクセスできるBlingアカウント。
• Bling(開発者エリア)で作成したアプリ。そこからClient IDとClient Secretを取得し、認可を行ってOAuthのリフレッシュトークンを取得します。
• Sellioでは、管理者(設定管理権限)であることが必要です。認証情報は設定 → 連携で保存します。

手順1: Blingでアプリを作成する

1. Blingでアプリ/開発者エリアを開き、API v3を使う新しいアプリを作成します。
2. アプリのClient IDとClient Secretをコピーします。
3. 自分のアカウント向けにアプリのOAuth認可を実行し、生成されたリフレッシュトークンを保持します。CRMはこのリフレッシュトークンを使って自動的にアクセスを更新します。

手順2: CRMに認証情報を貼り付ける

1. 設定 → 連携を開き、「Bling ERP」カードを探します。
2. Client ID、Client Secret、リフレッシュトークンを貼り付けます。認証情報は暗号化して保存され、二度と表示されません。
3. 「エンティティと方向」で、顧客・商品・注文・請求書についてそれぞれ、Blingから取り込む・Blingへ送る・双方向・同期しない、のいずれかを選択します。
4. 「接続を保存」、続けて「有効化」をクリックします。

手順3: 同期して更新を受け取る

1. 「今すぐ同期」をクリックすると、Blingからのデータをすぐに取り込みます。自動同期も毎日実行されます。
2. 変更をほぼリアルタイムで受け取るには、Blingの通知(webhook)をカードに表示されているURLに設定します。URLにはシークレットトークンが含まれているため、非公開にしてください。
3. このWebhookはCRMにレコードを書き込む(取引先担当者、注文、請求書)ため、カードの「Webhookシークレット」を入力し、Bling側でも同じ値を使うことを強く推奨します。シークレットがあれば、署名(HMAC)によりすべての呼び出しの正当性が保証されます。

個人の顧客は取引先担当者、法人は取引先になります。各商品は商品、各受注は受注(顧客に紐付け)、各請求書は番号・金額・DANFEリンク付きのアクティビティになります。

セキュリティとプライバシー

Client Secretとリフレッシュトークンは暗号化して保存され、表示されることはありません。アクセストークンは期限切れ時に再認可なしで自動更新されます。連携は設定・有効化するまで休止状態です。

テスト方法

1. 保存して有効化した後、「今すぐ同期」をクリックし、確認メッセージを待ちます。
2. 取引先担当者、商品、受注のリストを開き、Blingのレコードが表示されていることを確認します。
3. カードの「エンティティごとのリンク数」がデータ同期に伴って増えていくことを確認します。

トラブルシューティング

• 何も同期されない: 連携が「有効」になっていること、少なくとも1つのエンティティが「Blingから取り込む」または「双方向」に設定されていることを確認してください。
• 同期時に認証情報のエラーが出る: Client ID、Client Secret、リフレッシュトークンを入力し直してください(Secretとトークンはサーバーから取得できないため、全体を貼り付け直す必要があります)。
• レコードが表示されない: アカウントに取引先担当者・取引先・商品・受注のオブジェクトが存在することを確認してください(これらは標準オブジェクトです)。
• Webhookが届かない: Blingに登録したURLがカードに表示されているものと一致していること、Webhookシークレットを使用している場合は両側で同じ値になっていることを確認してください。

Open this article inside the system →