> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steerai.autos/llms.txt
> Use this file to discover all available pages before exploring further.

# API für Schadensbewertung

> Umfassende Analyse der Schadensschwere und Reparaturkostenschätzung

## POST /v1/inspections/damage-assessment

Fortschrittliche KI-gestützte Schadensbewertung, die visuelle Inspektionsdaten mit Reparaturkosten-Datenbanken kombiniert, um genaue Schadensschweregrade und Reparaturschätzungen zu liefern.

### Anfrage

```bash theme={null}
curl -X POST "https://api.steerai.autos/v1/inspections/damage-assessment" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890abcdef",
    "inspection_id": "vis_1234567890abcdef",
    "damages": [
      {
        "damage_id": "dmg_front_bumper_001",
        "type": "scratch",
        "location": "front_bumper",
        "severity": "minor"
      },
      {
        "damage_id": "dmg_rear_door_left_002",
        "type": "dent",
        "location": "rear_door_left",
        "severity": "moderate"
      }
    ],
    "assessment_options": {
      "include_repair_timeline": true,
      "include_part_prices": true,
      "labor_rate_region": "US_CALIFORNIA",
      "currency": "USD"
    }
  }'
```

### Anfrage-Body

| Feld                                         | Typ     | Erforderlich | Beschreibung                                               |
| -------------------------------------------- | ------- | ------------ | ---------------------------------------------------------- |
| `vehicle_id`                                 | string  | Ja           | Fahrzeugkennung                                            |
| `inspection_id`                              | string  | Nein         | Zugehörige visuelle Inspektions-ID                         |
| `damages`                                    | array   | Ja           | Array der zu bewertenden Schäden                           |
| `damages[].damage_id`                        | string  | Ja           | Eindeutige Schadenskennung                                 |
| `damages[].type`                             | string  | Ja           | Schadensart                                                |
| `damages[].location`                         | string  | Ja           | Betroffenes Fahrzeugteil                                   |
| `damages[].severity`                         | string  | Nein         | Erste Schweregrad-Schätzung                                |
| `assessment_options.include_repair_timeline` | boolean | Nein         | Reparatur-Zeitabschätzungen einschließen (Standard: true)  |
| `assessment_options.include_part_prices`     | boolean | Nein         | OEM-/Aftermarket-Teilepreise einschließen (Standard: true) |
| `assessment_options.labor_rate_region`       | string  | Nein         | Region für Arbeitslöhne                                    |
| `assessment_options.currency`                | string  | Nein         | Währung für Preise (Standard: USD)                         |

### Unterstützte Regionen

| Regionscode     | Beschreibung           | Ø Arbeitslohn      |
| --------------- | ---------------------- | ------------------ |
| `US_CALIFORNIA` | Kalifornien, USA       | \$150-200/Std.     |
| `US_TEXAS`      | Texas, USA             | \$100-150/Std.     |
| `US_NORTHEAST`  | Nordosten USA          | \$125-175/Std.     |
| `US_MIDWEST`    | Mittlerer Westen USA   | \$90-140/Std.      |
| `EU_GERMANY`    | Deutschland            | €80-120/Std.       |
| `EU_UK`         | Vereinigtes Königreich | £70-100/Std.       |
| `EU_FRANCE`     | Frankreich             | €70-100/Std.       |
| `ASIA_JAPAN`    | Japan                  | ¥8.000-12.000/Std. |
| `ASIA_CHINA`    | China                  | ¥400-800/Std.      |

### Antwort

```json theme={null}
{
  "status": "success",
  "data": {
    "assessment_id": "asmt_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "inspection_id": "vis_1234567890abcdef",
    "created_at": "2024-01-15T12:00:00Z",
    "assessed_damages": [
      {
        "damage_id": "dmg_front_bumper_001",
        "type": "scratch",
        "location": "front_bumper",
        "severity": "minor",
        "severity_score": 2.5,
        "impact_assessment": {
          "structural": "none",
          "cosmetic": "minor",
          "safety": "none",
          "affects_value": true,
          "value_reduction_percentage": 1.2
        },
        "repair_options": [
          {
            "option": "paint_touch_up",
            "description": "Professional paint touch-up and blending",
            "recommended": true,
            "repair_type": "cosmetic",
            "parts_required": [
              {
                "part": "paint_materials",
                "type": "consumable",
                "oem_price": 75,
                "aftermarket_price": 50,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 1.5,
              "rate_per_hour": 150,
              "total": 225,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 75,
              "labor": 225,
              "total": 300,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 1,
              "description": "Same-day repair possible"
            }
          },
          {
            "option": "bumper_replacement",
            "description": "Complete bumper replacement and paint",
            "recommended": false,
            "repair_type": "replacement",
            "parts_required": [
              {
                "part": "front_bumper_cover",
                "part_number": "52119-12345",
                "type": "body_part",
                "oem_price": 450,
                "aftermarket_price": 250,
                "currency": "USD"
              },
              {
                "part": "paint_and_materials",
                "type": "consumable",
                "oem_price": 200,
                "aftermarket_price": 150,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 4.0,
              "rate_per_hour": 150,
              "total": 600,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 650,
              "labor": 600,
              "total": 1250,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 3,
              "description": "Includes paint curing time"
            }
          }
        ],
        "recommended_repair": {
          "option": "paint_touch_up",
          "min_cost": 250,
          "max_cost": 350,
          "estimated_cost": 300,
          "currency": "USD"
        }
      },
      {
        "damage_id": "dmg_rear_door_left_002",
        "type": "dent",
        "location": "rear_door_left",
        "severity": "moderate",
        "severity_score": 5.8,
        "impact_assessment": {
          "structural": "minor",
          "cosmetic": "moderate",
          "safety": "none",
          "affects_value": true,
          "value_reduction_percentage": 3.5
        },
        "repair_options": [
          {
            "option": "pdr_and_paint",
            "description": "Paintless dent removal with touch-up",
            "recommended": true,
            "repair_type": "pdr",
            "parts_required": [
              {
                "part": "paint_materials",
                "type": "consumable",
                "oem_price": 150,
                "aftermarket_price": 100,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 3.5,
              "rate_per_hour": 150,
              "total": 525,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 150,
              "labor": 525,
              "total": 675,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 1,
              "description": "1-day repair typical"
            }
          },
          {
            "option": "panel_replacement",
            "description": "Replace door panel and repaint",
            "recommended": false,
            "repair_type": "replacement",
            "parts_required": [
              {
                "part": "rear_door_shell",
                "part_number": "67003-98765",
                "type": "body_part",
                "oem_price": 850,
                "aftermarket_price": 500,
                "currency": "USD"
              },
              {
                "part": "paint_and_materials",
                "type": "consumable",
                "oem_price": 250,
                "aftermarket_price": 175,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 6.5,
              "rate_per_hour": 150,
              "total": 975,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 1100,
              "labor": 975,
              "total": 2075,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 5,
              "description": "Includes panel fitting and paint"
            }
          }
        ],
        "recommended_repair": {
          "option": "pdr_and_paint",
          "min_cost": 600,
          "max_cost": 800,
          "estimated_cost": 675,
          "currency": "USD"
        }
      }
    ],
    "summary": {
      "total_damages_assessed": 2,
      "overall_severity": "moderate",
      "overall_severity_score": 4.15,
      "total_value_reduction_percentage": 4.7,
      "repair_cost_summary": {
        "recommended_repairs_total": {
          "min": 850,
          "max": 1150,
          "estimated": 975,
          "currency": "USD"
        },
        "all_repairs_range": {
          "min": 850,
          "max": 3325,
          "currency": "USD"
        }
      },
      "repair_timeline": {
        "estimated_total_days": 2,
        "can_repair_simultaneously": true
      },
      "impact_on_vehicle_value": {
        "estimated_market_value": 25000,
        "value_reduction": 1175,
        "adjusted_value": 23825,
        "currency": "USD"
      }
    },
    "reports": {
      "pdf_url": "https://reports.steerai.autos/asmt_1234567890abcdef.pdf",
      "json_url": "https://api.steerai.autos/v1/inspections/damage-assessment/asmt_1234567890abcdef/report"
    }
  },
  "meta": {
    "request_id": "req_asmt_xyz123",
    "processing_time": 2.456,
    "labor_rate_used": 150,
    "currency": "USD",
    "region": "US_CALIFORNIA"
  }
}
```

