tss bt atualizacao de boletim bra arg[1]

5/28/2018 TSS BT Atualizacao de Boletim BRA ARG[1]

1/42

Boletim Tcnico

1TSSTOTVS SERVICE SPED

TOTVSService SPED - TSS

Produto : TOTVS SERVICE SPEDTSS Verso 10

Chamado : TFYDR2 Data da publicao : 03/12/12

Pas(es) : Brasil / Argentina Banco(s) de Dados : Todos

Esta documentao define o processo para instalao e configurao do TOTVSSERVICE SPEDTSS.

O TOTVSSERVICE SPEDconsiste em um servidor (appserver) que responde e realiza requisies de servios WebService. Este

servidor tem o objetivo de fazer a comunicao entre os servios disponibilizados pelo fisco, especialmente, os servios de Nota Fiscal

Eletrnica, Nota Fiscal Eletrnica de Servio, entre outros.

Procedimento para Implementao

O TSS um aplicativo que responde e realiza somente servios Web Servicepara se comunicar com o ERP e com o fisco, sendo

necessrio que o hardwarede instalao possua conexo internet e tenha alto ndice de confiabilidade.


2/42

Boletim Tcnico

2 TSS

TOTVS SERVICE SPED

Trabalha junto com o TopConnect, desta forma ser necessrio ter um banco de Dados relacional homologado pela TOTVSTEC

(Ex: SQL Server, Oracle, DB2, etc.).

Caso exista algum bloqueio de Firewall, este deve ser liberado para a comunicao junto aos Web Services do Fisco.

Para iniciar a instalao do TSS, realize o download do Instalador do TSS por meio do portal do Cliente ou Analista. Com o

instalador baixado, realize o procedimento a seguir:

Instalao do TSS - Windows

1 Passo

1. Execute o instalador do TSS, arquivo TSS.exe. Ser aberta a tela para seleo do idioma de instalao:

2. Escolha a opo Portuguse clique em OK.

2 Passo

1. Ser apresentada a tela de Boas Vindas, com o Wizardde Instalao do TSS. Nesta tela clique em Avanar:

2. Ser aberta a tela do Contrato de Licena. Leia atentamente e se aceitar todos os termos do contrato, clique em Sim. Aoescolher No, o processo de instalao encerrado.

3. Na prxima tela, escolha a pasta de instalao do TSS emProcurar, por defaultser C:\TotvsSped\. Aps a escolha clique emAvanar.

4. Na prxima janela ser configurado o servio de HTTP, que o TSSdisponibilizar. Configure o servidor e a porta.

Ateno! No campo Servidordeve ser informado o IP do Servidor no qual est sendo realizada a instalao. Casoeste campo seja preenchido como LOCALHOST, o acesso se dar internamente apenas pelo servidor no qual estinstalado o TSS, qualquer outra mquina da Rede no enxergar o Servio.

5. Aps preenchimento dos campos Servidore Porta, clique em Avanar.

6. Neste momento, informe os campos Database, Aliase Servidor. Clique em Avanar.

7. Agora ser definido o Tipo de Instalao, ou seja, quais sero osjobsque o TSSsubir ao ser iniciado. As opes so:

Nota Fiscal Eletrnica;

Nota Fiscal EletrnicaLocalizado;

Nota Fiscal de Servio;

Conhecimento de Transporte Eletrnico;

Nota Fiscal Eletrnica[Totvs Colaborao];

Recebimento de Documentos[Totvs Colaborao];


3/42

Boletim Tcnico


Nota Fiscal de Servio [Totvs Colaborao];

Conhecimento de Transporte Eletrnico [Totvs Colaborao].

8. Aps definir os servios, clique em Avanar.Antes de copiar os arquivos, confira a configurao realizada.

9. Clique emAvanarpara continuar a instalao. Aguarde at que a barra de statusda quantidade instalada chegue ao final.

10. Indique se deseja executar o TSS como servio. Ao clicar em Sim, o TSS ser automaticamente classificado como servio doWindows, a opo Nofaz com que seja somente instalado e iniciado em modo console.

11. Aps a escolha, clique em Concluir.

12. Salve a configurao e inicie o servio do TSSem modo console para verificar se a configurao est correta.

13. Se o serversubir corretamente, acesse o endereo configurado na instalao do TSS via HTTP.

No exemplo a seguir foi configurado o IP 172.16.70.22e porta 8080, acessando via IE:


4/42

Boletim Tcnico

4 TSS

TOTVS SERVICE SPED

Procedimentos para Atualizao - Windows

Para iniciar a atualizao do TSSser necessrio realizar o downloadpor meio do portal do Cliente ou Analista. Realize o Updatee siga o

procedimento a seguir:

1 Passo

1. Baixe o servio do TSSa ser atualizado. Execute o Update do TSS, arquivo TSS-Update.exe, ao realizar este processo ser abertaa tela para seleo do idioma da instalao.

2 Passo

