# Import & Export Deep Dive {#import--export-deep-dive}


Bulk data import and export capabilities.


## Export Formats {#export-formats}


| Format | Use Case              |
| ------ | --------------------- |
| CSV    | Spreadsheet analysis  |
| XLSX   | Excel with formatting |
| JSON   | API/programmatic use  |
| PDF    | Reports and invoices  |


## Exporting Data {#exporting-data}



### From UI {#from-ui}


1. Navigate to any list view (Employees, Tasks, Invoices)
2. Apply filters as needed
3. Click **Export** → select format
4. Download file


### Via API {#via-api}


```bash
GET /api/employee/export
Authorization: Bearer {token}
Accept: text/csv
```


## Importing Data {#importing-data}



### Supported Entities {#supported-entities}


| Entity    | Import | Export |
| --------- | ------ | ------ |
| Employees | ✅     | ✅     |
| Tasks     | ✅     | ✅     |
| Invoices  | ❌     | ✅     |
| Contacts  | ✅     | ✅     |
| Time Logs | ✅     | ✅     |
| Expenses  | ✅     | ✅     |
| Products  | ✅     | ✅     |


### Import Process {#import-process}


1. Download template CSV
2. Fill in data following the template format
3. Go to **Settings** → **Import/Export**
4. Upload CSV file
5. Map columns to fields
6. Preview and confirm
7. Import executes


### Validation {#validation}


During import, each row is validated:

- Required fields present
- Data types correct
- Foreign keys resolve (project, org)
- Duplicates detected


## Bulk Operations {#bulk-operations}


```bash
POST /api/employee/import
Content-Type: multipart/form-data

# Upload CSV/XLSX with employee data
```


## Related Pages {#related-pages}


- [Import/Export](https://sourcey-gauzy.pages.dev/features/import-export/index.md) — overview
- [Data Export Formats](https://sourcey-gauzy.pages.dev/features/data-export-formats/index.md) — format details
- [Bulk Operations](https://sourcey-gauzy.pages.dev/features/bulk-operations/index.md) — bulk actions
