> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar archivo SCIENTI

> Sube un archivo comprimido de exportación SCIENTI para su procesamiento.

> [!NOTE]
>
> Requiere sesión activa. El JWT se lee desde la cookie `access_token_cookie`
> y la solicitud debe llevar el encabezado `X-CSRF-TOKEN`. Se envía como
> `multipart/form-data`.

El archivo se guarda en la carpeta de la institución en Google Drive, o en el almacenamiento local del servidor si Drive falla. Solo después de guardarlo se envía el correo de confirmación de recibido.

## Cuerpo de la solicitud

**file** `file` *required*

Archivo comprimido de exportación SCIENTI. Formatos permitidos: `.zip`,
`.rar`, `.7z`, `.tar`, `.gz`, `.tgz`, `.bz2`, `.tar.gz`, `.tar.bz2`. Un
archivo vacío responde `400`.

## Respuesta

**success** `boolean`

`true` si el archivo fue guardado y se envió el correo de confirmación.

**msg** `string`

Mensaje de resultado del procesamiento.

**upload\_date** `string`

Fecha y hora de recepción del archivo en formato `DD/MM/YYYY HH:MM` (zona
horaria de Bogotá).

**file\_msg** `string`

Resultado del guardado, con el nombre con el que quedó el archivo.

> [!NOTE]
>
> Si el archivo no se puede guardar, o se guarda pero falla el correo de
> confirmación, responde `500` con el detalle en `storage_error` o
> `email_error`.

```json 200 theme={null}
{
  "success": true,
  "msg": "Archivo SCIENTI recibido con éxito para ser validado.",
  "upload_date": "15/10/2026 14:32",
  "file_msg": "Archivo scienti_example-institution-id_2026-10-15_14:32.zip guardado correctamente."
}
```

```json 400 theme={null}
{ "success": false, "msg": "Archivo requerido" }
```

```json 400 — archivo vacío theme={null}
{ "success": false, "msg": "El archivo cargado está vacío. Verifique que contenga información." }
```

```json 401 theme={null}
{"msg": "Token inválido o expirado", "success": false}
```

```json 415 theme={null}
{
  "success": false,
  "msg": "Tipo de archivo no permitido. Los formatos soportados son: .zip, .rar, .7z, .tar, .gz, .tgz, .bz2, .tar.gz y .tar.bz2."
}
```

```json 500 theme={null}
{
  "success": false,
  "msg": "Archivo recibido pero falló el guardado",
  "storage_error": {
    "success": false,
    "msg": "Error al guardar el archivo tanto en Drive como en local. Detalle: ...",
    "location": null
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.