TSS Manual de Configuracao

Manual de Configurao TSS
TSS
Sumrio
1.
Introduo .................................................................................................................................................. 4
1.1.
Instalao ................................................................................................................................................... 4
1.2.
Configurao .............................................................................................................................................. 6
1.2.1 WebService ................................................................................................................................................ 7

1.2.2 JOB ............................................................................................................................................................ 8
1.2.2.1 NFe ............................................................................................................................................................ 8
1.2.2.2 NFSe ......................................................................................................................................................... 10
1.2.2.3 NFCe ......................................................................................................................................................... 11
1.2.2.4 MDe ........................................................................................................................................................... 12
1.2.2.5 CTe ............................................................................................................................................................ 13
1.2.2.6 CLe ............................................................................................................................................................ 15
1.2.2.7 MDFe ......................................................................................................................................................... 16
1.2.2.8 Remito ....................................................................................................................................................... 17
1.2.2.9 Nota Fiscal Argentina ................................................................................................................................ 18
1.2.2.10 TOTVS Colaborao ............................................................................................................................... 20
1.2.2.10.1 NFe ....................................................................................................................................................... 20
1.2.2.10.2 CTe ....................................................................................................................................................... 22
1.2.2.10.3 NFSe .................................................................................................................................................... 23
1.2.2.10.4 MDe ...................................................................................................................................................... 25
1.2.2.10.5 Documentos ......................................................................................................................................... 26
1.2.2.10.6 MDFe .................................................................................................................................................... 30
1.2.2.10.7 TOTVS Colaborao In House ............................................................................................................. 32
1.2.3 Configuraes Gerais................................................................................................................................. 33
1.2.4. Rede ........................................................................................................................................................... 35
1.2.5 Interface ..................................................................................................................................................... 36
1.2.5.1 Acesso ....................................................................................................................................................... 36
1.2.5.2 TSS Monitor ............................................................................................................................................... 36
1.2.5.3 TSS Portal .................................................................................................................................................. 37
1.2.5.4 TSS Interface ............................................................................................................................................. 38
1.3
Balanceamento .......................................................................................................................................... 40
1.3.1 Configuraes ............................................................................................................................................ 40

1.3.1.1 Por JOB...................................................................................................................................................... 41
1.3.1.2 Por Procedimento....................................................................................................................................... 42
Verso 1.0
1.3.1.3. Por Entidade ............................................................................................................................................. 43

1.3.1.4. Estimativa................................................................................................................................................ 44
1.4
Licenciamento ............................................................................................................................................ 44
1.4.1 ERP Totvs .................................................................................................................................................. 45

1.4.2 ERP No Totvs........................................................................................................................................... 45
1.5
Reestruturao do TSS TSS OnDemand................................................................................................ 47
Verso 1.0
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 (NFe),
Conhecimento de Transporte Eletrnico (CTe), Nota Fiscal de Servio Eletrnica (NFSe), Capa de Lote eletrnica (CLe),
Manifesto de Documentos Fiscais Eletrnicos (MDFe), Nota Fiscal Eletrnica para Consumidor Final (NFCe), Manifesto do
destinatrio (MDe) e a mensagem 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. Escolha a pasta de instalao do TSS em Procurar, por default C:\totvstped\. Aps, clique em Avanar.
Verso 1.0
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.
Importante/ Saiba Mais
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
Verso 1.0
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.
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
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
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.
Verso 1.0
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
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:
Verso 1.0
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 NFe, NFSe, NFCe, CTe, CLe, 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).
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):
Verso 1.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
entidades de 000001 a 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
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
Verso 1.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:

[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]
10
Verso 1.0
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:
Abaixo, segue uma lista dos parmetros que podero ser configurados, todos so de uso opcional e esto listados com
Rotinas a serem executadas
[Nome do Environment]
NFCE_JOB_ROTINAS= nfceOffLine, nfceOffLote, nfceInutiliza
Entidades a serem processadas
Verso 1.0
11
NFCE_JOB_ENTIDADES=000001-000005 //Por padro sero processadas todas as entidades ativas do sistema.

