FAQ - Lotes de Importação
Esta documentação abrange a área de troubleshooting, essencial para resolver problemas técnicos e manter sistemas funcionando adequadamente. Exploraremos a abordagem sistemática de análise de sintomas, testes e diagnóstico, além de destacar a importância da colaboração e compartilhamento de conhecimento. O guia fornece informações valiosas para aprimorar habilidades técnicas e enfrentar desafios com confiança, garantindo a eficiência operacional. Mantenha-se atualizado com as últimas tendências nesse campo em constante evolução.
Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial
Problema na importação SFTP
Em caso de problemas em importações via SFTP há algumas situações comuns de acontecer, como:
Arquivos compactados individualmente, sem um arquivo “agrupador”:
No importador SFTP do Mosia Omnichannel, é necessário que os arquivos individualizados sejam “agrupados” em um único arquivo .ZIP, com o nome “redecredenciada-AAAAMMDDHHMMSS.ZIP” para os arquivos de carga de rede, e “beneficiario-AAAAMMDDHHMMSS.ZIP” para o arquivo de carga de beneficiários. Não enviar um arquivo unificador fará com que sua importação seja rejeitada.
ATENÇÃO
Os arquivos devem ser enviado em um arquivo único “Agrupador”, conforme exemplo:
redecredenciada.zip
especialidades.zip
planos.zip
prestadortipo.zip
redecredenciada.zip
Arquivo de exemplo:
Arquivo agrupador formato .ZIP | Arquivos .ZIP dentro do arquivo agrupador |
|---|---|
|
|
Nomenclatura dos arquivos que contém as informações estão sem a nomenclatura padronizada:
Os arquivos importados devem seguir um padrão de nomenclatura que está descrito em nossa documentação. Sem essa nomenclatura padronizada, os arquivos serão rejeitados.
Arquivos com extensão incorreta:
Dentro dos arquivos ZIP é necessário que existam arquivos CSV separados por PONTO E VÍRGULA. Se algum dos arquivos não estiver nesse formato, o lote de importação será inteiramente rejeitado.
Falta de algum arquivo obrigatório:
Em nossa documentação indicamos quais são os arquivos obrigatórios a serem enviados para o funcionamento da Rede Credenciada. Verifique se algum dos arquivos obrigatórios estão faltando no arquivo.
Exemplo de script de envio SFTP
Estamos disponibilizando também um script simples para auxiliar nos envios de arquivos via SFTP.
Em nossa documentação temos a visão geral de como os arquivos devem estar, desde nomenclatura até forma de compacta-lo, para mais informações consultar a documentação.
Download de arquivos importados
É possível realizar o download de arquivos já importados no painel, para isso acesse:
Painel > Ferramentas > Lotes de importação > Visualizar carga desejada.
Os arquivos estarão a disposição para download.
Atenção
Os lotes ficam disponíveis para download por 6 meses (182 dias)
Como entender os logs de erros do importador
Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial
Para melhor entendimento do log de nosso importador disponibilizamos este conteúdo para auxiliar na leitura e tambem como analisar seus arquivos enviados para identificar onde está o problema e ajustar na origem (no caso o sistema/banco de dados responsável por guardar e gerar os arquivos).
Erro em arquivo que são exportados via PTU
Em caso de Erro na importação de arquivos que foram exportados dos arquivos PTU recomendamos verificar especificamente o arquivo de GM_MS_TPREDE que é exportado.
Alguma informação pode vir cortada, ocasionando o erro!
Neste caso, faça a exportação novamente dos arquivos novamente para que sejam gerados corretamente e faça uma nova importação.
Como Analisar e Ajustar sua Importação com Erros
🧩 Problema:
Ao tentar importar um arquivo (ex: de acreditação), o sistema retorna uma mensagem de erro relacionada a conteúdo inválido ou campos inconsistentes.
❓1. O que significa a mensagem "conteúdo inválido no arquivo de acreditação"?
Essa mensagem indica que alguns campos do arquivo estão preenchidos de forma incorreta ou com valores inválidos (ex: código inexistente, campos vazios, data inválida etc.).
Embora algumas inconsistências não impeçam a importação, os erros com "conteúdo inválido" devem ser corrigidos.
❓2. Qual programa devo usar para abrir e corrigir o arquivo CSV?
Recomendamos usar o LibreOffice Calc, e não o Excel.
O LibreOffice lida melhor com arquivos .csv que possuem delimitadores por ponto e vírgula e campos entre aspas, evitando problemas como:
CPF/CNPJ exibidos em notação científica;
Dados truncados ou formatados incorretamente.
❓3. Como abrir corretamente o arquivo CSV no LibreOffice?
Abra o LibreOffice Calc.
Ao importar o arquivo:
Defina o delimitador como ponto e vírgula ( ; );
Marque todos os campos como tipo texto;
Verifique se os dados estão sendo exibidos corretamente (sem notação científica, por exemplo).
❓4. O que é o “código CBO” e por que o erro menciona o valor “00”?
O CBO (Código Brasileiro de Ocupações) identifica a especialidade dos profissionais.
O erro aparece porque o seu arquivo contém o valor “00” em um ou mais registros, mas esse código não existe no cadastro do sistema.
❓5. Como encontrar e corrigir as linhas com erro de código CBO?
No LibreOffice, aplique um filtro na coluna do código CBO.
Filtre por registros com valor “00”.
Você tem duas opções:
Remover essas linhas se não forem necessárias;
Corrigir com o código CBO correto.
Depois de corrigir, salve o arquivo.
❓6. Como salvar o arquivo CSV corretamente no LibreOffice?
Vá em Arquivo > Salvar como.
Escolha o formato CSV (.csv).
Marque as opções:
Delimitador de campo: ponto e vírgula ( ; );
Delimitador de texto: aspas ( " );
Forçar aspas em todas as células de texto (se disponível);
Salve o arquivo com essas configurações.
❓7. Como conferir se o CSV foi salvo corretamente?
Abra o arquivo com um editor de texto (ex: Bloco de Notas ou Notepad++).
Verifique se:
Todos os campos estão entre aspas (
"campo1";"campo2";...);Os campos estão separados por ponto e vírgula (
;).
Se estiver assim, o arquivo está pronto para ser importado novamente no sistema.
✅ Dica Final
Sempre que for importar arquivos CSV no sistema:
Use o LibreOffice;
Marque todos os campos como texto;
Verifique o conteúdo antes de importar;
Remova ou corrija valores inválidos, como o CBO "00".
Inversão da Ordem de Busca de Rede Credenciada
1. Visão Geral do Incidente
Resumo claro e direto do problema: Implementação da inversão da ordem de busca de rede credenciada (Especialidade -> Tipo Prestador) em um sistema projetado para a ordem oposta (Tipo Prestador -> Especialidade). Isso requer alterações de arquivos, dados e labels da UI, resultando em comportamentos específicos da interface que precisam ser validados e aceitos.
Tipo: Customização de Funcionalidade / Integração de Dados / Frontend (UI)
Severidade: Baixa a Média (depende da aceitação dos comportamentos secundários da UI). Não é uma falha que impede a operação, mas uma inconsistência funcional/visual.
Status: Mitigado via workaround (solução implementada, mas com ressalvas).
2. Contexto Técnico
Ambiente: Produção e/ou Staging (para testes e validação da customização).
Stack envolvida:
Cloud: Suposição de que a aplicação está hospedada em ambiente cloud.
Backend: Módulo de importação de dados de rede credenciada; lógica de busca da rede credenciada.
Frontend: Interface de busca da rede credenciada (painel público), painel de administração (para configuração de labels).
Dados: Arquivos de dados de rede credenciada (
rede_credenciada.xlsx), especialidades (especialidades.xlsx), e tipos de prestador (tipo_de_rede_credenciada.xlsx).
Componentes afetados:
Funcionalidade de busca de rede credenciada no portal do beneficiário.
Processo de importação de arquivos de rede credenciada.
Configurações de labels/textos na interface de administração.
Dependências externas: Não explicitamente mencionadas, mas o arquivo CBO (Classificação Brasileira de Ocupações) é referenciado como padrão para especialidades.
3. Sintomas Observados
Problema Original (antes da customização):
Busca linear: Plano -> Localização -> Tipo Prestador -> Especialidade.
Comportamentos Inesperados (após a customização, se não seguir todos os passos ou não aceitar as nuances):
Labels incorretas na UI: A interface de busca pode exibir "Tipo Prestador" onde deveria ser "Especialidade" e vice-versa, causando confusão para o usuário.
Dados incorretos após importação: Se a renomeação dos arquivos ou a inversão das colunas não for realizada corretamente, o importador pode falhar ou associar dados incorretamente, impedindo a busca funcionar.
Informação incorreta no rodapé da busca: Após a busca invertida, o campo exibido no rodapé (e.g., "Clínicas e Médicos") pode ser o "Tipo Prestador" em vez da "Especialidade", que seria o comportamento padrão do produto.
Detalhes do prestador não exibem especialidades: Ao selecionar um prestador específico após a busca invertida, as especialidades relacionadas a ele não são exibidas (comportamento original do produto, não compatível com a busca invertida).
4. Impacto
Usuários afetados: Beneficiários que utilizam a busca de rede credenciada.
Funcionalidades comprometidas: Experiência de busca da rede credenciada impactada por ordem não intuitiva ou labels incorretas. Exibição de informações contextuais (rodapé, detalhes do prestador) pode estar desalinhada com a nova lógica.
Escopo do incidente: Específico para a operadora que solicitou a customização. Potencialmente replicável em outras operadoras que busquem a mesma inversão sem seguir o guia.
5. Hipóteses de Causa
Sistema não projetado para busca inversa (Mais provável):
Descrição técnica: A arquitetura original do módulo de busca de rede credenciada foi desenvolvida com uma sequência rígida (Tipo Prestador -> Especialidade). Inverter essa lógica exige workarounds que manipulam a interpretação de dados e labels.
Evidências a favor: A transcrição afirma que "a busca de rede credenciada ela não foi, em primeira mão, não foi desenvolvida para fazer esse tipo de alteração, é por isso que tem essas nuances".
Configuração incorreta de arquivos de dados ou labels (Alto impacto):
Descrição técnica: Erro na renomeação dos arquivos de especialidade/tipo de prestador ou na inversão das colunas A e C no arquivo de rede credenciada. Ou, labels da UI não foram atualizadas corretamente no painel de administração.
Evidências a favor: O vídeo detalha exatamente as alterações necessárias nos nomes dos arquivos, na ordem das colunas e nas labels. Qualquer desvio resultaria nos sintomas observados.
Processo de importação de dados falho (Médio impacto):
Descrição técnica: Embora o importador faça validação apenas de "conteúdo" (não de "tipo"), um erro no formato do arquivo (CSV/XLSX), codificação, ou permissões pode impedir a importação bem-sucedida dos dados modificados.
Evidências a favor: Não explicitamente mencionado, mas é uma causa comum para problemas de dados. Suposição.
6. Passos de Diagnóstico (para validar a implementação da customização)
Este checklist foca em validar a correta aplicação dos workarounds e identificar inconsistências.
Verificação de Arquivos de Dados:
Confirmar que o arquivo nomeado
especialidades.xlsxcontém dados de Tipo Prestador.Confirmar que o arquivo nomeado
tipo_de_rede_credenciada.xlsxcontém dados de Especialidades.Abrir o arquivo
rede_credenciada.xlsxe verificar a ordem das colunas:Coluna A: Deve conter Tipo Prestador (Classe Prestadora).
Coluna C: Deve conter Especialidades (Código CBO).
Verificação do Processo de Importação:
Disparar manualmente o processo de importação dos arquivos modificados.
Inspecionar logs do importador para identificar erros ou avisos relacionados ao conteúdo ou formato dos arquivos.
Comando Sugerido (Suposição):
tail -f /var/log/minha_app/data_importer.log | grep -i "rede_credenciada|especialidade|prestador"Verificar se a importação foi concluída com sucesso.
Verificação de Configurações da UI (Painel Administrativo):
Acessar o painel administrativo da funcionalidade de busca de rede credenciada.
Navegar até a seção de "Parâmetros" e "Labels".
Confirmar que as seguintes labels foram alteradas conforme a inversão:
label_botao_especialidades:tipo prestador(originalmenteespecialidade)label_tipo_pesquisa_especialidades:tipo prestador(originalmenteespecialidades)botao_selecao_tipo_prestador:especialidade(originalmentetipo prestador)label_botao_selecao_especialidade:tipo prestador(originalmenteespecialidade)
Teste Manual da Funcionalidade de Busca (Frontend):
Acessar o portal público da operadora e a funcionalidade de busca de rede credenciada.
Passo 1: Selecionar Plano, Localização.
Passo 2: Verificar se o campo de seleção subsequente exibe "Especialidade" (deve ser o novo primeiro campo invertido).
Passo 3: Selecionar uma Especialidade (ex: Cardiologia).
Passo 4: Verificar se o campo de seleção subsequente exibe "Tipo Prestador" e oferece as opções corretas para a especialidade selecionada.
Passo 5: Realizar a busca e verificar os resultados.
Passo 6: Observar o texto exibido no rodapé da busca: deve estar mostrando o "Tipo Prestador" (comportamento conhecido e validado).
Passo 7: Clicar em um prestador nos resultados da busca e verificar os detalhes: confirmar que as especialidades do prestador não são exibidas (comportamento conhecido e validado).
7. Análise Técnica
O que foi investigado: A forma como o sistema processa os arquivos de dados para a busca e a flexibilidade das labels da interface.
O que foi descartado: A possibilidade de uma solução de software que naturalmente inverta a ordem da busca sem side effects, devido à afirmação de que "não foi desenvolvida para fazer esse tipo de alteração".
Correlações encontradas:
O importador de dados valida o conteúdo das colunas em relação aos arquivos mestre, não o nome semântico da coluna. Isso permite a "trapaça" de renomear arquivos e inverter colunas, desde que os conteúdos se alinhem.
A configuração de labels na UI é independente da lógica de busca de dados, permitindo a correção visual das inconsistências sem alterar o backend.
A alteração força o sistema a tratar o "Tipo Prestador" como o "último campo" da busca para fins de exibição no rodapé, e a lógica de detalhes do prestador não foi adaptada para a nova sequência, resultando nas nuances observadas.
8. Causa Raiz (Root Cause)
Explicação técnica clara: A causa raiz para a complexidade da implementação e os side effects é a arquitetura do sistema de busca de rede credenciada não ser flexível o suficiente para permitir a inversão nativa da ordem dos campos de busca (
Tipo Prestador<->Especialidade). O produto foi desenhado para uma sequência linear específica, e qualquer desvio requer uma série de workarounds manuais na preparação dos dados e na configuração da UI, introduzindo inconsistências controladas.Cadeia de eventos que levou ao problema:
Requisito de negócio para buscar por "Especialidade" antes de "Tipo Prestador".
Sistema atual suporta apenas "Tipo Prestador" antes de "Especialidade".
Para atender ao requisito, foram propostos workarounds:
Troca lógica de nome de arquivos de dados.
Troca física da ordem das colunas de dados no arquivo principal.
Troca de labels na interface do usuário.
Esses workarounds, embora funcionais, levam a inconsistências de exibição na UI (rodapé, detalhes do prestador) porque o sistema subjacente não foi alterado para entender a nova semântica, apenas os dados e a apresentação superficial.
9. Solução / Mitigação
Ação aplicada: Implementação de um conjunto de workarounds que manipulam a interpretação dos arquivos de dados pelo importador e ajustam as labels da UI para simular a ordem de busca desejada.
Workaround:
Renomeação lógica de arquivos: Trocar o conteúdo dos arquivos
especialidades.xlsxetipo_de_rede_credenciada.xlsx. O arquivo nomeadoespecialidades.xlsxpassa a conter dados de tipo de prestador, e o arquivo nomeadotipo_de_rede_credenciada.xlsxpassa a conter dados de especialidades.Inversão de colunas em
rede_credenciada.xlsx: A coluna A passa a conter "Tipo Prestador" e a coluna C passa a conter "Especialidades".Ajuste de labels na UI: Alterar os textos dos campos de busca no painel administrativo para refletir a nova ordem.
Riscos da solução: Inconsistências visuais permanentes no rodapé da busca e nos detalhes do prestador, risco de confusão do usuário se a comunicação não for clara, maior complexidade na manutenção dos arquivos de dados, e a solução pode ser frágil a futuras atualizações do produto.
10. Passos de Correção
Este guia assume que as importações anteriores ou configurações de label estão incorretas e precisa ser revertido/ajustado.
Preparação dos Arquivos de Dados:
Passo 1.1: Criar backups dos arquivos
especialidades.xlsx,tipo_de_rede_credenciada.xlsxerede_credenciada.xlsxatuais.Passo 1.2: Inverter conteúdo dos arquivos mestre:
Pegue o arquivo que atualmente está nomeado
especialidades.xlsx.Pegue o arquivo que atualmente está nomeado
tipo_de_rede_credenciada.xlsx.Troque os nomes dos arquivos. Ou seja: o arquivo com conteúdo de Especialidades deve ser renomeado para
tipo_de_rede_credenciada.xlsx. O arquivo com conteúdo de Tipo Prestador deve ser renomeado paraespecialidades.xlsx.
Passo 1.3: Inverter colunas no arquivo de rede credenciada:
Abra o arquivo
rede_credenciada.xlsx.Identifique a coluna de "Código CBO" (Especialidades) e a coluna de "Classe Prestadora" (Tipo Prestador).
Mova ou copie o conteúdo da coluna "Classe Prestadora" (Tipo Prestador) para a Coluna A.
Mova ou copie o conteúdo da coluna "Código CBO" (Especialidades) para a Coluna C.
Verificação: Após a alteração, a Coluna A deve ter o Tipo Prestador e a Coluna C deve ter a Especialidade.
Passo 1.4: Salvar e importar arquivos: Salve as alterações nos arquivos e realize o processo de importação de dados no sistema.
Configuração das Labels no Painel Administrativo:
Passo 2.1: Acessar o Painel de Administração: Navegue até a funcionalidade de busca de rede credenciada e, em seguida, para "Parâmetros" e "Labels".
Passo 2.2: Alterar os valores das labels:
Campo
label_botao_especialidades: Altere o valor deespecialidadeparatipo prestador.Campo
label_tipo_pesquisa_especialidades: Altere o valor deespecialidadesparatipo prestador.Campo
botao_selecao_tipo_prestador: Altere o valor detipo prestadorparaespecialidade.Campo
label_botao_selecao_especialidade: Altere o valor deespecialidadeparatipo prestador.
Passo 2.3: Salvar alterações: Confirme e salve as novas configurações de label.
11. Validação da Solução
Como confirmar que o problema foi resolvido:
Testes funcionais completos (manual): Realize o "Teste Manual da Funcionalidade de Busca (Frontend)" detalhado na Seção 6.
Logs esperados: O log do importador deve indicar sucesso na importação dos arquivos (sem erros de validação de conteúdo).
Métricas estabilizadas: Não aplicável diretamente, mas monitorar a latência da busca e o volume de acessos pode ser útil.
Verificação visual da UI: Confirme que todos os campos de busca e botões relacionados estão exibindo as labels corretas conforme a nova ordem (Especialidade -> Tipo Prestador).
Validação interna: Certifique-se de que a equipe e a operadora aceitam as "nuances" da UI (rodapé exibindo Tipo Prestador, detalhes do prestador não exibindo especialidades).
12. Monitoramento e Prevenção
Alertas recomendados:
Alerta sobre falha na importação de arquivos de rede credenciada.
Alerta sobre picos anormais de erros no backend (associados à busca de rede credenciada).
Monitoramento de erros de JavaScript no console do navegador para a página de busca.
Métricas a acompanhar:
Taxa de sucesso/erro das buscas de rede credenciada.
Latência média da busca.
Número de acessos à funcionalidade de busca.
Suposição: Métricas de importação de dados (tempo, sucesso/falha).
Melhorias sugeridas:
Desenvolvimento de feature nativa: A longo prazo, a melhor solução é implementar uma feature nativa que permita configurar a ordem dos campos de busca diretamente no sistema, sem a necessidade de workarounds com arquivos e labels.
Documentação clara: Manter uma documentação detalhada sobre essa customização, incluindo os passos de configuração e as nuances de comportamento, para futuras referências ou novas operadoras.
Testes automatizados: Desenvolver testes automatizados (end-to-end) para a funcionalidade de busca, incluindo a ordem invertida, para garantir que futuras atualizações não quebrem o workaround.
13. Logs, Métricas e Evidências
Logs de Importação de Dados (exemplo - Suposição):
[2023-10-27 10:00:01] INFO DataImporter - Iniciando importação de 'especialidades.xlsx' (renomeado logicamente para Tipo Prestador) [2023-10-27 10:00:05] INFO DataImporter - 'especialidades.xlsx' importado com sucesso. Registros processados: 150 [2023-10-27 10:00:06] INFO DataImporter - Iniciando importação de 'tipo_de_rede_credenciada.xlsx' (renomeado logicamente para Especialidades) [2023-10-27 10:00:10] INFO DataImporter - 'tipo_de_rede_credenciada.xlsx' importado com sucesso. Registros processados: 200 [2023-10-27 10:00:11] INFO DataImporter - Iniciando importação de 'rede_credenciada.xlsx' [2023-10-27 10:00:30] INFO DataImporter - 'rede_credenciada.xlsx' importado com sucesso. Registros processados: 50000Configurações de Labels (do painel admin):
{ "label_botao_especialidades": "tipo prestador", "label_tipo_pesquisa_especialidades": "tipo prestador", "botao_selecao_tipo_prestador": "especialidade", "label_botao_selecao_especialidade": "tipo prestador" }Comportamento da UI (observado):
Campo "Especialidade" aparece antes de "Tipo Prestador" na sequência de busca.
Rodapé da busca exibe o "Tipo Prestador" do resultado da busca, não a "Especialidade".