Importação de Dados via CSV

A importação via CSV permite cadastrar em lote grandes volumes de dados no sistema sem precisar incluir cada registro manualmente. O processo ocorre em duas etapas, pré-validação e confirmação, de modo que você veja os erros antes de qualquer dado ser gravado.

Passo a passo

Etapa 1 — Pré-validação

Acesse Minha conta > Organização > Importação de Dados.
Selecione a opção CSV e Importar.
Defina o tipo de entidade que deseja importar.
Faça o upload do arquivo CSV.
O sistema analisa todas as linhas e exibe um relatório com:
- Total de linhas encontradas
- Quantidade de linhas válidas
- Quantidade de linhas inválidas
- Para cada linha inválida: o número da linha e a descrição do erro
Revise os erros. Você pode corrigir o arquivo ainda na tela e antes de prosseguir.

Etapa 2 — Confirmação

Ao confirmar, a importação é iniciada em segundo plano. Você pode acompanhar o progresso em tempo real na tela.
Ao finalizar, o sistema exibirá um dos seguintes estados:

Status	Significado
Em processamento	Importação ainda em andamento
Concluída	Todos os registros foram gravados com sucesso
Concluída com erros	Parte dos registros foi gravada; os que falharam são detalhados em um arquivo de erros disponível para download
Falhou	Nenhum registro foi gravado

Se houver erros de processamento, baixe o arquivo de erros gerado, corrija as linhas indicadas e importe novamente apenas elas.

Formato do arquivo

Atributo	Valor
Extensão	`.csv`
Separador de colunas	(pipe)
Delimitador de texto	`"` (aspas duplas, opcional)
Codificação	UTF-8
Primeira linha	Cabeçalho com os nomes das colunas

Limites e tamanhos

Limite	Valor
Tamanho testado e suportado	Arquivos de até 50 MB
Limite explícito de linhas	Não há limite fixo

Atenção — arquivos grandes: O processamento ocorre em memória e não pode ser retomado em caso de interrupção (queda do servidor, reinício, timeout). Registros já gravados permanecem no banco, mas não há como saber o ponto de parada nem reprocessar apenas o restante. Prefira dividir o arquivo em lotes menores (recomendado: até 10.000 linhas) para reduzir o tempo de processamento, o risco de timeout e o impacto de uma eventual falha — além de facilitar a correção de erros.

Validações aplicadas

Pré-validação (antes de gravar)

Inconsistência	Aplicação
Campo obrigatório em branco	Sempre que o campo está marcado como obrigatório
Formato de CPF inválido	Campos com formato `000.000.000-00`
Formato de CNPJ inválido	Campos com formato `00.000.000/0000-00`
Formato de data inválido	Campos de data — aceita `AAAA-MM-DD` ou `AAAA-MM-DD HH:MM`
Estrutura de campo composto inválida	Campos com separadores internos (`;`, `@`, `&`) — ver cada entidade

Processamento (durante a gravação)

Validação	Entidades afetadas
Data não pode ser anterior a 20 anos	ASO, Atestado Médico, Deficiência, Questionário Clínico, Vacinas, Riscos
Registros que falham nessa validação são registrados no arquivo de erros e pulados; os demais continuam sendo gravados.

Entidades suportadas

1. ASO — Atestado de Saúde Ocupacional

Colunas obrigatórias: CPF, Data da Consulta, Tipo de Consulta, Nome do Médico, CRM, UF CRM, Resultado

Modelo de cabeçalho:

CPF | Data da Consulta | Minutos | Tipo de Consulta | Nome do Médico | CRM | UF CRM | Motivação | Data Clínica | Indicador | Resultado | Indicador Resultado | Exames | Data Agendamento | Natureza Consulta | Natureza | Data Cancelamento | Data Emissão | Recomendação | Plataforma | Manutenção Civil | Explosivos | Altura | Escavação | Eletricidade | Soldagem | Confinado | Frio | Radiação | Pressão | Manuseio de Carga

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
CPF	✓	`000.000.000-00`	CPF do trabalhador
Data da Consulta	✓	`AAAA-MM-DD HH:MM`	Data e hora da consulta
Minutos	—	Número	Duração em minutos
Tipo de Consulta	✓	Código	Código do tipo de consulta
Nome do Médico	✓	Texto	Nome completo do médico
CRM	✓	Número	Número do CRM
UF CRM	✓	Sigla	Estado do CRM (ex: `SP`)
Motivação	—	Texto	Motivação da consulta
Data Clínica	—	`AAAA-MM-DD HH:MM`	Data clínica
Indicador	—	Texto	Indicador
Resultado	✓	Código	Resultado da consulta
Indicador Resultado	—	Texto	Indicador do resultado
Exames	—	Composto	Lista de exames (ver abaixo)
Data Agendamento	—	`AAAA-MM-DD HH:MM`	Data do agendamento
Natureza Consulta	—	Texto	Natureza da consulta
Natureza	—	Texto	Natureza
Data Cancelamento	—	`AAAA-MM-DD HH:MM`	Data de cancelamento
Data Emissão	—	`AAAA-MM-DD HH:MM`	Data de emissão
Recomendação	—	Texto	Recomendação
Plataforma	—	Texto	Plataforma
Manutenção Civil	—	Texto	Manutenção civil
Explosivos	—	Texto	Explosivos
Altura	—	Texto	Trabalho em altura
Escavação	—	Texto	Escavação
Eletricidade	—	Texto	Eletricidade
Soldagem	—	Texto	Soldagem
Confinado	—	Texto	Espaço confinado
Frio	—	Texto	Frio
Radiação	—	Texto	Radiação
Pressão	—	Texto	Pressão
Manuseio de Carga	—	Texto	Manuseio de carga

Campo composto — Exames:
Cada exame é um bloco de subcampos separados por ;. Múltiplos exames são separados por @.

"Clínica;Audiometria;Dr. Silva;12345;SP;2026-05-15 10:00;1;Normal;0"  "Clínica;Audiometria;Dr. Silva;12345;SP;2026-05-15 10:00;1;Normal;0@Clínica;Eletrocardiograma;Dr. Lima;54321;RJ;2026-05-15 10:00;1;Normal;0"

Exemplo de linha:

"050.576.226-92" | "2026-05-15 10:00" | "30" | "0" | "Ana Silva" | "45741" | "SC" | "Periódico" | "2026-05-15 10:00" | "1" | "Normal" | "1" | "Clínica;Audiometria;Dr. Silva;45741;SC;2026-05-15 10:00;1;Normal;0" | "2026-05-15 10:00" | "1" | "1" | | "2026-05-15 10:00" | "1" | | | | | | | | | | | |

2. Atestado Médico

Colunas obrigatórias: CPF, Data Início, Tipo Atestado

Modelo de cabeçalho:

CPF | Data Início | Data Fim | Dias Tratamento | Tipo Atestado | CID | Grupo CID | Observação | Tipo Ausência | Tipo Abono | Início Ausência | Fim Ausência | Nome do Médico | CRM | UF CRM | Tipo Médico

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
CPF	✓	`000.000.000-00`	CPF do trabalhador
Data Início	✓	`AAAA-MM-DD HH:MM`	Início do atestado
Data Fim	—	`AAAA-MM-DD HH:MM`	Fim do atestado
Dias Tratamento	—	Número	Quantidade de dias de tratamento
Tipo Atestado	✓	Código	Código do tipo de atestado
CID	—	Código	Código CID
Grupo CID	—	Código	Grupo do CID
Observação	—	Texto	Observações livres
Tipo Ausência	—	Código	Código do tipo de ausência
Tipo Abono	—	Código	Código do tipo de abono
Início Ausência	—	`AAAA-MM-DD HH:MM`	Início da ausência
Fim Ausência	—	`AAAA-MM-DD HH:MM`	Fim da ausência
Nome do Médico	—	Texto	Nome do médico
CRM	—	Número	CRM do médico
UF CRM	—	Sigla	Estado do CRM
Tipo Médico	—	Código	Código do tipo de médico

Exemplo de linha:

"871.997.180-04" | "2026-05-15 03:00" | "2026-05-17 03:00" | "3" | "1" | | | "Queixa de dor lombar" | | | | | "Francisco" | "123456" | "SC" | "0"

3. Credenciado

Colunas obrigatórias: Nome
Modelo de cabeçalho:

Nome | Documento | Início Contrato | Exames

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
Nome	✓	Texto	Nome do credenciado
Documento	—	CPF ou CNPJ	CPF (`000.000.000-00`) ou CNPJ (`00.000.000/0000-00`)
Início Contrato	—	`AAAA-MM-DD HH:MM`	Data de início do contrato
Exames	—	Composto	Exames oferecidos (ver abaixo)

