Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
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.
O TSS um aplicativo que responde e realiza somente servios Web Service para se comunicar com o ERP e
com o fisco, sendo necessrio que o hardware de instalao possua conexo internet e tenha alto ndice de
confiabilidade.
Trabalha junto com o TopConnect, desta forma ser necessrio ter um banco de Dados relacional homologado
pela TOTVSTEC (Ex: SQL Server, Oracle, DB2, etc.).
Caso exista algum bloqueio de Firewall , este deve ser liberado para a comunicao junto aos Web Services do
Fisco.
Para iniciar a instalao do TSS, realize o download do Instalador do TSS por meio do portal do Cliente ou
Analista. Com o instalador baixado, realize o procedimento a seguir:
1 Passo
1. Execute o instalador do TSS, arquivo TSS.exe. Ser aberta a tela para seleo do idioma de instalao:
2 Passo
1. Ser apresentada a tela de Boas Vindas, com o Wizard de Instalao do TSS. Nesta tela clique em
Avanar:
2. Ser aberta a tela do Contrato de Licena. Leia atentamente e se aceitar todos os termos do contrato,
clique em Sim. Ao escolher No, o processo de instalao encerrado.
3. Na prxima tela, escolha a pasta de instalao do TSS em Procurar, por default ser C:\TotvsSped\.
Aps a escolha clique em Avanar.
4. Na prxima janela 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.
Caso este campo seja preenchido como LOCALHOST, o acesso se dar internamente apenas pelo servidor
no qual est instalado o TSS, qualquer outra mquina da Rede no enxergar o Servio.
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.
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.
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.
Para iniciar a atualizao do TSS ser necessrio realizar o download por meio do portal do Cliente ou Analista.
Realize o Update e siga o procedimento a seguir:
1 Passo
1. Baixe o servio do TSS a ser atualizado. Execute o Update do TSS, arquivo TSS-Update.exe, ao
realizar este processo ser aberta a tela para seleo do idioma da instalao.
2 Passo
1. Ser aberta a tela de Boas Vindas, com o Wizard de Instalao do TSS. Nesta primeira tela, clique em
Avanar.
2. Ser aberta a tela do Contrato de Licena, leia atentamente e caso aceite todos os termos, clique em
Sim.
3. Na prxima tela escolha a pasta de instalao do TSS, por default ser em C:\TotvsSped\. Aps a
escolha, clique em Avanar.
5. Na prxima etapa, se deseja executar o TSS como servio clique em Sim. O TSS ser
automaticamente colocado como servio do Windows. Para que seja instalado e executado em modo
console, clique em No.
Para iniciar a instalao do TSS, realize o download do Instalador do TSS por meio do portal do Cliente ou
Analista. Com o instalador baixado, realize o procedimento a seguir:
1 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.
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.
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.
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.
12. Salve a configurao e inicie o servio do TSS em modo console para verificar se a configurao est
correta.
No exemplo a seguir foi configurado o IP 172.16.70.155 e porta 8060, acessando via Navegador de
Internet:
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.
Existem algumas formas diferentes de se configurar o TSS, visando um melhor desempenho no processamento
das Notas Eletrnicas.
[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
A seo JOBLOC que define o job da Fatura Eletrnica (Argentina) foi desmembrada em
dois JOBS: JOBNFE_WSFEX e JOBNFE _WSFE.
Deve estar dentro da seo que estiver a configurao do TopConnect, geralmente na chave do ambiente
[Environment] ou na chave do TopConnect.
Exemplo:
[Environment]
TOPMEMOMEGA=1
XMLSAVEALL: permite que seja gravado na Pasta WSLOGXML, todos os XMLs de comunicao dos Mtodos
do TSS com a aplicao chamadora.
Esta chave deve ser habilitada somente para ajudar na anlise de inconsistncias, pois gera um grande
nmero de XMLs.
Exemplo:
[JOB_WS]
TYPE=WEBEX
ENVIRONMENT=SPED
INSTANCES=5,50
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
XMLSAVEALL=1
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 Descrio
0 (padro) Todos
1 Assinatura
2 Transmisso
3 Cancelamento/Inutilizao/Recepo de lotes
Exemplo
Neste exemplo, foi definido que ser processado apenas o JOB de assinatura.
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
1 Todos
Neste exemplo ser demonstrada a configurao padro do TSS. Ser configurado no mesmo servio o HTTP
e os JOBS.
Arquivo TOTVSAppserver.ini
Passo 3 - Configurao dos JOBS, e habilitando o start de todos os JOBS atravs da Seco [ONSTART]
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.
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
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.
Passo 3 - Configurao dos JOBS, e habilitando o start de todos os JOBS atravs da Seco [ONSTART]
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
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
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.
Atualmente esto disponveis no mercado dois tipos de certificados digitais, o certificado de tipo A1 (em formato
de arquivo com extenses .pfx ou .p12) e o certificado de tipo A3 ( tipo hardware, podendo ser um carto ou
token).
No TSS est homologado para uso apenas o tipo A1 e o tipo A3 (HSMs) da marca SAFENET, sendo que os
modelos homologados do tipo A3 (HSMs) foram:
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:
CKA_PRIVATE
CKA_VERIFY
CKA_SIGN
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;
Tabelas Utilizadas
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.