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.
Deck of Cards
iddeckConfig
Card
id1
labelConfiguração do TSS

Antes de iniciar a utilização do TOTVS Transmite, efetue as configurações abaixo no arquivo appserver.ini 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

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.

...

Configuração do arquivo
  1. :

    Bloco de código
    firstline1
    title
  1. appserver.ini
    linenumberstrue
collapsetrue
  1. ;===================================================
    ;==================  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
;-------------------------------------------------------------------------------------------- ; 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=*

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.

  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

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

...