> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/usuarios-e-permissoes/gerenciar-usuarios/como-importar-usuarios.md).

# Como importar pessoas

## Visão geral

De maneira geral, a importação de pessoas permite carregar pessoas em lote para o sistema OU editar dados de pessoas já existentes. Ela funciona através da carga de um arquivo no formato .CSV.  Esse tipo de arquivo pode ser facilmente criado no Excel, por exemplo, selecionando a opção de salvar como CSV.

Para acessar esse recurso, é preciso ter permissão no sistema para criar novas pessoas.

![](/files/crTmjwd6jPrSp6NpnBmk)

Uma maneira prática de obter o arquivo modelo de importação é realizar uma [exportação de pessoas](/zeev/usuarios-e-permissoes/gerenciar-usuarios/como-exportar-usuarios.md). O arquivo de exportação de pessoas é o mesmo arquivo / formato utilizado na importação.

## Regras gerais

1. Pessoas novas, identificadas pelo login, serão importados no sistema;
2. Pessoas já existentes, identificadas pelo login, serão atualizadas; 
3. É possível incluir mais de uma linha para a mesma pessoa, permitindo a inclusão de múltiplos [times e funções](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-times-e-funcoes.md), e [grupos de permissões](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-grupos-de-permissoes.md); 
4. Nenhuma pessoa receberá nenhum e-mail. Novas pessoas deverão usar o recurso de "Esqueci minha senha" para criar uma nova senha de acesso, ou usar um dos meios de autenticação integrada, se foram habilitados;

## Com esse recurso, é possível:

1. Criar novas pessoas, caso o login já não exista no sistema;
2. Criar novas pessoas e já vincular elas a [grupos de manutenção](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-grupos-de-permissoes.md) e [times e funções](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-times-e-funcoes.md);
3. Atualizar dados cadastrais de pessoas existentes (identificadas através do login), tais como nome ou endereço de e-mail;
4. Desativar pessoas em lote, modificando o valor da propriedade que identifica seu status;
5. Acrescentar [grupos de permissões](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-grupos-de-permissoes.md) e [times e funções](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-times-e-funcoes.md) a pessoas já existentes;

## **Não** é possível com esse recurso:

1. Excluir [grupos de permissões](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-grupos-de-permissoes.md) da pessoa existente. Essa operação deverá ser feita manualmente, ou através de outros recursos;
2. Excluir [times de funções](/zeev/usuarios-e-permissoes/gerenciar-usuarios/vincular-usuarios-a-times-e-funcoes.md) da pessoa existente. Essa operação deverá ser feita manualmente, ou através de outros recursos;

## Demonstração prática

Veja na demonstração abaixo como importar pessoas via planilha: 

{% embed url="<https://www.youtube.com/watch?v=IZG9MgCYJ3A>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kb.stoque.com.br/zeev/usuarios-e-permissoes/gerenciar-usuarios/como-importar-usuarios.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.