Wizard Configuração

<aside> 🧙

O Wizard de Configuração (Assistente de configuração da Central NF-e/CT-e) é a rotina que configura e-mail, perfis de usuários, parâmetros fiscais/NF-e/CT-e e cria/atualiza as tabelas da Central XML®. Ele grava os parâmetros XM_* na SX6 da empresa logada e cria as tabelas CONDOR* diretamente no banco de dados. Fonte: CriaTblXml.prx → U_MLCRTBLX()

</aside>

Quando o Wizard é aberto

Abertura obrigatória (forçada)

O Wizard é exibido automaticamente ao entrar na Central XML® quando:

a versão gravada no parâmetro XM_CTRLVRS é anterior à versão compilada da rotina — mensagem "Favor rodar o Wizard para contemplar as melhorias versão '...'";
o índice único CONDORXML_UNQ da tabela principal ainda não existe no banco — mensagem "Favor rodar o Wizard para aplicar indice Unique da tabela principal da Central XML®!".

Nesses casos somente um usuário Administrador consegue prosseguir. Para os demais usuários a rotina não abre até que o Wizard seja executado por um administrador. Se a criação/atualização das tabelas da Etapa 6 falhar, a Central XML® não é aberta.

Abertura opcional

Fora dos casos acima, ao entrar na rotina é exibida a tela Seleção de função para os usuários que atendem a pelo menos uma condição:

usuário com perfil de Administrador;
ID do usuário contido no parâmetro XM_USRLBWZ;
grupo do usuário contido no parâmetro XM_GRPLBWZ.

Opção	O que faz
Rodar Wizard	Abre o assistente completo (etapas abaixo). Execute somente quando for necessário fazer alguma reconfiguração.
Selecionar Usuários	Atalho para configurar os perfis de usuários (Escrita Fiscal, Compras e Recebimento) sem passar pelo Wizard. Detalhes em Etapa 3 - Parâmetros Fiscais.
Resetar Liberação	Disponível apenas quando faltam menos de 5 dias para expirar a liberação. Redefine a data de expiração.
Cancelar	Segue para a Central XML® sem rodar o Wizard.

<aside> ℹ️

O Wizard nunca é aberto nas execuções automáticas (jobs U_MLNFEAUT e U_APXMLAUTO). Antes de qualquer tela, a rotina valida a liberação da Central XML® e exibe um aviso quando faltam menos de 5 dias para a expiração.

</aside>

Antes de começar

Tenha em mãos os dados da conta de envio (SMTP) e da conta de recebimento (POP3/IMAP) dos XMLs: servidor, porta, usuário, senha e tipo de conexão segura (SSL/TLS).
O ambiente precisa ter a chave TOPMEMOMEGA=1 (na seção do ambiente, [TopConnect] ou [DBAccess]). Se ela não for encontrada, o Wizard tenta gravá-la no appserver.ini; se não conseguir, a Etapa 1 não avança.
Para uso de IMAP, a seção [MAIL] do appserver.ini deve ter Protocol=IMAP e Folder=Inbox; para POP3, Protocol=POP3. O Wizard oferece gravar essas chaves (e SSLVersion=2) automaticamente.
Os parâmetros são gravados na filial definida por XM_SX6_FIL (padrão: filial da SX6 conforme o compartilhamento da tabela). Execute o Wizard em cada grupo de empresas — ao final é possível replicar o controle de versão para as demais empresas.
Na primeira execução todos os parâmetros XM_* são criados na SX6 com seus valores padrão, inclusive os que não aparecem nas telas. Eles podem ser ajustados depois pelo Configurador ou pela rotina de parâmetros da Central XML® (U_ML1XLPAR).