> ## 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 de evaluacion de danos

> Analisis de severidad de danos y estimacion de costos de reparacion

## POST /v1/inspections/damage-assessment

Evaluacion avanzada de danos con IA que combina datos de inspeccion visual con bases de costos de reparacion para entregar severidad precisa y estimaciones de reparacion.

### Request

```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"
    }
  }'
```

### Request Body

| Field                                        | Type    | Required | Description                                     |
| -------------------------------------------- | ------- | -------- | ----------------------------------------------- |
| `vehicle_id`                                 | string  | Yes      | Identificador del vehiculo                      |
| `inspection_id`                              | string  | No       | ID de inspeccion visual relacionada             |
| `damages`                                    | array   | Yes      | Arreglo de danos a evaluar                      |
| `damages[].damage_id`                        | string  | Yes      | Identificador unico de dano                     |
| `damages[].type`                             | string  | Yes      | Tipo de dano                                    |
| `damages[].location`                         | string  | Yes      | Parte del vehiculo afectada                     |
| `damages[].severity`                         | string  | No       | Severidad inicial                               |
| `assessment_options.include_repair_timeline` | boolean | No       | Incluir tiempos de reparacion (default: true)   |
| `assessment_options.include_part_prices`     | boolean | No       | Incluir precios OEM/aftermarket (default: true) |
| `assessment_options.labor_rate_region`       | string  | No       | Region geografica para tarifas                  |
| `assessment_options.currency`                | string  | No       | Moneda para precios (default: USD)              |

### Regiones soportadas

| Region Code     | Description     | Avg Labor Rate   |
| --------------- | --------------- | ---------------- |
| `US_CALIFORNIA` | California, USA | \$150-200/hr     |
| `US_TEXAS`      | Texas, USA      | \$100-150/hr     |
| `US_NORTHEAST`  | Northeast USA   | \$125-175/hr     |
| `US_MIDWEST`    | Midwest USA     | \$90-140/hr      |
| `EU_GERMANY`    | Germany         | €80-120/hr       |
| `EU_UK`         | United Kingdom  | £70-100/hr       |
| `EU_FRANCE`     | France          | €70-100/hr       |
| `ASIA_JAPAN`    | Japan           | ¥8,000-12,000/hr |
| `ASIA_CHINA`    | China           | ¥400-800/hr      |

### Response

```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"
  }
}
```

### Campos de respuesta

| Field                          | Type   | Description                                       |
| ------------------------------ | ------ | ------------------------------------------------- |
| `assessment_id`                | string | Identificador unico de evaluacion                 |
| `severity_score`               | float  | Severidad numerica (0-10, 10 = perdida total)     |
| `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  | Porcentaje de reduccion del valor                 |
| `repair_options[].repair_type` | string | `cosmetic`, `pdr`, `replacement`, `structural`    |

### Puntuacion de severidad

<AccordionGroup>
  <Accordion icon="1" title="Menor (0-3)">
    **Caracteristicas:**
    • Solo dano de superficie
    • Sin impacto estructural
    • Danos cosmeticos
    • Reparacion facil y barata

    **Ejemplos:**
    • Rayones leves
    • Pequenos chips de pintura
    • Rozaduras menores
  </Accordion>

  <Accordion icon="2" title="Moderado (3-6)">
    **Caracteristicas:**
    • Dano visible que afecta apariencia
    • Preocupacion estructural menor
    • Complejidad de reparacion moderada
    • Impacto notable en el valor

    **Ejemplos:**
    • Abolladuras que requieren PDR
    • Rayones profundos hasta el primer
    • Parachoques agrietados
    • Desalineacion menor de panel
  </Accordion>

  <Accordion icon="3" title="Severo (6-8)">
    **Caracteristicas:**
    • Dano significativo
    • Integridad estructural afectada
    • Reparaciones complejas
    • Reduccion mayor de valor

    **Ejemplos:**
    • Secciones de chasis danadas
    • Reemplazo de multiples paneles
    • Dano de suspension
    • Dano mayor por colision
  </Accordion>

  <Accordion icon="4" title="Critico (8-10)">
    **Caracteristicas:**
    • Dano extenso
    • Sistemas de seguridad comprometidos
    • Potencial perdida total
    • Costo de reparacion cercano al valor

    **Ejemplos:**
    • Dano severo de chasis
    • Despliegue de airbag
    • Dano por inundacion/incendio
    • Fallas en multiples sistemas
  </Accordion>
</AccordionGroup>

### Tipos de reparacion

| Type             | Description                           | Typical Cost Range | Timeline    |
| ---------------- | ------------------------------------- | ------------------ | ----------- |
| **Cosmetic**     | Reparaciones de superficie, pintura   | \$100-500          | 1-2 dias    |
| **PDR**          | Reparacion de abolladuras sin pintura | \$200-800          | 1-2 dias    |
| **Panel Repair** | Reparacion de paneles y repintado     | \$500-2000         | 2-5 dias    |
| **Replacement**  | Reemplazo de piezas                   | \$800-5000+        | 3-7 dias    |
| **Structural**   | Reparaciones estructurales            | \$2000-15000+      | 1-4 semanas |

### Respuestas de error

#### 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"
  }
}
```

### Referencia de partes del vehiculo

<CardGroup cols={3}>
  <Card title="Paneles exteriores" 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="Vidrios y luces" 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="Mecanico" icon="gears">
    • engine
    • transmission
    • suspension\_fl
    • suspension\_fr
    • suspension\_rl
    • suspension\_rr
    • exhaust\_system
    • fuel\_system
    • cooling\_system
    • brake\_system
  </Card>
</CardGroup>

### Funcionalidades avanzadas

<Tip>
  **Optimizacion de costos:** Solicita precios OEM y aftermarket para ofrecer opciones a distintos precios. Las piezas aftermarket pueden reducir costos en 30-50%.
</Tip>

### Ejemplo de integracion

Combina inspeccion visual con evaluacion de danos:

```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>
  **Precision de estimaciones:** Los costos se basan en promedios regionales y bases de partes. Los costos reales pueden variar ±20% segun taller y disponibilidad.
</Warning>