TSS Manual de Configuração PDF

Manual de Configurao - TSS
TSS
TOTVS Service SOA
do Treinamento
ndice
1. Introduo ............................................................................................................................................. 3
1.1. Instalao............................................................................................................................................ 3
1.2. Configurao ....................................................................................................................................... 5
1.2.1 WebService ....................................................................................................................................... 5
1.2.2 JOB ................................................................................................................................................... 6
1.2.2.1 NFe ................................................................................................................................................ 7
1.2.2.2 NFSe............................................................................................................................................... 8
1.2.2.3 NFCe .............................................................................................................................................. 9
1.2.2.4. MDe .............................................................................................................................................. 10
1.2.2.5. CTe................................................................................................................................................ 11
1.2.2.6 CLe ................................................................................................................................................. 12
1.2.2.7. MDFe ............................................................................................................................................ 13
1.2.2.8 Remito ........................................................................................................................................... 14
1.2.2.9 Nota Fiscal Argentina ...................................................................................................................... 15
1.2.2.10 TOTVS Colaborao ....................................................................................................................... 17
1.2.2.10.1 NFe............................................................................................................................................ 17
1.2.2.10.2 CTe ............................................................................................................................................ 18
1.2.2.10.3 NFSeSe ...................................................................................................................................... 20
1.2.2.10.4 MDe .......................................................................................................................................... 21
1.2.2.10.5 Documentos .............................................................................................................................. 22
1.2.2.10.6 MDFe......................................................................................................................................... 26
1.2.2.10.7 TOTVS Colaborao In House ...................................................................................................... 27
1.2.3 Configuraes gerais .......................................................................................................................... 28
1.2.4 Rede ................................................................................................................................................. 29
1.2.5 Interface ........................................................................................................................................... 30
1.2.5.1. Acesso ........................................................................................................................................... 30
1.2.5.2. TSSMonitor.................................................................................................................................... 30
1.2.5.3 TSSPortal ........................................................................................................................................ 31
1.2.5.4 TSSInterface ................................................................................................................................... 312
1.3. Balanceamento ................................................................................................................................... 344
1.3.1. Configuraes ................................................................................................................................... 344
1.3.1.1. Por JOB ......................................................................................................................................... 344
1.3.1.2 Por Procedimento ........................................................................................................................... 366
1.3.1.3 Por entidade ................................................................................................................................... 366
1.3.1.4. Estimativa ..................................................................................................................................... 377
1.4. Licenciamento ..................................................................................................................................... 388
2
TOTVS Service SOA
1.4.1. ERP Totvs ......................................................................................................................................... 399

1.4.2. ERP No Totvs .................................................................................................................................. 399
1. Introduo
O TSS (TOTVS Service SOA) uma aplicao baseada na arquitetura orientada a servios, em que o objetivo principal prover os
servios de emisso e manuteno de documentos fiscais eletrnicos como: Nota Fiscal Eletrnica (No), Conhecimento de Transporte
Eletrnico (CTe), Nota Fiscal de Servio Eletrnica (NFSe), Capa de Lote eletrnica (Seu), Manifesto de Documentos Fiscais Eletrnicos
(MDFe), Nota Fiscal Eletrnica para Consumidor Final (NFCe), Manifesto do destinatrio (MDe) e a mensageria de documentos entre
produtos homologados.
O TSS se conecta exclusivamente com ERPs homologados, sincronizando informaes e promovendo o repasse de dados tais como:
Pedidos de compra e venda;
Programao de entrega de mercadorias;
Repassagem de Nota Fiscal Eletrnica.
Alm de servir como um software de prestao de servios, o TSS tambm possui interfaces grficas para demonstrar informaes
interativas de suas operaes e disponibilizar funcionalidades diretamente com alguns servios especficos do produto.
Existem servios automticos para:
Importao de documentos eletrnicos;
Exportao de documentos eletrnicos;
Impresso e notificao ao usurio por e-mail de forma configurada para diversas ocorrncias no processo do Sistema.
Os servios so oferecidos pelo protocolo SOAP (via Web).
1.1. Instalao
A instalao e atualizao do TSS so realizadas por meio de um executvel que realiza todo o processo de forma assistida. O
instalador e atualizador esto disponveis no Portal do Cliente TOTVS em https://suporte.totvs.com seo de Download.
Instalao do TSS no Windows
1 Passo
1- Execute o instalador do TSS, arquivo TSS11.exe. aberta a tela para seleo do idioma de instalao.
2- Escolha o Idioma e clique em OK.
2 Passo
1- apresentada a tela de Boas Vindas com o Wizard de Instalao do TSS, clique em Avanar.
2- 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
TOTVS Service SOA
do Treinamento
3- Escolha a pasta de instalao do TSS em Procurar, por default C:\totvstped\. Aps, clique em Avanar.
4- Escolha o Idioma para o repositrio do TSS.
5- Configure o servio de HTTP que o TSS disponibilizar. Configure o servidor e a porta.
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.
6- Aps preenchimento dos campos Servidor e Porta, clique em Avanar.

7- Neste momento, informe os campos Database (MSSQL,ORACLE etc.), Alias (conexo ODBC criada para o banco de dados do
TSS) e Servidor. Clique em Avanar.
8- Aps definir os servios (Jobs) que devero ser executados, clique em Avanar. Antes de iniciar a cpia dos arquivos, confira
a configurao realizada.
9- Clique em Avanar para continuar a instalao. Aguarde at que a barra de status da porcentagem instalada chegue ao final.
10- Indique se deseja executar o TSS como servio. Esta mensagem s ocorre no sistema operacional Windows. Ao clicar em Sim,
o TSS automaticamente classificado como servio, a opo No faz com que seja somente instalado e iniciado em modo
console.
11- Clique em Concluir.
12- Salve a configurao e inicie o servio do TSS em modo console para verificar se a configurao est correta
13- Para verificar se o server est instalado corretamente, acesse o endereo do Web service configurado nos passos anteriores
via HTTP. Exemplo: http://127.0.0.1:8080/.
Atualizao no Windows
1 Passo
1- Baixe o servio do TSS que deve ser atualizado. Execute o Update do TSS, arquivo TSS11 - Update.exe, ao realizar este
processo aberta a tela para seleo do idioma da instalao.
2 Passo
1- aberta a tela de Boas Vindas, com o Wizard de Instalao do TSS. Nesta primeira tela, clique em Avanar.
2- 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 em C:\totvstped\. Aps a escolha, clique em
Avanar.
4- Reveja a configurao definida e clique em avanar para iniciar a atualizao
5- Indique se deseja executar o TSS como servio. Esta mensagem s ocorre no sistema operacional Windows. Ao clicar
em Sim o TSS automaticamente classificado como servio, a opo No faz que seja somente instalado e iniciado em
modo console.
Aps a escolha, clique em Concluir.
4
TOTVS Service SOA
Boletim Tcnico
Instalao do TSS no Linux
1 Passo
1- Execute o instalador do TSS (arquivo install_linux) via Terminal utilizando o comando ./install_linux.
2- apresentada a mensagem de confirmao de instalao. Para continuar digite <ENTER>.
3- O prximo passo 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 a configurao do Banco de Dados. Digite 1 para selecionar a opo TopConnect e digite <ENTER>
para configurar o prximo passo.
5- Configurar o servio de HTTP que o TSS disponibilizar. Configure o Servidor e a Porta.
6- Neste momento, dever ser realizada a configurao do TOP. Informe o Servidor, a Porta e Alias. Digite <ENTER> para
configurar o prximo passo.
7- Aps configurao dos Servios (Jobs) que devero ser executados, digite <ENTER> para concluir a instalao.
8- Salve a configurao e inicie o servio do TSS em modo console para verificar se a configurao est correta.
9- Para verificar se o server est instalado corretamente, acesse o endereo do Web Service configurado nos passos
anteriores via HTTP.
A atualizao do TSS realizada a partir da execuo do instalador com a ltima verso disponvel no
Portal do cliente, pois no h pacote de Update para o Sistema Operacional Linux.
O TSS deve estar atualizado sempre com a ltima verso para evitar uma falha de comunicao entre o TSS e os demais produtos
integrados.
1.2. Configurao
As sees configuradas durante a instalao do TSS podem ser editadas conforme necessidade, considerando os servios, o
WebService, configuraes de rede, processos automticos (JOBS) e a interface.
1.2.1 WebService
A abertura do WebService no TSS configurada pelo arquivo .ini do servidor da aplicao (dentro do diretrio TSS / Bin /
appserver, arquivo xxxxxxxx.ini).
No arquivo, necessrio conter a Seo que declara a execuo do WebService, a abertura da porta HTTP, o host e porta em que
o WebService funcionar:
Declarao da seo para execuo do WebService:

[JOB_WS]
TYPE=WEBEX
ENVIRONMENT=Nome do Environment
INSTANCES=5,10
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
5
TOTVS Service SOA
do Treinamento
ONCONNECT=__WSCONNECT
Abertura da porta HTTP:

[HTTP]
Enable=1
Port=8011; porta utilizada para comunicao HTTP.
Path=C:\instalao do tss \HTML
instances=40,100
SESSIONTIMEOUT=60000
Declarao da seo para host e porta do WebService:

[localhost: 8011]; o host o nome/IP da mquina hospedeira, a porta deve ser a mesma aberta para conexes HTTP.
ENABLE=1
PATH=C:\ instalao do tss \web\ws
ENVIRONMENT=Nome do Environment
RESPONSEJOB=JOB_WS; Nome da Seo de configurao da execuo do WebService.
INSTANCENAME=WS
DEFAULTPAGE=wsindex.apw
Na clusula que define o comportamento do WebService (JOB_WS) pode-se inserir o parmetro INSTANCES que recebe dois
nmeros separados por vrgula; o primeiro refere-se ao nmero de threads que ficam sempre rodando no WebService
esperando conexes, o segundo, o nmero mximo de threads, isto , quando as threads j criadas estiverem em utilizao,
cria-se uma thread que encerrada sob demanda at chegar a este nmero, ao ser esgotado no servidor, apresentada a
mensagem No free working threads. Para esta regra necessrio adicionar o JOB_WS ao ONSTART de JOBS do arquivo de
configurao, caso contrrio, o servidor cria threads apenas sob demanda sendo mais demorado o tempo de comunicao por
toda a lgica que isto envolve. Coloque o JOB_WS no ONSTART separado por vrgula dos demais JOBS, conforme exemplo a
seguir:
Declarao do JOB_WS na seo ONSTART
[ONSTART]
JOBS=JOB_WS, JOBNFE
Executando o servidor de aplicao com a configurao do WebService, ao acessar o host e porta por protocolo HTTP (pelo
navegador Web, por exemplo), exibe-se a pgina do WebService com os servios e mtodos compilados no repositrio do TSS,
assim como as especificaes WSDL de cada servio.
1.2.2 JOB
O TSS possui processos automticos (JOBS) para a manipulao de documentos eletrnicos.

Os JOBS existentes no TSS so para os documentos No, NFSe, NFCe, CTe, Seu, MDe, MDFe, e servios para o mercado
internacional que podem ser configurados para realizao de procedimentos especficos sobre o documento e em apenas
algumas entidades (empresas/filiais).
6
TOTVS Service SOA
1.2.2.1 NFe
A configurao do JOB da NFe no arquivo .ini do servidor do TSS realizada da seguinte forma:
Seo do JOB:
[JOBNFE]
main=SPEDWF
Environment=Nome do Environment
Ativao do JOB da NFe:

[ONSTART]
JOBS=JOBNFE
O JOB da NFe responsvel pela execuo das seguintes rotinas:

Emisso de NFe:
1=Realiza assinatura das NFe.
2= Transmite NFe pendentes.
3= Verifica lotes pendentes/realiza cancelamento e inutilizao de NFe.
4= Dispara e-mail de distribuio das NFe.
Recebimento de NFe:
5=Busca no servidor de entrada de Email, notas fiscais recebidas e gera registro de entrada na tabela SPED060.
Eventos da NFe:
6= Processa eventos relacionados emisso de NFe, como carta de correo, cancelamento e registro de sada.
As rotinas que devero ser executadas podem ser configuradas atravs do parmetro NFESPED_WORKFLOW, separadas por
vrgula (Por exemplo: 1, 2,3), caso no informado o default zero (0):
Abaixo, temos uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com seus
valores padro:
Rotinas a serem executadas:

[Environment]
NFESPED_WORKFLOW=0
Intervalo de Entidades para processamento:

[Environment]
NFESPED_WFENTIDADES
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas apenas as entidade
de 000001 000005.
Intervalo de tempo em segundos para execuo das rotinas:

[Environment]
NFESPED_WFDELAY = 10
Intervalo de tempo em segundos para execuo entre as entidades:

[Environment]
NFESPED_WFENTIDADEWAIT = 10
tempo de espera para reincio do processamento do Job:

[Environment]
NFESPED_WF_SLEEPJOB = 30
7
TOTVS Service SOA
do Treinamento
Habilita a notificao das Threads em processamento no console do TSS:
0=Desabilita
1=Habilita
[Environment]
SPED_THREADID = 0
Habilita a notificao do processamento das rotinas no console do TSS:

0=Desabilita
1=Habilita
2=Notifica apenas quando houver documentos processados pela rotina.
[Environment]
NFESPED_WF= 0
Habilita o uso do horrio de vero:

0=No configurado
1= Sim.
2=No.
[Environment]
SPED_HVERAO = 0
1.2.2.2 NFSe
A configurao do JOB da NFSe no arquivo .ini do servidor do TSS realizada da seguinte forma:
Seo do JOB:
[NFSE_WF]
main=NFSEWF
ativao do JOB da NFSe:

[ONSTART]
JOBS=NFSE_WF
O JOB da NFSe, responsvel pela execuo das seguintes rotinas:
Emisso de NFSe:
1=Monta os lotes para emisso de NFSe

2=Monta os lotes para emisso de cancelamentos de NFSe.
3=Transmite os lotes pendentes.
4=Recepciona os lotes pendentes.
5=Atualiza informaes de RPS substitudos.
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFSE_WORKFLOW, separadas por vrgula
(Por exemplo:1,2,3), caso no informado o default 0.
Abaixo, segue uma lista dos parmetros que podero ser configurados. Todos so de uso opcional e esto listados com seus valores
padres:
8
TOTVS Service SOA

[Environment]
NFSE_WORKFLOW=0

[Environment]
NFSE_WF_ENTIDADES=000001-000005
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas as entidade de 000001
000005.
Intervalo de tempo em segundos entre a execuo das rotinas do Job:

[Environment]
NFSE_WFDELAY = 10
Tempo de espera para reincio do processamento do Job:

[Environment]
NFSE_WF_SLEEP =30
Intervalo de tempo em segundos entre a execuo das entidades:

[Environment]
NFSE_WFENTIDADEWAIT = 10

0=Desabilita
1=Habilita
[Environment]
NFSE_WF_DEBUG=0
1.2.2.3 NFCe
A configurao do JOB da NFCe no arquivo .ini do servidor do TSS realizada da seguinte forma:
Seo do JOB
[NFCE_WF]
main=NFCEWF
Ativao do JOB da NFCe

[ONSTART]
JOBS=NFCE_WF
O JOB da NFCe, responsvel pela execuo das seguintes rotinas:

Emisso de NFCe:
nfceOffLine: Remessa de NFCe emitida em contingncia;
nfceOffLote: Retorno de NFCe emitido em contingncia;
nfceInutiliza: Remessa e Retorno de inutilizao;
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFCE_JOB_ROTINAS separadas por
vrgula, caso no informado o default executar todos:
9
TOTVS Service SOA
do Treinamento
Abaixo, segue uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com seus
valores padres:
Rotinas a serem executadas

[Nome do Environment]
NFCE_JOB_ROTINAS= nfceOffLine, nfceOffLote, nfceInutiliza
Entidades a serem processadas

NFCE_JOB_ENTIDADES=000001-000005 //Por padro sero processadas todas as entidades ativas do sistema. Nesse exemplo
sero processadas as entidade de 000001 000005.
Intervalo para execuo das rotinas em segundos:

NFCE_JOB_ATRASO=30
Intervalo do reincio para execuo das rotinas em segundos:

NFCE_JOB_INTERVALO=60
1.2.2.4. MDe
O JOB de processamento do MDe o mesmo da NFe, assim como os parmetros de configurao. Para a utilizao deve se apenas
adicionar a rotina no parmetro NFECOL_WORKFLOW=8, caso o parmetro no exista ou esteja configurado com 0 a rotina
tambm executada.
Seo do JOB:
[JOBNFE]
main=SPEDWF
Ativao do JOB do MDe:

[ONSTART]
JOBS=JOBNFE
valores padres.

[Environment]
NFESPED_WORKFLOW=0

