Tネット API連携 — ジム様がTネットへ連絡するための文案

まるごとほけん損害保険更新システム向け · 2通セット（依頼文＋ Tネット送付文）

使い方
① まず「ジム様への依頼メール」を送る
② ジム様には「Tネット宛メール」をそのままコピーして送ってもらう（または転送）
③ Tネットから仕様が返ったら、こちらで2〜3週間以内に接続テスト完了可能

①ジム様への依頼メール（まるごとほけん → ジム様）

件名

【お願い】TネットへのAPI連携照会のご送付について（損保更新システム）

本文

ジム様

いつもお世話になっております。まるごとほけんの〇〇です。

損害保険の年次更新を記録するシステムを開発しており、
Tネットから契約データを取り込む連携を進めております。

現在は Tネット の CSV を手動で取り込む運用ですが、
面談時に証券番号を入力するだけで契約情報が即座に表示される
API 連携を実装したいと考えております。

つきましては、お手数ですが
下記「Tネット宛メール」をそのまま（または少し修正して）
Tネットのご担当窓口へご送付いただけますでしょうか。

■ お願いしたいこと
・Tネット宛メールの送付（下記②をコピーして送信）
・可能であれば、Tネット担当者のご連絡先を共有いただけると助かります
・代理店コード・募集人コードが必要な場合は、こちらにご教示ください

■ 背景（ジム様向けメモ）
・システム側の API 受け口は実装済みです
・Tネットから「接続先URL・認証方式・JSONの項目名」が分かれば接続完了できます
・API が整うまでは、今まで通り CSV 取込で運用可能です

■ 添付推奨（お持ちであれば）
・損保更新システムの画面キャプチャ（証券番号で取込する画面）
・現在お使いの Tネット CSV のサンプル（個人情報はマスク可）

お忙しいところ大変恐れ入りますが、
更新シーズン前に接続テストまで進めたく、ご協力いただけますと幸いです。

何卒よろしくお願いいたします。

――――――――――――――――――
まるごとほけん
〇〇 〇〇
TEL: 〇〇-〇〇〇〇-〇〇〇〇
Email: 〇〇@example.com
――――――――――――――――――

────────────────────────
【以下、Tネット宛メール。ジム様よりそのまま送付ください】
────────────────────────

②Tネット宛メール（ジム様 → Tネット担当）※そのまま送付可

件名

【ご照会】代理店システムとの契約データ API 連携について（まるごとほけん）

宛先の例（ジム様記入用）

Tネットサポート窓口 / 代理店システム担当 / 東京海上日動代理店サポート等（貴社の窓口に合わせて差し替え）

取得したいデータ項目

項目	用途
証券番号	契約の特定
保険会社名	画面表示・記録PDF
契約者氏名（姓・名）	本人確認
生年月日	本人確認
住所・電話番号	変更確認
商品名・満期日	更新案内
保険料・支払方法	説明記録
ノンフリート等級	前年比較
車両保険の付帯有無	トラブル防止記録
車種・登録ナンバー	口頭確認記録
担当募集人名	監査証跡

本文（ジム様 → Tネット）

Tネット ご担当者様

いつもお世話になっております。
まるごとほけんのジムと申します。

当代理店では、損害保険の年次更新業務を支援する
社内システム（意向確認・重要事項説明の記録・署名・PDF出力）を導入しており、
Tネット に登録されている契約データとの連携を検討しております。

現在は Tネット から出力した CSV を手動で取り込んでおりますが、
更新面談の際に証券番号を入力するだけで契約情報をリアルタイムに取得できる
API 連携が可能かどうか、ご照会させていただきます。

────────────────────────
■ 1. ご照会事項
────────────────────────
(1) 代理店向けに、証券番号を指定して契約情報を1件取得する API（REST 等）は
    ご提供いただけますでしょうか。

(2) ご提供可能な場合、以下をご教示ください。
    ・API の接続先 URL（エンドポイント）
    ・認証方式（APIキー / OAuth / IPアドレス制限 等）
    ・代理店コード（募集人コード）の指定方法
    ・利用申請の手続き・審査期間
    ・テスト環境（サンドボックス）の有無

(3) 取得可能なデータ項目と、JSON のフィールド名
    （サンプルレスポンスまたは API 仕様書をご共有いただけますと幸いです）

(4) 個人情報の取り扱いに関する条件
    ・API 経由で取得したデータの保存・利用範囲
    ・第三者（システム開発ベンダー）への提供可否
    ・利用規約・利用料金

────────────────────────
■ 2. 取得したいデータ項目（最低限）
────────────────────────
証券番号をキーに、以下の項目を取得したいと考えております。

・証券番号
・保険会社名
・契約者氏名（姓・名）
・生年月日
・住所・電話番号
・商品名・満期日
・保険料・支払方法
・ノンフリート等級
・車両保険の付帯有無
・車種・登録ナンバー
・担当募集人名

────────────────────────
■ 3. 想定する利用フロー
────────────────────────
① 募集人が面談時に証券番号を入力
② Tネット API から契約データを取得し、画面に自動表示
③ 住所・電話・車両情報の変更有無を確認（変更なしの場合はワンタップ）
④ 更新意向・説明内容を記録
⑤ お客様・担当者の署名
⑥ 更新確認記録 PDF を出力・保管

※ 取得データは当代理店の更新記録・監査証跡の目的にのみ使用します。
  お客様の個人情報を第三者に提供することはありません。

────────────────────────
■ 4. システム側の技術仕様（参考）
────────────────────────
システム開発側では、以下の形式での接続を想定して実装済みです。

・方式: REST API（GET）
・エンドポイント例: GET {API_URL}/contracts/{証券番号}
・認証: Authorization: Bearer {API_KEY}
・ヘッダー（任意）: X-Agency-Code: {代理店コード}
・レスポンス形式: JSON
・タイムアウト: 15秒

正式な仕様が異なる場合は、いただいた仕様に合わせて修正いたします。

────────────────────────
■ 5. スケジュール
────────────────────────
・損保更新シーズンに向けて本番運用を予定しており、
  API 仕様が確定次第、接続テストまで約2〜3週間で完了したいと考えております。
・API 連携が整うまでは、従来どおり CSV 取込で運用を継続します。

────────────────────────
■ 6. お願い
────────────────────────
まずは以下2点をご共有いただけますと、開発を進められます。

① API の有無（または代替手段のご提案）
② サンプルレスポンス、API 仕様書、または CSV 項目定義書

お忙しいところ恐れ入りますが、
ご確認のほど何卒よろしくお願いいたします。

――――――――――――――――――
まるごとほけん
ジム ○○（ジム様：氏名をご記入ください）
代理店コード: ○○○○（わかる範囲でご記入ください）
TEL: ○○-○○○○-○○○○
Email: ○○@example.com
――――――――――――――――――

③ジム様が転送するだけの短い添え文（任意）

Tネット ご担当者様

いつもお世話になっております。まるごとほけんのジムです。

当社で導入予定の損保更新記録システムと Tネット の API 連携について
ご照会させていただきたく、下記内容をお送りします。

ご確認のほど、よろしくお願いいたします。

（↓ 上記②の本文をここに貼り付け、または②をそのまま送信）

ジム様への補足（口頭で伝える場合）

「システム側はもう API を受け取る準備ができている。Tネットの仕様が来ればすぐつなげる」
「今は CSV で回せるので急ぎではないが、更新シーズン前に繋げたい」
「個人情報は代理店内の記録用だけ。外部には出さない」
「返事が来たら開発担当（〇〇）に転送してほしい」

開発担当向け（環境変数・接続テスト）

環境変数チェックリスト

変数名	必須	説明
`TNET_API_URL`	API利用時	接続先（例: https://…/contracts）
`TNET_API_KEY`	API利用時	Bearer 認証キー
`TNET_AGENCY_CODE`	任意	代理店コード
`TNET_API_TIMEOUT_MS`	任意	タイムアウト（既定15秒）
`NEXT_PUBLIC_SUPABASE_URL`	監査保存時	未設定でも PDF は出力可

API 未設定時のフォールバック運用

事前投入 — Tネット CSV → /cie-import → Google Sheets CIE_契約
面談時その場 — 損保 Step2「CSV取込」または証券番号検索（台帳参照）

証券番号直取込: GET /api/marugoto/tnet/contracts?id=証券番号

Tネット返答後の作業手順

サンプル JSON を lib/marugoto/tnetApiMapper.ts の keys に追記
Vercel に環境変数を設定
/api/marugoto/tnet/live?policy=テスト証券番号 で接続確認
npx tsx scripts/check-marugoto-sonpo-readiness.ts で readiness 確認

送信前に〇〇・代理店コード・連絡先を差し替えてください。
Tネット返答は開発担当（〇〇@example.com）へ転送をお願いします。