# Import Data API

Manages data import operations from Excel files.

## Model

```json
{
  "id": "uuid",
  "module": "Student",
  "file_name": "students.xlsx",
  "file_url": "https://s3.../students.xlsx",
  "status": "completed",
  "total_rows": 100,
  "processed_rows": 100,
  "success_rows": 95,
  "error_rows": 5,
  "mapping": {...},
  "started_at": "2024-01-15T10:00:00Z",
  "completed_at": "2024-01-15T10:02:00Z",
  "team_id": "team-uuid"
}
```

## Status Values

| Status | Description |
|--------|-------------|
| `pending` | Awaiting mapping |
| `mapped` | Ready to start |
| `processing` | Import running |
| `completed` | Finished |
| `failed` | Error occurred |
| `cancelled` | User cancelled |

## Endpoints

### Upload File

`POST /api/import_datas/upload`

### Save Mapping

`PUT /api/import_datas/:id/mapping`

### Start Import

`POST /api/import_datas/:id/start`

### Check Status

`GET /api/import_datas/:id/status`

### Download Error Report

`GET /api/import_datas/:id/errors/download`

### Cancel Import

`POST /api/import_datas/:id/cancel`

### Get Saved Mappings

`GET /api/import_datas/mappings`

See [Import System Guide](../../guides/import-system.md) for full documentation.