Boletim Tcnico

1 TSS TOTVS SERVICE SPED

TOTVS

Service SPED - TSS

Produto : TOTVS SERVICE SPED TSS Verso 10
Chamado : TFYDR2/ TGUIV1 / TGNCN9 / TGVIPT Data da publicao : 01/04/13
Pas(es) : Brasil / Argentina Banco(s) de Dados : Todos






Esta documentao define o processo para instalao e configurao do TOTVS

SERVICE SPED TSS.

O TOTVS

SERVICE SPED consiste em um servidor (appserver) que responde e realiza requisies de servios WebService. Este
servidor tem o objetivo de fazer a comunicao entre os servios disponibilizados pelo fisco, especialmente, os servios de Nota Fiscal
Eletrnica, Nota Fiscal Eletrnica de Servio, entre outros.



Boletim Tcnico


2 TSS TOTVS SERVICE SPED
Procedimento para Implementao
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 TOTVS

TEC
(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:
Instalao do TSS - Windows
1 Passo
1. Execute o instalador do TSS, arquivo TSS.exe. Ser aberta a tela para seleo do idioma de instalao:
2. Escolha a opo Portugus e clique em OK.
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.

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.
5. Aps preenchimento dos campos Servidor e Porta, clique em Avanar.
6. Neste momento, informe os campos Database, Alias e Servidor. Clique em Avanar.
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;
Boletim Tcnico
3 TSS TOTVS SERVICE SPED
Nota Fiscal Eletrnica [Totvs Colaborao];
Recebimento de Documentos [Totvs Colaborao];
Nota Fiscal de Servio [Totvs Colaborao];
Conhecimento de Transporte Eletrnico [Totvs Colaborao].
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.22 e porta 8080, acessando via IE:
Boletim Tcnico


4 TSS TOTVS SERVICE SPED

Procedimentos para Atualizao - Windows
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.
4. Reveja a configurao definida e clique em avanar para iniciar a atualizao
Boletim Tcnico
5 TSS TOTVS SERVICE SPED
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.
Aps a escolha, clique em Concluir.

Instalao do TSS - Linux
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 install_linux) via Terminal utilizando o comando ./install_linux.




2. Ser apresentada a mensagem de confirmao de instalao. Para continuar digite <ENTER>.
Boletim Tcnico


6 TSS TOTVS SERVICE SPED

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.
Boletim Tcnico
7 TSS TOTVS SERVICE SPED

5. Neste passo, ser configurado o servio de HTTP que o TSS disponibilizar. Configure o Servidor e a Porta.




Boletim Tcnico


8 TSS TOTVS SERVICE SPED

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.
Boletim Tcnico
9 TSS TOTVS SERVICE SPED

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.
Boletim Tcnico


10 TSS TOTVS SERVICE SPED

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.



Boletim Tcnico
11 TSS TOTVS SERVICE SPED
11. Neste momento definido se o JOB da Nota Fiscal Eletrnica [Totvs Colaborao] deve subir no momento em que o TSS for
iniciado. Informe 1- Sim ou 2 No.

12. Neste momento definido se o JOB de Recebimento de Documentos [Totvs Colaborao] deve subir no momento em que o
TSS for iniciado. Informe 1- Sim ou 2 No.

Boletim Tcnico


12 TSS TOTVS SERVICE SPED
13. Neste momento definido se o JOB de Nota Fiscal de Servio [Totvs Colaborao] deve subir no momento em que o TSS for
iniciado. Informe 1- Sim ou 2 No.

14. Neste momento definido se o JOB de Conhecimento de Transporte Eletrnico [Totvs Colaborao] deve subir no momento
em que o TSS for iniciado. Informe 1- Sim ou 2 No.

Boletim Tcnico
13 TSS TOTVS SERVICE SPED
15. Aps configurao dos Servios, digite <ENTER> para conclur a instalao.











Boletim Tcnico


