# Criar um novo cliente

**Criar um novo cliente:**

Para criar um novo cliente é necessário seguir este roteiro de detalhe. O procedimento requer o envio de uma solicitação utilizando o método POST.

Esta solicitação pode ser realizada de duas maneiras distintas: utilizando dados no formato JSON ou através de Multipart/fomr-data.

**URL de Solicitação:**

```url
https://api.zsystems.com.br/clientes
```

**Cabeçalhos Exigidos para a Requisição:**

* Content-Type: Necessário especificar como multipart/form-data ou application/json, adaptado ao método de envio dos dados.
* Authorization: Precisa incluir um 'TokenAPI', precedido por Bearer, para confirmar a autenticação e conceder permissão para realizar a solicitação.

**Detalhes dos Parâmetros da Solicitação:**

| Id             | Tipo | Descrição                                                              |
| -------------- | ---- | ---------------------------------------------------------------------- |
| nome           |      | Nome do cliente / Razão Social                                         |
| documento      |      | CPF ou CNPJ do cliente                                                 |
| dataNascimento |      | Data de nascimento do cliente, caso o **documento** seja CPF           |
| email          |      | E-mail do cliente                                                      |
| celular        |      | Número celular do cliente                                              |
| sexo           |      | <p><strong>M</strong> = Masculino<br><strong>F</strong> = Feminino</p> |
| logradouro     |      | Rua ou Avenida do endereço                                             |
| numero         |      | Número do endereço                                                     |
| cep            |      | Código postal do endereço                                              |
| cidade         |      | Cidade do endereço                                                     |
| estado         |      | Código ISO 3166-2 para o estado, com duas letras                       |
| complemento    |      | Complemento do endereço                                                |

**Exemplo de requisição:**

```json
{
  "nome": "João Paulo",
  "documento": "00000000000",
  "dataNascimento": "1993-12-16",
  "email": "teste2@zsystems.com.br",
  "celular": "00999998888",
  "sexo": "M",
  "endereco": {
    "logradouro": "Rua Pedro Souza",
    "numero": "124",
    "cep": "03380-200",
    "cidade": "São Paulo",
    "estado": "SP",
    "complemento": ""
  }
}
```

**Exemplo de resultado:**

```json
{
  "success": true,
  "cliente": {
    "id": 18638,
    "endereco_id": 700,
    "nome": "João Paulo",
    "email": "teste2@zsystems.com.br",
    "senha": "",
    "sexo": "M",
    "ativo": true,
    "data_nascimento": "1993-12-16",
    "created": "2020-02-07T21:49:38.000Z",
    "modified": "2020-02-07T21:49:38.000Z",
    "removed": null,
    "endereco": {
      "id": 700,
      "logradouro": "Rua Souza Lima",
      "numero": "124",
      "complemento": "",
      "cep": "03380200",
      "cidade": "São Paulo",
      "uf": "SP",
      "lat": null,
      "long": null,
      "created": "2020-02-07T21:49:38.000Z",
      "modified": "2020-02-07T21:49:38.000Z",
      "removed": null
    }
  }
}
 
```