Manual Configuração

Manual de Configuração
Manual de Atualização e Configuração

Versão 4XML - 2022
Versão
Versão 7.0Versão4XML
7.0 - 2022 11
MS
Sumário
ração
1 Introdução .................................................................................................... 4
2 O que é 4XML? ................................................................................................ 5
3 Fluxo de Atualização ........................................................................................ 6
4 Processos para atualização ................................................................................. 7
4.1 Aplicação da Patch ..................................................................................... 7
4.2 Wizard de Configuração / Atualização das Tabelas ..............................................11
5 Parâmetros e Configurações do Wizard .................................................................14
5.1 Etapa 1 – Boas Vindas .................................................................................14
5.2 Etapa 2 e 3 - Configurações de E-mail .............................................................15
5.2.1 Etapa 2 – Configuração SMTP ...................................................................16
5.2.2 Etapa 3 – Configuração Pop ....................................................................18
5.3 Etapa 4 – Configuração NF-e / CT-e ................................................................20
5.4 Etapa 5 - Configuração Espião .......................................................................36
5.4.1 Mapeamento do caminho da pasta Certs (TSS) ..............................................37
5.4.2 Inserção do arquivo e senha do certificado ..................................................38
5.4.3 Cópia dos arquivos ‘.pem’ para o diretório cerconf........................................41
5.4.4 Configuração NFSe ...............................................................................42
5.5 Etapa 6 - Configurações BPO ........................................................................43
Etapa 7 - Integração Fluig ....................................................................................45
5.6 Etapa 8 - Integração OCR ............................................................................46
5.7 Etapa 9 – Finalização..................................................................................47
6 Configuração de Jobs.......................................................................................49
6.1 Download de Notas Fiscais Eletrônicas.............................................................50
6.2 Download de Conhecimento de Transporte .......................................................52
6.3 Download dos XML por e-mail .......................................................................54
Versão
7.0 - 2022 22
MS
6.4 Informações adicionais da configuração ...........................................................56
7 Informações técnicas .......................................................................................57
7.1 Tabelas da 4XML .......................................................................................57
7.2 Pontos de entrada .....................................................................................58
7.3 Configurações / Parâmetros ocultos da 4XML ....................................................60
7.4 Parâmetros padrões Protheus .......................................................................62
Versão
7.0 - 2022 33
MS
1 Introdução
Este documento tem como objetivo capacitar e orientar os usuários administradores do sistema
Totvs/Protheus a realizar a atualização da ferramenta, realizar a configuração do certificado
digital e configurar os parâmetros do Wizard de Configuração. Como pré-requisito é importante
ter conhecimento na ferramenta VSCode para aplicação do pacote.
Informamos que os itens NFSe, OCR, BPO, Conferência Cega e Portaria não estão contemplados
na instalação padrão da 4XML, para maiores informações solicite uma apresentação à nossa equipe
comercial!
Versão
7.0 - 2022 44
MS
2 O que é 4XML?
Observando a grande quantidade de dados preenchidos e a quantidade de erros destes
preenchimentos, devido ao processo operacional, durante o lançamento de documentos fiscais
no TOTVS Protheus, foi pensada em uma solução que poderia automatizar o lançamento das
entradas encurtando o processo operacional.
Deste modo foi desenvolvida a 4XML, uma ferramenta que agiliza o processo de lançamento de
notas ficais eletrônicas, conhecimentos de transportes eletrônico e notas fiscais de serviço
através do preenchimento automático da maioria das informações, garantindo a integridade dos
documentos pela possibilidade da realização do download do XML direto do site da Sefaz ou
realizar a importação do xml através do recebimento por e-mail enviado pelo fornecedor.
Versão
7.0 - 2022 55
MS
3 Fluxo de Atualização
Encerrar qualquer conexão de

usuário/job que esteja utilizando a
rotina da Central XML
*O acesso exclusivo é somente na ferramenta, o sistema pode ser acessado normalmente.
Versão
7.0 - 2022 66
MS
4 Processos para atualização

Para atualização completa da ferramenta será necessário realizar somente dois processos:
Aplicação da Patch e Execução do Wizard de Configuração.
4.1 Aplicação da Patch
Periodicamente ocorrem atualizações da ferramenta que são registradas através de boletins

enviados por e-mail juntamente com um pacote/pach de atualização (arquivo.ptm). O pacote
possui a seguinte nomenclatura:
4XML V12_20210601_V7.0_LG.PTM
• Nome do Programa: 4XML;

• Versão do Protheus: V12 = Versão 12;
• Data de Geração: 20210601 = 01/06/2021 – se lê de trás para frente, pois segue o
formato de data internacional definido pelo ISO 8601;
• Versão do Programa: V7.0 = 7.0;
• Release do Sistema: Quando informado LG = Lobo Guará - versão 12.1. 23 em diante.
• Release do Sistema: Quando não informado = versão 12.1.17 somente;
• Extensão do arquivo pacote/patch: PTM.
Figura 1 - Arquivo da Patch 4XML
Versão
7.0 - 2022 77
MS
Para iniciar o processo de atualização, faça o download do arquivo do pacote/patch

recebido e salve em um local no servidor visível pelo software VS Code que utilizaremos para
aplicação.
Figura 2 - VSCode: Localização da Patch
Conecte-se no ambiente, configurado anteriormente, que foi escolhido para aplicação do pacote,
este ambiente deve estar totalmente exclusivo (sem nenhum usuário conectado).
Figura 3 - VSCode: Seleção do Ambiente
Versão
7.0 - 2022 88
MS
Depois de realizada a conexão, clique com o botão direito do mouse em cima do arquivo do
pacote salvo e clique em Patch Apply from file (Aplicar pacote do arquivo).
Figura 4 - Aplicação da Patch
Versão
7.0 - 2022 99
MS
O pacote será aplicado no RPO do ambiente conectado anteriormente, neste exemplo no

ambiente PRODUCAO. Caso o processo ocorra corretamente será apresentada a mensagem “...
successfully applied.” na saída, informando que a aplicação ocorreu com sucesso.
Figura 5 - Mensagem de processo finalizado com sucesso
Caso haja contrário será apresentada a mensagem “Start build error:...” e a causa do erro, neste
exemplo, não foi possível obter acesso exclusivo ao repositório de objetos (rpo).
Figura 6 - Mensagem de processo finalizado com erro
Versão
7.0 - 2022 1010
MS
4.2 Wizard de Configuração / Atualização das Tabelas
Acessar o sistema, com um usuário com perfil de administrador, no módulo onde foi instalada a
rotina da 4XML, geralmente, no ambiente de Compras – SIGACOM (02) > Atualizações > 4XML >
Gerenciador 4XML.
Atenção: somente o usuário administrador possui acesso ao Wizard de Configuração da