14 TSS TOTVS SERVICE SPED
16. Salve a configurao e inicie o servio do TSS em modo console para verificar se a configurao est correta.

17. 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 IE:
Boletim Tcnico
15 TSS TOTVS SERVICE SPED


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.
Procedimentos de Configurao
Existem algumas formas diferentes de se configurar o TSS, visando um melhor desempenho no processamento das Notas
Eletrnicas.
Como o TSS no apresenta uma interface, qualquer tipo de alterao na configurao deve ser feita diretamente no
TotvsAppServer.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
Boletim Tcnico


16 TSS TOTVS SERVICE SPED
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 Nota Fiscal Eletrnica (NF-e).
Exemplo:
[JOBNFE]
main=SPEDWF
environment=SPED

[CTE_WF] Define o job do Conhecimento de Transporte Eletrnico (CT-e).
Exemplo:
[CTEWF]
main=CTEWF
environment=SPED

[CLE_WF] Define o job da Capa de Lote Eletrnica (CL-e).
Exemplo:
[CLE_WF]
main=CLE_WF
environment=SPED
[NFSE_WF] Define o job da Nota Fiscal de Servio Eletrnico (NFS-e).
Exemplo:
[NFSE_WF]
MAIN=NFSEWF
ENVIRONMENT=SPED

Boletim Tcnico
17 TSS TOTVS SERVICE SPED
[JOBNFE_WSFEX] Define o job da Nota Fiscal de Exportao da Argentina.
Exemplo:
[JOBNFE_WSFEX]
MAIN=JOB_WSFEX
ENVIRONMENT=SPED

[JOBNFE_WSFE] Define o job da Nota Fiscal interna da Argentina.
Exemplo:
[JOBNFE_WSFE]
MAIN=JOB_WSFE
ENVIRONMENT=SPED

[JOBNFE_WSMTX] Define o job da Nota Fiscal interna da Argentina Regime Dominacion 2904.
Exemplo:
[JOBNFE_WSMTX]
MAIN=JOB_WSMTX
ENVIRONMENT=SPED

[JOBNFE_WSBFE] Define o job da Nota Fiscal interna da Argentina Regime 2557.
Exemplo:
[JOBNFE_WSBFE]
MAIN=JOB_WSBFE
ENVIRONMENT=SPED

[JOBREMITO] Define o job que processa o remito eletrnico da Argentina.
Exemplo:
[JOBREMITO]
MAIN= JOB_WSREMITO
ENVIRONMENT=SPED

[JOBNFECOL] Define o job que processa a Nota Fiscal Eletrnica de Sada para TOTVS Colaborao.
Exemplo:
[JOBNFECOL]
MAIN=SPEDWFCOL
ENVIRONMENT=SPED

[JOBDOCSCOL] Define o job que processa a Nota Fiscal Eletrnica de Entrada para TOTVS Colaborao.
Exemplo:
Boletim Tcnico


18 TSS TOTVS SERVICE SPED
[JOBDOCSCOL]
MAIN=DOCSWFCOL
ENVIRONMENT=SPED

[JOBCTECOL] Define o job que processa o conhecimento de Transporte eletrnico (CT-e) para TOTVS Colaborao.
Exemplo:
[JOBCTECOL]
MAIN=CTEWFCOLAB
ENVIRONMENT=SPED

[JOBNFSECOL] Define o job que processa a Nota Fiscal de Servio Eletrnica (NFS-e) para TOTVS Colaborao.
Exemplo:
[JOBNFSECOL]
MAIN=NFSEWFCOL
ENVIRONMENT=SPED

[ONSTART] define quais os jobs sero iniciados.
Exemplo:
[ONSTART]
JOBS=JOBNFE,JOBNFE_WSFEX,JOBNFE_WSFE,JOBNFE_WSMTX,JOB_WSBFE,
NFSE_WF,CTE_WF,CLE_WF,JOBNFECOL,JOBDOCSCOL,JOBNFSECOL,JOBCTECOL
Algumas Chaves Importantes:
Abaixo esto listadas algumas chaves importantes para execuo do TSS. Elas esto divididas nos seguintes tpicos:

TSS.
Nota Fiscal Eletrnica (NF-e).
Nota Fiscal de Servio Eletrnica (NFS-e).
Nota Fiscal Localizada Argentina.
Conhecimento de Transporte Eletrnico (CT-e).
Capa de Lote Eletrnica (CL-e).
Totvs Colaborao.


TSS

TOPMEMOMEGA: permite que as conexes SGBD (Sistema de Gerenciamento de Banco de Dados), realizadas por meio do
ByYou DBAccess, utilizem campo M (Memo) com at 1000000 de bytes. Este parmetro necessrio, pois o TSS utiliza campos
MEMO para gravao dos XML.
Deve estar dentro da seo que estiver a configurao do TopConnect, geralmente na chave do ambiente [Environment]
ou na chave do TopConnect.
Boletim Tcnico
19 TSS TOTVS SERVICE SPED

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

SPED_SAVEWSDL: habilita a gravao dos Xmls de comunicao do TSS com os Web Services 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 Todos
2 Web Service de Status Servio \ NF-e
3 Web Service de Consulta Cadastro \ NF-e
4 Web Service de Consulta Cadastro_1 \ NF-e
5 Web Service de Cancelamento \ NF-e
6 Web Service de Consulta Nota \ NF-e
7 Web Service de Inutilizao \ NF-e
8 Web Service de Recepo Lote \ NF-e
9 Web Service de Retorno Recepo \ NF-e
A Web Service de Cancelamento \ CT-e
B Web Service de Consulta \ CT-e
C Web Service de Inutilizao \ CT-e
D Web Service de Recepo \ CT-e
E Web Service de Retorno Recepo \ CT-e
F Web Service de Status Servio \ CT-e
G Web Service de Consulta \ DPEC
H Web Service de Recepo \ DPEC
Boletim Tcnico


20 TSS TOTVS SERVICE SPED
I Web Service de Cancelamento \ NFS-e BH
J Web Service de Consulta Lote \ NFS-e BH
K Web Service de Consulta NFS-e \ NFS-e BH
L Web Service de Consulta NFS-e por RPS \ NFS-e BH
M Web Service de Consulta Situao LOTE \ NFS-e BH
N Web Service de Recepo \ NFS-e BH
O Web Service de Gerao de NFS-e \ NFS-e BH
P Web Service de Recepo \ NFS-e ISSnet
Q Web Service de Consulta Situao LOTE \ NFS-e ISSnet
R Web Service de Consulta NFS-e por RPS \ NFS-e ISSnet
S Web Service de Consulta Lote \ NFS-e ISSnet
T Web Service de Consulta NFSE \ NFS-e ISSnet
U

Web Service de Cancelamento \ NFS-e ISSnet
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)

NGSEND Web Service de Transmisso da NFS-e via TOTVS Colaborao

Exemplo:
Neste exemplo, foi definido que deve ser gravado o XML que o TSS realizou a comunicao com os Servios
de STATUS, CONSULTA e Recepo de Lote da NF-e.
[Environment]
SPED_SAVEWSDL=268

SPED_USASPEDBR: define se as tabelas do TSS a serem carregadas sero referentes ao Brasil. Contedo Vlido: 0 - No / 1-
Sim.
Exemplo:
[Environment]
SPED_USASPEDBR = 1

Nota Fiscal Eletrnica(NF-e)

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]
Boletim Tcnico
21 TSS TOTVS SERVICE SPED
NFESPED_WF=1

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

NFESPED_WFNFE: define qual o Job da NF-e 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.
4 Envio do e-mail de distribuio.
5 Recepo das Mensagens (email) de Excees.

Exemplo
Neste exemplo, foi definido que ser processado apenas o Servio de assinatura.
[Environment]
NFESPED_WFNFE=1

NFESPED_WORKFLOW: informa quais servios do JOB da NF-e sero executados.


Contedos vlidos
Valor Descrio
0 (padro) Todos.
1 Assinatura.
2 Transmisso.
3 Verifica Lotes Pendentes e Cancelamento/Inutilizao.
4 Envio do e-mail de distribuio.
5 Recepo da NF-e.
6 Assinatura / Transmisso/ Cancelamento de um Evento.

Boletim Tcnico


22 TSS TOTVS SERVICE SPED

Exemplo
Neste exemplo, foi definido que ser processado apenas o Servio de Transmisso.
[Environment]
NFESPED_WORKFLOW = 2

NFESPED_WF_SLEEPJOB: tempo em segundos que o TSS utiliza para aguardar o reincio do processamento dos Jobs da NF-e.
Exemplo
[Environment]
NFESPED_WF_SLEEPJOB = 30

NFESPED_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Nota Fiscal Eletrnica.
Exemplo
[Environment]
NFESPED_WFDELAY = 10

NFESPED_WFSMTP: define se ser enviado o e-mail de distribuio da NF-e. Contedo vlido: 0 - No / 1 Sim.
Exemplo
[Environment]
NFESPED_WFSMTP = 1

REFLOTE: define o nmero de referencia do lote.
Exemplo
[Environment]
REFLOTE = 50

SPED_HVERAO: define se o local em que o servidor de TSS se encontra est em horrio de vero.
Contedo vlido: 0 - inicial / 1 Sim / 2-No
Exemplo
[Environment]
SPED_HVERAO = 0
Nota Fiscal de Servio Eletrnica (NFS-e)

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]
Boletim Tcnico
23 TSS TOTVS SERVICE SPED
NFSE_WF_DEBUG =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]
NFSE_WF_ENTIDADES =000005-000020

NFSE_WORKFLOW: informa quais servios do JOB da NFS-e sero executados.
Contedos Vlidos
Valor Descrio
0 (padro) Todos.
1 Monta os lotes para transmisso.
2 Monta os lotes para Cancelamento.
3 Transmite os lotes pendentes.
4 Recepciona os lotes pendentes.
5 Verifica Substituio.

Exemplo
Neste exemplo, foi definido que ser processado apenas o Servio de Montagem dos lotes para
transmisso.
[Environment]
NFSE_WORKFLOW = 1

NFSE_WORKFLOW_1: este parmetro deve ser utilizado quando no houver o NFSE_WORKFLOW. Quando habilitado ir ativar
o servio de Montagem de Lotes para Transmisso. Contedo Vlido: 0 - Desativado / 1- Ativado.
Exemplo
[Environment]
NFSE_WORKFLOW_1 = 1

NFSE_WORKFLOW_2: este parmetro deve ser utilizado quando no houver o NFSE_WORKFLOW. Quando ativado ir habilitar
o servio de Montagem de Lotes para Cancelamento. Contedo Vlido: 0 - Desativado / 1- Ativado.
Exemplo
[Environment]
NFSE_WORKFLOW_2 = 1

Boletim Tcnico


24 TSS TOTVS SERVICE SPED
NFSE_WORKFLOW_3: este parmetro deve ser utilizado quando no houver o NFSE_WORKFLOW. Quando ativado ir habilitar
o servio de Transmisso dos Lotes Pendentes. Contedo Vlido: 0 - Desativado / 1- Ativado.
Exemplo
[Environment]
NFSE_WORKFLOW_3 = 1

NFSE_WF_SLEEP: tempo em segundos que o TSS aguarda para o reincio do processamento dos Jobs da NFS-e.
Exemplo
[Environment]
NFSE_WF_SLEEP = 30