Nesse exemplo sero processadas as entidades de 000001 a 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
seus 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
[Environment]
12
Verso 1.0

[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
Verso 1.0
13
Eventos de emisso de CTe.

6= Processa os eventos relacionadas emisso de CTe (ainda no disponvel).
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.
[Environment]
NFESPED_WORKFLOW=0
[Environment]
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas as entidades de
000001 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
14
Verso 1.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:
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 entidades 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
Verso 1.0
15
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 emisso de MDFe.
separadas por vrgula (Por exemplo:1,2,4), caso no informado o default 0.
[Environment]
NFESPED_WORKFLOW=0
[Environment]
NFESPED_WFENTIDADES =000001-000005
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas as entidades
de 000001 a 000005.
[Environment]
Intervalo de tempo em segundos entre a execuo das entidades:
[Environment]
16
Verso 1.0

[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]
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.
[Environment]
REMITOLOC_WORKFLOW=1
Configurao do range de entidades para processamento:
[Environment]
REMITOLOC_WFENTIDADES =000001-000005
Verso 1.0
17
Por padro sero processadas todas as entidades ativas no Sistema. Neste exemplo sero processadas as entidades
de 000001 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 devese criar uma seo para execuo:
1- Nota Fiscal de Exportao:
[JOB_WSFEX]
main=JOB_WSFEX
2- Nota Fiscal Interna:
[JOB_WSFE]
main=JOB_WSFE
3- Nota Fiscal Interna Regime Dominacion 2904:
[JOB_WSMTX]
main=JOB_WSMTX
18
Verso 1.0
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
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
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.
Verso 1.0
19
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,
20
Verso 1.0

[Environment]
NFECOL_WORKFLOW=0
[Environment]
[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
Verso 1.0
21
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
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.
separadas por vrgula (Por exemplo 1,2,3), caso no informado o default 0.
seus valores padro:
[Environment]
NFECOL_WORKFLOW=0
[Environment]
[Environment]
NFESPED_WFDELAY = 2
22
Verso 1.0

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

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.3 NFSe
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:
Verso 1.0
23
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,
NFSECOL_WORKFLOW=0
NFSEWF_ENTIDADES=000001-000005
[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
24
Verso 1.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
[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
[Environment]
NFESPED_WFDELAY = 2
[Environment]
[Environment]
Verso 1.0
25

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:
[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
26
Verso 1.0
Recebimento de CTe:
Realiza o recebimento de CTe emitidos para os clientes Totvs colaborao. Para o recebimento deste tipo de documento,
[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 parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[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
[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 documento, o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
[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,
[Environment]
DOCS_WORKFLOW=5
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
Verso 1.0
27
[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
[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,
[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
[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 documento, o parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:
28
Verso 1.0
[Environment]
DOCS_WORKFLOW=12
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
[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
[Environment]
DOCS_WORKFLOW=16
Pedido de venda:
Realiza a transmisso de pedidos de vendas emitidos pelos clientes Totvs colaborao. Para a transmisso deste tipo
[Environment]
DOCS_WORKFLOW=17
Fornecedor:
Realiza a transmisso de cadastro de fornecedores emitidos pelos clientes Totvs colaborao. Para a transmisso deste
Verso 1.0
29
[Environment]
DOCS_WORKFLOW=18
As rotinas que devero ser executadas, podem ser configuradas atravs do parmetro NFSECOL_WORKFLOW,
[Environment]
DOCS_WORKFLOW=0
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 entidades
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
30
Verso 1.0
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,
[Environment]
NFECOL_WORKFLOW=0
[Environment]
[Environment]
NFESPED_WFDELAY = 2
[Environment]
[Environment]
Define se no console do TSS apresentada a informao do ID da thread:
0=No
1=Sim
[Environment]
Verso 1.0
31
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.
Exclusivo para windows
Deve ser criado na pasta do StartPath (System), um arquivo com o nome COlabNFeURL.cfg com o contedo abaixo:
2,http://ipserver:porta,0,0
Ambiente:
1 Produo
2 Homologao
Pelo Windows/Linux
Realizar a manuteno(incluso) da url(tabela sped 158) pelo TSS INTERFACE conforme o tpico 1.2.5.4 TSS
INTERFACE.
Deve incluir os seguintes valores
rgo:
=0
Ambiente : =1 produo 2 homologao
Modelo: =0-T.Colab.InHouse
Servio: =0
Verso: =0
Observao:
A aplicao integrator de responsabilidade da Neogrid.
32
Verso 1.0
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
Verso 1.0
33
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
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
34
Verso 1.0
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 de essa 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 arquivos .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:
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
Verso 1.0
35
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 fornecer 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 TSS Monitor

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.
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.
36
Verso 1.0
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 TSS Portal

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 email, 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.
Verso 1.0
37
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.
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 Interface

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
TSS INTERFACE.
Para ter acesso tela principal do TSS Interface, 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 e 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.
38
Verso 1.0
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. 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 nos arquivos
.ini do servidor de aplicao (appserver).
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: Parmetro de configurao de Ambiente.
Tabelas: Permite visualizar a estrutura das tabelas(campos detalhe e ndice).
Url: Permite a manuteno da das url(tabela sped 158).
Analisador: um facilitador que permite a configurao/alterao do(s) Ambiente(s) do TSS.
Procedimento
1. Clique no cone da Pasta para localizar o Diretrio para busca.
2. Selecione a pasta na qual est instalado o TSS (Totvs Service Sped).
Ex.: Instalao padro, o nome da pasta totvssped.
3. Clicar em Abrir.
Modo de edio/visualizador
Identificar que o Diretrio ficou salvo com o caminho selecionado.
Clique 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 Interface possuindo 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 possui duas opes:
Apenas Este: Somente aquele ambiente no qual est posicionado.
Verso 1.0
39
Todos: 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 backups do appserver.ini para
caso o usurio tenha realizado uma 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 possui duas opes:
Apenas Este: Somente aquele ambiente no qual est posicionado.
Todos: Seria todos ambientes.
O arquivo exportado ser no formato .xml.
Miscelnea
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).
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.
40
Verso 1.0
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]
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):
Verso 1.0
41
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.
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
42
Verso 1.0
[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
Segundo servidor:
NFESPED_WORKFLOW=2
[JOBNFE]
main=SPEDWF
Verso 1.0
43
[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:
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.
44
Verso 1.0
ShowStatus= permite o controle de requisies e liberaes de licena atravs de mensagem na tela de console do
Server.
[LICENSECLIENT]
Server= endereo do servidor de licena
Port= porta do servidor de licena
Observao: 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.
Verso 1.0
45
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.
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.)
46
Verso 1.0

Aps a configurao na Central de Notificaes, ser enviado e-mail da notificao com
as informaes acima.
1.5 Reestruturao do TSS TSS OnDemand

Implementado atravs do parmetro JOBONDEMAND o controle de JOB por Demanda, para quando estiver habilitado,
realizar o processamento de documentos pendentes para transmisso somente da Entidade na qual foi responsvel pela
requisio.
Com
o
parmetro
desativado,
o
processo
do
TSS
realizado
por
Entidade.
Exemplo: Caso seja configurada trs Entidades atravs do parmetro nfesped_wfentidades, porm voc mandou um
documento a ser processado pela Entidade 000003, o TSS realizar o processo passando pela primeira Entidade
verificando se possu algo pendente para (Assinatura, Transmisso, etc) at chegar na Entidade na qual voc enviou o
processamento, que no caso foi na terceira Entidade, e a realizar o processo.
Verso 1.0
47
Exemplo como ficaria o processo:
Entidade 000001
Assinatura
Transmisso
Recepo de Lote
Entidade 000002
Assinatura
Transmisso
Recepo de Lote
Entidade 000003
Assinatura
Transmisso
Recepo de Lote
Com o parmetro ativado, o processo do TSS ser realizado atravs da Origem da Requisio, ou seja, o TSS verificar
no Processo de Assinatura se possu um documento pendente a transmisso atravs da entidade configurade de/At, ou
caso no esteja configurado o parmetro nfesped_wfentidades ele realizar o processamento de todas as Entidades
existentes.
Exemplo como ficaria o processo:
Entidade De: 000001 At: 000003
Assinatura
Transmisso
Recepo de Lote
O controle de Demanda ter funcionalidades para os servios:
NF-e: Nota Fiscal Eletrnica

CT-e: Conhecimento Transporte Eletrnico
MDF-e: Manifesto Eletrnico de Documentos Fiscais
NFS-e: Nota Fiscal de Servio Eletrnico
Totvs Colaborao
Configurao: Acrescentar no arquivo de configuraes do Server TSS , onde os servios/JOBs esto configurados ,o
parmetro JOBONDEMAND na seo Enviroment.
JOBONDEMAND = 1 (Ativado) / 0 (Desativado)
JOBONDEMAND=1
48
Verso 1.0

TSS Manual de Configuracao

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

TSS Manual de Configuracao

Hochgeladen von

Copyright:

Verfügbare Formate

Manual de Configurao TSS

Manual de Configurao TSS

1.2.1 WebService ................................................................................................................................................ 7

1.3.1 Configuraes ............................................................................................................................................ 40

Manual de Configurao TSS

1.3.1.3. Por Entidade ............................................................................................................................................. 43

1.4.1 ERP Totvs .................................................................................................................................................. 45

Reestruturao do TSS TSS OnDemand................................................................................................ 47

Manual de Configurao TSS

Manual de Configurao TSS

4. Escolha o Idioma para o repositrio do TSS.

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

4. Reveja a configurao definida e clique em avanar para iniciar a atualizao

Manual de Configurao TSS

Instalao do TSS no Linux

Manual de Configurao TSS

Manual de Configurao TSS

Declarao do JOB_WS na seo ONSTART

Manual de Configurao TSS

Manual de Configurao TSS

Rotinas a serem executadas:

Tempo de espera para reincio do processamento do Job:

Manual de Configurao TSS

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

Manual de Configurao TSS

NFCE_JOB_ENTIDADES=000001-000005 //Por padro sero processadas todas as entidades ativas do sistema.

Manual de Configurao TSS

Intervalo de tempo em segundos para execuo entre as entidades:

Manual de Configurao TSS

Eventos de emisso de CTe.

Manual de Configurao TSS

Intervalo de entidades para processamento:

Manual de Configurao TSS

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

Manual de Configurao TSS

Tempo de espera para reincio do processamento do Job:

Manual de Configurao TSS

1.2.2.9 Nota Fiscal Argentina

Manual de Configurao TSS

4- Nota Fiscal Interna Regime 2557:

Manual de Configurao TSS

1.2.2.10 TOTVS Colaborao

Manual de Configurao TSS

Rotinas a serem executadas:

Manual de Configurao TSS

Manual de Configurao TSS

Intervalo de tempo em segundos para execuo entre as entidades:

Importante/ Saiba Mais

Manual de Configurao TSS

Manual de Configurao TSS

Manual de Configurao TSS

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

Manual de Configurao TSS

Documento de Aviso de Embarque de NFe:

Documento de programao de entrega:

Recebimento do Pedido de Compra:

Recebimento de Aviso de Embarque para NFe:

Manual de Configurao TSS

Recebimento de programao de entrega:

Manual de Configurao TSS

Manual de Configurao TSS

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

Manual de Configurao TSS

Manual de Configurao TSS