ferramenta. Em qualquer momento este usuário poderá alterar as configurações.
Se não houver nenhuma configuração a ser alterada na atualização a ser feita, no Wizard de
configuração, avance por todas as etapas até a última.
Versão
7.0 - 2022 1111
MS
Na última etapa será apresentada a tela para criação / atualização das tabelas da ferramenta.
Atenção, para que a ferramenta possa realizar a atualização, é necessário que neste momento
não haja nenhum usuário ou Job acessando as tabelas da 4XML, ou seja, o acesso à ferramenta
deve ser exclusivo.
Clique em SIM para que seja feita a atualização completa. Caso não seja realizado este processo,
ao acessar a ferramenta pode ocorrer uma série de erros devido a divergências entre as instruções
do programa e o dicionário de dados.
Sendo assim, a execução do Wizard de Configuração torna-se obrigatória toda vez que haja
necessidade de atualização da ferramenta.
Se ocorrer a atualização corretamente do dicionário de dados, será apresentada a tela a seguir.
Versão
7.0 - 2022 1212
MS
Como forma de validação da atualização é possível observar a data da versão da 4XML localizada
no Menu Inicial no rodapé à direita. Esta deve estar com a mesma data informada na
nomenclatura da patch recebida.
Versão
7.0 - 2022 1313
MS
5 Parâmetros e Configurações do Wizard

Os parâmetros e configurações disponíveis permitem utilizar uma série de recursos que podem
auxiliar os processos dos usuários e processos gerenciais no dia a dia. A seguir serão detalhadas
todas as etapas do Wizard de Configuração.
5.1 Etapa 1 – Boas Vindas
A tela inicial apresentada no Wizard traz a tela de ‘Boas Vindas’ com a informação da versão do
programa, neste caso V7.0.
Versão
7.0 - 2022 1414
MS
5.2 Etapa 2 e 3 - Configurações de E-mail
Para que haja redundância dos dados, ou seja, a duplicação de componentes para garantir serviço
ininterrupto e evitar falha no recebimento dos XML, a configuração do e-mail é obrigatória.
Com esse recurso é possível assegurar o recebimento dos XML mesmo que haja indisponibilidade
ou conexão intermitente dos WebServices da Secretaria da Fazenda, o e-mail fará a captura dos
XML (NFe, CTe e NFSe) enviados pelos fornecedores via e-mail.
Como premissa é necessário realizar a criação de um e-mail exclusivo para a ferramenta, pois
esta, ao acessar a caixa de entrada para realizar a baixa, faz a exclusão de todos os e-mails
recebidos sendo inviável a utilização do e-mail por um colaborador.
Versão
7.0 - 2022 1515
MS
5.2.1 Etapa 2 – Configuração SMTP

A configuração SMTP é utilizada para que a ferramenta possa utilizar os recursos abaixo:
• Envio de alertas no e-mail quando ocorrer o lançamento de uma Nota Fiscal Eletrônica;
• Envio de alertas no e-mail quando ocorrer o lançamento de um Conhecimento de Transporte
Eletrônico;
• Envio de alertas no e-mail quando ativado o lançamento automático de prenota;
• Envio de alertas no e-mail quando ativada a classificação automática;
• Envio de alertas no e-mail quando for realizado o estorno de uma prenota manifestando
Operação não Realizada.
smtp.seudominio.com.br
587
seuemail@seudominio.com.br
suasenha
Atenção, orientamos a utilização de um e-mail exclusivo criado pela empresa para a

ferramenta.
Quando a hospedagem for contratada de terceiros, será necessário solicitar a informação das
configurações para os mesmos.
Versão
7.0 - 2022 1616
MS
O preenchimento pode ser feito conforme o exemplo abaixo, da hospedagem na Locaweb:
Servidor SMTP? smtplw.com.br - Disponibilizado pela Locaweb

Porta? 587 (sem criptografia) ou 465 (SSL/TLS) - Disponibilizado pela Locaweb
Login E-mail? 4XML@seudominio.com.br - Exemplo de e-mail exclusivo
Senha? senhacadastrada
Conta de Email? 4XML@seudominio.com.br - Exemplo de e-mail exclusivo
Usa SSL (Verifique se utiliza a criptografia SSL)
Autenticação Marcar
Usa TSL (Verifique se utiliza a criptografia TSL)
Após configurações realizadas, clique no botão Avançar.
A ferramenta irá validar as informações inseridas apresentando a mensagem abaixo com retorno
de sucesso ou falha. E também fará um disparo de e-mail teste.
Email enviado para seuemail@seudominio.com.br
Atenção, caso não possua as informações de e-mail ou não queira utilizar o recurso basta
clicar em avançar para a próxima janela sem o preenchimento dos campos.
Versão
7.0 - 2022 1717
MS
5.2.2 Etapa 3 – Configuração Pop

A configuração POP é utilizada para que a ferramenta possa utilizar os recursos abaixo:
• Baixa automática dos XML pelo e-mail;
• Baixa dos XML pelo botão ‘E-mail’.
pop.seudominio.com.br
995
suasenha
Atenção, orientamos a utilização de um e-mail exclusivo criado pela empresa para a

ferramenta, pois ao realizar o acesso na caixa de entrada, a ferramenta exclui todos os
e-mails.
Quando a hospedagem for contratada de terceiros, será necessário solicitar a informação das
configurações para os mesmos.
Versão
7.0 - 2022 1818
MS
O preenchimento pode ser feito conforme o exemplo abaixo, da hospedagem na Locaweb:
Servidor POP? email-ssl.com.br- Disponibilizado pela Locaweb

Porta? 995 - Disponibilizado pela Locaweb
Login? 4XML@seudominio.com.br - Exemplo de e-mail exclusivo
Senha? senhacadastrada
Usa SSL (Verifique se utiliza a criptografia SSL)
Usa TSL (Verifique se utiliza a criptografia TSL)
Após configurações realizadas, clique no botão Avançar.
A ferramenta irá validar as informações inseridas apresentando a mensagem abaixo com retorno
de sucesso ou falha.
Atenção, caso não possua as informações de e-mail ou não queira utilizar o recurso basta
clicar em avançar para a próxima janela sem o preenchimento dos campos.
Versão
7.0 - 2022 1919
MS
5.3 Etapa 4 – Configuração NF-e / CT-e
Nesta etapa há uma série de configurações e parâmetros que permitem utilizar recursos que
podem auxiliar os processos dos usuários e processos gerenciais no dia a dia. A seguir
detalharemos cada um dos itens.
ID Usuários Escrita Fiscal?

Neste parâmetro é possível escolher quais os usuários poderão realizar a classificação dos
documentos caso seja necessário fazer esta limitação. Para configuração, deverão ser inseridos os
códigos dos usuários separados por ‘#’ cerquilha. Exemplo: 000001#000006#000027.
Caso não seja preenchido, vai permitir a classificação por todos os usuários.
Versão
7.0 - 2022 2020
MS
ID Usuários Compras?
Neste parâmetro é possível escolher quais os usuários poderão realizar o lançamento da prenota
caso seja necessário fazer esta limitação. Para configuração, deverão ser inseridos os códigos dos
usuários separados por ‘#’ cerquilha. Exemplo: 000001#000006#000027.
Caso não seja preenchido, vai permitir o lançamento da prenota por todos os usuários.
ID Usuários Alteram Pedido?

Neste parâmetro é possível escolher quais os usuários poderão fazer a alteração do pedido de
compras caso seja necessário fazer esta limitação. A ferramenta respeita as regras padrões de
controle de alçadas do módulo SIGACOM - Compras. Para configuração, deverão ser inseridos os
códigos dos usuários separados por ‘#’ cerquilha. Exemplo: 000001#000006#000027.
Caso não seja preenchido, vai permitir a alteração do pedido de compras por todos os usuários.
Pedido de Compra NF-e?

