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.

A versão 3.0 do TSS introduziu um novo conceito em relação ao processamento de documentos.

Referente aos documentos eletrônicos, qualquer inclusão ou alteração de Status de documento eletrônico na Base de dados do TSS é denominado um Processo. Cada modelo de documento pode conter um  ou mais tipos de processo. Por exemplo o Tipo de documento NFe possui processos do tipo: Emissão, Cancelamento, Carta de correção etc...

Por sua vez um Processo pode ser composto por Sub Processos, que representam as etapas de execução de um Processo. As etapas também podem variar de acordo com o Processo. No caso de um processo de Emissão de NFe temos: Recepção, Assinatura, Transmissão, Recepção e Envio de E-mail.

Para melhor organização e identificação, os Documentos e Processos estão definidos em cadastro:

2. Configuração do JOB
Deck of Cards
iddeckConfig

appserver.ini

Card
id1
label1. Configuração do serviço RESTTSS

Antes de iniciar a utilização do TOTVS TransmitePara habilitar o serviço REST, efetue as configurações abaixo no arquivo appserver.ini no TSS 

Bloco de código
firstline1
title
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=*
Card
id2
label2. Configuração do serviço REST no TSS

do TSS:

  1. Habilite o serviço REST: 01. Configuração

  2. Habilite o job (jobQueue) para o processamento da fila de integração do TSS com TOTVS Transmite:

    Bloco de código
    firstline1
code
  1. 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
    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
id
configTransmite
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

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

2label