# Índice

1. [Quando usar as consultas em lote no painel web](#quando-usar)
2. [Criação de lote](#criacao-lote)
3. [Download do arquivo entrada](#download-entrada)
4. [Download dos resultados](#download-resultados)
5. [Replicar colunas para o CSV de saída](#replicar-colunas)

## [Quando usar as consultas em lote no painel web](#quando-usar)
A [área de lotes](https://api.infosimples.com/consultas/lotes) no painel web permite a realização de consultas em lote e é destinada a usuários finais, uma vez que não requer conhecimentos de programação.

De forma geral, o fluxo de funcionamento consiste em enviar arquivos do tipo CSV para processamento e posteriormente obter os resultados compactados em arquivos do tipo Zip **protegidos por senha**. Os resultados do processamento podem incluir:

- Um arquivo similar ao de entrada, porém com dados enriquecidos através das consultas (CSV).
- Os arquivos de visualização das consultas realizadas (HTML ou PDF).
- Os retornos originais da API da Infosimples (JSON).

Portanto, o uso dessa ferramenta é recomendado quando o seu processo de negócio funciona bem com envio e recepção de arquivos ou quando o usuário não tem os conhecimentos necessários de programação para realizar uma integração personalizada.

Os tutoriais em vídeo abaixo demonstram como usar área de consultas em lote.


## [Criação de lote](#criacao-lote)
Veja abaixo como criar um lote e enviar um arquivo do tipo CSV corretamente formatado. Um lote pode ter no máximo 50.000 registros.


## [Download do arquivo entrada](#download-entrada)
Caso necessário, é possível obter o arquivo original enviado por você como entrada do processamento.

> IMPORTANTE: após um determinado período de tempo, o arquivo de entrada é automaticamente deletado de forma permanente. Consulte o seu lote no painel web para verificar até quando o respectivo arquivo de entrada estará disponível.


## [Download dos resultados](#download-resultados)
Após o processamento de um lote, serão gerados como resultados alguns arquivos do tipo Zip protegidos por senha. Veja abaixo como baixá-los e descompactá-los no seu computador.

> IMPORTANTE: após um determinado período de tempo, os arquivos de resultados são automaticamente deletados de forma permanente. Consulte o seu lote no painel web para verificar até quando os respectivos arquivos de resultados estarão disponíveis.


## [Replicar colunas para o CSV de saída](#replicar-colunas)
Ao criar um lote, você pode indicar na interface web do painel da Infosimples a qual parâmetro da API cada uma das colunas do CSV de entrada se refere. Tais colunas serão automaticamente replicadas no CSV de saída, de forma a ficar claro quais foram os parâmetros de entrada que deram origem a determinados dados de saída.

Caso você precise que uma coluna do CSV de entrada **seja replicada no CSV de saída mas não seja usada como parâmetro de consulta da API** , basta nomear essa coluna no CSV de entrada com o prefixo `incluir_`.

Por exemplo, o CSV abaixo poderia ser usado na consulta `Receita Federal / CPF` para replicar no CSV de saída a coluna `id_interno_do_meu_usuario`.

```csv
cpf,data_de_nascimento,incluir_id_interno_do_meu_usuario
11111111111,1111-11-11,12345
22222222222,2222-22-22,ABCDE
```

As colunas `cpf` e `data_de_nascimento` são necessárias para a consulta em questão. A coluna `incluir_id_interno_do_meu_usuario` seria apenas replicada no CSV de saída.

É possível usar o prefixo `incluir_` em mais de uma coluna no CSV de entrada.


## [Parâmetros constantes](#parametros-constantes)
Ao criar um lote em que um ou mais dos parâmetros sejam os mesmos para todas as linhas (ex.: `login_cpf`, `ignora_nao_lidas`, etc.), você pode adicionar um **parâmetro constante**.

Esse valor será utilizado para o parâmetro selecionado em todas as linhas em que a coluna estiver vazia.


## Precisa de ajuda?
Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.