Caso seja necessário tornar a amarração do pedido de compras para Notas Fiscais de Eletrônicas
obrigatória na ferramenta, basta ativar este parâmetro e ao tentar lançar a prenota sem a
amarração será apresentada uma mensagem de alerta não permitindo o lançamento.
Se o parâmetro MV_PCNFE no padrão do Protheus estiver preenchido (.T.), a ferramenta

irá respeitar esta configuração automaticamente.
Versão
7.0 - 2022 2121
MS
Pedido de Compra CT-e?

Caso seja necessário tornar a amarração do pedido de compras para Conhecimentos de
Transportes obrigatória na ferramenta, basta ativar este parâmetro e ao tentar lançar a prenota
sem a amarração será apresentada uma mensagem de alerta não permitindo o lançamento.
Se o parâmetro MV_PCNFE no padrão do Protheus estiver preenchido (.T.), a ferramenta

irá respeitar esta configuração automaticamente.
Destinatários Inclusão NF-e?

Para envio de alerta no e-mail quando ocorrer o lançamento de uma Nota Fiscal Eletrônica,
preencher com a conta de e-mail que deverá receber o alerta. Para inserir mais de um e-mail
deverá ser separado por ponto e vírgula.
Destinatários Inclusão CT-e?

Para envio de alerta no e-mail quando ocorrer o lançamento de um Conhecimento de Transporte
Eletrônico, preencher com a conta de e-mail que deverá receber o alerta. Para inserir mais de um
e-mail deverá ser separado por ponto e vírgula.
Versão
7.0 - 2022 2222
MS
Produto de Frete?
Caso haja um produto de Conhecimento de Transporte padrão utilizado pela empresa, o mesmo
deverá ser inserido neste parâmetro. Se preenchido, todos os XML de CTe carregarão este código
automaticamente.
Completa Série com Zeros à Esquerda?

Esse parâmetro define se completa a série com zeros a esquerda no lançamento no sistema ou
não.
Não considera CTe?

Esse parâmetro define se considera CT-e de Compra como Conhecimento de Frete (rotina
MATA116) ou se a entrada será feita pelo Documento de Entrada (rotina MATA103).
Fazer a habilitação do parâmetro caso todo e qualquer frete de compra seja lançado diretamente
pelo Documento de Entrada (Prenota e Classificação).
Exemplo:
Versão
7.0 - 2022 2323
MS
CFOP’s que utilizam cliente?

Esse parâmetro será preenchido com as CFOP’s mais utilizadas das notas de devolução de cliente.
A ferramenta pode receber XML tanto de fornecedores quanto devolução de clientes, esse
parâmetro foi criado para diferir quando a nota for considerada de fornecedor ou cliente. Nesse
campo se houver mais de um CFOP deve ser separado por ‘#’ cerquilha.
Permite classificar NF Sem Consultar Sefaz?

Esse parâmetro define se ao classificar o documento pela 4XML será realizada uma consulta no
SEFAZ para validar o XML através da chave de acesso.
Caso este parâmetro estiver desabilitado, o usuário sempre será obrigado a realizar a
consulta da Chave de acesso na Sefaz para validação do XML na classificação do
documento. Orientamos manter o parâmetro padrão MV_CHVNFE = .T., desta forma, o parâmetro
da 4XML não será considerado respeitando o parâmetro padrão.
Código do Produto Fornecedor na SA5?

Esse parâmetro é preenchido com o nome do campo do código do Produto x Fornecedor na tabela
SA5 padrão, só deverá ser alterado caso o Produto x Fornecedor utilizar uma tabela customizada.
Caso precise mudar a tabela será necessário programar em um ponto de entrada.
Versão
7.0 - 2022 2424
MS
Pergunta se altera data?

Esse parâmetro define se os usuários terão permissão para alterar a data base do sistema na 4XML
no momento do lançamento.
Este parâmetro atua em conjunto com a permissão do usuário no padrão do sistema.
Considera CST original do XML?

Esse parâmetro pergunta se será considerado o CST original do XML.
Considera Ped. Compra do XML?

Esse parâmetro define se serão preenchidos o número e item do pedido de compras vindos da Tag
do XML, preenchido anteriormente pelo fornecedor na emissão da nota fiscal.
Com o preenchimento destas informações, nas tags <xPed> e <nItemPed>,

automaticamente a 4XML irá buscar o pedido de compras no sistema para amarração,
tornando o processo de lançamento mais ágil. Se estes campos vierem com dados incorretos, será
apresentada uma tela de alerta na ferramenta.
Versão
7.0 - 2022 2525
MS
Permite alterar preço unitário?

Este parâmetro define se os usuários terão permissão para alterar o preço unitário e quantidade
do item na tela da 4XML para o lançamento da Prenota.
Este recurso é muito utilizado quando não há o cadastro da 2ª unidade de medida no

cadastro do produto, possibilitando assim manipulação manualmente dos dados.
Manifesta Automaticamente?
Esse parâmetro define se o sistema irá realizar automaticamente o manifesto de Confirmação da
Operação da Nota Fiscal-após classificação do documento.
Orientamos a análise junto à contabilidade para ativação deste recurso, pois o mesmo
confirma para a SEFAZ (Secretaria da Fazenda) que os produtos foram recebidos
corretamente.
Desabilita Botão Sincronizar?

Este parâmetro desabilita o botão de sincronizar na tela do espião para que o usuário não faça a
utilização indevida do recurso.
Versão
7.0 - 2022 2626
MS
Bloqueia classificação de NF-e?

Esse parâmetro tem como objetivo bloquear a classificação da Nota Fiscal Eletrônica caso tenha
sido cancelada pelo emitente.
Para o funcionamento adequado deste recurso é fundamental habilitar os parâmetros

padrões do Protheus: MV_CHVNFE - MV_DCHVNFE - MV_BCHVNFE. Para que possam sempre
validar os XML na Sefaz no momento da classificação.
Criar registro automático na SA5?

Esse parâmetro pergunta se deseja criar um registro automático na tabela padrão SA5, caso
encontre o código de barras no produto.
Para o funcionamento desse recurso a tag <cEAN> do arquivo XML deve estar preenchida e
no cadastro do produto deve estar com o mesmo código do arquivo XML.
Salvar XML CT-e (GFE)?

Esta opção solicita que informe o diretório onde os arquivos XML de Frete devem ser salvos
quando é utilizada a integração com o módulo SIGAGFE - Gestão de Frete Embarcador do Totvs
Protheus.
A 4XML mantém por padrão um backup de todos os XML recebidos no diretório da

Protheus_Data > 4XML > XML > CT-e.
Versão
7.0 - 2022 2727
MS
Consultar CT-e na SEFAZ?

Esse parâmetro tem como objetivo bloquear a classificação do Conhecimento de Transporte
Eletrônico caso tenha sido cancelado pelo emitente.
Para o funcionamento adequado deste recurso é fundamental habilitar os parâmetros

padrões do Protheus: MV_CHVNFE - MV_DCHVNFE - MV_BCHVNFE. Para que possam
sempre validar os XML na Sefaz.
Permite lançar documento com Status Divergente?

