Escolar Documentos
Profissional Documentos
Cultura Documentos
Produto Data da criao Pas(es) FNC : TOTVS SERVICE SPED Verso 11 Data da reviso : 14/03/11
Esta documentao define qual o processo para instalao e configurao do TOTVS SERVICE SPED TSS. O TOTVS SERVICE SPED consiste em um servidor (appserver) que responder e realizar requisies de servios WebService. Este servidor tem o objetivo de realizar a comunicao entre os servios disponibilizados pelo fisco, especialmente os servios de Nota Fiscal Eletrnica, SPED Contbil, Nota Fiscal Eletrnica de Servio, entre outros.
7. Agora ser definido o Tipo de Instalao, ou seja, quais sero os jobs que o TSS subir ao ser iniciado. As opes so: Nota Fiscal Eletrnica; Nota Fiscal Eletrnica Localizado; Nota Fiscal de Servio; Conhecimento de Transporte Eletrnico.
8. Aps definir os servios, clique em Avanar. Antes de copiar os arquivos, confira a configurao realizada. 9. Clique em Avanar para continuar a instalao. Aguarde at que a barra de status da quantidade instalada chegue ao final. 10. Indique se deseja executar o TSS como servio. Ao clicar em Sim, o TSS ser automaticamente classificado como servio do Windows, a opo No faz com que seja somente instalado e iniciado em modo console. 11. Aps a escolha, clique em Concluir. 12. Salve a configurao e inicie o servio do TSS em modo console para verificar se a configurao est correta.
13. Se o server subir corretamente, acesse o endereo configurado na instalao do TSS via HTTP.
No exemplo a seguir foi configurado o IP 172.16.70.46 e porta 8080, acessando via Navegador de Internet:
Observao: Aps concluda a instalao do TSS, so gravados arquivos .CFG na pasta system, pois alguns Municpios no transmitem via Web Service. Para saber qual o municpio que transmite a partir destes arquivos, basta verificar o nome dos mesmos que so formados da seguinte maneira: NFSE_(Cdigo de municpio).cfg. Exemplo: NFSE_3132404.CFG (Municpio de Itajub - MG). Os Arquivos .CFG so responsveis pela gerao dos arquivos (.txt e .xml) no layout correto para importao nos portais das prefeituras descritas. Os arquivos de envio (.txt ou .xml) so salvos na pasta ARQGER e os arquivos de retorno (.txt ou .xml) devem ser salvos na pasta ARQIMP. Estas pastas encontram-se dentro do roothpath na pasta FTP.
3. O prximo passo ser a configurao do idioma de instalao. Digite 1 para informar a opo Portugus e digite <ENTER> para configurar o prximo passo.
4. O passo seguinte ser a configurao do Banco de Dados. Digite 1 para selecionar a opo TopConnect e digite <ENTER> para configurar o prximo passo.
5. Neste passo, ser configurado o servio de HTTP que o TSS disponibilizar. Configure o Servidor e a Porta.
Observao: Ateno! No campo Servidor deve ser informado o IP do Servidor no qual est sendo realizada a instalao, pois o Sistema Operacional Linux no entende como LOCALHOST, onde neste caso necessrio informar o IP 127.0.0.1. Aps preenchimento dos campos Servidor e Porta, digite <ENTER> para configurar o prximo passo. 6. Neste momento, ser realizada a configurao do TOP. Informe o Servidor, a Porta e Alias. Digite <ENTER> para configurar o prximo passo.
7. Neste momento ser definido se o JOB da Nota Fiscal Eletrnica subir no momento em que o TSS for iniciado. Informe 1- Sim ou 2 No. Digite <ENTER> para configurar o prximo passo.
8.
Neste momento ser definido se o JOB da Nota Fiscal Eletrnica Localizado subir no momento em que o TSS for iniciado. Informe 1- Sim ou 2 No. Digite <ENTER> para configurar o prximo passo.
9. Neste momento ser definido se o JOB da Nota Fiscal de Servio subir no momento em que o TSS for iniciado. Informe 1- Sim ou 2 No. Digite <ENTER> para configurar o prximo passo.
10. Neste momento ser definido se o JOB do Conhecimento de Transporte Eletrnico subir no momento em que o TSS for iniciado. Informe 1- Sim ou 2 No.
11. Aps configurao dos Servios, digite <ENTER> para que seja concluda a instalao.
12. Salve a configurao e inicie o servio do TSS em modo console para verificar se a configurao est correta.
13. Se o server subir corretamente, acesse o endereo configurado na instalao do TSS via HTTP. No exemplo a seguir foi configurado o IP 172.16.70.155 e porta 8060, acessando via Navegador de Internet:
Observaes: Ateno! A atualizao do TSS realizada a partir da execuo do instalador com a ltima verso disponvel no Portal do cliente / analista, pois no h pacote de Updates para o Sistema Operacional Linux. Aps concluda a instalao do TSS, so gravados arquivos .CFG na pasta system, pois alguns Municpios no transmitem via Web Service. Para saber qual o municpio que transmite a partir destes arquivos, basta verificar o nome dos mesmos que so formados da seguinte maneira: NFSE_(Cdigo de municpio).cfg. Exemplo: NFSE_3132404.CFG (Municpio de Itajub - MG). Os Arquivos .CFG so responsveis pela gerao dos arquivos (.txt e .xml) no layout correto para importao nos portais das prefeituras descritas. Os arquivos de envio (.txt ou .xml) so salvos na pasta ARQGER e os arquivos de retorno (.txt ou .xml) devem ser salvos na pasta ARQIMP. Estas pastas encontram-se dentro do roothpath na pasta FTP.
Como o TSS no apresenta uma interface, qualquer tipo de alterao na configurao deve ser feita diretamente no AppServer.INI. Veja a seguir as funcionalidades de algumas Sees/Chaves utilizadas no TSS e tambm alguns exemplos de configurao. Sees importantes para o TSS:
[SSLCONFIGURE] abaixo desta seo existem as chaves que so responsveis pela comunicao do Web Service, junto com as informaes do protocolo Criptogrfico (SSL Securty Sockets Layer) . Exemplo: [SSLConfigure] HSM=0 SSL2=1 SSL3=1 TLS1=1 BUGS=1 CertificateClient=C:\TSS\certs\000010_all.pem KeyClient=C:\TSS\certs\000010_key.pem [PROXY] caso exista um Proxy para o acesso a internet, a configurao do mesmo dever ser informada nas chaves desta seo. Exemplo: [PROXY] Enable=1 Server=endereo do proxy Port=porta do proxy User=dominio\login usurio Password=senha do usurio no proxy [JOBNFE] define o job da NF-e e CT-e. Exemplo: [JOBNFE] main=SPEDWF environment=SPED [NFSE_WF] define o job da NFS-e Exemplo: [NFSE_WF]
MAIN=NFSEWF ENVIRONMENT=SPED
A seo JOBLOC que define o job da Fatura Eletrnica (Argentina) foi desmembrada em dois JOBS: JOBNFE_WSFEX e JOBNFE _WSFE. [JOBNFE_WSFEX] define o job da Fatura Eletrnica de exportao da Argentina. Exemplo: [JOBNFE_WSFEX] main=JOB_WSFEX environment=SPED
[JOBNFE _WSFE] define o job da Fatura Eletrnica Nacional da Argentina. Exemplo: [JOBNFE_WSFE] main=JOB_WSFE environment=SPED Ao selecionar o servio de NF-e (nota fiscal eletrnica) ou CT-e (conhecimento de transporte eletrnico) no momento da instalao, ser gerado alm dos Jobs de cada servio (JOBNFE e CTE_WF) o JOB CLE_WF.
[CLE_WF] define o job da Capa de Lote Eletrnico. Exemplo: [CLE_WF] main= CLE_WF environment=SPED
[ONSTART] define quais os jobs sero iniciados. Exemplo: [ONSTART] JOBS= JOB_WS ,JOBNFE,NFSE_WF, JOBNFE_WSFEX,JOBNFE _WSFE,CLE_WF
NFESPED_WF: define se no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao processamento realizado pelo JOB da NF-e sero demonstradas. Exemplo: [Environment] NFESPED_WF=1
NFSE_WF_DEBUG: define se ser demonstrado no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao processamento realizado pelo JOB da NFS-e. Exemplo: [Environment] NFSE_WF_DEBUG =1
16 TSS TOTVS Service SPED
NFESPED_WFENTIDADES: define um range de entidades que sero processadas pelo JOB da NFE do TSS, parmetro muito utilizado quando existe a necessidade de se ter mais de um TSS utilizando um mesmo banco devido a um grande nmero de Entidades. Exemplo Neste exemplo, foi definido que ser processado pelo JOB da entidade 000005 at a entidade 000020. [Environment] NFESPED_WFENTIDADES=000005-000020
NFSE_WF_ENTIDADES: Define um range de entidades que sero processadas pelo JOB da NFS-e do TSS, parmetro muito utilizado quando existe a necessidade de se ter mais de um TSS utilizando um mesmo banco devido a um grande numero de Entidades. Exemplo Neste exemplo, foi definido que ser processado pelo JOB da entidade 000005 at a entidade 000020. [Environment] NFESPED_WFENTIDADES=000005-000020 NFESPED_WFNFE: define qual o JOB do TSS que ser processado, utilizado quando houver a necessidade de se ter mais de um TSS processando com o mesmo banco de dados, com este parmetro possvel definir um JOB para cada TSS. Contedos vlidos Valor 0 (padro) Todos 1 2 3 4 5 Exemplo Neste exemplo, foi definido que ser processado apenas o JOB de assinatura. Assinatura Transmisso Cancelamento/Inutilizao/Recepo de lotes Envio do e-mail de distribuio Recepo das Mensagens (emial)de Excees Descrio
[Environment] NFESPED_WFNFE=1
SPED_SAVEWSDL: habilita a gravao dos Xmls de comunicao do TSS com os WebService Externos.Esta chave deve ser habilitada apenas em casos que seja realmente necessrio, pois pode causar uma grande lentido na comunicao. Contedos vlidos valor Descrio
X(padro) Desconsidera o parmetro 1 2 3 4 5 6 7 8 9 A B C D E F Todos Web Service de Status Servio \ NF-e Web Service de Consulta Cadastro \ NF-e Web Service de Consulta Cadstro_1 \ NF-e Web Service de Cancelamento \ NF-e Web Service de Consulta Nota \ NF-e Web Service de Inutilizao \ NF-e Web Service de Recepo Lote \ NF-e Web Service de Retorno Recepo \ NF-e Web Service de Canelamento \ CT-e Web Service de Consulta \ CT-e Web Service de Inutilizao \ CT-e Web Service de Recepo \ CT-e Web Service de Retorno Recepo \ CT-e Web Service de Status Servio \ CT-e
G H I J K L M N O P Q
Web Service de Consulta \ DPEC Web Service de Recepo \ DPEC Web Service de Cancelamento \ NFS-e BH Web Service de Consulta Lote \ NFS-e BH Web Service de Consulta NFS-e \ NFS-e BH Web Service de Consulta NFS-e por RPS \ NFS-e BH Web Service de Consulta Situao LOTE \ NFS-e BH Web Service de Recepo \ NFS-e BH Web Service de Gerao de NFS-e \ NFS-e BH Web Service de Recepo \ NFS-e ISSnet Web Service de Consulta Situao LOTE \ NFS-e ISSnet Web Service de Consulta NFS-e por RPS \ NFS-e ISSnet Web Service de Consulta Lote \ NFS-e ISSnet Web Service de Consulta NFSE \ NFS-e ISSnet Web Service de Cancelamento \ NFS-e ISSnet
R S T U
V W X Y Z @
Web Service de Envio de Lote (ABRASF) Web Service de Consulta de Lote (ABRASF) Web Service de Cancelamento de Lote (ABRASF) Web Service de Envio de Lote (DSFNET) Web Service de Consulta de Lote (DSFNET) Web Service de Cancelamento de Lote (DSFNET)
Exemplo: No exemplo abaixo estou habilitando a gravao do XML que o TSS realizou a comunicao com os Servios de STATUS, CONSULTA e Recepo de Lote da NF-e. [Environment] SPED_SAVEWSDL=268
Exemplos Indicados para uso do TSS Exemplo 1 Modo de utilizao padro para empresas com baixo volume de movimentao. Neste exemplo ser demonstrada a configurao padro do TSS. Ser configurado no mesmo servio o HTTP e os JOBS. Estrutura de Diretrios (Windows):
Passo 3 - Configurao dos JOBS, e habilitando o start de todos os JOBS atravs da Seco [ONSTART]
Aps a configurao acima, ao iniciar o Servio em modo console, deve aparecer a seguinte tela com os JOBS iniciados e a verso atual do TSS:
Exemplo 2 Modo de utilizao com separao de servios, para empresas com mdio volume de movimentaes. Neste modo ser configurado dois servios, um apenas para o HTTP e outro apenas para os JOBS. Servio 1 - HTTP Realizar toda a configurao conforme o exemplo 1, deixando apenas de realizar o Passo 3 da configurao dos JOBS.
Servio 2 JOBS
A iniciar o servio em modo console ser mostrado apenas o start dos JOBS:
Exemplo 3 Modo de utilizao com separao de Servios de processamento do JOB, para empresas com alto volume de movimentaes. Neste exemplo ser demonstrado a configurao de 4 Servios, NFESPED_WFENTIDADES com um range de entidades configurado. Servio 1 Entidades de 000001 0000003 mais o servio de HTTP. Realize os mesmos procedimentos do Exemplo 1, s que no passo 1 inclua a chave NFESPED_WFENTIDADES da seguinte forma: cada um utilizar a chave
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Realize os mesmos procedimentos do Exemplo 1, mas no realize a configurao do HTTP (Passos 2 e 4) e no passo 1 inclua a chave NFESPED_WFENTIDADES da seguinte forma:
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Servio 4 Entidades de 000010 000012 sem os servios do HTTP. Realize os mesmos procedimentos do servio 2.
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Observao Para que seja apresentado no console as informaes dos jobs, habilite a chave NFESPED_WF = 1 para os jobs da NF-e e NFSE_WF_DEBUG=1 para os jobs da NFS-e. Observao Para o Exemplo 3 tambm possvel realizar a separao do processamento para os jobs da NFS-e, basta utilizar a chave NFSE_WF_ENTIDADES, no lugar da chave NFESPED_WFENTIDADES.
Arquivo TOTVSAppserver.ini
Passo 3 - Configurao dos JOBS, e habilitando o start de todos os JOBS atravs da Seco [ONSTART]
Aps a configurao acima, ao iniciar o Servio em modo console, deve aparecer a seguinte tela com os JOBS iniciados e a verso atual do TSS:
Exemplo 2 Modo de utilizao com separao de servios, para empresas com mdio volume de movimentaes. Neste modo ser configurado dois servios, um apenas para o HTTP e outro apenas para os JOBS. Servio 1 - HTTP Realizar toda a configurao conforme o exemplo 1, deixando apenas de realizar o Passo 3 da configurao dos JOBS.
Servio 2 JOBS Realizar a configurao conforme o Exemplo 1, deixando apenas de realizar os Passos 2 e 4.
A iniciar o servio em modo console ser mostrado apenas o start dos JOBS:
TSS TOTVS Service SPED 43
Exemplo 3 Modo de utilizao com separao de Servios de processamento do JOB, para empresas com alto volume de movimentaes. Neste exemplo ser demonstrado a configurao de 4 Servios, NFESPED_WFENTIDADES com um range de entidades configurado. Servio 1 Entidades de 000001 0000003 mais o servio de HTTP. cada um utilizar a chave
Realize
os
mesmos
procedimentos
do
Exemplo
1,
que
no
passo
inclua
chave
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Realize os mesmos procedimentos do Exemplo 1, mas no realize a configurao do HTTP (Passos 2 e 4) e no passo 1 inclua a chave NFESPED_WFENTIDADES da seguinte forma:
TSS TOTVS Service SPED 45
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.
Observao
48 TSS TOTVS Service SPED
Para que seja apresentado no console as informaes dos jobs, habilite a chave NFESPED_WF = 1 para os jobs da NF-e e NFSE_WF_DEBUG=1 para os jobs da NFS-e. Observao Para o Exemplo 3 tambm possvel realizar a separao do processamento para os jobs da NFS-e, basta utilizar a chave NFSE_WF_ENTIDADES, no lugar da chave NFESPED_WFENTIDADES.
LUNA SA LUNA SP LUNA PCI LUNA PCM PROTECTSERVER Externo PROTECTSERVER Gold ProtectHost EFT
Observao:
Para o pleno funcionamento da NF-e necessrio que o certificado digital no HSM seja importado com as seguintes diretivas:
Informaes Tcnicas
SPED000 - Tabela de Parmetros; SPED001 - Cadastro de Entidades ; SPED001A - Complemento de Entidades ; SPED050 - Notas Fiscais Eletrnicas; SPED050L - Factura Electrnica - Localizada; SPED051 Notas Fiscais Eletrnicas de Servio; SPED052 - Lote da NF-e; SPED052L - Lote da Factura Electrnica; SPED053 - Lote da NFS-e; SPED054 - Relacionamento Lote versus NF-e; SPED054L Relacionamento Lote versus Factura; SPED055 - Relacionamento Lote versus NFS-e; SPED056 - Nota Fiscal Eletrnica log de Contingncia.
Tabelas Utilizadas
Sistemas Operacionais
Windows/Linux