パートナーポータル
チャネルパートナー(紹介者、認定導入担当者、またはOEM)のワークスペースです。1つの画面に、参照専用で:ポートフォリオ(導入したテナントと、それぞれの状況)、パイプライン(ネットワークを再利用して提案した進行中の紹介案件)、未収コミッション(パートナーの明細から読み取った、まだ差し引かれていないコミッションのクレジット残高)、そしてこのオペレーションで完了したAcademyの認定資格が表示されます。パートナーはログインの紐づけ(tb_usuarioparceirocomercial)によって特定され、現在の企業のスコープ内で扱われます。
この画面にあるもの
画面そのものから読み取った内容です。画面が変われば、ここも変わります。
実行できる操作
登録配達を表示テスト今すぐ配信を試す絞り込み再送する
一覧に表示される項目
イベントエンドポイントシークレットステータス試行HTTP次の試みエラー日付バージョンURL
入力項目
EventoQual acontecimento da plataforma dispara o aviso para fora.
Endereço de destinoPara onde o aviso é enviado. Endereço errado faz o evento sumir sem erro visível.
AtivaInscrição inativa para de disparar, sem perder a configuração de destino.
まずはここから
O que esta tela responde
ここで何かが起きた瞬間に外部システムへ通知する方法です。イベントにアドレスを登録すると、プラットフォームがそのアドレスを呼び出すようになります。配信ごとの記録も残ります。
この画面について
テナントはエンドポイント(自社のURL)を登録し、Tenkaで業務イベント(契約締結、債権債務の支払い、FCAの起票)が発生するたびにHTTPで通知を受け取ります。各通知は、あなたとTenkaだけが知るシークレットを使って本文のHMAC-SHA256で署名されたPOSTです(ヘッダー X-Tenka-Signature)。あなたのシステムは署名を検証し、呼び出しがTenkaからのもので改ざんされていないことを確認します。ここでは登録(url+イベント+シークレット)の作成、有効化・無効化、配信記録の確認(保留 → 配信済み | 失敗、試行回数とバックオフ付き)ができ、テストイベントの送信や失敗した配信の再キューイングも行えます。「*」イベントはすべてを登録します。社内の課金用Webhook(Asaas)とは別物です。
操作方法
この画面が答えること
各配信は登録のシークレットで署名されます。受信側は内容を信頼する前に必ずこの署名を検証してください。検証しないと、URLを知った誰もが偽のイベントを送れてしまいます。
頼る前にテストイベントを送る
テストボタンは、事象が起きるのを待たずに、今すぐ実際のイベントをエンドポイントに送ります。URL、ファイアウォール、署名の誤りを見つける最速の方法です。最初の本物のイベントがキューで失われる前に確認できます。
固定APIとSDK
A API pública /api/v1 é congelada: nada some nem muda de tipo; mudança que quebra vai para /v2. O SDK sai do próprio contrato: /api/v1/sdk/tenka.js e /api/v1/sdk/tenka.py. O histórico de versões está no documento API-CHANGELOG da Biblioteca.
ルール
この画面が答えること
エンドポイントが停止していてもイベントは失われません。プラットフォームは間隔を空けながら再試行します。記録にはステータスと試行回数が表示されます。相手側の証明書が期限切れで連携が「止まった」ことが分かるのはそこです。
イベントログと再送
O log de eventos mostra tudo que a conta enviou, em todas as inscrições, com filtro por evento e situação. Reenviar cria uma entrega nova com o mesmo conteúdo e o cabeçalho X-Tenka-Replay-Of com o id da original, para o sistema que recebe não duplicar. Toda entrega leva X-Tenka-Event-Version com a versão do contrato.
よくある質問
この画面が答える問い
何かが起きたとき、Tenkaは自社のどのシステムに通知しているのか。そして配信は届いているのか。業務イベントごとにエンドポイント(自社のURL)を登録すると、Tenkaは本文のHMAC-SHA256で署名したPOSTを送ります(ヘッダー X-Tenka-Signature)。あなたのシステムはそれを検証し、呼び出しがここからのもので改ざんされていないことを確認します。配信記録には保留、配信済み、失敗が、試行回数とバックオフとともに表示されます。テストイベントの送信や、失敗した配信の再キューイングも可能です。* イベントはエンドポイントをすべてのイベントに登録します。
この記事は役に立ちましたか？
同じモジュール内: Integrações e extensões2
Tenka アカデミー
アカデミーを見る業種別の学習コースを、プラットフォーム内でステップごとに。