Esse parâmetro define se será permitido o lançamento do documento com o status divergente, a
4XML irá validar apenas o Número, Série ou Chave de Acesso da do documento, caso todo o
processo de lançamento não tenho sido realizado pela ferramenta.
Ativa Conferência Cega?

Este parâmetro ativa o Controle de Portaria e Conferência Cega, deverá ser habilitado para de
bloquear o lançamento sem conferência física dos produtos. Para contratação deste recurso entre
em contato com a nossa equipe do comercial.
Versão
7.0 - 2022 2828
MS
Quanto à impressão da DANFE?

Esse parâmetro permite a visualização e a impressão do DANFE (Documento Auxiliar da Nota Fiscal
Eletrônica) com base no arquivo XML recebido pela ferramenta. Pode ser configurado de duas
formas, executável ou imprime PDF.
Chama Executável: Essa opção possibilita ao usuário a chamada de uma aplicação instalada
individualmente na máquina do usuário como, por exemplo, o software Danfe View.
Imprime PDF: Impressão em formato PDF padrão da ferramenta utilizando WebService.
Desabilitar todos os alertas do PC?

Esse parâmetro desabilita os alertas de pedido de compras que podem ser apresentados na tela da
ferramenta quando é preenchido, pelo fornecedor, o número e o item do pedido de compras que
estiverem nas tags <xPed> e <nPedItem>, caso o parâmetro considerar o pedido de compra do
arquivo XML estiver habilitado.
Consultar NF-e automaticamente?

Esse parâmetro consulta a Nota Fiscal através da chave de acesso e retorna com o número de
protocolo da consulta do XML, o arquivo sendo importado manualmente ou sincronizado.
Versão
7.0 - 2022 2929
MS
Lança Prenota automaticamente?

Esse parâmetro permite lançar a prenota automaticamente caso passe por todas as validações e
amarrações do Pedido de Compra x XML do fornecedor.
O fornecedor deve informar na tag <xPed> e <nPedItem> do arquvo XML o número e o

item do pedido de compra. Na 4XML a referência Protheus deve estar informada na linha
do item e caso passe por todas as validações internas, a prenota será realizada automaticamente
no momento da importação do arquivo para a ferramenta feita manualmente ou por sincronismo.
Caso haja alguma inconsistência o processo será interrompido.
Destinatário de Erros lançamento automático?

Este parâmetro define quais são os e-mails que receberão um alerta com a inconsistência
encontrada se estiver habilitado o lançamento automático da prenota.
Habilita botão PC?

Este parâmetro habilita o botão criar Pedido de Compra para NFe, CTe e NFSe com base nos dados
informados no arquivo XML. Caso passe por todas as validações de campos obrigatórios da
empresa.
A referência Protheus (Produto x Fornecedor) deve estar informada na linha do item e no

cadastro do fornecedor deve ser informada a condição de pagamento mesmo que não
seja a condição que será utilizada para o lançamento da prenota.
Versão
7.0 - 2022 3030
MS
Mostra NF-e no Browse?

Esse parâmetro tem como objetivo permitir a visualização de notas lançadas por outra filial.
Esse parâmetro tem um vínculo com o filtro inicial “Visualizar todas as Empresas” ou “apenas a
empresa” que foi feito o login. Para visualizar a nota fiscal e o lançamento de outra filial será
necessário selecionar “Todas as Empresas”.
Gravação do campo lote na SD1?

Esse parâmetro permite escolher o campo na tabela SD1 onde deve ser gravado o número do lote
informado na tag <Rastro> do XML pelo o fornecedor, sendo D1_LOTECTL ou D1_LOTEFOR.
Exemplo da gravação do campo lote na SD1:
Considerar fator de conversão?

Esse parâmetro considera o fator de conversão do cadastro de produto para calcular a unidade a
ser lançada, caso o mesmo não utilize do pedido de compra.
Versão
7.0 - 2022 3131
MS
Destinatário de erros na Classificação Automática?

Este parâmetro define quais são os e-mails que receberão um alerta com a inconsistência
encontrada se estiver habilitada a classificação automática.
Para ativar a classificação automática é necessário realizar a inserção da configuração do

Job em um Application Server, a rotina irá verificar no sistema todas as notas que
estiverem lançadas como prenota e caso passe por todas as validações internas a nota fiscal será
lançada. No final deste documento está detalhada a configuração do Job.
Pergunta se manifesta NF-e?

Esse parâmetro realiza o manifesto das notas fiscais de produtor rural que são lançadas pelo o
botão ‘Formulário Próprio’.
Considera base de dados do sistema?

Esse parâmetro define se será considerada a data base do sistema ou a data original do arquivo
XML para lançamento das notas fiscais de devolução de cliente.
Versão
7.0 - 2022 3232
MS
Criar registro automático na SA7?

Esse parâmetro define se será criado um registro automático na tabela SA7, caso encontre o
código de barra no produto.
Para o funcionamento deste recurso a tag <cEAN> do arquivo XML deve estar preenchida
e no cadastro do produto deve estar com o mesmo código do arquivo XML.
Permite lançar prenota?

Esse parâmetro define se permite lançar a Prenota mesmo que o pedido de compras esteja
divergente dos dados do arquivo XML.
Caso utilize a rotina de tolerância de recebimento o parâmetro não será considerado,

respeitando sempre a rotina padrão do Totvs Protheus.
Estornar Prenota?
Esse parâmetro emite o manifesto de operação não realizada quando o usuário realiza a exclusão
da Prenota.
Orientamos a análise junto à contabilidade para ativação deste recurso, pois este
confirma para a SEFAZ que a operação da venda não foi realizada.
Versão
7.0 - 2022 3333
MS
Destinatário do estorno?
Este parâmetro define quais são os e-mails que receberão um alerta para informar os estornos
realizados.
Confere e Alerta?
Este parâmetro irá apresentar um alerta na tela para informar quando houver divergências entre
os impostos vindos do XML e a TES informada na linha do produto na 4XML.
Versão
7.0 - 2022 3434
MS
Os parâmetros a seguir fazem parte do recurso "Monitor de Portaria e Conferência Cega" da 4XML
que poderá ser contratado adicionalmente.
Para maiores informações entre em contato com a nossa equipe!
TES de exceção p/ conferência?
Inserir as TES que não exigirão a conferência do produto na Conferência Cega da 4XML (o produto
também não será apresentado folha de conferência).
Usuário permite recusar Documento de Conferência?

Inserir os códigos dos usuários que terão permissão para utilizar o botão para Recusa.
Usuário permite devolução Documento de Conferência?

Inserir os códigos dos usuários que terão permissão para utilizar o botão para Devolução.
Quantidade de tentativas de Conferência?

Inserir a quantidade de tentativas de conferência que o usuário poderá realizar, quando a
quantidade for excedida, somente outro usuário poderá dar sequência na conferência.
Versão
7.0 - 2022 3535
MS
5.4 Etapa 5 - Configuração Espião
Esta etapa apresenta a configuração do certificado digital que é utilizado para realizar a baixa dos
documentos através do TSS com as conexões dos WebServices. Essa configuração é imprescindível
para download dos XML. Também há duas configurações para Notas Fiscais de Serviço.
Versão
7.0 - 2022 3636
MS
Configuração do Certificado Digital
Para configuração do certificado digital (arquivo.pfx) na 4XML há três maneiras:

