Service Provider — Claims Player
Audience: Garages, clinics, contractors, repair shops, service businesses. Role: Service performer, evidence provider, payment recipient. Substrate: truth_node:person / truth_node:organization (provider), integration_entity (provider mirror), sourcing bus, escrow disbursement.
1. Role in Claims Processing
Service providers perform the work that resolves claims — garage repairs, medical treatment, contractor defect rectification. Providers are sourced through the sourcing bus (qualified, nearest, certified), perform work, upload evidence, and receive payment via escrow release against verified proof.
| Function | Canonical Primitive | Example |
|---|---|---|
| Provider registration | truth_node:organization | Garage, clinic, contractor business |
| Capability attestation | APF role + capability | motor_body_repair, medical_adjudication, construction_repair |
| Work evidence | claim metadata + MinIO | Completion photo, parts used, labor hours |
| Payment receipt | fn::escrow::disburse | Payment released against verified proof |
2. Capabilities & Attestations
| Capability | Required For | Attestation Source |
|---|---|---|
motor_body_repair | Garage role (motor claims) | Garage certification + licensing |
glass_repair | Garage role (auto glass) | Glass repair certification |
paint_work | Garage role (auto body) | Paint certification |
service_rendered | Provider role (medical claims) | Clinical licence |
dispensing | Provider role (pharmacy claims) | Pharmacy licence |
clinical_documentation | Provider role (medical claims) | Medical records certification |
defect_rectification | Contractor role (construction) | Contractor licence |
construction_repair | Contractor role (construction) | Construction certification |
All capabilities require: approved affiliation + active status + attestation. Lease TTLs: one hour for operational roles.
3. Sourcing Eligibility — Provider
Providers are sourced through the sourcing bus (platform.criteria.v1.sourcing.requirement). The sourcing plane qualifies candidates against declared criteria (TGC) and solves the assignment (solver-gateway branch_and_bound 1.4.0).
| Criterion | Description |
|---|---|
| Qualification | Provider must hold required capability attestation |
| Location | Nearest qualified provider to claim location |
| Availability | Provider must have capacity for the claim |
| Cost | Solver optimizes for least cost among qualified candidates |
| Attestation | Provider must have active attestation for the capability |
Unqualified providers are never shortlisted even if nearer or cheaper. Infeasibility returns a terminal fill_infeasible verdict — no fake match.
4. Evidence Requirements — Provider
| Claim Type | Provider Evidence | Format |
|---|---|---|
| Motor Claim | Repair completion photo, parts used, labor hours, warranty | MinIO + claim metadata |
| Home Claim | Repair completion, materials, contractor licence | MinIO + claim metadata |
| Medical Claim | Service rendered, clinical notes (PHI-scrubbed), diagnosis codes | MinIO (encrypted) + hash reference |
| Pharmacy Claim | Drug dispensed, quantity, prescriber, pharmacy NABP | Pharmacy system + claim metadata |
| Construction | Rectification evidence, contractor fix, inspector sign-off | Building inspection + completion photo |
Providers cannot approve their own close (separation of duties). Missing sorting or arrival checks are refused rather than guessed.
5. Payment Flow — Provider
- Provider assigned via sourcing bus (qualified, nearest, certified).
- Quote approved by claim approver (adjuster, property manager, etc.).
- Work performed — provider completes service, uploads evidence.
- Inspector verifies — completion evidence reviewed, sign-off recorded.
- Escrow holds payment —
fn::escrow::holdagainst verified proof. - Escrow releases —
fn::escrow::disburseagainst inspector sign-off. - Payment recorded — PoCE receipt sealed: provider → inspector → payment chain.
Guard check: Escrow releases only against verified proof. Provider cannot self-approve. No cash handling by playbooks — mobile-money or bank transfer where money moves.
6. Worked Example — Garage Motor Repair
- Motor claim filed — vehicle accident, photos, police report.
- Garage sourced via sourcing bus — three qualified garages offer, solver binds the pair covering the repair at least cost.
- Quote approved — adjuster approves garage quote within estimate band.
- Repair performed — garage fixes vehicle, uploads completion photo + parts invoice.
- Inspector verifies — inspector re-visits, signs off on repair quality.
- Payment released — escrow disburses to garage against verified proof.
- Claim finalized — PoCE receipt: broker → adjuster → garage → inspector → payment chain.
Guard check: Adjuster ≠ Garage. No payment without completion photo + arrival point + inspector sign-off.
7. What We Do Not Build
- No provider-specific tables. All provider data maps to
truth_node/integration_entity/ sourcing candidates. - No pricing engine. Repair estimates are external; Sovereign OS mirrors estimate references.
- No synthetic "optimal" provider. Solver down →
fill_infeasibleverdict; no fake match.