| Card |
|---|
| id | 1 |
|---|
| label | Passo 1: Configuração do TSS |
|---|
| Antes de iniciar a utilização do TOTVS Transmite realize 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
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 |
01. Configuração
Habilite o job (jobQueue)
Ainda no arquivo, habilite o job 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,  Image Removed
Sendo assim, quando for solicitado, basta informar a URL e porta do TSS (ex: 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 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 : | Aviso |
|---|
| - 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 informar
Informe o caminho do
certificado certificado através das chaves (CertificateServer / KeyServer)
no trecho na sessão [SSLConfigure]
no arquivo do appserver.ini.
| Bloco de código |
|---|
| firstline | 1 |
|---|
| title | appserver.ini |
|---|
| linenumbers | true |
|---|
| [SSLConfigure] |
CertificateClient=C:\totvssped\certs\000001_all.pem |
KeyClient=C:\totvssped\certs\000001_key.pem |
CertificateServer=C:\totvssped\certs\totvs_certificate.crt
KeyServer=C:\totvssped\certs\totvs_certificate_key.pem | Aviso |
|---|
| - 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 Removed Image 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 |
|