### Antwortfelder

| Feld                           | Typ    | Beschreibung                                      |
| ------------------------------ | ------ | ------------------------------------------------- |
| `assessment_id`                | string | Eindeutige Bewertungskennung                      |
| `severity_score`               | float  | Numerische Schwere (0-10, 10 = Totalschaden)      |
| `impact_assessment.structural` | string | `none`, `minor`, `moderate`, `severe`, `critical` |
| `impact_assessment.cosmetic`   | string | `none`, `minor`, `moderate`, `severe`             |
| `impact_assessment.safety`     | string | `none`, `minor`, `moderate`, `severe`, `critical` |
| `value_reduction_percentage`   | float  | Prozentuale Wertminderung des Fahrzeugs           |
| `repair_options[].repair_type` | string | `cosmetic`, `pdr`, `replacement`, `structural`    |

### Schweregradbewertung

<AccordionGroup>
  <Accordion icon="1" title="Gering (0-3)">
    **Merkmale:**
    • Nur oberflächliche Schäden
    • Keine strukturellen Auswirkungen
    • Kosmetische Probleme
    • Einfache und kostengünstige Reparatur

    **Beispiele:**
    • Leichte Kratzer
    • Kleine Lackabplatzer
    • Geringe Schrammen
  </Accordion>

  <Accordion icon="2" title="Mittel (3-6)">
    **Merkmale:**
    • Sichtbare Schäden, die das Erscheinungsbild beeinträchtigen
    • Geringe strukturelle Bedenken
    • Mittlere Reparaturkomplexität
    • Spürbare Wertminderung

    **Beispiele:**
    • Dellen, die PDR erfordern
    • Tiefe Kratzer bis zur Grundierung
    • Gerissene Stoßfänger
    • Geringe Fehlstellung von Karosserieteilen
  </Accordion>

  <Accordion icon="3" title="Schwer (6-8)">
    **Merkmale:**
    • Erhebliche Schäden
    • Strukturintegrität betroffen
    • Komplexe Reparaturen erforderlich
    • Hohe Wertminderung

    **Beispiele:**
    • Beschädigte Rahmenteile
    • Mehrere Karosserieteile müssen ersetzt werden
    • Fahrwerksschäden
    • Schwere Unfallschäden
  </Accordion>

  <Accordion icon="4" title="Kritisch (8-10)">
    **Merkmale:**
    • Umfangreiche Schäden
    • Sicherheitssysteme beeinträchtigt
    • Möglicher Totalschaden
    • Reparaturkosten nähern sich dem Fahrzeugwert

    **Beispiele:**
    • Schwere Rahmenschäden
    • Airbag-Auslösung
    • Wasser-/Brandschäden
    • Mehrere Systemausfälle
  </Accordion>
</AccordionGroup>

### Reparaturtypen

| Typ                 | Beschreibung                                    | Typischer Kostenbereich | Zeitrahmen |
| ------------------- | ----------------------------------------------- | ----------------------- | ---------- |
| **Kosmetisch**      | Oberflächliche Reparaturen, Lackarbeiten        | \$100-500               | 1-2 Tage   |
| **PDR**             | Lackfreie Dellenentfernung                      | \$200-800               | 1-2 Tage   |
| **Panel-Reparatur** | Reparatur und Aufbereitung von Karosserieteilen | \$500-2000              | 2-5 Tage   |
| **Austausch**       | Teileaustausch                                  | \$800-5000+             | 3-7 Tage   |
| **Strukturell**     | Rahmen-/Strukturreparaturen                     | \$2000-15000+           | 1-4 Wochen |

