# Registro de cliente

Fenicio envía (por única vez) la información del cliente para su registro en el sistema del comercio y lo vincula a través del código que obtenga del mismo.

| Método     | URL                               |
| ---------- | --------------------------------- |
| **`POST`** | https\://{ApiURL}/registrocliente |

## Request

### Usuario

| Clave           | Tipo                                                                                                | Descripción                                            |
| --------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| **`email`**     | String(255)                                                                                         | Email del usuario                                      |
| **`nombre`**    | String(255)                                                                                         | Nombre del usuario                                     |
| **`apellido`**  | String(255) \| null                                                                                 | Apellido del usuario                                   |
| **`telefono`**  | String(255)                                                                                         | <p>Teléfono del usuario. </p><p>Ejemplo: 099123456</p> |
| **`documento`** | [**Documento**](https://guia.fenicio.help/developers/referencia/modelos-de-datos#documento) \| null | Datos del documento del usuario                        |

### Documento

| Clave        | Tipo       | Descripción                                                             |
| ------------ | ---------- | ----------------------------------------------------------------------- |
| **`numero`** | String(32) | Número de documento                                                     |
| **`tipo`**   | String     | Tipo de documento. Valores posibles: `PASAPORTE`, `DOCUMENTO_IDENTIDAD` |

### Ejemplo

```json
{
 "_idSolicitud": "200325120000-FNSHPUY-3c7621ed5a707177c1421cce79338668",
 "email": "mail@dominio.com",
 "nombre": "Juan",
 "apellido": "Pérez",
 "telefono": "099123456",
 "documento": {
 "numero": "41234568",
 "tipo": "DOCUMENTO_IDENTIDAD"
 }
}
```

## Response

### Caso de exitoso

```json
{
 "status": "OK",
 "mensaje": "Usuario registrado.",
 "_idSolicitud": "200325120000-FNSHPUY-3c7621ed5a707177c1421cce79338668",
 "data": {
 "codigo": "abc12345"
 }
}
```

### Caso de error

```json
{
 "status": "ERROR",
 "mensaje": "El usuario no se ha registrado.",
 "_idSolicitud": "200325120000-FNSHPUY-3c7621ed5a707177c1421cce79338668",
}
```

En el campo 'mensaje', pueden retornar los diferentes errores que se presenten durante el
\
intento de registrar un usuario. En caso de éxito, el mensaje podría ser 'Usuario registrado'. En
\
caso de error, el mensaje deberá describir la causa del fallo, como por ejemplo 'El usuario no se
\
ha registrado', o bien detallar el motivo específico del error.