- Mapeamento do caminho da pasta Certs (TSS);
- Inserção do arquivo e senha do certificado;
- Cópia dos arquivos .pem para o diretório cerconf.
5.4.1 Mapeamento do caminho da pasta Certs (TSS)
Clique no botão ‘Procurar’. Será apresentada uma tela para navegação dos diretórios do servidor.
Versão
7.0 - 2022 3737
MS
Deve ser localizada a pasta ‘certs’ do diretório do TSS que contém os arquivos extraídos dos
certificados configurados no Protheus no módulo do Faturamento. Clique na pasta para selecioná-
la e depois em ‘Abrir’.
Neste momento a ferramenta fará a cópia de todos os arquivos .pem do diretório ‘certs’ do TSS
para o diretório ‘cerconf’ localizado no Protheus_data > 4XML > cerconf.
Para que seja possível a utilização desta opção o TSS - TOTVS® SERVICE SOA, serviço que
responde e realiza requisições de serviços WebService, deve estar instalado no mesmo
servidor que o sistema.
5.4.2 Inserção do arquivo e senha do certificado

Clique no botão ‘Configurar’ no canto esquerdo inferior.
Versão
7.0 - 2022 3838
MS
Será apresentada a tela para informar o tipo de certificado digital, o arquivo do certificado digital
e a senha.
Versão
7.0 - 2022 3939
MS
Clique em Drive para localizar e selecionar o arquivo do certificado (arquivo.pfx).
Observe que ao selecionar o arquivo do lado direito, o nome do arquivo é preenchido. Clique em
abrir.
Insira a senha e clique em confirmar, neste momento a ferramenta irá extrair os arquivos do
certificado para o diretório da 4XML na Protheus_Data.
Versão
7.0 - 2022 4040
MS
5.4.3 Cópia dos arquivos ‘.pem’ para o diretório cerconf

A terceira maneira de configurar o certificado digital na ferramenta consiste em copiar os
arquivos ‘.pem’ da pasta Certs do TSS para a pasta Cerconf da 4XML
(Protheus_Data/4XML/Cerconf).
Feito este processo, a ferramenta está pronta para o sincronismo e baixa dos documentos.
Versão
7.0 - 2022 4141
MS
5.4.4 Configuração NFSe

Este módulo não está contemplado na instalação padrão da 4XML, para maiores detalhes solicite
uma apresentação da equipe comercial!
Pedido de Compra NFS-e?

Esse parâmetro pergunta se é obrigatória a amarração do pedido de compra para as Notas Fiscais
de Serviço Eletrônicas.
Destinatários Inclusão NFS-e?

Ao configurar esse parâmetro, o usuário será informado/alertado por e-mail com Número e Série
da NFS-e lançada no sistema. Para inserir mais de um e-mail deverá ser separado por ponto e
vírgula.
Versão
7.0 - 2022 4242
MS
5.5 Etapa 6 - Configurações BPO
Os parâmetros abaixo são do módulo do BPO que tem a finalidade de escriturar as Notas Fiscais de
saída, é utilizado geralmente por contabilidades externas. Este módulo não está contemplado na
instalação padrão da 4XML, para maiores detalhes solicite uma apresentação da equipe comercial!
Pedido de Venda BPO?

Habilita a obrigatoriedade da amarração do pedido de vendas com XML.
TES para NF sem Pedido?

Quando habilitada a obrigatoriedade da amarração do pedido de vendas com o XML, se houver
alguma exceção de lançamento sem pedido, informar a TES correspondente neste parâmetro.
Versão
7.0 - 2022 4343
MS
Cond. Pagto para NF sem Pedido?

Informar a condição de pagamento utilizada para realizar o faturamento das Notas Fiscais de
saída, sem a obrigatoriedade do pedido de vendas.
TES para NF de Devolução?

Informar a TES utilizada para realizar o faturamento das Notas Fiscais de devolução.
Produto Frete para CT-e (BPO)?

Caso haja um produto de Conhecimento de Transporte padrão utilizado pela empresa, o mesmo
deverá ser inserido neste parâmetro. Se preenchido, todos os XML de CTe carregarão este código
automaticamente.
Versão
7.0 - 2022 4444
MS
Etapa 7 - Integração Fluig
Os parâmetros abaixo configuram a integração com a ferramenta Fluig da TOTVS. É obrigatório o

preenchimento de todos os campos, caso a integração seja utilizada. Estes dados são informados
pela TOTVS.
Versão
7.0 - 2022 4545
MS
5.6 Etapa 8 - Integração OCR
Esta etapa contém as credenciais utilizadas para a comunicação da Integração OCR.

Sua validação ocorre somente para os clientes que adquirirem a funcionalidade, esta faz a leitura
Óptica de PDFs mapeando e transformando os dados das Notas Fiscais de Serviço em XML,
possibilitando o lançamento dos documentos na 4XML. Este módulo não está contemplado na
instalação padrão da 4XML, para maiores detalhes solicite uma apresentação da equipe comercial!
Versão
7.0 - 2022 4646
MS
5.7 Etapa 9 – Finalização
Na última etapa será apresentada a tela para criação / atualização das tabelas da ferramenta.
Se forem realizadas somente alterações de configurações e parâmetros da ferramenta, nesta

etapa clique na opção NÃO.
Se estiver sendo aplicada uma nova patch para atualização da ferramenta será necessário
criar/atualizar as tabelas da 4XML, neste caso clique em SIM. Atenção, para que a ferramenta
possa realizar a atualização, é necessário que neste momento não haja nenhum usuário ou Job
acessando as tabelas da 4XML, ou seja, o acesso à ferramenta deve ser exclusivo. Se este
processo não for realizado na atualização, ao acessar a ferramenta pode ocorrer uma série de
erros devido a divergências entre as instruções do programa e o dicionário de dados.
Sendo assim, a execução do Wizard de Configuração torna-se obrigatória toda vez que haja
necessidade de atualização da ferramenta. Se ocorrer a atualização corretamente do dicionário
de dados, será apresentada uma tela com a mensagem “Processo Finalizado com Sucesso”.
Versão
7.0 - 2022 4747
MS
Como forma de validação da atualização é possível observar a data da versão da 4XML localizada
no Menu Inicial no rodapé à direita. Esta deve estar com a mesma data informada na
nomenclatura da patch recebida.
Versão
7.0 - 2022 4848
MS
6 Configuração de Jobs
É possível criar um JOB (serviço automático) para realizar a sincronização e baixa automática dos
XMLs através da conexão com os servidores da SEFAZ (Secretaria da Fazenda).
Este recurso viabiliza a baixa com maior agilidade, pois as requisições são enviadas de maneira
automática sem a interferência do usuário, de maneira que, quando o fornecedor fizer a emissão
do documento e este estiver disponível no ambiente nacional (AN) da Sefaz, a 4XML irá realizar a
requisição da baixa através da conexão do TSS (utilizando o certificado digital) com os
WebServices da Secretaria da Fazenda.
Este recurso não é obrigatório, porém é recomendado para que haja menos processos e maior
facilidade para aquisição do XML.
Como boas práticas, orientamos a criação de um novo serviço do Protheus (Application Server)
exclusivo para o JOB. Para executar essa atividade siga os procedimentos a seguir:
• Copie a pasta APPSERVER do seu ambiente de Produção;