[Environment]
NFESPED_WFENTIDADES=000001-000005
Por padro sero processadas todas as entidades ativas no Sistema. Nesse exemplo sero processadas apenas as entidade de
000001 000005.
10
TOTVS Service SOA

[Environment]

[Environment]

[Environment]
Habilita informaes das Threads em processamento no console do TSS:

0=Desabilita
1=Habilita
[Environment]
SPED_THREADID= 0

0=Desabilita
1=Habilita
2=Notifica apenas quando houver documentos processados
[Environment]
NFESPED_WF=0
1.2.2.5. CTe
O JOB de processamento do CTe o mesmo utilizado para a NFe e MDFe, mudando apenas a seo e a chamada do JOB no
arquivo .ini do TSS que dever ser feita atravs da criao de uma seo para o CTe:
Seo do JOB
[CTE_WF]
main=CTEWF
Ativao do JOB do CTe:

JOBS=CTE_WF
O JOB do CTe responsvel pela execuo das seguintes rotinas:
Emisso de CTe:
1=Realiza a assinatura dos CTe.
2= Transmite os CTe pendentes.
3= Verifica os lotes pendentes e realiza o cancelamento e inutilizao de CTe.
4= Envia o e-mail de distribuio da CTe.
Recebimento de CTe:
5=Busca no servidor de entrada de e-mail, conhecimentos de transporte recebidos e gera registro de entrada na tabela SPED060
Eventos de emisso de CTe.
6= Processa o eventos relacionadas a emisso de CTe (ainda no disponvel).
11
TOTVS Service SOA
do Treinamento
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFESPED_WORKFLOW, separadas por
vrgula (Por exemplo: 1,2,3), caso no informado o default 0.
Abaixo, segue uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com seus valores
padres:

[Environment]
NFESPED_WORKFLOW=0

[Environment]
a 000005.
Intervalo de tempo em segundos entre a execuo das rotinas:

[Environment]
Intervalo de tempo em segundos entre execuo das entidades:

[Environment]

[Environment]
Habilita a notificao das Threads em processamento no console do TSS:

0=Desabilita
1=Habilita
[Environment]
SPED_THREADID= 0
1.2.2.6 CLe
A configurao do JOB da CLe no arquivo .ini do servidor do TSS realizada da seguinte forma:
Seo do JOB
[CLE_WF]
main=CLE_WF
Ativao do JOB da CLe:

[ONSTART]
JOBS=CLE_WF
Para a CLe existe apenas a rotina de transmisso. Abaixo segue uma lista dos parmetros que podero ser configurados, todos so
de uso opcional e esto listados com seus valores padres:
12
TOTVS Service SOA
Intervalo de entidades para processamento:

CLE_WF_ENTIDADES =000001-000005
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas as entidade de 000001 a
000005.
Intervalo de tempo em segundos entre execuo das rotinas:

[Environment]
CLE_WF_DELAY=10

[Environment]
CLE_WFENTIDADEWAIT = 1

[Environment]
CLE_WF_SLEEP =30
Habilita mensagens do processamento da CLe no console do TSS:

0=Desabilita
1=Habilita
2=Apenas quando existir documentos processados
[Environment]
CLE_WF_DEBUG=0
1.2.2.7. MDFe
A rotina de processamento do MDFe a mesma utilizada para a NFe e CTe, mudando apenas a seo e a chamada do JOB no
arquivo .ini do TSS que dever ser feita atravs na criao de uma seo para o MDFe:
Seo do JOB
[JOB_MDFE]
main=MDFEWF
Ativao do JOB do MDFe:

JOBS=JOB_MDFE
O JOB do MDFe, responsvel pela execuo das seguintes rotinas:

Emisso de MDFe:
1 = Realiza a assinatura dos MDFe.
2 = Transmite os MDFe pendentes.
3 = Consulta lotes pendentes.
4 = Envia o e-mail de distribuio do MDFe.
Eventos do MDFe.
6 = Processa os eventos relacionadas a emisso de MDFe.
13
TOTVS Service SOA
do Treinamento
vrgula (Por exemplo:1,2,4), caso no informado o default 0.
Abaixo, segue uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com seus valores
padres:

[Environment]
NFESPED_WORKFLOW=0

[Environment]
NFESPED_WFENTIDADES =000001-000005
a 000005.

[Environment]
Intervalo de tempo em segundos entre a execuo das entidades:

[Environment]

[Environment]
Habilita informaes das Threads em processamento no console do TSS:

0=Desabilita.
1=Habilita.
[Environment]
SPED_THREADID= 0:
1.2.2.8 Remito
Este JOB realiza as operaes sobre o remito eletrnico da Argentina (COT).

A configurao do remito no arquivo .ini do servidor do TSS realizada da seguinte forma:
Seo do JOB:
[JOBREMITO]
main=JOB_WSREMITO
Environment=SPED
[Environment]
NFELOC_USALOC=1
Ativao do JOB do Remito:

[ONSTART]
14
TOTVS Service SOA
JOBS=JOBREMITO
O JOB do Remito, responsvel pela execuo das seguintes rotinas:

Emisso de Remito:
1=Monta os lotes de remitos a transmitir.
2=Transmite os lotes de remito.
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro REMITOLOC_WORKFLOW, separadas por
vrgula (1,2), caso no informado o default 0.
valores padres:

[Environment]
REMITOLOC_WORKFLOW=1
Configurao do range de entidades para processamento:

[Environment]
REMITOLOC_WFENTIDADES =000001-000005
a 000005.

[Environment]
REMITOLOC_WF_SLEEPJOB= 10
Intervalo de tempo em segundos para execuo das rotinas configuradas:

[Environment]
REMITOLOC_WF_DELAY= 10

[Environment]
REMITOLOC_WFENTIDADEWAIT = 1
Habilita notificao do processamento das rotinas no console do TSS:

[Environment]
NFESPED_WF
0=Desabilita.
1= Habilita.
2=Apenas quando houver documentos processados.
1.2.2.9 Nota Fiscal Argentina
Existem 4 modelos diferentes de Nota Fiscal Argentina abordadas da mesma forma pelo TSS, para cada modelo deve- se criar
uma seo para execuo:
1- Nota Fiscal de Exportao:

[JOB_WSFEX]
main=JOB_WSFEX
15
TOTVS Service SOA
do Treinamento
2- Nota Fiscal Interna:
[JOB_WSFE]
main=JOB_WSFE
3- Nota Fiscal Interna Regime Dominacion 2904:
[JOB_WSMTX]
main=JOB_WSMTX
4- Nota Fiscal Interna Regime 2557:
[JOB_WSBFE]
main=JOB_WSBFE
Para que as rotinas sejam executadas, devero ser adicionadas na seo ONSTART, conforme exemplo abaixo:
[ONSTART]
JOBS= JOBNFE_WSFEX,JOBNFE_WSFE,JOBNFE_WSMTX,JOB_WSBFE
valores padres:
Intervalo de entidades para processamento.

NFELOC_WFENTIDADES =000001-000005
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas as entidade de 000001 a
000005.

[Environment]
NFELOC_WFDELAY = 10

[Environment]
NFELOC_WFENTIDADEWAIT = 10

[Environment]

0= Desabilita
1=Habilita
2=Apenas quando houver documentos processados
[Environment]
NFESPED_WF= 0
16
TOTVS Service SOA
Aps configurar as entidades, todos os Jobs de Nota Fiscal Argentina assumem as mesmas entidades, deve-se ento configurar
mais de um servidor para rodar Jobs diferentes, caso seja queira ter cada JOB processando entidades diferentes.
1.2.2.10 TOTVS Colaborao
Atualmente o TOTVS Colaborao atende aos seguintes servios eletrnicos:
NFe/Eventos
CTe
NFSe
MDe
MDFe
Documentos especficos (Exemplo: Pedidos de Compra e Venda)
TOTVS Colaborao In House
A integrao TOTVS Colaborao uma ligao entre o TSS e a NeoGrid, em que o TSS responsvel por repassar mensagens
entre a NeoGrid e os ERPs.
1.2.2.10.1 NFe
A configurao do JOB de NFe para TOTVS Colaborao realizado da seguinte maneira:
Seo do Job
[JOBNFECOL]
main=SPEDWFCOL
Ativao do Job
[ONSTART]
JOBS=SPEDWFCOL
O JOB do NFe, responsvel pela execuo das seguintes rotinas:

Emisso de NFe:
2= Transmite NFe pendentes.
3= Transmite cancelamentos pendentes.
4=Verifica lotes pendentes.
6=Realiza a confirmao de recebimento do documento para a Neogrid.
Eventos da NFe:
7=Processa os eventos da NFe como a carta de correo por exemplo.
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFECOL_WORKFLOW, separadas por vrgula
(Por exemplo: 1,2,3), caso no informado o default 0.
Abaixo, temos uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com seus valores
padres:

[Environment]
NFECOL_WORKFLOW=0
17
TOTVS Service SOA
do Treinamento
[Environment]
000001 a 000005.

[Environment]
NFESPED_WFDELAY = 2

[Environment]
NFECOL_WFENTIDADEWAIT = 1

[Environment]
Habilita as informaes das Threads em processamento no console do TSS:

0=Desabilita
1=Habilita
[Environment]
SPED_THREADID= 0

0=Desabilita
1=Habilita
[Environment]
NFESPED_WF=0
Habilita o uso do horrio de vero:

0=No configurado
1= Sim.
2=No.
[Environment]
SPED_HVERAO = 0
1.2.2.10.2 CTe
O JOB de processamento de CTe o mesmo utilizado para a NFe e MDFe, mudando apenas a seo e a chamada do JOB no
arquivo .ini do TSS que dever ser feita atravs da criao da seo para o CTe:
Seo do Job
[JOBCTECOL]
main=CTEWFCOLAB
18
TOTVS Service SOA
Ativao do Job
[ONSTART]
JOBS= JOBCTECOL
O JOB do CTe, responsvel pela execuo das seguintes rotinas:
Emisso de CTe:
2= Transmite os CTe pendentes.
3=Transmite o cancelamento e inutilizao de CTe.
4= Busca retorno dos lotes pendentes.
6= Realiza confirmao de recebimento para a Neogrid.
Eventos do CTe:
7=Processa os eventos do CTe.
vrgula (Por exemplo 1,2,3), caso no informado o default 0.
valores padro:

[Environment]
NFECOL_WORKFLOW=0

[Environment]
000001 a 000005.

[Environment]
NFESPED_WFDELAY = 2

[Environment]

[Environment]

0=Desabilita
1=Habilita
[Environment]
SPED_THREADID= 0
19
TOTVS Service SOA
do Treinamento
Habilita a notificao do processamento no console do TSS:
0=Desabilita
1=Habilita
[Environment]
NFESPED_WF=0
Qualquer configurao realizada quanto aos procedimentos e/ou entidades que sero processadas, afetam o JOB de NFe e CTe
igualmente, por utilizarem os mesmos parmetros do arquivo .ini.
1.2.2.10.3 NFSeSe
O JOB para o envio de NFSe configurado da seguinte maneira:
Seo do Job
[NFSEWFCOL]
main=NFSEWFCOL
Habilitao do Job
[ONSTART]
JOBS=NFSEWFCOL
O JOB do da NFSe, responsvel pela execuo das seguintes rotinas:
Emisso de NFSe:
1=Transmite lotes pendentes.
2= Transmite cancelamentos pendentes.
4=Busca retorno dos lotes pendentes.
6=Realiza confirmao de recebimento dos documentos para Neogrid.
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFSECOL_WORKFLOW, separadas por
Abaixo, temos uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com seus valores
padres:

NFSECOL_WORKFLOW=0

NFSEWF_ENTIDADES=000001-000005
000001 a 000005.
20
TOTVS Service SOA

[Environment]
NFSE_WFDELAY = 10

[Environment]
NFSECOL_WFENTIDADEWAIT = 1

[Environment]
NFESPED_WF_SLEEPJOB =30

0=Desabilita
1=Habilita
[Environment]
SPED_THREADID= 0

0=Desabilita
1=Habilita
[Environment]
NFSE_WF_DEBUG=0
1.2.2.10.4 MDe
O JOB de processamento do MDe o mesmo da NFe, assim como os parmetros de configurao. Para a utilizao deve - se
apenas adicionar a rotina no parmetro NFECOL_WORKFLOW=8, caso o parmetro no exista ou esteja configurado com 0 a
rotina tambm executada.
Seo do Job
[SPEDWFCOL]
main=SPEDWFCOL
Ativao do Job
[ONSTART]
JOBS=SPEDWFCOL
valores padres:

[Environment]
NFECOL_WORKFLOW=0
Configurao do intervalo de entidades para processamento:

[Environment]
Por padro sero processadas todas as entidades ativas no Sistema. Nesse exemplo sero processadas as entidade de 000001
a 000005.
21
TOTVS Service SOA
do Treinamento
[Environment]
NFESPED_WFDELAY = 2

[Environment]

[Environment]

0=Desabilita
1=Habilita
[Environment]
SPED_THREADID= 0
1.2.2.10.5 Documentos
Este JOB realiza operaes de recebimento de documentos fiscais e procedimentos exclusivos com o TOTVS Colaborao. A
definio das rotinas a serem executadas, devem ser configuradas no parmetro DOCS_WORKFLOW.
A configurao do JOB deve ser realizada da seguinte forma:
Seo do Job:
[DOCSWFCOL]
main=DOCSWFCOL
Ativao do Job
[ONSTART]
JOBS=DOCSWFCOL
O JOB do DOCS, responsvel pela execuo das seguintes rotinas:
Recebimento de NFe para o Destinatrio:

Realiza o recebimento das NFe emitidas para os clientes Totvs colaborao. Para o recebimento deste tipo de documento, o
parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[Environment]
DOCS_WORKFLOW=1
Recebimento de NFe para o Transportador:

Realiza o recebimento de NFe para os clientes Totvs colaborao que atuam como transportador da NFe. Para o recebimento deste
tipo de documento, o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
22
TOTVS Service SOA
[Environment]
DOCS_WORKFLOW=1
Recebimento de Cancelamento de NFe:

Realiza o recebimento de cancelamento de NFe emitido para os clientes Totvs colaborao. Para o recebimento deste tipo de
documento, o parmetro DOCS_WORKFLOW dever estar configurado a seguinte forma:
[Environment]
DOCS_WORKFLOW=1
Recebimento de CTe:
Realiza o recebimento de CTe emitidos para os clientes Totvs colaborao. Para o recebimento deste tipo de documento, o
[Environment]
DOCS_WORKFLOW=1
Recebimento de cancelamento de CTe:

Realiza o recebimento de cancelamento de CTe emitidos para os clientes Totvs colaborao. Para o recebimento deste tipo de
documento, o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[Environment]
DOCS_WORKFLOW=1
Pedido de Venda:
Realiza transmisso de pedidos de venda emitido pelos clientes Totvs Colaborao. Para a transmisso deste tipo de documento, o
[Environment]
DOCS_WORKFLOW=2
Documento de Aviso de Embarque de NFe:

Realiza transmisso de Avisos de embarque emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de documento,
o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[Environment]
DOCS_WORKFLOW=3
Documento de programao de entrega:

Realiza transmisso de programaes de entrega emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=4
Recebimento do Pedido de Compra:

Realiza recebimento de pedidos de compra gerado pelo Totvs colaborao. Para a transmisso deste tipo de documento, o
[Environment]
DOCS_WORKFLOW=5
23
TOTVS Service SOA
do Treinamento
Recebimento de Aviso de Embarque para NFe:
Realiza o recebimento de Avisos de embarque integrados com o Totvs colaborao. Para a transmisso deste tipo de documento, o
[Environment]
DOCS_WORKFLOW=6
Recebimento de programao de entrega:

Realiza o recebimento de programaes de entrega emitidos pelos clientes Totvs colaborao. Para o recebimento deste tipo de
[Environment]
DOCS_WORKFLOW=7
Recebimento de NFSe:
Realiza a transmisso da NFSe emitidas para os clientes Totvs colaborao. Para a transmisso deste tipo de documento, o
[Environment]
DOCS_WORKFLOW=8
Envio de Itens:
Realiza a transmisso dos itens de pedidos emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de documento,
o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[Environment]
DOCS_WORKFLOW=9
Local de estoque:
Realiza a transmisso de cadastros de Local de estoque emitidos pelos Clientes Totvs Colaborao. Para a transmisso deste tipo
de documento, o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[Environment]
DOCS_WORKFLOW=10
Cadastro de Origem:
Realiza a transmisso de cadastros de origem emitido pelos clientes Totvs Colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=11
Cadastro local de estoque:

Realiza a transmisso de Cadastros de local de estoque emitido pelos clientes Totvs Colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=12
24
TOTVS Service SOA
Movimentao SKU:
Realiza a transmisso de Movimentao SKU emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=13
Movimentao DFU:
Realiza a transmisso de Movimentaes de DFU emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=14
Eventos:
Realiza a transmisso de Eventos especficos para documentos emitidos pelos clientes Totvs colaborao. Para a transmisso
deste tipo de documento, o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[Environment]
DOCS_WORKFLOW=15
Pedido de compra:
Realiza a transmisso de pedidos de compras emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=16
Pedido de venda:
Realiza a transmisso de pedidos de vendas emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=17
Fornecedor:
Realiza a transmisso de cadastro de fornecedores emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo de
[Environment]
DOCS_WORKFLOW=18
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFSECOL_WORKFLOW, separadas por
valores padres:

[Environment]
DOCS_WORKFLOW=0
25
TOTVS Service SOA
do Treinamento
Configurao do intervalo de Entidades para processamento:
[Environment]
DOCS_WF_ENTIDADES=000001-000005
Por padro sero processadas todas as entidades ativas no Sistema. Nesse exemplo sero processadas as entidade de 000001 a
000005.

[Environment]
DOCS_WFDELAY = 2

[Environment]
DOCSCOL_WFENTIDADEWAIT = 1

[Environment]

[Environment]
0=Desabilita
1=Habilita
DOCS_WF_DEBUG =0
1.2.2.10.6 MDFe
O JOB para o envio de MDFe configurado da seguinte maneira:
Seo do Job:
[JOB_MDFECOL]
main=MDFEWFCOL
Habilitao do Job:
[ONSTART]
JOBS=JOB_MDFECOL
O JOB do MDFe, responsvel pela execuo das seguintes rotinas:

Emisso de MDFe:
2= Transmite MDFe pendentes.
4=Verifica lotes pendentes.
6=Realiza a confirmao de recebimento do documento para a Neogrid.
Eventos do MDFe:
7=Processa os eventos do MDFe.
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFECOL_WORKFLOW, separadas por
vrgula (Por exemplo: 1,2,3), caso no informado o default 0.
26
TOTVS Service SOA
valores padres:

[Environment]
NFECOL_WORKFLOW=0

[Environment]
000001 a 000005.

[Environment]
NFESPED_WFDELAY = 2

[Environment]

[Environment]
Define se no console do TSS apresentada a informao do ID da thread:

0=No
1=Sim
[Environment]
SPED_THREADID= 0
Habilita a notificao do processamento no console do TSS:

0=Desabilita
1=Habilita
[Environment]
NFESPED_WF=0
1.2.2.10.7 TOTVS Colaborao In House
A soluo TOTVS Colaborao In House, utilizada por clientes que desejam ter seus documentos trafegados por seus prprios
servidores ao invs do ambiente Cloud da Neogrid.
Dessa forma instalado dentro do servidor do cliente, uma soluo da Neogrid para que todo o controle fique dentro da empresa
do cliente.
Para que essa integrao funcione com o TSS necessria uma nica configurao.
Deve ser criado na pasta do StartPath (System), um arquivo com o nome COlabNFeURL.cfg com o contedo abaixo:
27
TOTVS Service SOA
do Treinamento
2,http://ipserver:porta,0,0
Ambiente:
1 Produo
2 Homologao
Obs.: A aplicao integrator de responsabilidade da Neogrid.
1.2.3 Configuraes gerais
O TSS possui algumas configuraes que podem ser realizadas para uso geral dos servios por ele gerenciado. Abaixo, temos a
lista de parmetros e suas respectivas sees para a configurao.
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.
Exemplo:
[Environment]
TOPMEMOMEGA=1
XMLSAVEALL: Permite a gravao de todos os XMLs de comunicao entre o TSS e as aplicaes dos clientes do Web services do
TSS. Os arquivos gerados so salvos na a Pasta WSLOGXML,.
Esta chave deve ser habilitada somente para ajudar na anlise de inconsistncias, pois gera um grande nmero de XMLs.
Exemplo:
[JOB_WS]
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 sejam realmente necessrios, pois pode causar uma grande lentido na comunicao.
Contedos vlidos:
Valor = Descrio:
1 = Todos
2 = Web Service de Status Servio \ NFe
3 = Web Service de Consulta Cadastro \ NFe
4 = Web Service de Consulta Cadastro_1 \ NFe
5 = Web Service de Cancelamento \ NFe
6 = Web Service de Consulta Nota \ NFe
7 = Web Service de Inutilizao \ NFe
8 = Web Service de Recepo Lote \ NFe
9 = Web Service de Retorno Recepo \ NFe
A = Web Service de Cancelamento \ CTe
B = Web Service de Consulta \ CTe
C = Web Service de Inutilizao \ CTe
D = Web Service de Recepo \ CTe
28
TOTVS Service SOA
E = Web Service de Retorno Recepo \ CTe

F = Web Service de Status Servio \ CTe
G = Web Service de Consulta \ DPEC
H = Web Service de Recepo \ DPEC
I =Web Service de Cancelamento \ NFSe BH
J = Web Service de Consulta Lote \ NFSe BH

K = Web Service de Consulta NFSe \ NFSe BH
L = Web Service de Consulta NFSe por RPS \ NFSe BH
M = Web Service de Consulta Situao LOTE \ NFSe BH
N = Web Service de Recepo \ NFSe BH
O = Web Service de Gerao de NFSe \ NFSe BH
P = Web Service de Recepo \ NFSe ISSnet
Q = Web Service de Consulta Situao LOTE \ NFSe ISSnet
R = Web Service de Consulta NFSe por RPS \ NFSe ISSnet
S = Web Service de Consulta Lote \ NFSe ISSnet
T = Web Service de Consulta NFSe \ NFSe ISSnet
U =Web Service de Cancelamento \ NFSe ISSnet
V = Web Service de Envio de Lote (ABRASF)
W = Web Service de Consulta de Lote (ABRASF)

X = Web Service de Cancelamento de Lote (ABRASF)
Y = Web Service de Envio de Lote (DSFNET)
Z = Web Service de Consulta de Lote (DSFNET)
@ = Web Service de Cancelamento de Lote (DSFNET)
NGSEND = Web Service de Transmisso da NFSe 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 NFe.
[Environment]
SPED_SAVEWSDL=268
1.2.4 Rede
Para a comunicao entre o TSS e as entidades com a qual o TSS realiza troca de mensagens, como rgos do governo e
prefeituras por exemplo, geralmente existe a necessidade dessa comunicao ser realizada de forma segura, garantindo a
autenticidade e integridade das mensagens. A troca de mensagens realizada atravs do protocolo HTTP e esse por sua vez utiliza
o protocolo SSL, que o responsvel pela comunicao segura entre o cliente e servidor das mensagens. Juntos formam o
conhecido protocolo HTTPS. Abaixo temos um exemplo de configurao da seo SSL que deve ser realizada no arquivo .ini do
TSS:
[SSLCONFIGURE]
HSM=0
SSL2=1
SSL3=1
TLS1=1
BUGS=1
Nesta mesma seo temos as informaes dos arquivo .pem gerados na pasta certs aps a configurao do certificado digital
para a entidade utilizado pelo TSS. Essas informaes sero utilizadas para a realizao da conexo segura(SSL) e assinatura das
mensagens quando necessrio:
29
TOTVS Service SOA
do Treinamento
CertificateClient=C:\TSS\certs\000001_all.pem
KeyClient=C:\TSS\certs\000001_key.pem
Caso o acesso a internet passe por um Proxy, esse tambm dever ser configurado no arquivo .ini do servidor TSS. Segue abaixo
a seo e os respectivos parmetros para configurao:
[PROXY]
Enable=1
Server=endereo do proxy
Port=porta do proxy
User=domnio\login usurio
Password=senha do usurio no Proxy
1.2.5 Interface
O TSS possui alguns aplicativos com interfaces interativas que ajudam a monitorar e manusear algumas informaes que esto no
Sistema.
Os aplicativos que o TSS possui com interface so:
TSSMonitor: Utilizado para monitorar os documentos eletrnicos, visualizar informaes sobre as entidades cadastradas
e configuraes do TSS.
TSSPortal: Utilizado para que o destinatrio dos documentos possa acessar via Web HTTP uma interface para visualizar
documentos.
TSSInterface: Utilizado para fornece uma interface que possibilita monitorar e manipular informaes do servio do TSS,
proporcionando um gerenciamento rpido, simples e fcil
1.2.5.1. Acesso
Para realizar o acesso s interfaces do TSS preciso haver um usurio configurado com acesso ao Sistema:
1. Execute o SmartClient do TSS acessando algum aplicativo de interface.