NFSE_MODO_DEBUG: define se ser demonstrado no console as mensagens avanadas do Debug. Contedo Vlido : 0 - No /
1- Sim.
Exemplo
[Environment]
NFSE_MODO_DEBUG = 1

NFSE_GERLOG: define se ser gerado o log na pasta FTP. Contedo Vlido : 0 - No / 1- Sim.
Exemplo
[Environment]
NFSE_GERLOG = 1

NFSE_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Nota Fiscal de Servio Eletrnica.
Exemplo
[Environment]
NFSE_WFDELAY = 10
Nota Fiscal Eletrnica Localizada (Argentina).

NFELOC_WFENTIDADES: define um range de entidades que sero processadas pelo JOB da NF-e da Argentina, 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]
NFELOC_WFENTIDADES=000005-000020

Boletim Tcnico
25 TSS TOTVS SERVICE SPED
NFELOC_WFNFE: define qual o JOB do TSS - Argentina 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.
4 Envio do e-mail de distribuio.
5 Recepo das Mensagens (email) de Excees.

Exemplo
Neste exemplo, foi definido que ser processado apenas o JOB de assinatura.
[Environment]
NFELOC_WFNFE =1

NFELOC_WFDELAY: tempo de espera em segundos para reiniciar o Job por entidade referente ao Job Localizado (Argentina).
Exemplo
[Environment]
NFELOC_WFDELAY = 10

NFELOC_WF: define se no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao processamento realizado
pelo JOB da NF-e da Argentina sero demonstradas.
Exemplo
[Environment]
NFELOC_WF = 1

SAVE_LOCNFE: habilita a gravao dos Xmls de comunicao do TSS com os Web Services Externos. Esta chave deve ser
informada apenas em casos que seja realmente necessrio, pois pode causar uma grande lentido na comunicao. Para
habilita-lo dever configurar com 1 - Todos.
Exemplo
[Environment]
SAVE_LOCNFE = 1

NFELOC_USALOC: define se o ambiente utilizar transmisso Localizada - Argentina. Contedo Vlido : 0 - No / 1- Sim.
Exemplo
[Environment]
NFELOC_USALOC = 1
Boletim Tcnico


26 TSS TOTVS SERVICE SPED
Conhecimento de Transporte Eletrnico (CT-e)

SPED_DELMAIL: define se deve ser apagada a informao EMAIL= do XML do CT-e. Contedos Vlidos : 0 - No / 1- Sim.
Exemplo
[Environment]
SPED_DELMAIL = 1
Capa de Lote Eletrnica (CL-e)
SPED_USACLE: define se o ambiente utilizar a transmisso da Capa de Lote Eletrnica. Contedos Vlidos: 0 - No / 1- Sim.
Exemplo
[Environment]
SPED_USACLE = 1

CLE_WF_ENTIDADES: define um range de entidades que sero processadas pelo JOB da CL-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]
CLE_WF_ENTIDADES =000005-000020

CLE_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Capa de Lote Eletrnica.
Exemplo
[Environment]
CLE_WFDELAY = 10

CLE_WF_SLEEP: tempo em segundos que o TSS aguarda o reincio do processamento dos Jobs da CL-e.
Exemplo
[Environment]
CLE_WF_SLEEP = 30

CLE_WF_DEBUG: define se ser demonstrado no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao
processamento realizado pelo JOB da CL-e.
Exemplo
[Environment]
CLE_WF_DEBUG = 1

Boletim Tcnico
27 TSS TOTVS SERVICE SPED
CLE_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.
Exemplo
[Environment]
CLE_SAVEWSDL = 1

CLE_WORKFLOW: informa quais servios do JOB da CL-e sero executados. Servio disponvel: 1 -Transmisso.
Exemplo
[Environment]
CLE_WORKFLOW = 1

CLE_WORKFLOW_1: este parmetro deve ser utilizado quando no houver o parmetro CLE_WORKFLOW. Quando ativado ir
habilitar o servio de Transmisso da CL-e. Contedo Vlido: 0 - Desativado / 1- Ativado.
Exemplo
[Environment]
CLE_WORKFLOW_1 = 1
Totvs Colaborao

SPED_USACOLAB: define se o ambiente utilizar Totvs Colaborao para Transmisso de NF-e. Contedos Vlidos : 0 - No / 1-
Sim.
Exemplo
[Environment]
SPED_USACOLAB = 1

TSSCOLAB_RETRECEPCAO109: define o tempo de espera para retorno de Recebimento da NF-e atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO109 = 300

TSSCOLAB_RETRECEPCAO170: define o tempo de espera para retorno de Emisso da Nf-e atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO170 = 30

TSSCOLAB_RETRECEPCAO171: define o tempo de espera para retorno de Cancelamento da NF-e atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO171= 30
Boletim Tcnico


28 TSS TOTVS SERVICE SPED

TSSCOLAB_RETRECEPCAO172: define o tempo de espera para retorno de Inutilizao da NF-e atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO172= 30

TSSCOLAB_RETRECEPCAO199: define o tempo de espera para retorno de Emisso do CTE atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO199= 30

TSSCOLAB_RETRECEPCAO200: define o tempo de espera para retorno de Cancelamento do CTE atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO200= 30


TSSCOLAB_RETRECEPCAO201: define o tempo de espera para retorno de Inutilizao do CTE atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO201= 30

TSSCOLAB_RETRECEPCAO203: define o tempo de espera para retorno de Emisso da NFS-e atravs do Job Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO203= 300

TSSCOLAB_RETRECEPCAO204: define o tempo de espera para retorno de Cancelamento da NFS-e atravs do Job Totvs
Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO204 = 300

TSSCOLAB_RETRECEPCAO210: define o tempo de espera para retorno de Recebimento de Cancelamento da NF-e atravs do
Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO210= 300
Boletim Tcnico
29 TSS TOTVS SERVICE SPED

TSSCOLAB_RETRECEPCAO214: define o tempo de espera para retorno de Recebimento do CTE atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO214= 300

TSSCOLAB_RETRECEPCAO301: define o tempo de espera para retorno da CC-e atravs do Totvs Colaborao.
Exemplo
[Environment]
TSSCOLAB_RETRECEPCAO301= 30

DOCS_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Recebimento de NF-e para TOTVS
Colaborao.
Exemplo
[Environment]
DOCS_WFDELAY = 10

DOCS_WF_ENTIDADES: define um range de entidades que sero processadas pelo JOB que processa a Recebimento de NF-e
para TOTVS Colaborao no 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]
DOCS_WF_ENTIDADES =000005-000020

DOCS_WORKFLOW: informa quais servios do JOB dos Documentos para TOTVS COLABORAO sero executados. Servio
disponvel: 1- Transmite e verifica os documentos pendentes.
Exemplo
[Environment]
DOCS_WORKFLOW = 1

DOCS_WORKFLOW_1: este parmetro deve ser utilizado quando no houver o parmetro DOCS_WORKFLOW. Quando ativado
ir habilitar o servio de Transmisso e verificao dos documentos pendentes. Contedo Vlido: 0 - Desativado / 1- Ativado.
Exemplo
[Environment]
DOCS_WORKFLOW_1 = 1

Boletim Tcnico


30 TSS TOTVS SERVICE SPED
DOCS_WF_DEBUG: define se ser demonstrado no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao
processamento realizado pelo JOB do recebimento da NF-e atravs do Totvs Colaborao.
Exemplo:
[Environment]
DOCS_WF_DEBUG =1

DOCS_WF_SLEEP: tempo em segundos que o TSS aguarda o reincio do processamento dos Jobs do recebimento de NF-e
atravs do Totvs Colaborao.
Exemplo
[Environment]
DOCS_WF_SLEEP = 30


