1. 2. 3. 4. 1. 1. 1. 2. 3.
LINX MDF-e Web | Instruções de Instalação e Configuração
Assunto
O Linx MDF-e Web é uma aplicação Windows responsável pela troca de informações entre o ERP e o ambiente autorizador, para possibilitar a emissão de MDF-e.
Este documento descreve os procedimentos operacionais para efetuar a instalação/atualização do Linx MDF-e Web, bem como a parametrização e utilização do sistema.
Pré-requisitos
Windows 7 ou superior;Microsoft .Net Framework 3.5 SP1 ou superior;
IBM Informix Client SDK 3.50 ou superior (Quando utilizado banco de dados Informix);
Sumário Assunto Pré-requisitos Instalação/ Atualização SOBREPONDO UMA INSTALAÇÃO EXISTENTE INSTALAÇÃO DO SISTEMA
Instalação MDFe Web Instalação MDFe Web API
Parametrização Linx MDFe Web Execução do Sistema NT 2020.001 MDF-e Integrado
Instalação/ Atualização
SOBREPONDO UMA INSTALAÇÃO EXISTENTE
Se já existir uma versão anterior do Linx MDF-e instalada, siga os passos abaixo antes de instalar a nova:
Faça uma cópia do arquivo " C:\Linx Sistemas\MDFeWeb\mdf-e.ini", do diretório "C:\Linx Sistemas\MDFeWeb\certificados" e do diretório "C:\Linx Sistemas\MDFeWeb\logomarca". Após a instalação da nova versão (ver passos de instalação), retorne para o diretório " C:\Linx Sistemas\MDFeWeb\" o arquivo e as pastas copiadas, sobrepondo o que porventura tenha sido criado pelo instalador da nova versão.
Faça uma cópia do arquivo " C:\inetpub\Services\MDFe_api\bin\mdf-e.ini". Após a instalação da nova versão, retorne para o diretório " C:\inetpub\Services\MDFe_api\bin" o arquivo, sobrepondo o que porventura tenha sido criado pelo instalador da nova versão.
Execute a desinstalação do MDFeWeb e MDFeWeb_api através do Painel de Controle do Windows. Execute a instalação do MDFeWeb e MDFeWeb_api (seguir passos descritos no item Instalação)
INSTALAÇÃO DO SISTEMA
Configuração do sistema operacional:(Somente 64bits) verificar o controle de contas de usuário:
Clique em "Iniciar", "Painel de Controle", "Contas de Usuário e Segurança Familiar", "Contas de Usuário", opção "Alterar configurações de Controle de Conta de Usuário".
Na tela que será apresentada, garantir que está selecionado para "Nunca notificar" alterações no computador. Talvez seja necessário reiniciar o computador.
1. 2. 1. 2. 3. 3. 4. 1. 2. 3. 4. 5. 6.
Verificar se o Microsoft .Net está instalado:
Clique em "Iniciar", "Painel de Controle", "Programas", "Programas e Recursos", opção "Ativar ou desativar recursos do Windows". Será exibida uma lista com os recursos do Windows. Localize e marque o item "Microsoft .Net Framework 3.5.1"
Clique em Ok e após concluir, reinicie o computador.
(Somente 64bits) O usuário definido para utilização do Linx DMS MDF-e deve ter permissões administrativas (tipo de conta "Administrador"). Configurar o IIS para a API do ERP:
Criar um diretório MDFeERP_api em C:\inetpub\Services\. ex: C:\inetpub\Services\MDFeApollo_api Nesse diretório deve constar os arquivos Default.asmx e Web.config (Anexo ao instalador) Criar um subdiretório \bin
No diretório \bin deve constar os arquivos MDFeERP_api.dll e mdf-e.ini (Anexo ao instalador) Acessar o Gerenciador de Serviço de Informática (IIS)
1.
4.
7.
8.
2.
Em “Alias” informar MDFeERP_api e no campo “Caminho Físico” c:/inetpub/Services/MDFeERP_api ex:
Acessar o browser e abrir o a url: http://localhost/MDFeERP_api/Default.asmx para se certificar que está funcionando:
Efetuar download do Linx MDF-e e descompactar em um diretório temporário:
3. 4. 5. 6. 1. 2. 3.
Executar o "Windows Update" e garantir que o sistema operacional está atualizado.
Executar "Instalar Linx DMS MDF-e.exe (instruções no tópico “Instalação”).
Executar " MDFeWeb_api.exe" (instruções no tópico “Instalação”).
(Somente 64bits, quando utilizado banco de dados Informix). Conferir se o registro do Informix está correto em "C:\Windows\Microsoft.NET\Framework\v4.0.30319 \CONFIG\machine.config":
Fazer um Backup do arquivo
Abrir no Bloco de Notas o arquivo citado Procurar o texto "<runtime>"
4.
5.
Verificar se entre "<runtime>" e "</runtime>" existe o bloco de informações abaixo. Se não existir, incluir.
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v2.0.50727">
<dependentAssembly xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity name="IBM.Data.Informix" publicKeyToken="7c307b91aa13d208"
culture="" />
<bindingRedirect oldVersion="2.81.0.0" newVersion="3.0.0.2" />
</dependentAssembly>
<dependentAssembly xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity name="IBM.Data.Informix.3.0.0" publicKeyToken="7c307b91aa13d208"
culture="" />
<bindingRedirect oldVersion="2.81.0.0" newVersion="3.0.0.2" />
<codeBase version="3.0.0.2" href="C:\Program Files
(x86)\IBM\Informix\Client-SDK\bin\netf20\specific\IBM.Data.Informix.3.0.0.dll" />
</dependentAssembly>
</assemblyBinding>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="">
<dependentAssembly xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity name="IBM.Data.Informix" publicKeyToken="7c307b91aa13d208"
culture="" />
<bindingRedirect oldVersion="2.81.0.0" newVersion="3.0.0.2" />
</dependentAssembly>
<dependentAssembly xmlns="urn:schemas-microsoft-com:asm.v1">
<assemblyIdentity name="IBM.Data.Informix.3.0.0" publicKeyToken="7c307b91aa13d208"
culture="" />
<bindingRedirect oldVersion="2.81.0.0" newVersion="3.0.0.2" />
<codeBase version="3.0.0.2" href="C:\Program Files
(x86)\IBM\Informix\Client-SDK\bin\netf20\specific\IBM.Data.Informix.3.0.0.dll" />
</dependentAssembly>
</assemblyBinding>
O módulo MDFe.exe foi compilado na versão do framework 4.0, e caso ocorra o erro abaixo ao acessar o sistema, favor seguir os procedimentos listado. ERRO:
"Não foi possível localizar o Provedor de Dados .Net Framework solicitado. Talvez ele não esteja instalado." Procurar o texto "<DbProviderFactories>".
6. Verificar se entre "<DbProviderFactories>" e "</DbProviderFactories>" existe o bloco de informações abaixo. Se não existir, incluir.
<add name="Odbc Data Provider" invariant="System.Data.Odbc" description=".Net Framework
Data Provider for Odbc" type="System.Data.Odbc.OdbcFactory, System.Data, Version=2.0.0.0,
Culture=neutral, PublicKeyToken=b77a5c561934e089" />
<add name="OleDb Data Provider" invariant="System.Data.OleDb" description=".Net Framework
Data Provider for OleDb" type="System.Data.OleDb.OleDbFactory, System.Data, Version=2.
0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
<add name="OracleClient Data Provider" invariant="System.Data.OracleClient" description=".
Net Framework Data Provider for Oracle" type="System.Data.OracleClient.OracleClientFactory,
System.Data.OracleClient, Version=2.0.0.0, Culture=neutral,
PublicKeyToken=b77a5c561934e089" />
<add name="SqlClient Data Provider" invariant="System.Data.SqlClient" description=".Net
Framework Data Provider for SqlServer" type="System.Data.SqlClient.SqlClientFactory, System.
Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
<add name="IBM Informix .NET Data Provider" invariant="IBM.Data.Informix" description="IBM
Informix Data Provider for .NET Framework 2.0" type="IBM.Data.Informix.IfxFactory, IBM.Data.
Informix, Version=3.0.0.2, Culture=neutral, PublicKeyToken=7c307b91aa13d208" />
<add name="IBM Informix .NET Data Provider 3.0.0" invariant="IBM.Data.Informix.3.0.0"
description="IBM Informix Data Provider 3.0.0 for .NET Framework 2.0" type="IBM.Data.
Informix.IfxFactory, IBM.Data.Informix.3.0.0, Version=3.0.0.2, Culture=neutral,
PublicKeyToken=7c307b91aa13d208" />
Se o erro persistir, favor fazer o mesmo procedimento descrito acima nas Tag <runtime> e <DbProviderFactories no arquivo machine.config existente na outa pasta Framework64 existente no mesmo diretório "C:\Windows\Microsoft.NET\
1.
2.
Execute o instalador do produto “MDFeWeb.exe”. Surgirá então a tela onde deve-se informar o diretório onde será instalada a aplicação:
Após informar o diretório, clique em Next para continuar.
Na próxima tela será exibida a as opções de prosseguir, voltar para as configurações e cancelar a instalação:
3.
4.
Será exibida uma tela de acompanhamento da instalação do produto:
Aguarde a conclusão do processo.
Após a finalização do processo acima, surgirá uma tela de conclusão da instalação:
1.
Instalação MDFe Web API
Execute o instalador do produto “MDFeWeb_api.exe”. Surgirá então a tela onde deve-se informar o diretório onde será instalada a aplicação:
2.
3.
Na próxima tela será exibida a as opções de prosseguir, voltar para as configurações e cancelar a instalação:
Clique em Next para continuar
Será exibida uma tela de acompanhamento da instalação do produto
4.
5.
Após a finalização do processo acima, surgirá uma tela de conclusão da instalação:
Clique em Finish para finalizar a instalação do produto.
Após a instalação será apresentada a tela para testar a conexão MDF-e api:
6. Será aberto uma página com os métodos do MDFe_api no browser:
Deverá ser apresentado a página em questão.
Parametrização
IBM Informix Client-SDK 3.50 (Quando utilizado banco de dados Informix);
Execute o aplicativo Setnet32 (menu “Iniciar”, “IBM Informix Client-SDK 3.50”) e selecione a aba “Environment”. Nas opções apresentadas, procure pela chave “DBMoney” e altere (caixa “Edit Environment Variable”) para “R$,” (incluir a vírgula!).
Na aba “Server Information”, preencha os campos do servidor Informix (“IBM Informix Server”, “HostName”, “Protocolname” e “Service Name”). Em seguida, clique em “Make Default Server”.
Clique em “Aplicar” e “Ok”.
OBS: Para consultar os dados de configuração das portas de comunicação com o banco de dados, acesse o servidor do ERP com o usuário root e verifique o conteúdo do arquivo “/etc /services”.
Linx MDFe Web
Os campos apresentados devem ser parametrizados conforme abaixo: Tipo BD: deve ser informado qual o Banco de dados;
DLL: Deve ser informada a DLL de comunicação, de acordo com o sistema DMS utilizado: SISDIA: MDFe.Sisdia.dll
APOLLO: MDFe.Apollo.dll
Host/Instância: Deve ser informada a Instância do banco, no caso de Banco de Dados Informix, ou Nome ou IP do servidor de banco, no caso de outros tipos de Banco de Dados. DataBase: Informe o nome da base de dados;
Usuário: Informe o usuário do banco de dados; Senha: Informe a senha do usuário do banco de dados.
Seleciona Logomarca: deve ser selecionado o arquivo com a imagem referente à logomarca que será impressa no DAMDFe.
Ambiente: Informar Homologação ou Produção;
WebService: Deve ser informado o link para acesso ao Webservice, sem a informação da operação, exemplo:
HOMOLOGAÇÃO:
Link completo: https://mdfe.svrs.rs.gov.br/ws/MDFerecepcao/MDFeRecepcao.asmx Link a ser parametrizado: https://mdfe-homologacao.svrs.rs.gov.br/ws/
PRODUÇÃO:
1. 2.
Link a ser parametrizado: https://mdfe.svrs.rs.gov.br/ws/
Porta: Informar porta utilizada para envio de Email (Processo ainda não implementado)
Proxy: Informar as configurações de Proxy, caso o ambiente (rede) utilizado possua estes dados; Certificado Digital: O certificado poderá ser utilizado de duas formas:
Série: O certificado será instalado na estação de trabalho onde o Linx MDF-e está sendo executado, e o número de série deste certificado deverá ser informado com campo Série, conforme abaixo:
Arquivo: Deverá ser informado o caminho onde se encontra o arquivo referente ao certificado digital (.pfx). O mesmo será copiado para a pasta: “C:\Linx Sistemas\MDFe\certificados”, e será gravado com o nome “cnpj.pfx”:
Senha: Deve ser informada a senha do Certificado Digital Também na tela de Parâmetros Gerais deverá ser definida qual Arquitetura utilizar:
Local: Irá utilizar a dll do Desktop ex:MDFe.Apollo.dll para poder realizar a comunicação com o ERP.
Web: Irá comunicar com o ERP através da API< utilizando a URL informada no campo URL API ERP (Aba Web). Em Parâmetros Gerias aba Web, deverá ser informado a URL API e a URL API ERP:
URL API: Url de comunicação com a API geral, ex: http://localhost/MDFe_api/Default.asmxObs: O preenchimento deste campo é obrigatório. URL API ERP: Url de comunicação com a API do ERP, ex: http://localhost/MDFeApollo_api/Default.asmx
Obs: Após o processo de configuração será criado o arquivo mdf-e.ini no diretório de instalação do MDF-eWeb, Ex: C:\Linx Sistemas\MDFeWeb este arquivo será copiado automaticamente para os diretórios C:\inetpub\Services\MDFe_api\bin e C:\inetpub\Services\MDFeERP_api\bin.
Execução do Sistema
Execute o módulo Linx MDF-e. Será apresentada a tela para seleção do Emitente. Nesta tela serão apresentadas todas as filiais cadastradas no Banco de Dados Selecionado. Nela deverá ser definido o CNPJ emissor do MDF-e:
Para a geração de um MDF-e, selecione a opção: Manifesto Eletrônico, Emitir MDF-e. Será apresentada a tela abaixo, onde deverão ser definidos todos os dados para a emissão do MDF-e. (Esta tela é semelhante à tela do emissor gratuito utilizado atualmente).
Após cadastrar o MDF-e, este deverá ser salvo, e em seguida transmitido.
Para o gerenciamento de MDF-e gerados, transmissão de MDF-e salvos, Cancelamento e encerramento de MDF-e, inclusão de condutor, exportação de XML e impressão, acessar a opção: Manifesto Eletrônico, Gerenciar MDF-e.
Os MDF-e devem ser encerrados, para tal operação, poderá ser acessada a opção: Manifesto Eletrônico, Consultar MFF-e não Encerrados. Nesta opção serão apresentados todos os MDF-e não encerrados, possibilitando a o encerramento de cada um deles:
NT 2020.001 MDF-e Integrado
A versão 5.0 do MDF-e disponível no instalador “Instalar Linx MDF-e v5.0.exe”, possui as Implementações para Atender a NT 2020.001 MDF-e Integrado. Efetuar um backup da pasta do MDF-e
C:\Linx Sistemas\MDFe
Instalar o executável “Instalar Linx MDF-e v5.0.exe”.
Na tela de “Gerenciamento de MDF-e”, possui a nova opção “Enviar Evento Inf.Pagamento” que está disponível apenas para MDF-e Autorizados, esta tela é a mesma de “Pagamentos do Frete”.
OBS.: Caso seja necessário voltar a versão anterior, remova a pasta MDF-e que possui a nova instalação e volte backup Da pasta MDF-e.