1. Ser aberta a tela de Boas Vindas, com o Wizard de Instalao do TSS.Nesta primeira tela, clique em Avanar.

2. Ser aberta a tela do Contrato de Licena, leia atentamente e caso aceite todos os termos, clique em Sim.

3. Na prxima tela escolha a pasta de instalao do TSS, por defaultser em C:\TotvsSped\. Aps a escolha, clique em Avanar.

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


5/42

Boletim Tcnico


5. Na prxima etapa, se deseja executar o TSScomo servio clique em Sim. O TSSser automaticamente colocado como serviodo Windows. Para que seja instalado e executado em modo console, clique em No.

Aps a escolha, clique em Concluir.

Instalao do TSS - Linux

Para iniciar a instalao do TSS, realize o download do Instalador do TSS por meio do portal do Cliente ou Analista. Com o

instalador baixado, realize o procedimento a seguir:

1 Passo

1. Execute o instalador do TSS(arquivo install_linux) via Terminal utilizando o comando ./install_linux.

2. Ser apresentada a mensagem de confirmao de instalao. Para continuar digite .


6/42

Boletim Tcnico

6 TSS

TOTVS SERVICE SPED

3.O prximo passo ser a configurao do idiomade instalao. Digite 1para informar a opo Portugus e digite paraconfigurar o prximo passo.

4.O passo seguinte ser a configurao do Banco de Dados. Digite 1para selecionar a opo TopConnect e digite paraconfigurar o prximo passo.


7/42

Boletim Tcnico


5.Neste passo, ser configurado o servio de HTTPque o TSSdisponibilizar. Configure o Servidore a Porta.


8/42

Boletim Tcnico

8 TSS

TOTVS SERVICE SPED

Ateno! No campo Servidordeve ser informado o IP do Servidor no qual est sendo realizada a instalao, pois oSistema Operacional Linux no entende como LOCALHOST, onde neste caso necessrio informar o IP 127.0.0.1.

Aps preenchimento dos campos Servidore Porta, digite para configurar o prximo passo.

6.Neste momento, ser realizada a configurao do TOP. Informe o Servidor, a Porta e Alias. Digite para configurar oprximo passo.

7.Neste momento ser definido se o JOB da Nota Fiscal Eletrnica subir no momento em que o TSSfor iniciado. Informe 1- Simou 2No. Digite para configurar o prximo passo.


9/42

Boletim Tcnico


8. Neste momento ser definido se o JOB da Nota Fiscal Eletrnica Localizado subir no momento em que o TSSfor iniciadoInforme 1- Sim ou 2No. Digite para configurar o prximo passo.

9. Neste momento ser definido se o JOB da Nota Fiscal de Servio subir no momento em que o TSSfor iniciado. Informe 1- Simou 2No. Digite para configurar o prximo passo.


10/42

Boletim Tcnico

10 TSS

TOTVS SERVICE SPED

10.Neste momento ser definido se o JOB do Conhecimento de Transporte Eletrnico subir no momento em que o TSS foriniciado. Informe 1- Sim ou 2No.


11/42

Boletim Tcnico


11.Neste momento definido se o JOB da Nota Fiscal Eletrnica[Totvs Colaborao] deve subir no momento em que o TSSforiniciado. Informe 1- Sim ou 2No.

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


12/42

Boletim Tcnico

12 TSS

TOTVS SERVICE SPED

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

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


13/42

Boletim Tcnico


15.Aps configurao dos Servios, digite para conclur a instalao.


14/42

Boletim Tcnico

14 TSS

TOTVS SERVICE SPED

16. Salve a configurao e inicie o servio do TSSem modo console para verificar se a configurao est correta.

17.Se o serversubir corretamente, acesse o endereo configurado na instalao do TSS via HTTP.

No exemplo a seguir foi configurado o IP 172.16.70.155e porta 8060, acessando via IE:


15/42

Boletim Tcnico


Ateno! A atualizaodo TSS realizada a partir da execuo do instalador com a ltima verso disponvel noPortal do cliente / analista, pois no h pacote de Updates para o Sistema Operacional Linux.

Procedimentos de Configurao

Existem algumas formas diferentes de se configurar o TSS, visando um melhor desempenho no processamento das Notas

Eletrnicas.

Como o TSS no apresenta uma interface, qualquer tipo de alterao na configurao deve ser feita diretamente no

TotvsAppServer.INI. Veja a seguir as funcionalidades de algumas Sees/Chaves utilizadas no TSS e tambm alguns exemplos de

configurao.

Sees importantes para o TSS:

[SSLCONFIGURE] abaixo desta seo existem as chaves que so responsveis pela comunicao do Web Service, junto com as

informaes do protocolo Criptogrfico (SSLSecurty Sockets Layer) .

Exemplo:

[SSLConfigure]

HSM=0

SSL2=1


16/42

Boletim Tcnico

16 TSS

TOTVS SERVICE SPED

SSL3=1

TLS1=1

BUGS=1

CertificateClient=C:\TSS\certs\000010_all.pem

KeyClient=C:\TSS\certs\000010_key.pem

[PROXY]caso exista um Proxy para o acesso a internet, a configurao do mesmo dever ser informada nas chaves desta seo.

Exemplo:

[PROXY]

Enable=1

Server=endereo do proxy

Port=porta do proxy

User=dominio\login usurioPassword=senha do usurio no proxy

[JOBNFE]Define ojobda Nota Fiscal Eletrnica (NF-e).

Exemplo:

[JOBNFE]

main=SPEDWF

environment=SPED

[CTE_WF]Define ojobdo Conhecimento de Transporte Eletrnico (CT-e).

Exemplo:

[CTEWF]

main=CTEWF

environment=SPED

[CLE_WF]Define ojobda Capa de Lote Eletrnica (CL-e).

Exemplo:

[CLE_WF]

main=CLE_WF

environment=SPED

[NFSE_WF]Define ojobda Nota Fiscal de Servio Eletrnico (NFS-e).

Exemplo:

[NFSE_WF]

MAIN=NFSEWF

ENVIRONMENT=SPED


17/42

Boletim Tcnico


[JOBNFE_WSFEX]Define ojobda Nota Fiscal de Exportao da Argentina.

Exemplo:

[JOBNFE_WSFEX]

MAIN=JOB_WSFEX

ENVIRONMENT=SPED

[JOBNFE_WSFE]Define ojobda Nota Fiscal interna da Argentina.

Exemplo:

[JOBNFE_WSFE]

MAIN=JOB_WSFE

ENVIRONMENT=SPED

[JOBNFE_WSMTX]Define ojobda Nota Fiscal interna da Argentina Regime Dominacion 2904.Exemplo:

[JOBNFE_WSMTX]

MAIN=JOB_WSMTX

ENVIRONMENT=SPED

[JOBNFE_WSBFE]Define ojobda Nota Fiscal interna da Argentina Regime 2557.

Exemplo:

[JOBNFE_WSBFE]

MAIN=JOB_WSBFE

ENVIRONMENT=SPED

[JOBNFECOL]Define ojobque processa a Nota Fiscal Eletrnica de Sada para TOTVS Colaborao.

Exemplo:

[JOBNFECOL]

MAIN=SPEDWFCOL

ENVIRONMENT=SPED

[JOBDOCSCOL]Define ojobque processa a Nota Fiscal Eletrnica de Entrada para TOTVS Colaborao.

Exemplo:

[JOBDOCSCOL]

MAIN=DOCSWFCOL

ENVIRONMENT=SPED

[JOBCTECOL]Define ojobque processa o conhecimento de Transporte eletrnico (CT-e) para TOTVS Colaborao.

Exemplo:


18/42

Boletim Tcnico

18 TSS

TOTVS SERVICE SPED

[JOBCTECOL]

MAIN=CTEWFCOLAB

ENVIRONMENT=SPED

[JOBNFSECOL]Define ojobque processa a Nota Fiscal de Servio Eletrnica (NFS-e) para TOTVS Colaborao.

Exemplo:

[JOBNFSECOL]

MAIN=NFSEWFCOL

ENVIRONMENT=SPED

[ONSTART]define quais osjobssero iniciados.

Exemplo:

[ONSTART]JOBS=JOBNFE,JOBNFE_WSFEX,JOBNFE_WSFE,JOBNFE_WSMTX,JOB_WSBFE,

NFSE_WF,CTE_WF,CLE_WF,JOBNFECOL,JOBDOCSCOL,JOBNFSECOL,JOBCTECOL

Algumas Chaves Importantes:

Abaixo esto listadas algumas chaves importantes para execuo do TSS. Elas esto divididas nos seguintes tpicos:

TSS.

Nota Fiscal Eletrnica (NF-e).

Nota Fiscal de Servio Eletrnica (NFS-e).

Nota Fiscal LocalizadaArgentina.

Conhecimento de Transporte Eletrnico (CT-e).

Capa de Lote Eletrnica (CL-e).

Totvs Colaborao.

TSS

TOPMEMOMEGA: permite que as conexes SGBD (Sistema de Gerenciamento de Banco de Dados), realizadas por meio do

ByYou DBAccess, utilizem campo M(Memo) com at 1000000 de bytes. Este parmetro necessrio, pois o TSSutiliza campos

MEMOpara gravao dos XML.

Deve estar dentro da seo que estiver a configurao do TopConnect, geralmente na chave do ambiente [Environment]ou na chave do TopConnect.

Exemplo:

[Environment]

TOPMEMOMEGA=1

XMLSAVEALL: permite que seja gravado na Pasta WSLOGXML, todos os XMLs de comunicao dos Mtodos do TSS com a

aplicao chamadora.

Esta chave deve ser habilitada somente para ajudar na anlise de inconsistncias, pois gera um grande nmero de XMLs


19/42

Boletim Tcnico


Exemplo:

[JOB_WS]

TYPE=WEBEX

ENVIRONMENT=SPED

INSTANCES=5,50

SIGAWEB=WS

INSTANCENAME=ws

ONSTART=__WSSTART

ONCONNECT=__WSCONNECT

XMLSAVEALL=1

SPED_SAVEWSDL:habilita a gravao dos Xmls de comunicao do TSS com os Web Services Externos. Esta chave deve ser

habilitada apenas em casos que seja realmente necessrio, pois, pode causar uma grande lentido na comunicao.Contedos vlidos

valor Descrio

X(padro) Desconsidera o parmetro

1 Todos

2 Web Servicede StatusServio \ NF-e

3 Web Servicede Consulta Cadastro \ NF-e

4 Web Servicede Consulta Cadastro_1 \ NF-e

5 Web Servicede Cancelamento \ NF-e

6 Web Servicede Consulta Nota \ NF-e

7 Web Servicede Inutilizao \ NF-e

8 Web Servicede Recepo Lote \ NF-e

9 Web Servicede Retorno Recepo \ NF-e

A Web Servicede Cancelamento \ CT-e

B Web Servicede Consulta \ CT-e

C Web Servicede Inutilizao \ CT-e

D Web Servicede Recepo \ CT-e

E Web Servicede Retorno Recepo \ CT-e

F Web Servicede Status Servio \ CT-e

G Web Servicede Consulta \ DPEC

H Web Servicede Recepo \ DPEC

I Web Servicede Cancelamento \ NFS-e BH

J Web Servicede Consulta Lote \ NFS-e BH

K Web Servicede Consulta NFS-e \ NFS-e BH

L Web Servicede Consulta NFS-e por RPS \ NFS-e BH

M Web Servicede Consulta Situao LOTE \ NFS-e BH

N Web Servicede Recepo \ NFS-e BH

O Web Servicede Gerao de NFS-e \ NFS-e BH


20/42

Boletim Tcnico

20 TSS

TOTVS SERVICE SPED

P Web Servicede Recepo \ NFS-e ISSnet

Q Web Servicede Consulta Situao LOTE \ NFS-e ISSnet

R Web Servicede Consulta NFS-e por RPS \ NFS-e ISSnet

S Web Servicede Consulta Lote \ NFS-e ISSnet

T Web Servicede Consulta NFSE \ NFS-e ISSnet

U Web Servicede Cancelamento \ NFS-e ISSnet

V

W

X

Y

Z

@

Web Servicede Envio de Lote (ABRASF)

Web Servicede Consulta de Lote (ABRASF)

Web Servicede Cancelamento de Lote (ABRASF)

Web Servicede Envio de Lote (DSFNET)

Web Servicede Consulta de Lote (DSFNET)

Web Servicede Cancelamento de Lote (DSFNET)

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

Exemplo:

Neste exemplo, foi definido que deve ser gravado o XML que o TSSrealizou a comunicao com os Servios

de STATUS, CONSULTA e Recepo de Lote da NF-e.

[Environment]

SPED_SAVEWSDL=268

SPED_USASPEDBR: define se as tabelas do TSS a serem carregadas sero referentes ao Brasil. Contedo Vlido: 0 - No / 1-

Sim.Exemplo:

[Environment]

SPED_USASPEDBR = 1

Nota Fiscal Eletrnica(NF-e)

NFESPED_WF: define se no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao processamento

realizado pelo JOB da NF-e sero demonstradas.

Exemplo:

[Environment]

NFESPED_WF=1

NFESPED_WFENTIDADES: define um range de entidades que sero processadas pelo JOB da NFE do TSS, parmetro muito

utilizado quando existe a necessidade de se ter mais de um TSSutilizando um mesmo banco devido a um grande nmero de

Entidades.

Exemplo


21/42

Boletim Tcnico


Neste exemplo, foi definido que ser processado pelo JOB da entidade 000005 at a entidade

000020.

[Environment]

NFESPED_WFENTIDADES=000005-000020

NFESPED_WFNFE: define qual o Job da NF-e que ser processado, utilizado quando houver a necessidade de se ter mais de um

TSS processando com o mesmo banco de dados, com este parmetro possvel definir um JOB para cada TSS.

Contedos vlidos

Valor Descrio

0 (padro) Todos.

1 Assinatura.

2 Transmisso.

3 Cancelamento/Inutilizao/Recepo de lotes.

4 Envio do e-mail de distribuio.

5 Recepo das Mensagens (email) de Excees.

Exemplo

Neste exemplo, foi definido que ser processado apenas o Servio de assinatura.

[Environment]

NFESPED_WFNFE=1

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

Contedos vlidos

Valor Descrio

0 (padro) Todos.

1 Assinatura.

2 Transmisso.

3 Verifica Lotes Pendentes e Cancelamento/Inutilizao.


5 Recepo da NF-e.

6 Assinatura / Transmisso/ Cancelamento de um Evento.

Exemplo

Neste exemplo, foi definido que ser processado apenas o Servio de Transmisso.

[Environment]

NFESPED_WORKFLOW = 2


22/42

Boletim Tcnico

22 TSS

TOTVS SERVICE SPED

NFESPED_WF_SLEEPJOB: tempo em segundos que o TSS utiliza para aguardar o reincio do processamento dos Jobs da NF-e.

Exemplo

[Environment]

NFESPED_WF_SLEEPJOB = 30

NFESPED_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Nota Fiscal Eletrnica.

Exemplo

[Environment]

NFESPED_WFDELAY = 10

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

Exemplo

[Environment]NFESPED_WFSMTP = 1

REFLOTE:define o nmero de referencia do lote.

Exemplo

[Environment]

REFLOTE = 50

Nota Fiscal de Servio Eletrnica (NFS-e)

NFSE_WF_DEBUG: define se ser demonstrado no console de execuo do TOTVSSERVICE SPED, as mensagens referentes ao

processamento realizado pelo JOB da NFS-e.

Exemplo:

[Environment]

NFSE_WF_DEBUG =1

NFSE_WF_ENTIDADES: define um range de entidades que sero processadas pelo JOB da NFS-e do TSS, parmetro muito

utilizado quando existe a necessidade de se ter mais de um TSS utilizando um mesmo banco devido a um grande numero de

Entidades.

Exemplo


000020.

[Environment]

NFSE_WF_ENTIDADES =000005-000020

NFSE_WORKFLOW: informa quais servios do JOB da NFS-e sero executados.

Contedos Vlidos


23/42

Boletim Tcnico


Valor Descrio

0 (padro) Todos.

1 Monta os lotes para transmisso.

2 Monta os lotes para Cancelamento.

3 Transmite os lotes pendentes.

4 Recepciona os lotes pendentes.

5 Verifica Substituio.

Exemplo

Neste exemplo, foi definido que ser processado apenas o Servio de Montagem dos lotes para

transmisso.

[Environment]

NFSE_WORKFLOW = 1

NFSE_WORKFLOW_1: este parmetro deve ser utilizado quando no houver o NFSE_WORKFLOW. Quando habilitado ir ativar

o servio de Montagem de Lotes para Transmisso. Contedo Vlido:0 - Desativado / 1- Ativado.

Exemplo

[Environment]

NFSE_WORKFLOW_1 = 1

NFSE_WORKFLOW_2: este parmetro deve ser utilizado quando no houver o NFSE_WORKFLOW. Quando ativado ir habilitar

o servio de Montagem de Lotes para Cancelamento. Contedo Vlido: 0 - Desativado / 1- Ativado.

Exemplo

[Environment]

NFSE_WORKFLOW_2 = 1

NFSE_WORKFLOW_3: este parmetro deve ser utilizado quando no houver o NFSE_WORKFLOW. Quando ativado ir habilitar

o servio de Transmisso dos Lotes Pendentes. Contedo Vlido: 0 - Desativado / 1- Ativado.

Exemplo

[Environment]

NFSE_WORKFLOW_3 = 1

NFSE_WF_SLEEP: tempo em segundos que o TSS aguarda para o reincio do processamento dos Jobs da NFS-e.

Exemplo

[Environment]

NFSE_WF_SLEEP = 30

NFSE_MODO_DEBUG:define se ser demonstrado no console as mensagens avanadas do Debug. Contedo Vlido: 0 - No /

1- Sim.


24/42

Boletim Tcnico

24 TSS

TOTVS SERVICE SPED

Exemplo

[Environment]

NFSE_MODO_DEBUG = 1

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

Exemplo

[Environment]

NFSE_GERLOG = 1

NFSE_WFDELAY:tempo de espera em segundos para iniciar o Job por entidade referente Nota Fiscal de Servio Eletrnica.

Exemplo

[Environment]

NFSE_WFDELAY = 10

Nota Fiscal Eletrnica Localizada (Argentina).

NFELOC_WFENTIDADES:define um range de entidades que sero processadas pelo JOB da NF-e da Argentina, parmetro muito

utilizado quando existe a necessidade de se ter mais de um TSSutilizando um mesmo banco devido a um grande nmero de

Entidades.

Exemplo


000020.

[Environment]

NFELOC_WFENTIDADES=000005-000020

NFELOC_WFNFE:define qual o JOB do TSS - Argentina que ser processado, utilizado quando houver a necessidade de se ter

mais de um TSS processando com o mesmo banco de dados, com este parmetro possvel definir um JOB para cada TSS.

Contedos vlidos

Valor Descrio

0(padro) Todos.

1 Assinatura.

2 Transmisso.3 Cancelamento/Inutilizao.


5 Recepo das Mensagens (email) de Excees.

Exemplo

Neste exemplo, foi definido que ser processado apenas o JOB de assinatura.


25/42

Boletim Tcnico


[Environment]

NFELOC_WFNFE =1

NFELOC_WFDELAY: tempo de espera em segundos para reiniciar o Job por entidade referente ao Job Localizado (Argentina).

Exemplo

[Environment]

NFELOC_WFDELAY = 10

NFELOC_WF: define se no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao processamento realizado

pelo JOB da NF-e da Argentina sero demonstradas.

Exemplo

[Environment]

NFELOC_WF = 1

SAVE_LOCNFE: habilita a gravao dos Xmls de comunicao do TSS com os Web Services Externos. Esta chave deve ser

informada apenas em casos que seja realmente necessrio, pois pode causar uma grande lentido na comunicao. Para

habilita-lo dever configurar com 1 - Todos.

Exemplo

[Environment]

SAVE_LOCNFE = 1

NFELOC_USALOC: define se o ambiente utilizar transmisso Localizada - Argentina. Contedo Vlido: 0 - No / 1- Sim.

Exemplo

[Environment]

NFELOC_USALOC = 1

Conhecimento de Transporte Eletrnico (CT-e)

SPED_DELMAIL: define se deve ser apagada a informao EMAIL= do XML do CT-e. Contedos Vlidos: 0 - No / 1- Sim.

Exemplo

[Environment]

SPED_DELMAIL = 1

Capa de Lote Eletrnica (CL-e)

SPED_USACLE: define se o ambiente utilizar a transmisso da Capa de Lote Eletrnica. Contedos Vlidos: 0 - No / 1- Sim.

Exemplo

[Environment]

SPED_USACLE = 1


26/42

Boletim Tcnico

26 TSS

TOTVS SERVICE SPED

CLE_WF_ENTIDADES:define um range de entidades que sero processadas pelo JOB da CL-e do TSS, parmetro muito utilizado

quando existe a necessidade de se ter mais de um TSS utilizando um mesmo banco devido a um grande numero de Entidades.

Exemplo


000020.

[Environment]

CLE_WF_ENTIDADES =000005-000020

CLE_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Capa de Lote Eletrnica.

Exemplo

[Environment]

CLE_WFDELAY = 10

CLE_WF_SLEEP: tempo em segundos que o TSS aguarda o reincio do processamento dos Jobs da CL-e.

Exemplo

[Environment]

CLE_WF_SLEEP = 30

CLE_WF_DEBUG:define se ser demonstrado no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao

processamento realizado pelo JOB da CL-e.

Exemplo

[Environment]

CLE_WF_DEBUG = 1

CLE_SAVEWSDL: habilita a gravao dos Xmls de comunicao do TSS com os WebService Externos. Esta chave deve ser

habilitada apenas em casos que seja realmente necessrio, pois pode causar uma grande lentido na comunicao.

Exemplo

[Environment]

CLE_SAVEWSDL = 1

CLE_WORKFLOW:informa quais servios do JOB da CL-e sero executados. Servio disponvel: 1 -Transmisso.

Exemplo

[Environment]

CLE_WORKFLOW = 1

CLE_WORKFLOW_1: este parmetro deve ser utilizado quando no houver o parmetro CLE_WORKFLOW. Quando ativado ir

habilitar o servio de Transmisso da CL-e. Contedo Vlido: 0 - Desativado / 1- Ativado.


27/42

Boletim Tcnico


Exemplo

[Environment]

CLE_WORKFLOW_1 = 1

Totvs Colaborao

SPED_USACOLAB:define se o ambiente utilizar Totvs Colaborao para Transmisso de NF-e. Contedos Vlidos: 0 - No / 1-

Sim.

Exemplo

[Environment]

SPED_USACOLAB = 1

TSSCOLAB_RETRECEPCAO109:define o tempo de espera para retorno de Recebimento da NF-e atravs do Totvs Colaborao.

Exemplo

[Environment]

TSSCOLAB_RETRECEPCAO109 = 300

TSSCOLAB_RETRECEPCAO170: define o tempo de espera para retorno de Emisso da Nf-e atravs do Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO171: define o tempo de espera para retorno de Cancelamento da NF-e atravs do Totvs Colaborao.

Exemplo

[Environment]

TSSCOLAB_RETRECEPCAO171= 30

TSSCOLAB_RETRECEPCAO172:define o tempo de espera para retorno de Inutilizao da NF-e atravs do Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO199: define o tempo de espera para retorno de Emisso do CTE atravs do Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO200: define o tempo de espera para retorno de Cancelamento do CTE atravs do Totvs Colaborao.

Exemplo


28/42

Boletim Tcnico

28 TSS

TOTVS SERVICE SPED

[Environment]


TSSCOLAB_RETRECEPCAO201: define o tempo de espera para retorno de Inutilizao do CTE atravs do Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO203:define o tempo de espera para retorno de Emisso da NFS-e atravs do Job Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO204: define o tempo de espera para retorno de Cancelamento da NFS-e atravs do Job Totvs

Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO210:define o tempo de espera para retorno de Recebimento de Cancelamento da NF-e atravs do

Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO214:define o tempo de espera para retorno de Recebimento do CTE atravs do Totvs Colaborao.

Exemplo

[Environment]


TSSCOLAB_RETRECEPCAO301: define o tempo de espera para retorno da CC-e atravs do Totvs Colaborao.

Exemplo

[Environment]


DOCS_WFDELAY: tempo de espera em segundos para iniciar o Job por entidade referente Recebimento de NF-e para TOTVS

Colaborao.


29/42

Boletim Tcnico


Exemplo

[Environment]

DOCS_WFDELAY = 10

DOCS_WF_ENTIDADES:define um range de entidades que sero processadas pelo JOB que processa a Recebimento de NF-e

para TOTVS Colaborao no TSS, parmetro muito utilizado quando existe a necessidade de se ter mais de um TSS utilizando um

mesmo banco devido a um grande numero de Entidades.

Exemplo


000020.

[Environment]

DOCS_WF_ENTIDADES =000005-000020

DOCS_WORKFLOW: informa quais servios do JOB dos Documentos para TOTVS COLABORAO sero executados. Servio

disponvel: 1- Transmite e verifica os documentos pendentes.

Exemplo

[Environment]

DOCS_WORKFLOW = 1

DOCS_WORKFLOW_1: este parmetro deve ser utilizado quando no houver o parmetro DOCS_WORKFLOW. Quando ativado

ir habilitar o servio de Transmisso e verificao dos documentos pendentes. Contedo Vlido: 0 - Desativado / 1- Ativado.

Exemplo

[Environment]

DOCS_WORKFLOW_1 = 1

DOCS_WF_DEBUG: define se ser demonstrado no console de execuo do TOTVS SERVICE SPED, as mensagens referentes ao

processamento realizado pelo JOB do recebimento da NF-e atravs do Totvs Colaborao.

Exemplo:

[Environment]

DOCS_WF_DEBUG =1

DOCS_WF_SLEEP: tempo em segundos que o TSS aguarda o reincio do processamento dos Jobs do recebimento de NF-e

atravs do Totvs Colaborao.

Exemplo

[Environment]

DOCS_WF_SLEEP = 30


30/42

Boletim Tcnico

30 TSS

TOTVS SERVICE SPED

NFSECOL_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Jobpor entidade a partir da segunda chamada do

JOB,referente a Nota Fiscal de Servio Eletrnica via TOTVS Colaborao.

Exemplo

[Environment]

NFSECOL_WFENTIDADEWAIT=10

NFECOL_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Jobpor entidade a partir da segunda chamada do

JOB,referente a Nota Fiscal Eletrnica via TOTVS Colaborao.

Exemplo

[Environment]

NFECOL_WFENTIDADEWAIT=10

NFESPED_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Jobpor entidade a partir da segunda chamada doJOB,referente a Nota Fiscal Eletrnica.

Exemplo

[Environment]

NFESPED_WFENTIDADEWAIT=10

NFSE_WFENTIDADEWAIT:tempo de espera em segundos para iniciar o Jobpor entidade a partir da segunda chamada do JOB

referente a Nota Fiscal de Servio Eletrnica.

Exemplo

[Environment]

NFSE_WFENTIDADEWAIT=10

CLE_WFENTIDADEWAIT: tempo de espera em segundos para iniciar o Jobpor entidade a partir da segunda chamada do JOB

referente a Capa de Lote Eletrnica.

Exemplo

[Environment]

CLE_WFENTIDADEWAIT=10

NFELOC_WFENTIDADEWAIT:tempo de espera em segundos para iniciar o Jobpor entidade a partir da segunda chamada doJOB

referente ao Localizado ( Argentina).

Exemplo

[Environment]

NFELOC_WFENTIDADEWAIT=10


31/42

Boletim Tcnico


Exemplos Indicados para uso do TSS

Exemplo 1Modo de utilizao padro para empresas com baixo volume de movimentao.

Neste exemplo ser demonstrada a configurao padro do TSS.Ser configurado no mesmo servio o HTTP e os JOBS.

Estrutura de Diretrios:

Arquivo TOTVSAppserver.ini

Passo 1 - Configurao do Environment[SPED]


32/42

Boletim Tcnico

32 TSS

TOTVS SERVICE SPED

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

Passo 3 - Configurao dos JOBS, e habilitando o start de todos os JOBS atravs da Seo [ONSTART]

Passo 4 - Configurando o endereo de HTTP do servio:


33/42

Boletim Tcnico


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

Exemplo 2 Modo de utilizao com separao de servios para empresas com mdio volume de movimentaes. Neste modo

so configurados dois servios; um apenas para o HTTP e outro apenas para os JOBS.

Servio 1 - HTTP

Realizar toda a configurao conforme o exemplo 1, deixando apenas de realizar o Passo 3 da configurao dos JOBS.


34/42

Boletim Tcnico

34 TSS

TOTVS SERVICE SPED

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

Servio 2JOBS


35/42

Boletim Tcnico


Realizar a configurao conforme o Exemplo 1, deixando apenas de realizar os Passos 2 e 4.

A iniciar o servio em modo console ser mostrado apenas o start dos JOBS:


36/42

Boletim Tcnico

36 TSS

TOTVS SERVICE SPED

Exemplo 3 Modo de utilizao com separao de Servios de processamento do JOB, para empresas com alto volume de

movimentaes.

Neste exemplo ser demonstrado a configurao de 4 Servios, cada um utilizar a chave NFESPED_WFENTIDADEScom um range

de entidades configurado.

Servio 1Entidades de 0000010000003 mais o servio de HTTP.

Realize os mesmos procedimentos do Exemplo 1, s que no passo 1 inclua a chave NFESPED_WFENTIDADESda seguinte

forma:


37/42

Boletim Tcnico


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

Servio 2Entidades de 000004000006 sem os servios do HTTP.


38/42

Boletim Tcnico

38 TSS

TOTVS SERVICE SPED

Realize os mesmos procedimentos do Exemplo 1, mas no realize a configurao do HTTP (Passos 2 e 4) e no passo 1

inclua a chave NFESPED_WFENTIDADESda seguinte forma:



Realize os mesmos procedimentos do servio 2.


39/42

Boletim Tcnico




Realize os mesmos procedimentos do servio 2.


40/42

Boletim Tcnico

40 TSS

TOTVS SERVICE SPED



41/42

Boletim Tcnico


Para que seja apresentado no console as informaes dos jobs, habilite a chave NFESPED_WF = 1para osjobsdaNF-e e NFSE_WF_DEBUG=1para osjobsda NFS-e.

Para o Exemplo 3 tambm possvel realizar a separao do processamento para os jobsda NFS-e, basta utilizar achaveNFSE_WF_ENTIDADES, no lugar da chave NFESPED_WFENTIDADES.

Certificados Homologados pelo TSS

Atualmente esto disponveis no mercado dois tipos de certificados digitais: o certificado de tipo A1 (em formato de arquivo com

extenses .pfx ou .p12) e o certificado de tipo A3 (tipo hardware, podendo ser um carto ou token).

No TSS esto homologados apenas dois Tipos: A1 e o A3.

Abaixo seguem as marcas e modelos de certificados tipo A3 aceitos:

HSMs da marca SAFENET:

LUNA SA

LUNA SP

LUNA PCI

LUNA PCM

PROTECTSERVER Externo

PROTECTSERVER Gold ProtectHost EFT

Token da marca PRONOVA:

EPASS2000

Observao:

Para o pleno funcionamento da NF-e necessrio que o certificado digital no HSM seja importado com as seguintes diretivas:

CKA_PRIVATE

CKA_VERIFY

CKA_SIGN

Configurao manual de URL

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


42/42

Boletim Tcnico

42 TSS

TOTVS SERVICE SPED

O TSS realiza a leitura do arquivo spedurl.cfg dentroda pasta system do ambiente.Este arquivo deve ser preenchido de maneiraque cada linha deve conter as informaes sobre uma URL, sendo separadas por virgula, exemplo:

Orgo,Ambiente,Modelo,Servio,URL

Caso queira alterar a URL do servio externo NFeRecepcao do estado do Amazonas para o ambiente de homologao, necessriocriar uma linha no arquivo da seguinte forma:

AM,2,55,NFERECEPCAO,HTTP://MINHA.NOVA.URL

O TSS ento, toda vez que precisar utilizar a URL deste servio, usa a que foi definida dentro doarquivo.

Atualizao das URLs padres

A partir do release 2.09, o TSS conta com o arquivo tssatuurl.cfg na pasta system de seu ambiente para a atualizao das URLpadres do sistema. Sendo um arquivo encriptado, impossibilitando sua edio, o TSS em sua primeira execuo realiza a leituradeste arquivo, verificando se um arquivo mais recente, alimenta sua base com as URL novas e realiza a excluso do arquivo da

pasta.

INFORMAES TCNICAS

Tabelas Utilizadas

SPED000 - Tabela de Parmetros; SPED001 - Cadastro de Entidades ;SPED001A - Complemento de Entidades ; SPED050 - Notas FiscaisEletrnicas; SPED050L - Factura Electrnica - Localizada; SPED051 - NotasFiscais Eletrnicas de Servio; SPED052 - Lote da NF-e; SPED052L - Lote da

Factura Electrnica; SPED053 - Lote da NFS-e; SPED054 - RelacionamentoLote versus NF-e; SPED054L - Relacionamento Lote versus Factura;SPED055 - Relacionamento Lote versus NFS-e; SPED056 - Nota Fiscal

Eletrnica log de Contingncia.

Funes Envolvidas No se aplica

Sistemas Operacionais Windows/Linux

tss bt atualizacao de boletim bra arg[1]

Documents