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

# Enviar correo recuperación

El servicio permite a los usuarios solicitar el envío del correo de recuperación de contraseña del portal de clientes, en línea en formato JSON.

El mismo correo se utiliza para la **creación de cuenta** de los usuarios nuevos que aún no tienen contraseña asignada. El correo contiene el enlace con el token de recuperación que luego se utiliza en el servicio de [recuperación de contraseña](https://tech.sedierp.com/recuperacion-de-contrasena.md) para asignar la nueva contraseña.

El método de solicitud es POST y no requiere autenticación.

## Prerequisitos

Antes de solicitar el correo de recuperación, se debe contar con los siguientes datos:

* Identificador único de la empresa (UUID) asignado por SEDI-ERP
* Tipo y número de documento del usuario registrado en la empresa, con correo electrónico registrado

## Enviar correo de recuperación

**Request URL:** [https://portal.sedierp.com/API/api/Accesos/EnviarCorreoRecuperacion](https://portal.sedierp.com/API/api/Accesos/EnviarCorreoRecuperacion)\
**Tipo:** POST \
**Content Type:** application/json

**TipoDocumentoID** `int` *required*

Código del tipo de documento de identificación del usuario. Se obtiene del servicio de tipos de documentos.

![tipos-documentos](https://mintcdn.com/sedi-solutions-sas/GIw7WqTvI4uIXmWB/images/tipos-documentos.png?fit=max\&auto=format\&n=GIw7WqTvI4uIXmWB\&q=85\&s=4972cedc7a553835f30e959fa753fd0a)

**Documento** `string` *required*

Número de documento de identificación del usuario.

**UUID** `GUID` *required*

Identificador único de la empresa.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API/api/Accesos/EnviarCorreoRecuperacion' \
--header 'Content-Type: application/json' \
--data '{
	"TipoDocumentoID": 1,
	"Documento": "1032456789",
	"UUID": "2be0e514-4eb7-4677-b4b0-4a08936bfbee"
}'
```

### Validaciones

El servicio realiza las siguientes validaciones antes de enviar el correo. Si alguna no se cumple, no se envía el correo y se retorna el error correspondiente.

* `TipoDocumentoID` y `Documento` son obligatorios.
* El tipo y número de documento deben corresponder a un usuario de la empresa.
* El usuario debe tener un correo electrónico registrado.
* El correo se debe enviar correctamente a través del servicio de correos de la plataforma.

> [!NOTE]
>
> Cada solicitud genera un nuevo token de recuperación. El enlace de los correos enviados anteriormente al mismo usuario deja de ser válido.

### Respuesta

**TipoSalida** `string`

Resultado de la operación: "OK".

**Codigo** `int`

Código de la operación. Retorna 200 cuando el correo se envía correctamente.

**Descripcion** `string`

Mensaje de confirmación con el correo electrónico al que se envió el enlace, enmascarado (solo se muestran los dos primeros caracteres y el dominio).

Cuando alguna validación no se cumple, el servicio responde HTTP 400 con el campo `Message`, que contiene el detalle del error precedido de "Error:".

```json Request theme={null}
{
  "TipoDocumentoID": 1,
  "Documento": "1032456789",
  "UUID": "2be0e514-4eb7-4677-b4b0-4a08936bfbee"
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "TipoSalida": "OK",
            "Codigo": 200,
            "Descripcion": "Se ha enviado el link de recuperación o creación de cuenta al correo la...@correo.com, ."
        }
    ],
    "result": 1
}
```

```json Error theme={null}
{
    "Message": "Error: No cuenta con email registrado en el sistema para recuperar la contraseña o crear una cuenta."
}
```


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