# Cadastrar usuário

**Cadastrar usuário:**

Para cadastrar usuario é 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/{clienteId}/cartoes
```

**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                                                                                                                                                                                                                                                                                                            |
| ------------------ | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| estabelecimentoId  |      | Código de identificação do estabelecimento                                                                                                                                                                                                                                                                           |
| nome               |      | Nome do usuário                                                                                                                                                                                                                                                                                                      |
| email              |      | E-mail do usuário                                                                                                                                                                                                                                                                                                    |
| data de nascimento |      | Data de nascimento do usuário                                                                                                                                                                                                                                                                                        |
| sexo               |      | Sexo do usuário                                                                                                                                                                                                                                                                                                      |
| grupoId            |      | <p><strong>1</strong> = Administrador<br><strong>2</strong> = Gerencial<br><strong>3</strong> = Básico<br><strong>4</strong> = Financeiro<br><strong>5</strong> = Representante<br><strong>7</strong> = Backoffice<br><strong>7</strong> = Representante básico<br></p>                                              |
| id                 |      | null                                                                                                                                                                                                                                                                                                                 |
| tipoDocumento      |      | <p><strong>1</strong> = RG<br><strong>2</strong> = CPF<br><strong>3</strong> = CNPJ<br><strong>4</strong> = Outros<br><strong>5</strong> = Identificação<br><strong>6</strong> = Comprovante de atividade<br><strong>7</strong> = Comprovante de residência<br><strong>8</strong> = Identificação de usuário<br></p> |
| documento          |      | Número do documento                                                                                                                                                                                                                                                                                                  |
| tipoContato        |      | <p><strong>1</strong> = Fixo<br><strong>2</strong> = Celular<br></p>                                                                                                                                                                                                                                                 |
| valorContato       |      | Número do telefone                                                                                                                                                                                                                                                                                                   |
| logradouro         |      | Logradouro do endereço do usuário                                                                                                                                                                                                                                                                                    |
| numero             |      | Número do endereço                                                                                                                                                                                                                                                                                                   |
| cep                |      | Código Postal do endereço do usuário                                                                                                                                                                                                                                                                                 |
| Cidade             |      | Nome da cidade                                                                                                                                                                                                                                                                                                       |
| estado             |      | Código ISO 3166-2 para o estado, com duas letras da empresa                                                                                                                                                                                                                                                          |
| complemento        |      | Complemento do endereço do usuário                                                                                                                                                                                                                                                                                   |
| bairro             |      | Bairro do endereço do usuário                                                                                                                                                                                                                                                                                        |

**Exemplo de requisição:**

```json
{
    "estabelecimentoId": 158,
    "usuario": {
        "nome": "Jonatas",
        "email": "jonatas@teste.com.br",
        "dataNascimento": "2002-05-29",
        "dataNascimento2": "29/05/2002",
        "sexo": "M",
        "grupoId": 5
    },
    "documentos": [
        {
            "id": null,
            "tipoDocumento": 2,
            "documento": "47451835855"
        }
    ],
    "contatos": [
        {
            "tipoContato": 2,
            "valorContato": "11999999999"
        },
            "tipoContato": 1,
            "valorContato": "1188888888"
        }
    ],
    "endereco": {
        "logradouro": "Rua Luís de Andrade",
        "numero": "567",
        "cep": "02920000",
        "cidade": "São Paulo",
        "estado": "SP",
        "complemento": "",
        "bairro": "Vila Pereira Barreto"
    }
}
```

**Exemplo de resultado:**

```json

    "success": true,
    "message": "Usuário cadastrado com sucesso.",
    "usuario": {
        "ativo": "1",
        "id": 13251,
        "nome": "Jonatas",
        "email": "jonatas@teste.com.br",
        "sexo": "M",
        "parent_id": null,
        "senha": "3ae0b6825f571201b167223bd72e08ed54df1135",
        "token": "ce935b9aab1f7a7dca2bc9825d80da35ed5fce75",
        "grupo_id": 5,
        "endereco_id": 35336,
        "data_nascimento": "2002-05-29",
        "principal_estabelecimento_id": 158,
        "modified": "2020-08-17T15:47:47.942Z",
        "created": "2020-08-17T15:47:47.942Z"
    }
}
```
