Árvore de páginas

Versões comparadas

Chave

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

...

Com esta integração, o sistema Protheus passa a transmitir Borderôs de Pagamento para bancos através do TOTVS Connect Bank (TCB), baseando-se em comunicação por API.


02. CADASTROS

  • Bancos

No cadastro de bancos, foi criado um novo campo, chamado "Habilita TCB".

Este campo com a informação de "Sim", habilita o banco a realizar suas transmissões de borderôs de títulos a pagar via TCB.

03. CNAB CLOUD

Nesta primeira versão do produto, para termos o menor impacto possível na operação dos usuários, precisaremos de um CNAB configurado para que o Protheus possa se comunicar com o TCB.

Para isso, através da ferramenta Wizard Cnab Cloud, o cliente pode baixar um novo CNAB interno da TOTVS, chamado de CNAB TCB.

Esta opção passa a ficar disponível na lista de tipos de arquivos disponíveis com seus respectivos status 

Aviso

Neste momento, a integração está disponível somente para o banco Citibank.

Caso tenha interesse na funcionalidade, entre em contato com seu gerente de relacionamento do Citibank que ele ajudará com a condução do processo.


  • Parâmetros de Bancos

Nesse cadastro, devemos ter uma configuração com as seguintes informações básicas da conta que será processada:

    • Cadastros
      • Extensão : RET
      • Nro. Bytes : 240
      • Tam. Ocorre. : 2
    • Retorno Automático
      • Ret.Automat? : Pagar
      • Dir.Imp.Pag. : Informar diretório para importação
      • Arq.Cfg.Pag. : TCBPRET.2PR 
      • Dir.Bkp.Bac. : Informar diretório para salvar arquivo processado
      • CNAB Pgto.? : Modelo 2


  • Ocorrências CNAB

Nesta tabela, validar se todos as possíveis ocorrências para o banco 745 (Citi) estão devidamente configuradas.

Atenção para a necessidade da ocorrência :

    • Ocorr Banco : 00
    • Tipo : P - Contas a Pagar
    • Ocorr Sist. : 06  


03

...

. WIZARD DE CONFIGURAÇÃO

Para cada filial do Protheus que irá se comunicar com o TCB, faz-se necessária a configuração da mesma.

A rotina deve ser chamada necessariamente do ambiente onde está em uso o agendamento do Protheus (schedule). 

De posse do CPF e senha cadastradas e liberadas pela equipe responsável pelo TCB, deve-se entrar na rotina Wizard TCB, no módulo Configurador. A rotina passará a funcionar pelo módulo configurador com a lib 20220613 e posteriores.

Neste processo, o sistema também valida a conexão do Protheus (desde o servidor) com o ambiente TCB (que está na nuvem). Caso a conexão não seja estabelecida com sucesso, deve-se avaliar a infraestrutura, que pode ser o motivo de restrição de acesso. O servidor Protheus terá que ter acesso à seguinte URL : https://uatprd-tcb.tfs.totvs.com/

No final do processo, o sistema também irá configurar 2 schedules agendamentos automaticamente no módulo Configurador, com intervalo de 10 minutos, podendo o intervalo ser alterado pelo cliente, conforme sua necessidade. Eles serão responsáveis por :

  • Rotina FINI230O : Verificar se existem retornos disponíveis no ambiente TCB para processamento. Caso existam, realiza a cópia para a pasta configurada no sistema, tornando-os disponíveis para processamento no Protheus
  • Rotina FINA435 : Processar de forma automática arquivos de retorno bancário   

Caso os agendamentos não sejam configurados automaticamente no final do wizard, ele pode ser realizado manualmente através de rotina específica no módulo Configurador.


...


04. PROCESSOS

Deck of Cards
effectDuration.5
idWizard
effectTypefade
Card
id1
labelPasso 1

Borderô de Pagamento

Na tela com as informações do borderô a ser montado, criou-se a opção Transmitir Borderô através do TOTVS Connect Bank.

Se o banco selecionado para este borderô estiver com o campo Habilita TCB = Sim, esta opção se torna habilitada.

Com esta nova opção selecionada (marcada), ao final do processo de geração do borderô, o sistema automaticamente se comunicará com o TCB e enviará o borderô para processamento no respectivo banco.

Card
labelPasso 2 (opcional)

Geração de Cnab - Arquivos de Pagamento

Caso o borderô de pagamento necessite de aprovação pela gerência da área, o usuário pode desabilitar manualmente a opção de transmissão através do TCB no momento da geração do borderô.

Então, após a aprovação manual do borderô, o usuário poderá utilizar a rotina Arquivos de Pagamento, para realizar a transmissão do borderô para o TCB. 

Para isso, o cadastro do banco/agência/conta utilizado neste momento deve estar com o campo Habilita TCB = Sim, e o arquivo de configuração da rotina deve possuir o nome do arquivo de configuração TOTVS TCB. Com esta configuração, o sistema em vez de gerar o arquivo CNAB, irá automaticamente enviar o conteúdo do borderô para o TCB.

Card
labelPasso 3

Retorno de CNAB

Após configuração do Wizard TCB, os 2 jobs responsáveis por copiar os arquivos do TCB para o Protheus e realizar o processamento de retorno, fará com que automaticamente os retornos sejam processados no Protheus.  

...


05. MONITOR INTEGRAÇÃO TCB

Através da rotina Monitor de Integração TCB, o usuário poderá monitorar todas os pacotes gerados no Protheus e seu respectivo status, bem como detalhes da integração com o TCB.

Image Removed


Image Added

Image Added

06. CNAB CLOUD

Nesta primeira versão do produto, para termos o menor impacto possível na operação dos usuários, precisaremos de um CNAB configurado para que o Protheus possa se comunicar com o TCB.

Para isso, através da ferramenta Wizard Cnab Cloud, o cliente pode baixar um novo CNAB interno da TOTVS, chamado de CNAB TCB, padrão 240 posições.

Esta opção passa a ficar disponível na lista de tipos de arquivos disponíveis com seus respectivos status 

...


07. CAMPOS UTILIZADOS

  • A6_TCB : Utiliza TCB. Novo campo do cadastro de bancos



...