Histórico da Página

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

1. Habilite o serviço REST:

"Alerta de risco: 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."

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

[HTTPREST]
Port=8044
IPsBind=
URIs=HTTPURI
Security=0
verbose=1 
bugs=1 
SSL2=1 
SSL3=1 
TLS1=3 
TLS1_0  =1 
TLS1_1  =1 
TLS1_2  =1

[HTTPV11]
Enable=1
Sockets=HTTPREST,JOB_WS
TimeOut=120

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

1. 01. Configuração

2. Habilite o job (jobQueue)

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

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 está 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,

"Alerta de risco: 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."

Image Removed

Sendo assim, quando for solicitado a validação do TSS no browser, basta informar a URL e porta do TSS (ex: https://localhost:8044/api/tss).

E quando for realizar a integração de documentos no transmite, será necessário informar a porta TSS sem "/api/tss"; por exemplo: https://localhost:8044/

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

1. Gere o certificado multiprotocolo: Porta Multiprotocolo - Geração de Certificado
   

1. 
   
2. Informe o caminho do

1. certificado através das chaves (CertificateServer / KeyServer)

1. na sessão [SSLConfigure]

1. no arquivo appserver.ini.
   

   Bloco de código
   firstline 1 title appserver.ini linenumbers true
   [SSLConfigure]

1. HSM =0

1. Verbose =1

1. SSL2 =0

1. SSL3 =1

1. TLS1_0 =1

1. TLS1_1 =1

1. TLS1_2 =1

1. Bugs =1

1. State =1

1. CertificateClient=C:\totvssped\certs\000001_all.pem

1. KeyClient=C:\totvssped\certs\000001_key.pem

1. CertificateServer=C:\totvssped\certs\totvs_certificate.crt

1. KeyServer=C:\totvssped\certs\totvs_certificate_key.pem

   
   

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:

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, 

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:

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.

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";

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.

Antes de começar as consultas a seguir, é importante ressaltar, que o papel do TOTVS Transmite é ser basicamente um Monitor de Documentos, ele não tem

como função a emissão, 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 recebidos.

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

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,

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