Insurance Broker System — Host-to-Host Integration

Purpose of Host-to-Host

Automate the end‑to‑end placement lifecycle: market selection → submission → quotes → comparison → order to bind.
Exchange bound policy data, endorsements, renewal terms, and e‑documents with carriers in real time.
Streamline client‑money operations: invoicing, closings, commissions, taxes, and settlements with finance systems.

Core Data Objects

Client & Risk: corporate/retail details, locations, assets, exposures, loss history
Market: carrier/MGA codes, appetite, capacities, contacts, callback URLs
Submission: line of business, slip/schedule, questionnaires, attachments
Quote: terms, coverages, limits, deductibles, subjectivities, warranties, premium & taxes
Placement: order to bind, binder IDs, policy numbers, inception/expiry
Endorsement: type (add, delete, amend), premium delta, effective date
Renewal: expiring policy, marketing round, carried terms, NCD/loyalty
Finance: invoices, client money, closings, commission %, brokerage, fees, receipts
Documents: quote schedules, policy, endorsement, CoC, SoA
Claims: notifications, reserves, settlement updates, recoveries
Events: submissionSent, quoteReceived, orderBound, endorsementIssued, invoiceRaised, closingSettled

Example API Endpoints

POST /submissions
Create market submission with risk data & attachments

POST /markets/{carrierId}/quote-requests
Send quote request to a carrier/MGA

GET /quotes/{submissionId}
Retrieve quotes for comparison

POST /orders/bind
Issue order to bind; receive binder/policy numbers

POST /endorsements
Request an endorsement; track premium delta

POST /renewals/initiate
Start renewal with expiring policy & remarketing

POST /finance/invoices
Raise client invoice (premium, taxes, fees)

POST /finance/closings
Generate closing to carrier with commission

POST /payments/notify
Bank/PG callback for receipts & settlements

POST /documents/upload
Exchange e‑docs (policy, endorsements, SoA)

POST /claims/notify
Notify carriers of claims; sync reserves & settlements

POST /callbacks/status
Asynchronous updates from carriers to broker

Sample Order to Bind

POST /orders/bind
{
  "submissionId": "SUB-2025-04521",
  "market": {"carrierId":"CRR-AXA", "quoteId":"Q-AXA-88921"},
  "inception":"2025-09-01",
  "expiry":"2026-08-31",
  "commissionPct": 20.0,
  "billing":{"clientMoney": true, "taxPct": 1.0}
}
-- RESPONSE --
{"binderId":"BND-77610","policyNo":"POL-AXA-2025-009912"}

Reference Flows

New Business Placement

Broker creates /submissions with slip & attachments
Send /quote-requests to selected markets
Collect quotes → compare → /orders/bind → policy/e‑docs received

Endorsement

Client change → /endorsements request
Carrier returns premium delta & e‑doc
Broker raises adjustment invoice/closing

Renewal Marketing

Start /renewals/initiate with expiring policy
Remarket to carriers; capture carried/adjusted terms
Bind & deliver policy pack to client

Finance & Closings

Invoice client → receive payment (/payments/notify)
Generate carrier closing (net of commission)
Reconcile receipts vs closings; export to GL

Claims Notification

Broker posts /claims/notify to carriers
Reserves & settlements synced to client portal
Recovery updates shared to finance/DW

Security & Controls

mTLS, OAuth2/JWT; IP allow‑list; JWS signatures; short‑TTL tokens.
Client‑money segregation; trust account mapping; maker‑checker for finance.
PII protection; document hashing; access logs for e‑docs.
Idempotency keys and replay protection for submissions & payments.

Monitoring & Audit

Placement cycle time; quote turnaround; hit/bind rate by market.
Outstanding closings; unmatched receipts; commission variance.
Complete audit trail for submissions, quotes, endorsements, and documents.

What You Get

OpenAPI + Postman collection and mock carrier endpoints.
Slip & schedule templates; quote comparison widgets.
Finance mapping (invoices, closings, commissions, taxes) to GL/ERP.
Client portal components for policy packs, invoices, and claims status.
Annual maintenance incl. change requests; on‑prem or cloud.