• Mude a porta e o nome do novo Application Server;
• Altere o nome do ambiente (opcional);
• Adicione as configurações do Job, detalhado mais abaixo, no arquivo appserver.ini.
Atenção, estes procedimentos devem ser feitos por um profissional da equipe de TI que
tenha experiência com manutenção do sistema TOTVS Protheus. Caso haja alguma
dificuldade para configuração, não deixe de acionar a nossa equipe de Suporte.
Versão
7.0 - 2022 4949
MS
6.1 Download de Notas Fiscais Eletrônicas
Para a baixa/download das Notas Fiscais Eletrônicas a 4XML necessita realizar o manifesto da
Ciência da Operação. Por este motivo, recomendamos a análise junto à contabilidade, para
averiguar se os manifestos podem ser realizados sem que prejudique o processo da empresa.
O Job funciona por grupo de empresa, ou seja, para cada empresa será necessário uma nova
configuração.
;===============================================
;Schedule Baixar XML NF-E (4XML) EMP 01
;===============================================
Comentário para identificar a configuração do Job no appserver.ini.
[CEX_NF_JOB_01]
Nome do Job, este pode ser alterado, exemplo ‘JOB_NFE_EMP01’.
main=U_CEXMMDEJB
Nome da função, não pode ser alterada.
environment=4XML
Informar o mesmo ambiente configurado anteriormente neste Application Server.
nParms=2
Quantidade de parâmetros utilizados, não pode ser alterado.
Parm1=XX
Código do Grupo de Empresa, por exemplo ‘01’.
Parm2=XX;XX;
Código das Filiais do Grupo de Empresa, por exemplo: ‘01’. Para adicionar mais de uma filial,
separe por ponto e vírgula ‘01;02;03‘.
Após configuração, inserir o nome do(s) Job(s) na TAG [ONSTART] como no exemplo abaixo:
[ONSTART]
JOBS= CEX_NF_JOB_01, CEX_NF_JOB_02,... - separado por vírgula.
Refreshrate=3600 - Intervalo de tempo em segundos entre um sincronismo e o outro.
Versão
7.0 - 2022 5050
MS
Exemplos de Configuração do Job:

;===============================================
;===============================================
[CEX_NF_JOB_01]
main=U_CEXMMDEJB
environment=4XML
nParms=2
Parm1=01
Parm2=01;02;03;
;===============================================
;===============================================
[CEX_NF_JOB_02]
main=U_CEXMMDEJB
environment=4XML
nParms=2
Parm1=02
Parm2=01;
[ONSTART]
JOBS= CEX_NF_JOB_01, CEX_NF_JOB_02
Refreshrate=3600
Versão
7.0 - 2022 5151
MS
6.2 Download de Conhecimento de Transporte
Diferentemente das Notas Fiscais Eletrônicas, para a baixa/download dos Conhecimentos de

Transporte não é necessário realizar o manifesto da Ciência da Operação, a ferramenta faz a
requisição da baixa diretamente para os WebServices da Sefaz.
O Job funciona por grupo de empresa, ou seja, para cada empresa será necessário uma nova
configuração.
;===============================================
;Schedule Baixar XML CT-E (4XML) EMP 01
;===============================================
[CEX_CT_JOB_01]
Nome do Job, este pode ser alterado, exemplo ‘CEX_CTE_EMP01’.
main=U_CEXMCTEJB
environment=4XML
nParms=2
Quantidade de parâmetros, não pode ser alterado.
Parm1=XX
Parm2=XX;XX;
Código das Filiais do Grupo de Empresa, por exemplo: ‘01’. Para adicionar mais de uma filial,
separe por ponto e vírgula ‘01;02;03‘.
[ONSTART]
JOBS= CEX_NF_JOB_01,…, CEX_CT_JOB_01,... - separado por vírgula.
Versão
7.0 - 2022 5252
MS
Exemplo de Configuração do Job:

;===============================================
;Schedule Baixar XML CT-E (4XML) EMP 01
;===============================================
[CEX_CT_JOB_01]
main=U_CEXMCTEJB
environment=4XML
nParms=2
Parm1=01
Parm2=01;02;03;
[ONSTART]
JOBS= CEX_NF_JOB_01,CEX_NF_JOB_02, CEX_CT_JOB_01
Refreshrate=3600
Versão
7.0 - 2022 5353
MS
6.3 Download dos XML por e-mail
O Job de e-mail, diferentemente dos anteriores, não será necessária configuração por empresa.
;===============================================
; Schedule Baixar XML por Email (4XML)
;===============================================
[JB_MAILCENT]
Nome do Job, este pode ser alterado, exemplo ‘CEX_JOB_EMAIL’.
main=U_CEXMJBMAI
environment=4XML
nParms=2
Quantidade de parâmetros, não pode ser alterado.
Parm1=01
Parm2=01
Código das Filiais do Grupo de Empresa, por exemplo: ‘01’.
[ONSTART]
JOBS= CEX_NF_JOB_01,…, CEX_CT_JOB_01,…,CEX_NFS_JOB_01,..., JB_MAILCENT - separado
por vírgula.
Versão
7.0 - 2022 5454
MS
Exemplo de configuração de Job:

;===============================================
;Schedule Baixar XML por Email (4XML)
;===============================================
[JB_MAILCENT]
main=U_CEXMJBMAI
environment=4XML
nParms=2
Parm1=01
Parm2=01
[ONSTART]
JOBS= CEX_NF_JOB_01,CEX_NF_JOB_02, CEX_CT_JOB_01,CEX_NFS_JOB_01,JB_MAILCENT
Refreshrate=3600
Versão
7.0 - 2022 5555
MS
6.4 Informações adicionais da configuração
Após criação do novo Application Server com a configuração dos Jobs no appserver.ini, crie um
atalho do aplicativo Appserver.exe e, com o botão direito do mouse, clique em propriedades.
Insira ’-CONSOLE’ (após o ‘.exe’). Em seguida execute o mesmo como Administrador, neste
momento será apresentada a execução do JOB em tempo real.
Após a validação do JOB, altere a propriedade do atalho para ‘–INSTALL’ (após o ‘.exe’). Este
recurso irá instalar este Application Server como serviço no Sistema Operacional conforme nome
definido nas configurações do arquivo ‘appserver.ini’.
Na configuração de serviço do Windows, basta definir o serviço do Job como automático para que
seja sempre iniciado junto aos demais serviços do Windows automaticamente Start (Iniciar).
Versão
7.0 - 2022 5656
MS
7 Informações técnicas
A seguir serão disponibilizados alguns tópicos relacionados à estrutura, parâmetros e informações
restritas à ferramenta.
7.1 Tabelas da 4XML
Para conhecimento da estrutura abaixo estão apresentadas as tabelas da ferramenta.
Nota Fiscal Eletrônica:

• RECNFXML – Tabela do cabeçalho;
• RECNFXMLITENS – Tabela dos itens.
Conhecimento de Transporte Eletrônico:

• RECNFCTE – Tabela do cabeçalho.
• RECNFCTEITENS – Tabela dos itens;
Nota Fiscal de Serviço Eletrônica:

• RECNFSXML – Tabela do cabeçalho;
• RECNFSXMLITENS – Tabela dos itens;
• RECNFSERNFS e RECNFFORNNFS - Cadastro de Produto x Serviço.
BPO:
• RECNFBPO – Tabela do cabeçalho;
• RECNFBPOITENS – Tabela dos itens.
Outras:
• RECNFLOGE - Tabela de registro de Log 4XML;
• RECNFSINCXM - Tabela de registro de integração de XML;
• RECNFSTATUS – Registro das informações do botão ‘Status’.
Versão
7.0 - 2022 5757
MS
7.2 Pontos de entrada
Segue abaixo a relação dos pontos de entrada da ferramenta para desenvolvimento de

customizações, para mais detalhes ou exemplos acione a nossa equipe de suporte.
Pontos de Entrada Genéricos

• CEXMGRCNF – No fim da gravação dos registros do cabeçalho NF-e ;
• CEXMGRNFE – No fim da gravação dos registros de itens NF-e;
• CEXMGRCTE – No fim da gravação do CT-e;
• CEXMINIT - Define o acesso dos usuários - NF-e / CT-e;
• CEXMAINF - Personalização da Mensagem a ser enviada no envio dos e-mails;
• CEXCADCF – Permitir ou negar cadastro de Cliente ou Fornecedor (Duplo clique do Mouse);
• CEXMGICTE – Na gravação do XML de CT-e, permite manipular a aglutinação dos itens;
• CEXPCCEG – Na digitação do produto da Conferência Cega, retornar o código do produto;
• CEXEXXML - Na exclusão do XML da base de dados.
Pontos de Entrada Nota Fiscal Eletrônica

• CEXMBTNFE - Adiciona botão no menu lateral;
• CEXMORNF - Altera ordem dos campos nos itens da NF-e;
• CEXPNFOK - Após a gravação da prenota NF-e;
• CEXDANFE - Chamada no botão DANFE;
• CEXATUSA5 – Atualiza a tabela SA5;
• CEXCONSC7 - Atribuição das quantidades do pedido de compra na NF-e;
• CEXINITP - Altera tipo de NF no momento da geração;
• CEXMITDEV - Atribuição de itens de retorno da NF;
• CEXMITNFE - Valida entrada de prenota / manipula Acols de lançamento de prenota;
• CEXSA5INI - Permite buscar Produto x Fornecedor de uma tabela customizada;
• CEXSA5GET - Gravar / retornar Produto x Fornecedor personalizado;
• CEXLPROD – No lançamento em lote, chama caso não tenha produto;
Versão
7.0 - 2022 5858
MS
Pontos de Entrada Conhecimento de Transporte Eletrônico

• CEXMORCT - Altera ordem dos campos nos itens da CT-e;
• CEXPCTOK - Após a gravação da prenota CT-e;
• CEXMTECTE - Após a escolha da TES de entrada CT-e;
• CEXMITCTE - Valida entrada de prenota / manipula Acols de lançamento da prenota;
• CEXLANLT - Permite adicionar uma customização no início do lançamento em lote;
• CEXLFILT - Permite adicionar uma customização no fim do lançamento em lote;
• CEXMGCON - Após gravação do Conhecimento de Transporte;
• CEXMBTCTE - Adiciona botão no menu lateral;
• CEXPCCTD – Valida a divergência de valores do CT-e, avalia as quantidades e deixa
consumir o pedido com preço divergente.
Pontos de Entrada NFS-e

• CEXGRNFS - Fim da gravação dos registros;
• CEXMBNFS - Adiciona botão no menu lateral.
Pontos de Entrada BPO

• CEXMGRBPO - Fim da gravação dos registros;
• CEXMLPBPO - Após liberação do pedido à faturar;
• CEXMBPOGP - Após gravação do pedido de vendas;
• CEXMSELCF - Após selecionar Cliente ou Fornecedor;
• CEXTSBPO - Selecionar a TES no lançamento por lote.
Versão
7.0 - 2022 5959
MS
7.3 Configurações / Parâmetros ocultos da 4XML
Os parâmetros abaixo não são apresentados no Wizard de Configuração da ferramenta, devem ser
alterados diretamente pelo Configurador do Protheus.
Zipa Retorno do WS
O parâmetro XM_COMPXML foi criando visando a redução de espaço de arquivo XML no servidor
na pasta Protheus_Data/4XML. Quando o parâmetro for habilitado, os arquivos serão zipados
(comprimidos) liberando espaço no disco rígido (HD).
Quebra CT-e por linhas conforme Nota Fiscal de origem

O parâmetro XM_CTELIN identifica a Nota Fiscal de origem do Conhecimento de Frete (Compras)
e divide a quantidade de itens do XML do CTe para ficar equivalente à quantidade de itens da
Nota Fiscal. A Nota Fiscal de origem já deverá estar lançada no sistema.
Envio de alertas de lançamento automático NF-e sem TES

O parâmetro XM_LANATES valida e envia um alerta do lançamento automático de NF-e pela 4XML
quando a TES não for informada no lançamento da Prenota. As configurações de e-mail (SMTP)
devem ser parametrizadas no padrão Totvs Protheus e no Wizard de Configuração.
Exclusão do XML da base de dados

O parâmetro XM_EXCXML permite a exclusão do XML na base de dados (quando clicado com o
botão direito do mouse em cima do XML).
Desconsidera o Tipo de CTe do XML

O parâmetro XM_TPFRET desconsidera o preenchimento do campo Tipo CT-informado na tag do
XML <tpCTe> durante o lançamento do documento de entrada.
XM_TPFRET=.F. - Parâmetro tipo caractere.
Versão
7.0 - 2022 6060
MS
Desconsidera o Tipo de Frete do XML

Parâmetro para desconsiderar preenchimento do campo Tipo Frete na tag do XML <modFrete>
durante o lançamento do documento de entrada:
XM_LTPFRET =.F. - Parâmetro tipo caractere.
Desconsidera a Descrição do Cadastro de Produto

Parâmetro para desconsiderar a descrição do cadastro de produto e preencher com a descrição do
produto vinda do XML.
XM_ATUADSC =.F. - Parâmetro tipo caractere.
Preenchimento da espécie da NFSe

