Instalação TotvsServiceSped

Transcrição

1 Instalação TotvsServiceSped

2

3 ÍNDICE INSTALAÇÃO PRODUTO TOTVSSERVICESSPED - NFE... 1 INSTALAÇÃO DO TOPCONNECT Configuração da conexão com o Banco de Dados SQL Server Informix Oracle Configuração do TOPConnect CONFIGURAÇÕES NECESSÁRIAS NO SERVIDOR LOGIX CONFIGURAÇÃO DO TOTVSSERVICESPED i

4

5 INSTALAÇÃO PRODUTO TOTVSSERVICESPED - NFE Pré requisitos Windows Server 2000, Windows Server 2003, Windows Xp. Não há necessidade de licenças adicionais, pois a conexão é feita diretamente pelo banco de dados Não é recomendada a instalação no mesmo servidor de banco de dados nem no mesmo servidor do Logix. Lembrando que a utilização na mesma maquina, pode trazer problemas de performance a todas as aplicações que utilizam a mesma. Bancos de Dados Suportados: MSSQL 2000, 2005 e 2008; Oracle; Postgres; DB2; Informix; Sybase. Obs.: De preferência o TotvsServiceSped não poderá utilizar o mesmo banco de dados do Logix. Qualquer SGBD diferente dos acima mencionados é incompatível com o TotvsServiceSped. O servidor deve ter acesso liberado para a internet O acesso deve ser full, sem firewall. Este acesso é necessário para o envio e recebimento das notas e retornos do SEFAZ. Não pode ser um ISA Server Deve ser um JAVA (JRE ou JDK) 1.5 OU superior; Utilizar o Java da Sun. Servidor de POP/SMTP É necessário que o servidor possua estes protocolos para o envio dos XMLs Obs.: Não funciona com IMAP. Os produtos mencionados neste documento (exceto Java) devem ser baixados do site de suporte Logocenter pelo link NFE Nota Fiscal Eletrônica. Atenção para utilização do TotvsServiceSped com banco de testes: O TotvsServiceSped trabalha com as tabelas separadas do Logix, O TotvsServiceSped não faz leitura das tabelas o Logix ou vice-versa. Indicamos não apontar o Logix da base de testes para o mesmo TotvsServiceSped da base de produção, podem ocorrer problemas de conflito de parâmetros, enviando notas de homologação para produção indevidamente. Crie 2 ambientes para o trabalhar com o Logix de produção e testes. 1

6 INSTALAÇÃO DO TOPCONNECT O TOPConnect é um aplicativo da TOTVS, responsável pelo acesso ao Banco de Dados, que utiliza conexão ODBC e suporta drivers para diferentes Bancos de Dados. Abaixo seguem os passos para a instalação e configuração do programa: Caso seja instalado o TOPConnect em um computador com o sistema operacional de 64-bits, esse deve ser instalado diretamente no C:\, criando a estrutura C:\TOPConnect 1) Selecione o idioma desejado; 2) Na tela de boas-vindas, selecione avançar ; 2

7 3

8 3) O programa é instalado por padrão na pasta "Arquivos de programas"; 4) Selecione a pasta que você deseja salvar o TOPConnect no menu iniciar 4

9 5) A instalação será automática deste ponto em diante até a sua conclusão 5

10 Depois de sua instalação é necessário iniciar o serviço. Para isto, acesse o Painel de Controle > Ferramentas Administrativas > Serviços. Em seguida, selecione o serviço do TOPConnect, clique sobre o nome do serviço e depois no link "iniciar". O link "Iniciar o serviço" será habilitado, depois de sua habilitação, a instalação do TOPConnect estará concluída. 6

11 1. Configuração da conexão com o Banco de Dados 1.1. SQL Server 1) Abra o Painel de Controle > Ferramentas Administrativas > Fontes de Dados (ODBC). 2) Deve ser adicionado em Fonte de dados de sistema, o driver para o Banco de Dados SQL Server 3) Informe as configurações de acordo com o seu Banco de Dados. Sugerimos que o nome da fonte de dados seja "TotvsSped", sem aspas 7

12 NO SQL Server, o usuário que faz a conexão ODBC deve ser o "sa". Marque a primeira opção e selecione o banco de dados padrão que o TotvsSped fará a conexão. 8

