# Añadir nuevo cliente

Esta función permite añadir un nuevo **cliente** en el sistema.

---

### URL
`/CTNEAT/CUSTOMER/ADD/{tkn}`

---

### Método HTTP

<span style="background-color: RGB(22,216,80); color: white; font-weight: bold; padding: 8px;">POST</span>

---

### Parámetros de la solicitud

| Nombre del parámetro | Tipo de dato | Descripción del parámetro | Obligatorio | Formato del valor |
| :-------------------- | :------------ | :------------------------ | :----------- | :----------- |
| **CUSTOMERNIF** | cadena | NIF del cliente | Sí | cualquiera |
| **CUSTOMERNAME** | cadena | Nombre del cliente | Sí | cualquiera |

---

### Encabezados de la solicitud

| Nombre del encabezado | Descripción del encabezado | Obligatorio |
| :--------------------- | :-------------------------- | :----------- |
| **Content-Type** | Tipo de contenido de la solicitud | Sí |

---
### Parámetros de la respuesta

| Nombre del parámetro | Tipo de dato | Descripción del parámetro |Formato|
| -------------------- | ------------ | ------------------------ | ------------------------ |
|        ErrorContent, SuccessContent              |      JSON        |       Json con la descripción del resultado de la operación                   | <span style="color:blue">[Formato ErrorContent](https://docs.ctneat.com/link/64#bkmrk-elementos-de-errorco)</span> |

---

### Códigos de estado de la respuesta

| Código de estado | Descripción del código de estado | Posibles razones |
| ---------------- | -------------------------------- | ---------------- |
|     200             |            OK                      |     La solicitud fue exitosa             |
|     400             |            Petición errónea                      |     	Alguno de los parámetros pasados no es correcto             |
|     500             |            Error interno                      |     	Error en el servidor             |
|     401             |            Unauthorized                      |     	El usuario no está autenticado             |

---

### Cuerpo de la solicitud

Formato del cuerpo de la solicitud: **application/json**

URL de la solicitud:
`http://ctincoming/CTNEAT/CUSTOMER/ADD/6A201F1F5147079FF9CA80DCDBB032AB386905091BC973B53F50E6493EC53868`

Descripción del cuerpo de la solicitud:
```json
{
  "CUSTOMERNIF": "NIFDELETRASYNÚMEROS",
  "CUSTOMERNAME": "NOMBRE"
}
````

---

### Ejemplo de respuesta
```json
{ "Success":true, 
  "fault":
 { 
    		"faultcode":"", 
    		"faultstring":"Customer added", 
    		"detail":"Customer nombre_1 successfully added" 
  }
}
````