Parâmetro para o preenchimento da espécie da nota de serviço no lançamento do documento de
entrada.
XM_ESPNFSE=.F. Parâmetro tipo caractere.
Este parâmetro deve ser criado manualmente pelo configurador SIGACFG e parametrizado
conforme a necessidade da empresa. Para o funcionamento, a 4XML deve estar sempre
atualizada com a ultimar versão.
Versão
7.0 - 2022 6161
MS
7.4 Parâmetros padrões Protheus
A seguir estão listados alguns parâmetros padrões do Protheus que podem ser utilizados para
configuração de regras em conjunto com a ferramenta.
Chave de acesso
MV_CHVNFE = .T.
Habilita a consulta da chave de acesso na Sefaz para verificar a validade do XML para Notas Fiscais
e Conhecimentos de Transporte no documento de entrada.
MV_DCHVNFE = .T.
Obriga a digitação da chave de Notas Fiscais e Conhecimentos de Transporte caso a espécie seja
SPED ou CTE e Formulário Próprio=NÃO, no Documento de Entrada.
MV_VCHVNFE =.T.
Verifica se o CNPJ constante na chave bate com o CNPJ do fornecedor informado na nota e se o
número e a série constante na chave batem com o número e série digitados na nota, caso a
espécie seja SPED ou CTE e Formulário Próprio=NÃO.
MV_BCHVNFE = .T.
Na rotina de documento de entrada, aba Informações do Danfe, ao informar uma chave NF-e
inválida no cenário de Internet não conectada, é permitido a gravação do documento de entrada .
Diante da impossibilidade de validar a chave NF-e sem uma conexão com a SEFAZ, foi criado o
parâmetro MV_BCHVNFE para informar se a chave NF-e deve ser gravada ou o campo F1_CHVNFE
retornado para branco, caso não exista uma internet conectada.
Versão
7.0 - 2022 6262
MS
Pedido de Compras
MV_PCNFE
Obriga a amarração do pedido de compra no Documento de Entrada. Pode ser configurado com:
T (True) – Amarração obrigatória.
F (False) – Amarração não obrigatória.
MV_TESPCNF
Caso o parâmetro MV_PCNFE estiver habilitado, pode ser utilizado o parâmetro MV_TESPCNF para
informar ao sistema exceções de lançamentos, ou seja, sem a amarração do pedido de compras.
Sendo assim, basta informar os Tipos de Entrada e Saída (TES) que não necessitam da amarração
com o pedido de compras, como por exemplo, uma devolução de venda.
Podo ser configurado com:

Conteúdo vazio – O sistema não permitirá nenhum lançamento sem pedido de compras.
TES (separadas por ponto e vírgula) – Permitirá o lançamento sem pedido de compras dos
documentos com essas TES.
MV_ALTPRCC
Permite configurar se o preço unitário do produto pode ser alterado, no registro da entrada da
nota fiscal ou na inclusão da autorização de entrega, mesmo quando os valores já foram
informados no pedido compras, na autorização de entrega ou no contrato de parceria.
Pode ser configurado com as seguintes opções:

0 - Desabilitado: o preço unitário do produto pode ser alterado em qualquer situação.
1 – Valida o preço informado no pedido de compras, ou seja, no registro da entrada da nota fiscal
(rotina Documento de Entrada) ou na Classificação da Prenota. Não permite alteração no preço
unitário do produto quando relacionado a um pedido de compras.
2 – Valida o preço informado na autorização de entrega, ou seja, no registro da entrada da nota

fiscal (rotina Documento de Entrada) ou na classificação da Prenota. Não permite alteração no
preço unitário do produto quando relacionado a uma autorização de entrega.
3 – Valida o preço informado no pedido de compras e na autorização de entrega (ambos), no
Versão
7.0 - 2022 6363
MS
registro da entrada da nota fiscal (rotina Documento de Entrada)ou na classificação da Prenota.

Não permite alteração no preço unitário do produto quando relacionado a um pedido de compras
ou a uma autorização de entrega.
4 – Valida o preço informado no contrato de parceria, ou seja, na inclusão da autorização de

entrega. Não permite alteração no preço unitário do produto relacionado ao contrato.
5 – Valida o preço informado no contrato de parceria e na autorização de entrega.
6 - Valida o preço informado no pedido de compras, na autorização de entrega e no contrato de

parceria.
Versão
7.0 - 2022 6464
MS

Manual Configuração

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Configuração

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de Configuração

Manual de Atualização e Configuração

2 O que é 4XML? ................................................................................................ 5

3 Fluxo de Atualização ........................................................................................ 6

4 Processos para atualização ................................................................................. 7

4.1 Aplicação da Patch ..................................................................................... 7

4.2 Wizard de Configuração / Atualização das Tabelas ..............................................11

5 Parâmetros e Configurações do Wizard .................................................................14

5.1 Etapa 1 – Boas Vindas .................................................................................14

5.2 Etapa 2 e 3 - Configurações de E-mail .............................................................15

5.2.1 Etapa 2 – Configuração SMTP ...................................................................16

5.2.2 Etapa 3 – Configuração Pop ....................................................................18

5.3 Etapa 4 – Configuração NF-e / CT-e ................................................................20

5.4 Etapa 5 - Configuração Espião .......................................................................36

5.4.1 Mapeamento do caminho da pasta Certs (TSS) ..............................................37

5.4.2 Inserção do arquivo e senha do certificado ..................................................38

5.4.3 Cópia dos arquivos ‘.pem’ para o diretório cerconf........................................41

5.4.4 Configuração NFSe ...............................................................................42

5.5 Etapa 6 - Configurações BPO ........................................................................43

Etapa 7 - Integração Fluig ....................................................................................45

5.6 Etapa 8 - Integração OCR ............................................................................46

5.7 Etapa 9 – Finalização..................................................................................47

6.1 Download de Notas Fiscais Eletrônicas.............................................................50

6.2 Download de Conhecimento de Transporte .......................................................52

6.3 Download dos XML por e-mail .......................................................................54

6.4 Informações adicionais da configuração ...........................................................56

7 Informações técnicas .......................................................................................57

7.1 Tabelas da 4XML .......................................................................................57

7.2 Pontos de entrada .....................................................................................58

7.3 Configurações / Parâmetros ocultos da 4XML ....................................................60

7.4 Parâmetros padrões Protheus .......................................................................62

Encerrar qualquer conexão de

*O acesso exclusivo é somente na ferramenta, o sistema pode ser acessado normalmente.

4 Processos para atualização

4.1 Aplicação da Patch

Periodicamente ocorrem atualizações da ferramenta que são registradas através de boletins

• Nome do Programa: 4XML;

Figura 1 - Arquivo da Patch 4XML

Para iniciar o processo de atualização, faça o download do arquivo do pacote/patch

Figura 2 - VSCode: Localização da Patch

Figura 3 - VSCode: Seleção do Ambiente

Figura 4 - Aplicação da Patch

O pacote será aplicado no RPO do ambiente conectado anteriormente, neste exemplo no

Figura 5 - Mensagem de processo finalizado com sucesso

Figura 6 - Mensagem de processo finalizado com erro

4.2 Wizard de Configuração / Atualização das Tabelas

Atenção: somente o usuário administrador possui acesso ao Wizard de Configuração da

Se ocorrer a atualização corretamente do dicionário de dados, será apresentada a tela a seguir.

5 Parâmetros e Configurações do Wizard

5.1 Etapa 1 – Boas Vindas

5.2 Etapa 2 e 3 - Configurações de E-mail

5.2.1 Etapa 2 – Configuração SMTP

Atenção, orientamos a utilização de um e-mail exclusivo criado pela empresa para a

O preenchimento pode ser feito conforme o exemplo abaixo, da hospedagem na Locaweb:

Servidor SMTP? smtplw.com.br - Disponibilizado pela Locaweb

Após configurações realizadas, clique no botão Avançar.

Email enviado para seuemail@seudominio.com.br

5.2.2 Etapa 3 – Configuração Pop

Atenção, orientamos a utilização de um e-mail exclusivo criado pela empresa para a

O preenchimento pode ser feito conforme o exemplo abaixo, da hospedagem na Locaweb:

Servidor POP? email-ssl.com.br- Disponibilizado pela Locaweb

Após configurações realizadas, clique no botão Avançar.

5.3 Etapa 4 – Configuração NF-e / CT-e