2. No primeiro acesso faa o login com o usurio ADMIN e senha ADMIN; o aplicativo solicita que seja definida uma nova senha
para o usurio ADMIN.
3. O aplicativo tem acesso ao gerenciamento de usurios que permite manipular as contas de usurios que podem acessar o
Sistema.
4. Crie um usurio fornecendo o nome e clicando no cone de Adio.
5. Defina a senha de acesso que deve ser redefinida no primeiro acesso (semelhante ao acesso com o usurio ADMIN) e adicione
o CNPJ da empresa/filial que o usurio deve ter acesso.
6. Clique no cone representado pelo disquete para salvar as configuraes do usurio.
7. Acesse o aplicativo com o usurio recm-criado para utilizar as funcionalidades.
1.2.5.2. TSSMonitor
O aplicativo TSSMonitor fornece uma interface que possibilita monitorar e manipular informaes j existentes no TSS, como:
documentos j enviados ao TSS, configuraes realizadas, cadastros de entidades, etc.
Para acessar o TSSMonitor execute o SmartClient do TSS, apontando para o servidor e execute o programa inicial TSSMonitor.
Para ter acesso tela principal do TSSMonitor utilize a conta de usurio recm-criada.
30
TOTVS Service SOA
Estrutura de menus do aplicativo:
Eventos
NFe Eventos da NFe como CCe, Cancelamento e Registro de sada: neste menu podemos visualizar os eventos emitidos da
NFe, verificar o histrico de um evento, filtrar a listagem de eventos em tela e visualizar as informaes de um evento especfico.
Capa de Lote: podemos visualizar as capas de lote emitidas, filtrar a listagem para melhor visualizao, visualizar as informaes
de uma capa de lote especfica e imprimir o documento auxiliar da capa de lote.
Fiscal
NFe: Podemos visualizar uma listagem com as NFe emitidas, consultar a nota na SEFAZ, imprimir o DANFE, visualizar as
informaes de uma NFe especfica, exportar o arquivo XML de uma nota, enviar o arquivo XML por e-mail a algum, validar o
schema do arquivo XML, visualizar o histrico de uma nota, consultar o status da SEFAZ para aquela nota e filtrar a listagem de
notas para melhor visualizao.
NFe Recebidas NFe recebidas por TOTVS Colaborao: Podemos visualizar as NFe recebidas pelo TOTVS Colaborao, filtrar
a listagem de notas, visualizar as informaes de uma nota e exportar o XML de uma nota.
NFSe: Podemos visualizar as NFSe emitidas, visualizar as informaes de uma NFSe, exportar o XML de uma NFSe, imprimir seu
RPS e filtrar a listagem para melhor visualizao.
CTe: Visualizamos uma listagem dos CTe emitidos podendo visualizar as informaes de um CTe especfico, exportar o arquivo
XML de um CTe, imprimir um DACTE e filtrar a listagem de CTe para melhor visualizao.
Documentos Documentos emitidos e recebidos por TOTVS Colaborao

Pedido Pedidos de compra e venda: so listados os Pedidos de Compra e Venda emitidos e recebidos por TOTVS Colaborao,
permite filtrar a listagem dos documentos, exportar o XML de algum documento e validar o schema do XML de um documento.
Programao de entrega: exibe uma listagem de programaes de entrega emitida, permite filtrar a listagem, exportar o XML
de um documento especfico e validar o schema do XML de um documento especfico.
Aviso de embarque: lista os Avisos de Embarque emitidos, possibilita a filtragem dos documentos exibidos, exporta o XML de
um documento e valida o schema do XML de um documento.
1.2.5.3 TSSPortal
O TSSPortal um aplicativo hospedado pelo Emissor de Documentos Fiscais que aberto ao acesso dos destinatrios via Web,
desta forma, o destinatrio pode ver os documentos eletrnicos destinados a ele e realizar algumas operaes simples.
Para o destinatrio acessar o TSSPortal primeiro instale e configure o SmartClientHTML junto com o TSS e cadastre um usurio
com o CNPJ/CPF do destinatrio, a partir disso, o destinatrio acessa por meio do navegador o endereo configurado no
SmartClientHTML e executa, como programa inicial, o TSSPortal.
Inicial
NFe: apresenta as ltimas NFe emitidas podendo exportar o XML de uma nota, imprime o DANFE, envia o XML da nota por e-
mail, visualiza as informaes de uma nota e filtra para exibir as notas do perodo selecionado.
NFSe: lista as ltimas NFSe emitidas permitindo a exportao do XML, a impresso do RPS e o envio do XML por e-mail, visualiza
as informaes mais detalhadamente e as filtra para exibir as NFSe de perodos mais prximos ou afastados.
CTe: mostra os CTe emitidos recentemente possibilitando exportar o XML, imprime o DACTE, envia o arquivo XML por e-mail,
visualiza as informaes mais detalhadas e filtra para apresentar o CTe de perodos mais antigos ou mais recentes.
Monitor
NFe: apresenta as NFe, porm, aceita visualizar um maior nmero de documentos com extenses de tempo mais amplas, como
por exemplo, consultar uma nota de anos atrs.
31
TOTVS Service SOA
do Treinamento
NFSe: assim como o inicial da NFSe, funciona da mesma forma, porm, pode apresentar notas mais antigas que no se
consegue pelo inicial.
CTe: como no inicial, apresenta o CTe com as mesmas funcionalidades, porm, possibilita buscar o CTe emitido h mais tempo.
1.2.5.4 TSS Inteface
O aplicativo TSS Interface fornece uma interface que possibilita monitorar e manipular informaes do servio do TSS,
proporcionando um gerenciamento rpido, simples e fcil.
Para acessar o Interface execute o SmartClient do TSS, apontando para o servidor e execute o programa inicial TSSINTERFACE.
Para ter acesso tela principal do TSSMonitor utilize a conta de usurio.
Monitoramento
Essa tela apresenta todas as entidades do TSS.
Procedimento
1.Clique na opo Monitoramento.
2.Escolha qual modelo ser monitorado.
3.Clique em Ok.
4.Preencha os parmetros e confirme.
Ser exibida uma tela com alguns dados da entidade no cabealho. Dois grids, o superior com os lotes da entidade e abaixo um
grid com as notas que compem o lote selecionado acima. No rodap existem as informaes da nota de data e horrio de
algumas operaes.
Essa tela disponibiliza as seguintes opes:
-XML do lote: Permite visualizar o XML do lote e da Nota Fiscal.

-Visualizar Nf-e: Exibe informaes sobre a Nota Fiscal Eletrnica.
Na parte de cima da tela, no canto direito, h dois cones de acesso:

-Informao dos dados cadastrais da entidade: Permite somente a visualizao dos dados da entidade em questo.
-Informao do certificado digital da entidade: Abre as configuraes do certificado da entidade que est sendo monitorada
Refinar:Permite redefinir o perodo da movimentao.
Aes relacionadas:
Certificado: Exibe tela com as informaes do certificado da entidade com informaes sobre o emissor e entidade.
Parmetros Ent: Verifica quais so os parmetros configurados para a unidade.
Status SEFAZ: Efetua consulta SEFAZ de acordo com as configuraes estabelecidas. Esta consulta tem como retorno
informaes de fontes externas (SEFAZ) e no de dados gravados e existentes na base de dados do Sistema.
Entidade: Permite e visualizao dos dados cadastrais da entidade. Essa tela dividia em duas partes. Na parte inferior
possvel alterar os dados secundrios da entidade, bem como configurar se ela est ativa ou inativa. Vale lembrar, que essa
configurao altera a legenda da entidade, que poder ser visualizada na janela Monitoramento
Configurao: Permite a visualizao dos parmetros de configurao do TSS que so configurados no arquivos .ini do servidor
de aplicao (appserver).
32
TOTVS Service SOA
A tela exibe todos os parmetros existentes e atravs do cone localizado esquerda, possvel visualizar uma caixa de texto
com as informaes do parmetro.
Ambiente: Parametro de configurao de Ambiente
Tabelas: Permite visualizar a estrutura da tabelas(campos detalhe e ndice).
Url: Permite a manuteno da das url(tabela sped 158)
Analizador: um facilitador que permite a configurao/alterao do(s) Ambiente(s) do TSS.
Procedimento
1. Clicar no cone da Pasta para localizar o Diretrio para busca
2. Selecionar a pasta na qual est instalado o TSS (Totvs Service Sped)
Ex: Instalao padro, o nome da pasta totvssped
Clicar em Abrir
Modo de edio/visualizador
Identificar que o Diretrio ficou salvo com o caminho selecionado
Clicar em Analisar
No alerta que ser exibido, ter as opes abaixo:

NO : A interface estar somente para Exibio.
SIM : A interface estar disponvel para Alterao e gravao dos dados.
Ser exibido alerta carregando os dados e ser aberta uma Interfacepossuindo 3 abas (Geral, Conexes e Servios)
- Geral (servios, log, porta e Hambiente)

- Conexo ( Http,WebService,Proxy e SSL configure)
- Servios[Jobs](manuteno do servios de Jobs)
Boto: salvar e Exportar
O boto Salvar temos duas opes:

Apenas Este: Somente aquele ambiente no qual est posicionado.
Todos: Seria todos ambientes.
Obs: Boto Salvar ser exibido somente quando entrar em modo de Edio.
Importante: Ao clicar para salvar, foi criada uma pasta tssiniconfig_bkp para manter os backup do appserver.ini para caso o
usurio realizou a alterao indevidamente.
Uma vez salvo o arquivo pelo analisador o mesmo altera a estrutura e apaga tudo o que estava comentado.
O arquivo que foi transferido para pasta de Backup ficou:

serverini+AAAA+MM+DD+N de alteraes no dia
O boto Exportar temos duas opes:
Apenas Este: Somente aquele ambiente no qual est posicionado.

Todos: Seria todos ambientes.
O arquivo exportado ser no formato .xml
Micelanea
Permite a execuo da consulta de qualquer modelo SEFAZ.
Consultar status do sefaz : Permite selecionar os dados que deseja efetuar a consulta (SEFAZ, modelo e verso).
33
TOTVS Service SOA
do Treinamento
Exibir URL : Mostra todas as URL's configuradas no TSS para uma SEFAZ bem como sua verso e seu modelo. J a opo Portal,
conduz a um link direto ao navegador padro de Internet que estiver configurado.
1.3. Balanceamento
O TSS pode ser configurado para que a carga de processamento seja balanceada, ou seja, para que diversas instncias do TSS
realizem tarefas paralelamente, dando vazo limitao de recursos da mquina.
O balanceamento pode ser configurado para funcionar por entidades e/ou processos, de acordo com as configuraes dos Jobs
apresentados anteriormente.
1.3.1. Configuraes
Ao realizar o balanceamento de funcionalidade do TSS sempre configurado mais de um servidor/servio que dificulta o
reconhecimento de servidores/servios por possurem o mesmo nome.
Caso o servidor do TSS seja utilizado diretamente, ou seja, no em maneira de servio, aconselhvel renomear o arquivo
executvel do servidor, adicionando uma nomenclatura posteriormente identificvel da funcionalidade, por exemplo, um servidor
que encarregado de apenas tratar NFe, deve ser renomeado de appserver para appserver_NFe.
Caso seja utilizado como servio, configure uma clusula no arquivo .ini do servidor para informar o nome do servio:
[SERVICE]
NAME=TSS; nome interno do servio.
DISPLAYNAME=TSS; parmetro que define o nome que aparece no gerenciador de servios.
Outra importante configurao refere-se ao ambiente do diretrio dos servidores, por se criar diversos deles, eles podem partilhar
o mesmo ambiente de diretrios ou no, isto definido pelo arquivo .ini dos servidores:
SourcePath=\\HOSPEDEIRA\TOTVS\TSS\11\APO
RootPath=\\HOSPEDEIRA\TOTVS\TSS\11
O termo HOSPEDEIRA refere-se ao hostname da mquina que abriga o ambiente de diretrios do servidor. Pode se utilizar no
lugar o IP da mquina ou, se for local ao servidor que se est configurando, pode-se utilizar o caminho absoluto ao diretrio.
Ao configurar qualquer tipo de balanceamento, todos os servidores devem estar apontando para o mesmo banco de dados.
1.3.1.1. Por JOB
O balanceamento por JOB configurado para que se tenha dois ou mais servidores TSS trabalhando paralelamente em Jobs
diferentes, por exemplo, um servidor executando o JOB da NFe e outro o JOB da NFSe:
Primeiro servidor
[JOBNFE]
34
TOTVS Service SOA
main=SPEDWF
[ONSTART]
JOBS=JOBNFE
Segundo servidor
[NFSE_WF]
main=NFSEWF
[ONSTART]
JOBS=NFSE_WF
Neste exemplo, o primeiro servidor executa todas as funes do JOB de NFe, enquanto em paralelo, o segundo servidor executa
todas as funes do JOB de NFSe.
Ambos servidores esto apontando para o mesmo DBAccess, porm, podem ou no utilizar o mesmo ambiente (RootPath e
StartPath). No caso de utilizarem o mesmo ambiente, ambos devem ser configurados apontando para a mquina na rede mestre
do ambiente (caso a mquina seja hospedeira de um dos servidores, este servidor deve apontar como diretrio local e no utilizar
o IP/hostname da mquina):
SourcePath=\\HOSPEDEIRA\TOTVS\TSS\11\APO; nesse caso, utilizado um hostname fictcio (pode ser o IP da mquina).
RootPath=\\HOSPEDEIRA\TOTVS\TSS\11
Da mesma forma, pode ser configurado mais de um JOB por servidor ou quantidades divergentes de JOB por servidor:
Primeiro servidor:
[JOBNFE]
main=SPEDWF
[NFSE_WF]
main=NFSEWF
[ONSTART]
JOBS=JOBNFE,NFSE_WF
Segundo servidor:
[CLE_WF]
main=CLE_WF
[ONSTART]
JOBS=CLE_WF
Desta maneira, o primeiro servidor fica encarregado dos Jobs de NFe e NFSe e, o segundo, apenas de CLe.
35
TOTVS Service SOA
do Treinamento
1.3.1.2 Por Procedimento
O balanceamento do TSS pode ser configurado por procedimento de Job, ou seja, pode ter dois ou mais TSS trabalhando em
paralelo para procedimentos diferentes de um mesmo Job.
No exemplo abaixo, dois servidores executam o JOB da NFe, mas, o primeiro realiza os procedimentos de assinatura, transmisso
e dispara os e-mails de distribuio; o segundo verifica lotes pendentes, transmite cancelamentos e inutilizaes e processa os
eventos da NFe:
Primeiro servidor:
NFESPED_WORKFLOW=1,2,4
[JOBNFE]
main=SPEDWF
[ONSTART]
JOBS=JOBNFE
Segundo servidor:
NFESPED_WORKFLOW=3,6
[JOBNFE]
main=SPEDWF
[ONSTART]
JOBS=JOBNFE
1.3.1.3 Por entidade
Podemos configurar dois ou mais servidores do TSS para trabalharem paralelamente em um mesmo JOB e procedimento, porm,
processando entidades (empresas/filiais) diferentes.
No exemplo abaixo so configurados dois servidores e ambos trabalhando com a transmisso de NFe, entretanto, um trabalha
com 15 entidades previamente cadastradas e outro com as prximas 15:
Primeiro servidor:
NFESPED_WORKFLOW=2
[JOBNFE]
main=SPEDWF
[ONSTART]
JOBS=JOBNFE
36
TOTVS Service SOA
Segundo servidor:
NFESPED_WORKFLOW=2
[JOBNFE]
main=SPEDWF
[ONSTART]
JOBS=JOBNFE
1.3.1.4. Estimativa
Execute o balanceamento de funcionalidades do TSS quando a performance no aceitvel, seja da mquina, ou da agilidade
dos processos.
Alguns pontos so imprescindveis no balanceamento e bom funcionamento do TSS:

recomendado que um servidor do TSS seja configurado para atuar apenas como WebService.
A quantidade de Jobs configurados em um servidor impacta no consumo de recursos da mquina, assim como, na agilidade
que cada JOB e cada procedimento tem, portanto, como recomendao, balancear os Jobs e os procedimentos pelo tamanho
de carga.
Caso um JOB (exemplo o de NFe) for muito utilizado por possuir uma quantidade grande de notas a serem transmitidas,
monitoradas, isole este JOB em um servidor separado dos demais JOBs em concorrncia.
Caso algum procedimento de algum JOB for muito utilizado ou apresentar uma demora acima do esperado a ser executado,
isole-o em um servidor, separado dos demais Jobs e procedimentos.
Observe a quantidade de entidades ativas e configuradas para serem processadas nos Jobs, quaisquer entidades que no
requeira o processamento, ou que no so utilizadas, devem ser desativadas no TSS ou configurados os Jobs para que no
sejam processadas.
Entidades que possuem um volume grande de documentos a serem processados, ou demandam uma maior prioridade na
agilidade dos processos, devem ser isoladas em servidores dedicados a eles, garantindo que o processamento seja prioritrio
distante das demais entidades.
Acompanhe a utilizao dos recursos fsicos da mquina como memria e processador, se a utilizao est acima do
esperado, balanceie os Jobs e se necessrio, as entidades em mquinas diferentes, para no ocasionar uma lentido no
processo do TSS.
O diagrama abaixo representa um ambiente ideal balanceado do TSS:
37
TOTVS Service SOA
do Treinamento
Web Service
Servidores de JOB balanceados
Banco de Dados
WebServices Homologados
1.4. Licenciamento
O Licenciamento TSS ser um controle de licenas ERP Totvs e ERP no Totvs para cada servio do TSS no qual ser utilizado.
necessrio conter a licena do Server habilitado, atravs do LICENSESERVER, com a Porta e Server aonde se encontra o Servidor
de Licenas configurado.
O arquivo de Licena totvslic.key no qual o responsvel pelas licenas Totvs, disponibilizado para cada cliente com a(s)
licena(s) adquirida(s).
Aps o recebimento do arquivo de licena, necessrio conter a licena do Client habilitado, atravs do LICENSECLIENT, com a
Porta e Server aonde se encontra o Servidor de Licenas configurado.
Segue abaixo a configurao a ser realizada:
[LICENSESERVER]
Enable= habilitado ou desabilitado.
port= identifica a porta que ser utilizada para a comunicao entre o Servidor de Licenas e Server.
ShowStatus= permite o controle de requisies e liberaes de licena atravs de mensagem na tela de console do Server.
38
TOTVS Service SOA
[LICENSECLIENT]
Server= endereo do servidor de licena
Port= porta do servidor de licena
Obs.: Para maiores informaes sobre as configuraes das Sees LICENSESERVER e LICENSECLIENT, acesse o portal do cliente.
1.4.1. ERP Totvs
Controle:
O controle da licena ser realizado para cada servio (Job) estiver ativo.
Consumo:
O consumo da licena, ser realizado atravs da Licena ERP Totvs, ou seja, Faturamento, Loja, etc., no qual o cliente possui e
estiver disponvel no momento para consumo.
Exemplo de uma licena a ser consumida devido ao JOBNFE estar com o servio online.
[ONSTART]
JOBS=JOBNFE
Caso no possua licena disponvel, ser enviado e-mail de notificao (e-mail no qual j est configurado).
1.4.2. ERP No Totvs
O que seria ERP No Totvs?

Cliente possui um sistema ERP de outra empresa, porm necessita realizar os servios TSS Totvs Service SOA para transmisso
de NFe, NFSe, etc.
O cliente adquir o TSS Totvs Service SOA com a Totvs, com uma Licena OnDemand e realizar os servios no qual deseja
integrando com o ERP no qual possui.
O que seria Licena OnDemand?

uma licena na qual possui a quantidade exata (crditos) contratada para a utilizao dos servios TSS - Totvs Service SOA.
Controle:
O controle da licena ser realizado para cada documento enviado ao TSS.
Obs.: Erro de Schema e Cancelamento no ser debitado.
Consumo:
O consumo da licena, ser realizado atravs da Licena OnDemand, debitando a cada envio.
Central de Notificaes:
Na tela inicial, clicar no menu Configurao, aonde foi implementado Central de Notificaes no qual um facilitador para que
o cliente consiga realizar o gerenciamento da licena OnDemand, na qual receber a notificao contendo a quantidade de
licenas contratadas, quantas licenas foram utilizadas e informando o saldo.
Para configurar a notificao, selecionar Licena OnDemand e seguir os procedimentos abaixo:
Ser necessrio realizar a configurao do e-mail atravs do boto Config. e-mail.

Servidor SMTP: informar o servidor SMTP.
Conta de e-mail: informar a conta de e-mail no qual deseja receber a notificao.
E-mail: informar o e-mail no qual deseja receber a notificao.
39
TOTVS Service SOA
do Treinamento
Senha: informar a senha do e-mail informado acima.
Autenticao: Habilita ou Desabilita.
Conexo SSL: Habilita ou Desabilita.
Conexo TLS: Habilita ou Desabilita.
Segue abaixo a configurao para a notificao Licena OnDemand:

Habilita: se deseja receber a notificao.
E-mail: e-mail no qual foi configurado anteriormente.
Assunto: Por Default ele traz esta informao podendo ser alterado.
Info. Adic.: Poder acrescentar maiores informaes.
Intervalo de Exec.: em quanto tempo voc deseja que seja realizado a verificao e enviado a notificao.
Licenas para vencer: informar quantidade de licenas para vencer e ser notificado.
Segue abaixo as informaes do e-mail que receber com a notificao:

Assunto
Motivo do e-mail
Total de licena contratada
Saldo disponvel (quantidade de licenas que deseja receber a notificao antes do termino da licena)
Total de licena disponvel (total licena contratada Saldo disponvel)
Informaes Adicionais: Informao do campo (Info. Adic.)
Aps a configurao na Central de Notificaes, ser enviado e-mail da notificao com as informaes acima.
40

TSS Manual de Configuração PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

TSS Manual de Configuração PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de Configurao - TSS

1.4.1. ERP Totvs ......................................................................................................................................... 399

Os servios so oferecidos pelo protocolo SOAP (via Web).

Instalao do TSS no Windows

6- Aps preenchimento dos campos Servidor e Porta, clique em Avanar.

Aps a escolha, clique em Concluir.

Instalao do TSS no Linux

Declarao da seo para execuo do WebService:

Abertura da porta HTTP:

Declarao da seo para host e porta do WebService:

Declarao do JOB_WS na seo ONSTART

O TSS possui processos automticos (JOBS) para a manipulao de documentos eletrnicos.

Ativao do JOB da NFe:

O JOB da NFe responsvel pela execuo das seguintes rotinas:

Rotinas a serem executadas:

Intervalo de Entidades para processamento:

Intervalo de tempo em segundos para execuo das rotinas:

Intervalo de tempo em segundos para execuo entre as entidades:

tempo de espera para reincio do processamento do Job:

Habilita a notificao do processamento das rotinas no console do TSS:

Habilita o uso do horrio de vero:

ativao do JOB da NFSe:

O JOB da NFSe, responsvel pela execuo das seguintes rotinas:

1=Monta os lotes para emisso de NFSe

Rotinas a serem executadas:

Intervalo de Entidades para processamento:

Intervalo de tempo em segundos entre a execuo das rotinas do Job:

Tempo de espera para reincio do processamento do Job:

Intervalo de tempo em segundos entre a execuo das entidades:

Habilita a notificao do processamento das rotinas no console do TSS:

Ativao do JOB da NFCe

O JOB da NFCe, responsvel pela execuo das seguintes rotinas:

Rotinas a serem executadas

Entidades a serem processadas

Intervalo para execuo das rotinas em segundos:

Intervalo do reincio para execuo das rotinas em segundos:

Ativao do JOB do MDe:

Rotinas a serem executadas:

Intervalo de Entidades para processamento:

Intervalo de tempo em segundos para execuo das rotinas:

Intervalo de tempo em segundos para execuo entre as entidades:

Tempo de espera para reincio do processamento do Job:

Habilita informaes das Threads em processamento no console do TSS:

Habilita a notificao do processamento das rotinas no console do TSS:

Ativao do JOB do CTe:

O JOB do CTe responsvel pela execuo das seguintes rotinas:

Rotinas a serem executadas:

Intervalo de Entidades para processamento:

Intervalo de tempo em segundos entre a execuo das rotinas:

Intervalo de tempo em segundos entre execuo das entidades:

Tempo de espera para reincio do processamento do Job:

Habilita a notificao das Threads em processamento no console do TSS:

Ativao do JOB da CLe:

Intervalo de entidades para processamento:

Intervalo de tempo em segundos entre execuo das rotinas:

Intervalo de tempo em segundos para execuo entre as entidades:

Tempo de espera para reincio do processamento do Job:

Habilita mensagens do processamento da CLe no console do TSS:

Ativao do JOB do MDFe:

O JOB do MDFe, responsvel pela execuo das seguintes rotinas:

Rotinas a serem executadas:

Intervalo de entidades para processamento:

Intervalo de tempo em segundos entre execuo das rotinas: