Skip to content

2.2 Pré-cadastro em lote

Para grandes volumes — a carga inicial de um conselho, por exemplo — o pré-cadastro é feito por importação de arquivo CSV em Pré-cadastro → Em lote. A mesma tela concentra a configuração do identificador da organização.

Configuração do identificador externo

Cada conselho tem seu próprio "número forte" (Nº OAB, Nº CREA, matrícula). A plataforma não fixa esse conceito em código: ele é configurado por organização.

ConfiguraçãoEfeito
RótuloNome exibido nos formulários e relatórios (ex.: "Nº CREA")
Regex de validaçãoRegra opcional de formato (ex.: ^\d{4,8}$)
ObrigatórioExige o identificador no pré-cadastro
Alimenta nº de registroUsa o identificador como número de registro da carteira

O arquivo CSV

  • Colunas: cpf, nome, email, telefone, external_identifier (opcionais: categoria, canal, data_nascimento).
  • Codificação UTF-8, até 10 MB.
  • Cabeçalhos diferentes? A organização pode configurar um mapeamento de colunas.

Passo a passo

1 Selecione o serviço (Carteira funcional).

2 Marque Apenas validar (dry-run) na primeira execução: o arquivo inteiro é validado linha a linha sem gravar nada — ideal para depurar a carga antes da importação real.

3 Arraste o arquivo ou clique para selecionar. Ao concluir, a tela mostra o resumo (criados, reaproveitados, ignorados, erros) e o relatório por linha com o motivo de cada erro.

4 Corrija o arquivo se necessário e repita sem o dry-run.

Regras da importação

  • Idempotência: reimportar o mesmo arquivo não duplica pessoas nem solicitações — CPFs existentes são reaproveitados e atualizados.
  • Cada linha é independente: um erro em uma linha não aborta o lote.
  • Status inicial: como cargas em massa raramente trazem foto e documentos, o status típico é PRE_CADASTRO — os profissionais completam o cadastro pelo aplicativo, cada um no seu ritmo.
  • O template ativo continua sendo pré-condição — a tela bloqueia a importação e avisa quando ele não existe.

Plataforma Aquila — Carteira Funcional