NFSECOL_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Job por entidade a partir da segunda chamada do
JOB, referente a Nota Fiscal de Servio Eletrnica via TOTVS Colaborao.
Exemplo
[Environment]
NFSECOL_WFENTIDADEWAIT=10

NFECOL_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Job por entidade a partir da segunda chamada do
JOB, referente a Nota Fiscal Eletrnica via TOTVS Colaborao.
Exemplo
[Environment]
NFECOL_WFENTIDADEWAIT=10

NFESPED_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Job por entidade a partir da segunda chamada do
JOB, referente a Nota Fiscal Eletrnica.
Exemplo
[Environment]
NFESPED_WFENTIDADEWAIT=10

NFSE_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Job por entidade a partir da segunda chamada do JOB,
referente a Nota Fiscal de Servio Eletrnica.
Exemplo
[Environment]
NFSE_WFENTIDADEWAIT=10

Boletim Tcnico
31 TSS TOTVS SERVICE SPED
CLE_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Job por entidade a partir da segunda chamada do JOB,
referente a Capa de Lote Eletrnica.
Exemplo
[Environment]
CLE_WFENTIDADEWAIT=10

NFELOC_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Job por entidade a partir da segunda chamada do JOB,
referente ao Localizado ( Argentina).
Exemplo
[Environment]
NFELOC_WFENTIDADEWAIT=10



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:

Arquivo TOTVSAppserver.ini
Passo 1 - Configurao do Environment [SPED]
Boletim Tcnico


32 TSS TOTVS SERVICE SPED


Passo 2 - Configurao do HTTP com o Enable = 1 (Habilitado)


Passo 3 - Configurao dos JOBS, e habilitando o start de todos os JOBS atravs da Seo [ONSTART]
Boletim Tcnico
33 TSS TOTVS SERVICE SPED

Passo 4 - Configurando o endereo de HTTP do servio:


Boletim Tcnico


34 TSS TOTVS SERVICE SPED
Aps a configurao acima, ao iniciar o Servio em modo console, deve aparecer a seguinte tela com os JOBS iniciados:


Exemplo 2 Modo de utilizao com separao de servios para empresas com mdio volume de movimentaes. Neste modo
so configurados 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.

Boletim Tcnico
35 TSS TOTVS SERVICE SPED

Ao iniciar o servio em modo console ser mostrado apenas servio de HTTP:


Servio 2 JOBS
Boletim Tcnico


36 TSS TOTVS SERVICE SPED
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:

Boletim Tcnico
37 TSS TOTVS SERVICE SPED


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, cada um utilizar a chave 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:
Boletim Tcnico


38 TSS TOTVS SERVICE SPED

Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.


Servio 2 Entidades de 000004 000006 sem os servios do HTTP.

Boletim Tcnico
39 TSS TOTVS SERVICE 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.


Servio 3 Entidades de 000007 000009 sem os servios do HTTP.

Realize os mesmos procedimentos do servio 2.
Boletim Tcnico


40 TSS TOTVS SERVICE 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.

Boletim Tcnico
41 TSS TOTVS SERVICE SPED


Ao ser iniciado o servio, apenas sero demonstradas estas entidades em processamento para os JOBS do SPED.






Boletim Tcnico


42 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.
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.
Certificados Homologados pelo TSS
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 esto homologados apenas dois Tipos: A1 e o A3.
Abaixo seguem as marcas e modelos de certificados tipo A3 aceitos:
HSMs da marca SAFENET:

LUNA SA
LUNA SP
LUNA PCI
LUNA PCM
PROTECTSERVER Externo
PROTECTSERVER Gold
ProtectHost EFT

Token da marca PRONOVA:
EPASS2000
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

Configurao manual de URL

Caso o usurio necessite usar uma URL especfica, diferente das padres de funcionamento do TSS, para comunicao com outros
Web Services, disponibilizado um sistema para que sejam includas e utilizadas no lugar das padres.