A atualização do dicionário de dados através do programa U_IMPXACI é essencial para garantir que as tabelas do Importador de XML da Qive estejam sincronizadas com as últimas evoluções do ERP, permitindo a correta recepção e gestão de documentos fiscais.
Pré-requisitos para a atualização
Para que o processo de atualização (compatibilizador) ocorra sem falhas, certifique-se de cumprir os pontos abaixo:
Modo exclusivo: O ambiente do Protheus deve estar totalmente livre de usuários ou outras rotinas ativas no momento da execução.
Backup preventivo: Recomendamos realizar um backup do dicionário de dados (arquivos SXs) e do banco de dados antes de iniciar o procedimento.
Passo a passo de execução
1. Aplicação do pacote de atualização: Antes de rodar o programa de atualização, é obrigatório que o pacote de atualização do Importador de XML já tenha sido aplicado via AppServer/Patch. Caso ainda não tenha feito, clique no botão abaixo para verificar os pacotes mais recentes.
2. Início da função U_IMPXACI: Acesse o Smartclient do seu ambiente Protheus e, no campo de Programa Inicial, digite a função U_IMPXACI.
3. Tela Inicial do wizard de atualização: Assim que a tela do assistente for carregada, clique em Avançar > para iniciar o processo de validação das tabelas e integridade do sistema.
4. Seleção da empresa e filial: Nesta etapa, escolha a empresa onde a atualização deve ser aplicada.
Importante: O processo deve ser realizado em uma empresa por vez. Se você possui múltiplas empresas, repita este procedimento para cada uma delas individualmente após a conclusão da primeira.
5. Configuração do portal de integração: O sistema solicitará que você confirme qual portal será utilizado para a captura dos documentos fiscais (XMLs). Certifique-se de selecionar a opção Qive. Caso o campo já apresente o valor correto, basta clicar em Avançar >.
6. Definição de novas tabelas (Ações necessárias): Em algumas atualizações, o sistema pode solicitar a criação de novas tabelas técnicas para suporte a novos tipos de documentos ou regras fiscais.
Se o sistema pedir o nome de uma nova tabela, utilize o botão Tabelas Em Uso para conferir quais nomes já existem no seu banco de dados e escolha um nome inédito.
Se o seu ambiente já estiver com o dicionário atualizado, o sistema exibirá a mensagem: "Nenhuma ação é necessária!".
7. Análise de integridade e duplicidades: O programa realiza uma varredura automática em busca de registros duplicados na tabela principal de integração (vinculada ao parâmetro MV_XGTTAB1).
Se duplicidades forem encontradas: Você pode analisar o log para entender a origem ou clicar em Continuar para que o sistema realize o ajuste automático e a limpeza de registros legados obsoletos (como cartas de correção e cancelamentos antigos).
Atenção: A existência de registros duplicados nesta tabela técnica não significa que houve lançamentos duplicados no Protheus, pois o sistema mantém índices únicos de segurança na tabela SF1.
8. Resumo e conclusão: O Wizard exibirá um resumo final com todas as alterações estruturais que serão aplicadas ao seu banco de dados. Clique em Concluir e aguarde a barra de progresso atingir 100%.
Observações técnicas importantes
Registros legados: A rotina de atualização aproveita o processo para limpar dados de versões obsoletas, otimizando a performance da sua integração de documentos fiscais e reduzindo o peso do banco de dados.
Erros na execução: Caso o processo seja interrompido por queda de conexão ou erro crítico de banco, restaure o backup efetuado no pré-requisito e tente a execução novamente, garantindo o modo exclusivo.
Se encontrar dificuldades durante a atualização, entre em contato com nosso time técnico através do e-mail suporte@qive.com.br.