Páginas filhas
  • 2. Primeiros Passos - Integração TSS x TOTVS Transmite

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
iddeckConfig
Card
id1
labelPasso 1: Configuração do TSS

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

  1. Habilite o serviço REST:

Bloco de código
firstline1
titleappserver.ini
linenumberstrue
;--------------------------------------------------------------------------------------------
;                                           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=*
  1. 01. Configuração

  2. Habilite o job (jobQueue)

Ainda no arquivo, habilite o job
  1. para o processamento da fila de integração do TSS com TOTVS Transmite:

    Bloco de código
    firstline1
    titleappserver.ini
    linenumberstrue
    ;===================================================
    ;==================  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

Na linha 4 foi criada a seção [jobQueue]

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)

Após garantir que os serviços estão em funcionamento, 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,  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;

A primeira, o usuário deverá importar as empresas da base do TSS; clicando Configurações > Importar Empresa, assim

que acessar a nova pagina,

 Image Removed

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

Image Removed

com isso, basta informar a URL http://localhost:8044 , após validar com sucesso, basta clicar em "Executar Importação",  e as empresas

serão integradas com sucesso, e estão disponíveis conforme abaixo:

Image Removed

A 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.", será aberto uma nova janela, para incluir os dados da nova empresa, vale lembrar a importância do nº de entidade

no TSS, pois ao cadastrar manualmente, o usuário deverá estar ciente de que deve criar uma empresa com um número de entidade diferente 

das demais presentes no banco de dados.

Image RemovedImage Removed

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.

  1. Aviso
    titleALERTA 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.
  2. Gere o certificado multiprotocolo: Porta Multiprotocolo - Geração de Certificado

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

    Bloco de código
    firstline1
    titleappserver.ini
    linenumberstrue
    [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
    titleALERTA 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
idconfigTransmite
labelConfiguraçã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

Passo 2: Configuração Transmite
Card
labelConsultando documentos

É importante ressaltar, que o papel do TOTVS Transmite é ser um Monitor de Documentos, desta forma, não tem como função a emissão, edição e transmissão de documentos eletrônicos.

Após garantir que os cadastros empresas foram realizados com sucesso, para que as consultas de documentos sejam realizadas com sucesso, siga a documentação para acessar cada um dos documentos no monitor:

3. Monitor de Documentos

Card
idconfigTransmite
label