TSS Manual de Configuracao

Manual de Configurao - TSS

TSS

do Treinamento

TOTVS Service SOA

2

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 ............................................................................................................................................... 6

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 .................................................................................................................... 16

1.2.2.10.1 NFe .......................................................................................................................................... 17

1.2.2.10.2 CTe........................................................................................................................................... 18

1.2.2.10.3 NFSeSe ..................................................................................................................................... 19

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 ........................................................................................................................ 27

1.2.4 Rede ................................................................................................................................................ 29

1.2.5 Interface .......................................................................................................................................... 29

1.2.5.1. Acesso ......................................................................................................................................... 30

1.2.5.2. TSSMonitor .................................................................................................................................. 30

1.2.5.3 TSSPortal ...................................................................................................................................... 31

1.3. Balanceamento ................................................................................................................................. 31

1.3.1. Configuraes ................................................................................................................................. 31

1.3.1.1. Por JOBJOB .................................................................................................................................. 32

1.3.1.2 Pro procedimento ......................................................................................................................... 33

1.3.1.3 Por entidade ................................................................................................................................. 34

1.3.1.4. Estimativa .................................................................................................................................... 34

TOTVS Service SOA

3

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

do Treinamento

TOTVS Service SOA

4

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

3- O prximo passo a configurao do idioma de instalao. Digite 1 para informar a opo Portugus e digite para configurar o prximo passo.

TOTVS Service SOA

5

4- O passo seguinte a configurao do Banco de Dados. Digite 1 para selecionar a opo TopConnect e digite 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 para configurar o prximo passo.

7- Aps configurao dos Servios (Jobs) que devero ser executados, digite 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

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

do Treinamento

TOTVS Service SOA

6

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).

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

TOTVS Service SOA

7

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

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]

do Treinamento

TOTVS Service SOA

8

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, temos 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.

TOTVS Service SOA

9

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:


valores padres:

Rotinas a serem executadas

[Nome do Environment]

NFCE_JOB_ROTINAS= nfceOffLine, nfceOffLote, nfceInutiliza

Entidades a serem processadas


do Treinamento

TOTVS Service SOA

10

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.


[Environment]



[Environment]



[Environment]


TOTVS Service SOA

11

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).

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.


valores padres:


[Environment]

NFESPED_WORKFLOW=0


do Treinamento

TOTVS Service SOA

12

[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 temos 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 entidade de 000001 a

000005.

Intervalo de tempo em segundos entre execuo das rotinas:

[Environment]

CLE_WF_DELAY=10

TOTVS Service SOA

13


[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.


vrgula(Por exemplo:1,2,4), caso no informado o default 0.


valores padres:


[Environment]

NFESPED_WORKFLOW=0


[Environment]

do Treinamento

TOTVS Service SOA

14

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]

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:

TOTVS Service SOA

15


[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


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:

do Treinamento

TOTVS Service SOA

16

[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

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

TOTVS Service SOA

17

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.


valores padres:


[Environment]

NFECOL_WORKFLOW=0


[Environment]



000001 a 000005.


[Environment]

NFESPED_WFDELAY = 2


do Treinamento

TOTVS Service SOA

18

[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


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.

TOTVS Service SOA

19


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

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:

do Treinamento

TOTVS Service SOA

20

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



valores padres:



NFSECOL_WORKFLOW=0



NFSEWF_ENTIDADES=000001-000005


000001 a 000005.


[Environment]

NFSE_WFDELAY = 10


[Environment]

NFSECOL_WFENTIDADEWAIT = 1


[Environment]

NFESPED_WF_SLEEPJOB =30


0=Desabilita

1=Habilita

[Environment]

SPED_THREADID= 0

TOTVS Service SOA

21


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.


[Environment]

NFESPED_WFDELAY = 2


[Environment]



[Environment]



0=Desabilita

1=Habilita

[Environment]

SPED_THREADID= 0

do Treinamento

TOTVS Service SOA

22

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

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:

TOTVS Service SOA

23

[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


[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

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 parmetro DOCS_WORKFLOW dever estar configurado da seguinte forma:

[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

do Treinamento

TOTVS Service SOA

24

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:

[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 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

TOTVS Service SOA

25

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

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]



do Treinamento

TOTVS Service SOA

26

[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.


valores padres:


[Environment]

NFECOL_WORKFLOW=0


[Environment]



000001 a 000005.


[Environment]

NFESPED_WFDELAY = 2


[Environment]


TOTVS Service SOA

27


[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:

2,http://ipserver:porta,0,0

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:

Ambiente:

1 Produo

2 Homologao

do Treinamento

TOTVS Service SOA

28

[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 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)

TOTVS Service SOA

29

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:

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.

do Treinamento

TOTVS Service SOA

30

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.

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.

TOTVS Service SOA

31

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.

Estrutura de menus do aplicativo:

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.

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

do Treinamento

TOTVS Service SOA

32

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 JOBJOB

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):


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:

TOTVS Service SOA

33

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 Pro 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]

do Treinamento

TOTVS Service SOA

34

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


[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.

TOTVS Service SOA

35

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:

J

Banco de Dados

Servidores de JOB balanceados

WebServices Homologados

Web Service

Documents

TSS Manual de Configuracao