Campo composto — Exames:
Subcampos separados por ;, múltiplos exames separados por @.

"Clínica;Audiometria@Clínica;Eletrocardiograma"

Exemplo de linha:

"Clínica São José" | "12.345.678/0001-90" | "2026-01-01 00:00" | "Clínica;Audiometria@Clínica;Eletrocardiograma"

4. Deficiência

Colunas obrigatórias: CPF, Tipo
Modelo de cabeçalho:

CPF | Tipo | Data | Data Recuperação | CID | Observação

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
CPF	✓	`000.000.000-00`	CPF do trabalhador
Tipo	✓	Código	Código do tipo de deficiência
Data	—	`AAAA-MM-DD HH:MM`	Data do registro
Data Recuperação	—	`AAAA-MM-DD HH:MM`	Data de recuperação (máx. 20 anos atrás)
CID	—	Código	Código CID
Observação	—	Texto	Observações

Exemplo de linha:

"123.456.789-00" | "2" | "2024-03-10 00:00" | | "M54" | "Hérnia de disco"

5. Prontuário Médico

Colunas obrigatórias: CPF

Modelo de cabeçalho:

CPF | Candidato | Nome | Doador Sangue | Tipo Sanguíneo | Data Nascimento | Gênero | Peso | Altura | Fumante | Altura Olhos | Linha Mamilar | Altura Púbica | Altura Joelho | Altura Cotovelo | Tamanho Braço | Tamanho Antebraço | Tamanho Mão | Comprimento Perna | Tamanho Calçado | Gênero Enum | Cor Olhos | Cor Pele | Cor Cabelo | Período Tamagist | Quantidade Consumida | Histórico | Pressão Sistólica | Pressão Diastólica | Temperatura | Pulso

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
CPF	✓	`000.000.000-00`	CPF do trabalhador
Candidato	—	`true` / `false`	Se é candidato
Nome	—	Texto	Nome do trabalhador
Doador Sangue	—	`true` / `false`	Se é doador de sangue
Tipo Sanguíneo	—	Código	Código do tipo sanguíneo
Data Nascimento	—	`AAAA-MM-DD HH:MM`	Data de nascimento
Gênero	—	Código	Código do gênero
Peso	—	Número	Peso em kg
Altura	—	Número	Altura em cm
Fumante	—	`true` / `false`	Se é fumante
Altura Olhos	—	Número	Altura dos olhos
Linha Mamilar	—	Número	Linha mamilar
Altura Púbica	—	Número	Altura púbica
Altura Joelho	—	Número	Altura do joelho
Altura Cotovelo	—	Número	Altura do cotovelo
Tamanho Braço	—	Número	Tamanho do braço
Tamanho Antebraço	—	Número	Tamanho do antebraço
Tamanho Mão	—	Número	Tamanho da mão
Comprimento Perna	—	Número	Comprimento da perna
Tamanho Calçado	—	Número	Tamanho do calçado
Gênero Enum	—	Código	Gênero (enumeração)
Cor Olhos	—	Código	Cor dos olhos
Cor Pele	—	Código	Cor da pele
Cor Cabelo	—	Texto	Cor do cabelo
Período Tamagist	—	Texto	Período tamagist
Quantidade Consumida	—	Número	Quantidade consumida
Histórico	—	Texto	Histórico clínico
Pressão Sistólica	—	Número	Pressão sistólica
Pressão Diastólica	—	Número	Pressão diastólica
Temperatura	—	Número	Temperatura
Pulso	—	Número	Pulso

Exemplo de linha:

"123.456.789-00" | "false" | "João da Silva" | "false" | "O+" | "1985-06-20 00:00" | "M" | "80" | "175" | "false" | | | | | | | | | | | | | | | | | | | | |

6. Questionário

Colunas obrigatórias: Descrição, Grupo de Perguntas, Tipo Quiz

Modelo de cabeçalho:

Descrição | Grupo de Perguntas | Tipo Quiz

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
Descrição	✓	Texto	Nome do questionário
Grupo de Perguntas	✓	Composto	Perguntas e opções (ver abaixo)
Tipo Quiz	✓	Código	Código do tipo de questionário

Campo composto — Grupo de Perguntas:
Estrutura: pergunta;opção1&opção2&opção3@pergunta2;opçãoA&opçãoB

Perguntas separadas por @
Pergunta e suas opções separadas por ;
Opções entre si separadas por &
"Você possui hipertensão?;Sim&Não@Você é fumante?;Sim&Não&Ex-fumante"

Exemplo de linha:

"Questionário de Saúde Geral" | "Você possui hipertensão?;Sim&Não@Você é fumante?;Sim&Não&Ex-fumante" | "1"

7. Questionário Clínico

Colunas obrigatórias: CPF, Data Realização, Questionário, Respostas

Modelo de cabeçalho:

CPF | Data Realização | Questionário | Respostas

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
CPF	✓	`000.000.000-00`	CPF do trabalhador
Data Realização	✓	`AAAA-MM-DD HH:MM`	Data de realização (máx. 20 anos atrás)
Questionário	✓	Texto	Nome ou código do questionário
Respostas	✓	Composto	Respostas (ver abaixo)

Campo composto — Respostas:
Estrutura: código;resposta@código;resposta

Cada resposta é um par código da questão;valor da resposta
Pares separados por @
"1;Sim@2;Não@3;Ex-fumante"

Exemplo de linha:

"123.456.789-00" | "2026-03-10 09:00" | "Questionário de Saúde Geral" | "1;Sim@2;Não@3;Ex-fumante"

8. Riscos

Colunas obrigatórias: Data Reconhecimento, Agente de Risco

Modelo de cabeçalho:

Data Reconhecimento | Agente de Risco | Fonte Geradora | Ambiente | Centro de Custo | Departamento | Ocupação | Tarefa | Pessoa | Medição | Medida de Controle | IPE | Treinamento | Exame

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
Data Reconhecimento	✓	`AAAA-MM-DD HH:MM`	Data de reconhecimento do risco
Agente de Risco	✓	Composto `;`	`;nome;código;código`
Fonte Geradora	—	Texto	Fonte geradora do risco
Ambiente	—	Texto	Ambiente de trabalho
Centro de Custo	—	Composto `;@`	`;descrição@código;descrição` — múltiplos separados por `@`
Departamento	—	Composto `;@`	`;nome` — múltiplos separados por `@`
Ocupação	—	Composto `;@`	`;nome` — múltiplos separados por `@`
Tarefa	—	Composto `@`	Descrições separadas por `@`
Pessoa	—	Composto `;@`	`;nome;CPF;nascimento;código` — múltiplas separadas por `@`
Medição	—	Composto `;@`	`data;valor;instrumento` — múltiplas separadas por `@`
Medida de Controle	—	Composto `;@`	`descrição;código` — múltiplas separadas por `@`
IPE	—	Composto `@`	CAs separados por `@`
Treinamento	—	Composto `;@`	`;nome;código` — múltiplos separados por `@`
Exame	—	Composto `;@`	`nome;código;obrigatório;periódico;periodicidade` — múltiplos separados por `@`

Exemplo de linha:

"2026-01-15 00:00" | ";Ruído;01.01.001;1" | "Compressor" | "Produção" | ";Produção SC" | ";Montagem" | ";Operador" | | | "2025-12-01 00:00;85;Decibelímetro" | "Protetor Auricular;EPI-001" | "123456" | ";NR-15;TRN001" |

9. Vacinas

Colunas obrigatórias: CPF, Vacina, Data

Modelo de cabeçalho:

CPF | Vacina | Lote | Data | Status | Dose Atual | Dose

Referência de colunas:

Coluna	Obrigatório	Formato	Descrição
CPF	✓	`000.000.000-00`	CPF do trabalhador
Vacina	✓	Composto `;`	Dados da vacina (ver abaixo)
Lote	—	Texto	Número do lote
Data	✓	`AAAA-MM-DD HH:MM`	Data da aplicação (máx. 20 anos atrás)
Status	—	Código	Código do status
Dose Atual	—	Número	Número da dose atual
Dose	—	Número	Total de doses

Campo composto — Vacina:
8 subcampos separados por ;:

nome;campo2;campo3;campo4;campo5;campo6;campo7;campo8

Exemplo real:

"Coronavac;2;0;99;2;5;5;11"

Exemplo de linha:

"936.406.870-00" | "Coronavac;2;0;99;2;5;5;11" | "ABC240" | "2022-05-17 10:15" | "1" | "1" | "1"

Integrações e efeitos colaterais

A importação via CSV não gera eventos para o eSocial. Nenhuma das entidades suportadas enfileira mensagens no eSocial durante o processo de importação, inclusive o ASO, que em criações manuais dispararia o S-2220.