13 Finalize a configuração do ODBC 1.2. Informix Para que o TOPConnect se comunique com o banco de dados, é necessário que o client do Informix esteja na versão Verifique a versão do client Informix, selecionando a última aba "About IBM Informix ODBC". Caso a versão seja diferente da 2.90, favor providenciar a versão adequada (IBM Informix ODBC 2.90). O client de conexão do Informix deve ser instalado no diretório C:\Informix, para isto, deve-se selecionar a opção "Custom" durante a instalação. O TSS não deve ser instalado no mesmo servidor de banco de dados. Abra o painel de Controle > Ferramentas Administrativas > Fontes de Dados (ODBC). Deve ser adicionado em Fonte de dados de sistema o driver para o Banco de Dados Informix. Informe as configurações de acordo com o seu Banco de Dados. 9

14 Sugerimos que o nome da fonte de dados seja "TotvsSped", sem aspas Informe os dados de conexão do seu banco 10

15 Marque a opção "User Server Database Locale"; O Client Locale deve ter o mesmo valor do Database Locale. Em "Cursor Behavior", selecione a opção "1 - Preserve" e o "VMB Character" mantenha "0 - Estimate"; O "Fetch Buffer Size" deve ficar com o valor máximo,

16 A opção "Auto Commit Optimization" já vem marcada, deixe-a desta forma; Marcar as opções "Insert Cursors" e "Scrollable Cursors" 12

17 1.3. Oracle No banco de dados Oracle não é necessária uma configuração de dados ODBC, basta cadastrar no arquivo de conexões TNSNAMES.ora os dados da conexão com o banco. Obs.: Este arquivo geralmente fica na pasta raiz de instalação do Oracle\network\admin\TNSNAMES.ora. Informe as configurações de acordo com o seu Banco de Dados. Basta cadastrar os dados do seu servidor no arquivo mencionado acima. Obs.: Sugerimos que o nome da fonte de dados seja "TotvsSped", sem aspas No ORACLE também devem ser configuradas algumas variáveis de ambiente, para garantir a correta conexão do TOPConnect com o banco de dados. Devem-se criar as seguintes variáveis de ambiente de SISTEMA: Variável: ORACLE_HOME Variável: TNSADMIN Valor: Diretório onde se encontra o arquivo TNSNAMES.ora 13

18 2. Configuração do TOPConnect 1) Abra o TOPConnect que foi instalado anteriormente, dê um "Ok" na primeira tela para conectar no serviço TOPConnect 2) Selecione a aba "Configurações" e nas abas abaixo, a opção correspondente ao seu banco de dados, conforme exemplos abaixo. 3) Clique no botão "Novo", digite o nome do alias criado na conexão ODBC ("TotvsSped", conforme sugerido) e digite o usuário e senha de acesso ao banco. 14

19 SQL Server Informix 15

20 Oracle 6) Clique em "Salvar" para que as configurações sejam salvas no arquivo de configuração do TOPConnect. O TotvsServiceSped usará as informações deste arquivo para conectar no seu banco de dados. No banco de dados ORACLE, deve-se selecionar a opção Usar BLOB para campos MEMO, conforme a imagem acima. Esta opção está disponível apenas quando se configura o banco Oracle. Nas demais, por não ser necessária, esta opção não está disponível. É necessário apontar no arquivo de configuração do TOPConnect, o caminho aonde se localiza o arquivo OCI.dll 7) O arquivo de configurações do TOPConnect se chama topconn.ini e fica dentro do diretório onde o aplicativo foi instalado, por padrão, C:\Arquivos de Programas\TOPConnect ou C:\Program Files\TOPConnect (ou C:\TOPConnect caso seja um sistema 64-bits, conforme recomendado acima). Neste arquivo topconn.ini, deve ser adicionado na seção ORACLE a variável ClientLibrary, apontando para o arquivo OCI.dll, conforme exemplo abaixo: [ORACLE] environments=totvssped ClientLibrary=C:\oracle\ora92\bin\OCI.dll (A DLL fica no \bin do diretório de instalação do Oracle) 16

21 8) Em seguida, na aba Assistentes, selecione Validação de Conexão > Avançar, selecione o banco de dados a ser utilizado, informe o nome da fonte de dados que foi criada nas fontes de dados ODBC (como sugerido, "TotvsSped") e clique em "Finalizar", deverá ser exibida a informação "Conexão Ok". Caso aconteça algum erro, verificar os dados de conexão fornecidos. Clique na opção "Validação de Conexão" 17

22 Avançar Selecione o seu Banco de Dados 18

23 Coloque o nome de ambiente que você configurou anteriormente (como sugerido, "TotvsSped") e clique em "Finalizar" Caso esteja tudo certo, a seguinte mensagem será apresentada. Se alguma das informações estiver errada, será exibida uma mensagem de erro. Significa que existe algum erro de configuração no ODBC ou nos dados informados no TOPConnect. 19

