🎯 Objetivo
Este procedimento permite importar dados de hóspedes para o banco de dados do cliente, populando as tabelas pessoa, cliente, contato, telefone, pessoafisica/pessoajuridica e endereco de forma automatizada, a partir de um arquivo CSV padrão.
🗂️ 1. Estrutura esperada do CSV
O arquivo hospedes.csv deve conter exatamente as colunas abaixo, nesta ordem e com estes nomes no cabeçalho (linha 1):
COD;NOME;razaonome;fantariasobrenome;dataregistro;cliente;ativo;idiomasistema;observação;idnacionalidade;RG;estadocivil;SEXO;CPF;documentotipo;nome;EMAIL;tipo;complemento;BAIRRO;CEP;ENDERECO;tipo;idcidade;logradourotipo;FONE;tipo;CIDADE;UH;PAIS⚠️ Atenção: O cabeçalho é obrigatório e sensível a nomes e posições.
Não altere a grafia, ordem ou número de colunas.
🧾 2. Exemplo de preenchimento
COD;NOME;razaonome;fantariasobrenome;dataregistro;cliente;ativo;idiomasistema;observação;idnacionalidade;RG;estadocivil;SEXO;CPF;documentotipo;nome;EMAIL;tipo;complemento;BAIRRO;CEP;ENDERECO;tipo;idcidade;logradourotipo;FONE;tipo;CIDADE;UH;PAIS
122;MARIA;MARIA;DA SILVA SANTOS;01/01/2000;TRUE;TRUE;PT;;30;;SOLTEIRO;FEMININO;42342342342;CPF;MARIA DA SILVA SANTOS;maria@gmail.com;FISICA;;BAIRRO;12472004;JOSE LIMA CARDOSO;PADRAO;5185;RUA;11991999999;COMERCIAL;CAMPOS DO JORDAO;RJ;BRASIL🔍 3. Regras de preenchimento de cada campo
Campo | Descrição / Origem | Formato esperado | Obrigatório? |
|---|---|---|---|
COD | Código da pessoa (inteiro único) | Numérico sem zeros à esquerda - Começa a partir do 5 | ✅ |
NOME | Nome completo da pessoa | Texto | ✅ |
razaonome | Nome principal (geralmente primeiro nome) | Texto | ✅ |
fantariasobrenome | Sobrenome / nome fantasia | Texto | ✅ |
dataregistro | Data de cadastro | DD/MM/YYYY | ✅ |
cliente | Indica se é cliente | TRUE ou FALSE | ✅ |
ativo | Status de ativo | TRUE ou FALSE | ✅ |
idiomasistema | Idioma preferencial | Use PT | ✅ |
observação | Observações gerais | Texto livre | ❌ |
idnacionalidade | ID da nacionalidade | 30 (Brasil) | ✅ |
RG | Documento identidade | Texto / vazio | ❌ |
estadocivil | Estado civil | Ex: SOLTEIRO, CASADO | ❌ |
SEXO | Gênero | MASCULINO ou FEMININO | ✅ |
CPF | CPF ou CNPJ (só números) | ########### ou ############## | ✅ |
documentotipo | Tipo de doc (ex: CPF, CNPJ) | Texto | ✅ |
nome | Nome para contato | Texto | ✅ |
E-mail principal | Formato válido | ✅ | |
tipo | Tipo de contato (ex: FISICA / JURIDICA) | Texto | ✅ |
complemento | Complemento do endereço | Texto / vazio | ❌ |
BAIRRO | Bairro | Texto | ✅ |
CEP | Código postal | Somente números | ✅ |
ENDERECO | Rua, avenida, etc. | Texto | ✅ |
tipo (2ª ocorrência) | Tipo de endereço | PADRAO | ✅ |
idcidade | ID interno da cidade | Preencher se conhecido | ❌ |
logradourotipo | Tipo do logradouro | Ex: RUA, AVENIDA | ✅ |
FONE | Número de telefone | Somente números | ✅ |
tipo (3ª ocorrência) | Tipo de telefone | Padrão: PESSOA, mas pode ser usado também COMERCIAL. | ✅ |
CIDADE | Nome da cidade | Texto | ✅ |
UH | Estado (sigla UF) | Ex: SC, SP, RJ | ✅ |
PAIS | País | Ex: BRASIL | ✅ |
💡 Dica: mesmo campos não obrigatórios devem estar presentes (nem que vazios), pois o script depende da posição das colunas.
✅ 4. Checklist final para os técnicos
Arquivo salvo em .csv com ; e codificação UTF-8
Cabeçalho exatamente igual ao modelo
Colunas obrigatórias preenchidas
Datas no formato DD/MM/YYYY
CPF/CNPJ sem pontos ou traços
Testado em ambiente de homologação
Backup do banco feito antes da importação
Script executado com schema correto (cliente_XXXXXX)
🧾 5. Fluxo interno após validação
1️⃣ Validar o arquivo conforme o checklist.
2️⃣ Abrir um incidente no sistema (Redmine).
Título: Importação de Pessoas – Cliente <código>
Exemplo: Importação de Pessoas – Cliente 9010
Categoria: Incidente
Responsável: Andressa Celant
Descrição: Conforme template do Redmine