Á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.

Sobre a conta Cosmos do Citibank


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.

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.  

...

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 RemovedImage 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.

...