Histórico da Página

Monitore os documentos eletrônicos com o TOTVS Transmite.

Siga os passos a seguir e veja como é simples configurar.

Documento valido para a versão 12.1.27 do TSS.

Deck of Cards

id	deckConfig

Card

id	1
label	Passo 1: Configuração do TSS

Antes de iniciar a utilização do TOTVS Transmite, recomendo que realizem as orientações a seguir:Efetue efetue as configurações abaixo no arquivo appserver.ini do TSS:Para habilitar

Habilite o serviço REST:

Bloco de código

firstline	1
title	appserver.ini
linenumbers	true

;--------------------------------------------------------------------------------------------
;                                           WS REST
;--------------------------------------------------------------------------------------------
[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=SPED

[HTTPREST] 
Port=8044
IPsBind=
URIs=HTTPURI
Security=0

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPURI]
URL=/api/tss
PrepareIn=
Instances=1,10
CORSEnable=1
AllowOrigin=*

01. Configuração
Habilite o job (jobQueue)

Ainda no arquivo, habilite o job

Repare que na linha 4 foi criada a seção [jobQueue];

Enquanto na linha 9 foram incluídos os dois últimos parâmetros, jobQueue e HTTPJOB (seção declarada na linha 4 do bloco de código anterior);

Um ponto importante esta na linha do Port, pois a porta informada nela, será necessária para a execução de alguns processos após acessar o TOTVS

Transmite,

Image Removed

Sendo assim, quando for solicitado, basta informar http://localhost:8044, que o sistema lhe solicitar a porta de conexão.

Vale lembrar que a integração com o Transmite deverá ser realizada via conexão segura com o uso do protocolo "https". Dessa forma, deverá ser gerado

um certificado auto assinado com o host do TSS (DNS ou IP), para que o serviço possa ser acesso pelo "Transmite". Para a geração do certificado

disponibilizamos a seguinte ferramenta :

para o processamento da fila de integração do TSS com TOTVS Transmite:

Bloco de código

firstline	1
title	appserver.ini
linenumbers	true

;===================================================
;==================  Chamada dos Jobs ==============
;===================================================
[jobQueue]
main= jobQueue
environment=sped

[ONSTART]
JOBS = JOB_HTTP,JOB_WS,IPC_ONDEMAND,IPC_CONT,TSSTASKPROC,IPC_SMTP,jobQueue,HTTPJOB
REFRESHRATE=20

Aviso

title	ALERTA DE RISCO

TSS anteriores a versão 12.1.2410: fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização."
TSS com versão 12.1.2410 ou superior: a partir do TSS versão 12.1.2410, a chave Security=1 é obrigatória.

Gere o certificado multiprotocolo:

Porta Multiprotocolo - Geração de Certificado

Após a geração do certificado, basta adicioná-lo ao diretório \certs(ou qualquer outro diretório dentro da instalação do TSS) e configurá-lo no arquivo appserver.ini

Image Removed

Informe o caminho do certificado através das chaves (CertificateServer / KeyServer) na sessão [SSLConfigure] do appserver.ini.

Bloco de código

firstline	1
title	appserver.ini
linenumbers	true

[SSLConfigure]
HSM =0
Verbose =1
SSL2 =0
SSL3 =1
TLS1_0 =1
TLS1_1 =1
TLS1_2 =1
Bugs =1
State =1
CertificateClient=C:\totvssped\certs\000001_all.pem
KeyClient=C:\totvssped\certs\000001_key.pem

Aviso

title	ALERTA DE RISCO

TSS anteriores a versão 12.1.2410: fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização."
TSS com versão 12.1.2410 ou superior: a partir do TSS versão 12.1.2410, a chave Security=1 é obrigatória.

Card

id	configTransmite
label	Configuração Transmite

Após garantir que as configurações anteriores estão corretas, o usuário precisará realizar a configuração Integração TSS. A documentação a seguir explica o passo a passo desta configuração:

Configurar Empresas - Integração TSS

Após garantir que as configurações anteriores estão corretas, o usuário deverá acessar o site do TOTVS Transmite, onde será

solicitado que o usuário informe os dados de login e senha:

Image Removed

Assim que o usuário logar com sucesso, a primeira ação a ser realizada pelo usuário deverá ser a importação das empresas

da base do TSS; clicando Configurações > Importar Empresa,

Image Removed

e assim que acessar a nova pagina, será necessário informar a url de conexão do TSS, caso não saiba ou não consiga identificar qual a

URL correta, pode-se consultar através do arquivo ini, em "Port = XXXX" dentro de "[HTTPREST]" citado no passo anterior. Após validar

com sucesso, basta clicar em "Executar Importação", que as empresas serão integradas com sucesso, e estão disponíveis conforme abaixo:

Image Removed

Caso não queira importar, uma segunda opção, é o cadastro das empresas, na mesma tela de configurações, mas ao invés de clicar em "Importar Emp.",

o usuário deve clicar em "Cadastrar Emp.", onde será aberto uma nova janela, para inclusão dos dados da nova empresa.

Image RemovedImage Removed

E ao término, a(s) empresa(s), estarão disponíveis para consulta no grid das configurações.

Antes de partir para a próxima etapa, é necessário configurar as regras de integração com TSS, para isso, basta selecionar a empresa clicando no

checkbox, ao lado do nome da empresa, e na sequência clicar em "Config. Empresas" > "Integração TSS";

Image Removed

Assim que abrir a janela acima, o usuário deverá inserir o link para conexão do TSS (o mesmo que foi informado na integração das empresas), na sequência

deverá informar o "Período de Migração", este é um campo essencial, pois é com base nele que a API de integração entrará em contato com o TSS, para

"buscar" as notas fiscais emitidas dentro desse período. Para que não tenhamos o famoso "consumo indevido" com a SEFAZ, é recomendável que seja inserido

30, garantindo que a cada 30 dias as notas serão integradas com sucesso, evitando um número de consultas excessivas com o estado.

Card

label	Consultando documentos

É

Card

id	configTransmite
label	Passo 2: Configuração Transmite

Card

label	Passo 3: Consultando documentos

Antes de começar as consultas a seguir, é importante ressaltar, que o papel do TOTVS Transmite é ser basicamente um Monitor de Documentos, desta forma, ele não tem como função a emissão, edição e edição e transmissão de documentos ; estas utilidades ficam a cargo do Protheus, o Transmite vem com a proposta de facilitar a visualização e o controle dos documentos emitidos e recebidoseletrônicos.

Após garantir que os cadastros empresas foram realizados com sucesso, para que as consultas de documentos sejam realizadas com sucesso, o usuário deverá

se certificar de que as suas empresas estão disponíveis para consulta dentro da aba "Filiais":

Image Removed

Se por algum motivo, a empresa desejada não estiver disponível, existem duas opções para resolução deste problema;

Após cadastrar com sucesso, o usuário deve retornar para a consulta de documentos, clicando em Monitor de Documentos > NFe >

Emitidas, e na sequência, informar os dados dos respectivos filtros de pesquisa,

Image Removed

e assim que clicar em "Aplicar Filtro", será listado todas as notas fiscais já integradas com o TSS, caso as notas não sejam apresentadas,

é recomendável que realize o envio de notas normalmente através do TSS (como já é feito atualmente), que as mesmas serão carregadas

e estarão disponíveis para uso dentro do TOTVS Transmite.

siga a documentação para acessar cada um dos documentos no monitor:

3. Monitor de Documentos

Páginas filhas

Versões comparadas

Versão antiga 17

Nova versão Atual

Chave