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 e versão superior a 19.3.0.x do  Application Server.

Deck of Cards
iddeckConfig
cardid

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 RemovedImage 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
id1
labelPasso 1: Configuraçã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:

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

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

    no arquivo

    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
    CertificateServer=C:\totvssped\certs\totvs_certificate.crt
    KeyServer=C:\totvssped\certs\totvs_certificate_key.pem
  1. Aviso
  1. title
configTransmite
labelPasso 2: Configuração Transmite
  1. ALERTA 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

É

Card
labelPasso 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, ele desta forma, 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 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.

siga a documentação para acessar cada um dos documentos no monitor:

3. Monitor de Documentos