### Fehlerantworten

#### 400 Bad Request

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "INVALID_DAMAGE_DATA",
    "message": "Damage location 'invalid_part' is not recognized",
    "type": "validation_error",
    "field": "damages[0].location"
  }
}
```

#### 404 Not Found

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "INSPECTION_NOT_FOUND",
    "message": "The specified inspection_id does not exist",
    "type": "not_found_error",
    "field": "inspection_id"
  }
}
```

### Referenz der Fahrzeugteile

<CardGroup cols={3}>
  <Card title="Außenkarosserie" icon="car-side">
    • front\_bumper
    • rear\_bumper
    • hood
    • roof
    • trunk\_lid
    • front\_fender\_left
    • front\_fender\_right
    • front\_door\_left
    • front\_door\_right
    • rear\_door\_left
    • rear\_door\_right
    • quarter\_panel\_left
    • quarter\_panel\_right
  </Card>

  <Card title="Glas & Beleuchtung" icon="lightbulb">
    • windshield
    • rear\_window
    • side\_window\_fl
    • side\_window\_fr
    • side\_window\_rl
    • side\_window\_rr
    • headlight\_left
    • headlight\_right
    • taillight\_left
    • taillight\_right
    • fog\_light\_left
    • fog\_light\_right
  </Card>

  <Card title="Mechanik" icon="gears">
    • engine
    • transmission
    • suspension\_fl
    • suspension\_fr
    • suspension\_rl
    • suspension\_rr
    • exhaust\_system
    • fuel\_system
    • cooling\_system
    • brake\_system
  </Card>
</CardGroup>

### Erweiterte Funktionen

<Tip>
  **Kostenoptimierung:** Fordern Sie sowohl OEM- als auch Aftermarket-Teilepreise an, um Reparaturoptionen in unterschiedlichen Preisklassen anzubieten. Aftermarket-Teile können die Kosten um 30-50% senken.
</Tip>

### Integrationsbeispiel

Kombinieren Sie visuelle Inspektion mit der Schadensbewertung:

```python theme={null}
import requests

# Step 1: Create visual inspection
visual_response = requests.post(
    "https://api.steerai.autos/v1/inspections/visual",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "vehicle_id": "veh_123",
        "images": [...]
    }
)
visual_id = visual_response.json()["data"]["inspection_id"]

# Step 2: Get detected damages
damages = visual_response.json()["data"]["results"]["damages"]

# Step 3: Assess damages with cost estimates
assessment_response = requests.post(
    "https://api.steerai.autos/v1/inspections/damage-assessment",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "vehicle_id": "veh_123",
        "inspection_id": visual_id,
        "damages": damages,
        "assessment_options": {
            "include_part_prices": True,
            "labor_rate_region": "US_CALIFORNIA"
        }
    }
)

print(f"Total repair cost: ${assessment_response.json()['data']['summary']['repair_cost_summary']['recommended_repairs_total']['estimated']}")
```

### Webhooks

```json theme={null}
{
  "event": "damage_assessment.completed",
  "timestamp": "2024-01-15T12:00:05Z",
  "data": {
    "assessment_id": "asmt_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "damages_assessed": 2,
    "overall_severity": "moderate",
    "estimated_repair_cost": 975,
    "value_reduction_percentage": 4.7,
    "report_url": "https://reports.steerai.autos/asmt_1234567890abcdef.pdf"
  }
}
```

<Warning>
  **Schätzgenauigkeit:** Reparaturkostenschätzungen basieren auf regionalen Durchschnittswerten und Teile-Datenbanken. Die tatsächlichen Kosten können je nach Werkstattsatz und Teileverfügbarkeit um ±20% variieren.
</Warning>