> For the complete documentation index, see [llms.txt](https://paylivre.gitbook.io/guia-de-integracao-via-api-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paylivre.gitbook.io/guia-de-integracao-via-api-1/usuarios/editar-usuario.md).

# Editar usuário

**Editar usuário:**

Para editar o usuário é necessário seguir este roteiro de detalhe. O procedimento requer o envio de uma solicitação utilizando o método PUT.

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/usuarios/{usuarioId}
```

**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 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> |
| parentId           |      | Identifica a qual estabelecimento está vinculado                                                                                                                                                                                                                        |
| tipoContato        |      | <p><strong>1</strong> = Fixo<br><strong>2</strong> = Celular<br></p>                                                                                                                                                                                                    |
| valorContato       |      | Número do telefone                                                                                                                                                                                                                                                      |
| logradouro         |      | Logradouro do endereço da empresa                                                                                                                                                                                                                                       |
| numero             |      | Número do endereço                                                                                                                                                                                                                                                      |
| cep                |      | Código Postal do endereço da empresa                                                                                                                                                                                                                                    |
| 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                                                                                                                                                                                                                                           |
| usuarioId          |      | Código de identificação do usuário                                                                                                                                                                                                                                      |

**Exemplo de requisição:**

```json
{
	"usuario": {
		"nome": "Renan",
		"email": "renan@teste.com.br",
		"dataNascimento": "1998-01-01",
		"dataNascimento2": "01/01/2002",
		"sexo": "M",
		"grupoId": 2,
		"parentId": null
	},
	"contatos": [
		{
			"tipoContato": 1,
			"valorContato": "11888888888"
		},
		{
			"tipoContato": 2,
			"valorContato": "11888888888"
		}
	],
	"endereco": {
		"logradouro": "Rua Salvador Simoes",
		"numero": "801",
		"cep": "02920000",
		"cidade": "São Paulo",
		"estado": "SP",
		"complemento": "",
		"bairro": "Alto do Ipiranga"
	},
	"usuarioId": "12991"
}
```

**Exemplo de resultado:**

```json
Exemplo de resultado :

{
  "success": true,
  "message": "Usuário editado com sucesso.",
  "usuario": {
    "id": 12991,
    "parent_id": null,
    "grupo_id": 2,
    "endereco_id": 34914,
    "nome": "Renan",
    "email": "renan@teste.com.br",
    "senha": "59657da0958df8d7736be3556867d4f5c2a75806",
    "foto": null,
    "sexo": "M",
    "data_nascimento": "1998-01-01",
    "ativo": 1,
    "token": "b0241d60dd348d8545a0b3d41d6fe192561b61e4",
    "principal_estabelecimento_id": 158,
    "created": "2020-08-11T17:25:55.000Z",
    "modified": "2020-08-13T17:27:09.122Z",
    "removed": null,
    "endereco": {
      "id": 34914,
      "logradouro": "Rua Salvador Simoes",
      "numero": "801",
      "complemento": "",
      "cep": "02920000",
      "bairro": "Vila Pereira Barreto",
      "cidade": "São Paulo",
      "uf": "SP",
      "lat": null,
      "long": null,
      "created": "2020-08-11T17:25:55.000Z",
      "modified": "2020-08-13T17:27:09.111Z",
      "removed": null
    },
    "usuarios_contatos": [
      {
        "id": 628,
        "usuario_id": 12991,
        "tipo_contato_id": 2,
        "nome": "Teste",
        "contato": "11888888888",
        "created": "2020-08-11T17:25:55.000Z",
        "modified": "2020-08-13T17:27:09.147Z",
        "removed": null
      },
      {
        "id": 629,
        "usuario_id": 12991,
        "tipo_contato_id": 1,
        "nome": "Teste",
        "contato": "11888888888",
        "created": "2020-08-11T17:25:55.000Z",
        "modified": "2020-08-13T17:27:09.130Z",
        "removed": null
      }
    ],
    "usuarios_documentos": [
      {
        "id": 267,
        "usuario_id": 12991,
        "tipo_documento_id": 2,
        "documento": "46122469858",
        "arquivo": null,
        "created": "2020-08-11T17:25:55.000Z",
        "modified": "2020-08-11T17:25:55.000Z",
        "removed": null
      }
    ]
  }
}
```