24 CONFIGURAÇÕES NECESSÁRIAS NO SERVIDOR LOGIX 1) Instalar Java 1.5 ou superior (Java da Sun). 2) Baixar bibliotecas.jar necessárias para Nota Fiscal Eletrônica: itext205.jar, jdom1.1.jar e nfeletronica.jar. (site de suporte) Estes 3 arquivos devem ser salvos no servidor aonde está rodando o LOGIX, em um diretório de sua escolha, e devem ser configurados na variável de ambiente CLASSPATH conforme exemplo abaixo: No Linux export CLASSPATH=$CLASSPATH:/usr/itext205.jar:/usr/jdom1.1.jar:/usr/nfeletronica.jar No Windows set CLASSPATH=%CLASSPATH%;C:\usr\itext205.jar;C:\usr\jdom1.1.jar;C:\usr\nfeletron ica.jar Outra variável que deve ser configurada é a PROXY_NFE, necessária para comunicação entre o Logix e servidor TSS, conforme abaixo: PROXY_NFE=IP_SERVIDOR_TSS:PORTA (porta configurada no arquivo TotvsAppServer.ini). Ex.: PROXY_NFE= :8080 Caso o serviço esteja rodando na porta padrão (80), basta colocar o IP, não sendo necessário colocar :80. No Windows, esta configuração deve ser feita em todas as máquinas clientes que forem enviar as notas. 20

25 CONFIGURAÇÃO DO TOTVSSERVICESPED 1) Descompacte o arquivo diretamente no C:\, desta forma será criada a pasta "C:\TotvsSped\"com várias subpastas. 2) Dentro da subpasta "C:\TotvsSped\AppServer" deve-se editar o arquivo TotvsAppServer.ini com as seguintes configurações, conforme abaixo. a) Dentro da chave [sped] deve-se alterar os parâmetros abaixo: TopDatabase=mssql // Colocar uma das opções abaixo, correspondente ao seu banco de dados (como exemplo, foi usado o do SQL Server): mssql: SQL Server informix: Informix oracle: Oracle TopAlias=TotvsSped // Informar o nome da conexão usada no ODBC, neste caso, se foram seguidas as sugestões, basta deixá-la como está, que é "TotvsSped" [HTTP] Enable=1 Port=80(*) Path=c:\mp10\Html RpcEnable=1 instances=2,100 SessionTimeout=600 [IP LOCAL] // Alterar para o IP da máquina onde está sendo instalado o TotvsSped ENABLE=1 PATH=C:\mp10\web\ws ENVIRONMENT=SPED INSTANCENAME=ws RESPONSEJOB=JOB_WS DEFAULTPAGE=wsindex.apw Por padrão, o TotvsServiceSped utiliza a porta 80 para o serviço de comunicação, caso seu servidor já utilize esta porta para outros fins, escolha outra que esteja livre. Esta porta deverá ser configurada nas chaves: [localhost] e [IP_DO_SERVIDOR], conforme exemplo abaixo: [localhost:8080] e [ :8080] 3) Depois da configuração do arquivo TotvsAppServer.ini, deve-se iniciar o servidor TSS. Para isto, pode ser criado um atalho no desktop ou instalar como serviço. Opção 1 Atalho: 21

26 C:\TotvsSped\AppServer\TotvsAppServer.exe -console Se todos os parâmetros do TSS estiverem OK, uma tela, como demonstrado abaixo, será exibida. Opção 2 Serviço: Deve ser configurada uma chave dentro do arquivo totvsappserver.ini da seguinte maneira: [SERVICE] NAME=TOTVSSERVICESPED DISPLAYNAME= TotvsServiceSped (nome como será incluído na guia services do painel de controle do Windows) No diretório c:\totvssped\appserver será gerado um arquivo totvsconsole.log que conterá as informações que seriam demonstradas na tela acima, na opção 1 (atalho). Para testar se os serviços estão funcionando corretamente, basta abrir no seu browser o endereço ou caso tenha alterado para alguma outra porta, diferente da padrão (80). Obs.: O serviço "Log de Chamada de Serviços" é sempre desabilitado por padrão, não há necessidade de ativá-lo. 22

27 Uma página com todos os serviços dos webservices ativos será aberta no navegador. Na shell que executa o Logix, adicionar a seguinte linha: "umask 000" (sem aspas), para que ao executar o Logix, as devidas permissões sejam concedidas. Verifique se não há uma versão menor da biblioteca Itext instalada na máquina, se houver é recomendável que seja retirada. 23