No cadastro do Perfil do usuário, é necessário conceder as permissões relacionadas ao Boleto Híbrido conforme a necessidade de cada operador. Na imagem a seguir demonstramos as permissões disponíveis:

Para configurar o boleto híbrido, siga as etapas abaixo:

1. Acessando os Parâmetros

No TOTVS Gestão Financeira, acesse o menu Ambiente > Parâmetros > TOTVS Gestão Financeira > Contas a Receber > Boleto Híbrido.

2. Configuração dos Campos

• Credenciais: Insira as credenciais de acesso ao RAC.
  
• Baixa: Informe os meios de pagamento que serão utilizados para realizar a baixa do boleto híbrido.
  

Observação:
A parametrização pode ser feita no nível Coligada ou Filial. Caso seja configurado para a Filial, essa configuração terá prioridade sobre a da Coligada.
Preencha todos os campos obrigatórios (Credenciais e Baixa) para garantir o correto funcionamento.

Convênio

1. Ativar o Boleto Híbrido

• Acesse a aba Boleto Híbrido e habilite a opção "Permite registro de boleto híbrido".
• Informe a chave PIX fornecida pelo banco.
• Cada chave PIX pode estar vinculada a apenas um convênio.
  

2. Configurar Dados Adicionais

• Vá até a aba Dados Adicionais e, no campo "Valor código de barras", selecione a opção Original.
  

3. Configurações Adicionais

No menu Anexos do cadastro do convênio, é possível acessar as Configurações adicionais do boleto híbrido para personalizar os seguintes itens:

• Juros, multa, desconto e protesto:

  • Modalidade: As opções variam de acordo com as definições do banco, podendo apresentar modalidades diferentes para cada instituição.
  • Valor: Pode ser configurado como uma fórmula ou valor fixo.
    

• Outras Configurações:

  • Dias adicionais de validade após o vencimento: Permite definir um número de dias adicionais para pagamento após o vencimento. Exemplo: se configurado como 1, será possível pagar o boleto até 1 dia após o vencimento.
  • Mensagem personalizada: Insira uma mensagem que será enviada ao cliente.
    

1. Transações

A visão de transações exibe as transações existentes para boletos híbridos. Para acessá-la:

• Navegue até Contas a Pagar/Receber e clique no menu Boleto Híbrido.
• Selecione a opção Transação.
  

Na visão de transações, você encontrará:

• Anexos:  Utilizar o menu Anexos para executar opções como
  
  • Histórico de Transações
  • Boleto
    
    
    
• Processos: Utilize o menu Processos para executar ações, como:
  • Ajuste de Transação
  • Cancelar Registro de Boleto Híbrido
    
    

2. Registro Online

Registre o boleto híbrido diretamente na instituição bancária. É necessário que o boleto já esteja cadastrado no sistema.
O registro pode ser realizado de três formas:

• No momento da inclusão do boleto:

  • Ao incluir um boleto do tipo "Cobrança", marque a opção Registrar Online o boleto híbrido.
  • Caso o registro falhe, o boleto será incluído normalmente, mas o registro deverá ser tentado novamente pela visão de boletos ou via API.

  • Os campos Nosso Número, Linha Digital, Código de Barras e QRCode Pix, são gerados pelo banco e atualizados automaticamente no boleto após a confirmação do registro
    
    
    
    

• Na visão de boletos:

  • Selecione um boleto em aberto que ainda não esteja registrado.
  • Acesse o menu Processos > Boleto Híbrido > Registrar Boleto Híbrido.
    

Observação:
Quando o registro é realizado, o sistema cria uma transação para o boleto híbrido, garantindo que todas as atualizações sejam refletidas corretamente.

Status de Registro:

• Falha no Pagamento: Ocorreu um problema no registro.
• Pagamento Solicitado: Registro executado com sucesso; o boleto foi atualizado.
  
  

Observação:
Se o boleto estiver com o status "Remessa Registrado Boleto Híbrido", um novo registro não será permitido.
Para registrar novamente, primeiro é necessário cancelar o registro atual.

3. Atualização Online do Boleto Híbrido

O status das transações de boletos híbridos é atualizado pelo processo Ajuste de Transação, que pode ser:

• Agendado (recomendado realizar um único agendamento diário para todas as atualizações).
  
• Executado manualmente na visão de transações de boletos híbridos.
  

Status possíveis após a atualização:

• Pagamento Confirmado: O pagamento foi confirmado junto à instituição bancária, e o boleto está apto para baixa.
• Pagamento Concluído: O processo de baixa foi realizado com sucesso.
• Pagamento Expirado: O registro expirou junto à instituição bancária.
• Pagamento Cancelado: O registro foi cancelado pela instituição bancária.

4. Cancelamento de Registro

O cancelamento de registro tenta desfazer transações com o status Pagamento Solicitado diretamente na instituição bancária. Atenção: As regras de cancelamento podem variar de acordo com a instituição.

Formas de realizar o cancelamento:

• Na visão de boletos:

  • Selecione o boleto desejado.
  • Acesse o menu Processos > Boleto Híbrido > Cancelar Registro de Boleto Híbrido.
    

• Na visão de transações:

  • Selecione a transação desejada.
  • Acesse o menu Processos > Cancelar Registro de Boleto Híbrido.
    

Bancos habilitados: Itaú, Banco do Brasil, Santander, Sicoob, Bradesco e Sicredi. Cada banco possui suas próprias exigências e particularidades para parâmetros como Multa, Juros, Desconto e Protesto.

As regras descritas não são uma definição do nosso sistema, mas sim os padrões determinados pelas instituições financeiras. É fundamental seguir essas diretrizes para garantir o sucesso no registro de boletos híbridos.

Para facilitar a consulta, as informações estão organizadas por modalidade, destacando quais opções são suportadas por cada banco.

Regras para Multa

Regras para Juros

Regras para Desconto

Regras para Protesto

Autenticação

Sim (Basic, Bearer Token)

Estrutura da Url

Requisição

{
    "PaymentChannel": "Web",
    "items": [
        {
            "companyId": 1,
            "BankSlipId": 7537
        }
    ]
}

Resposta

200 - Success

{
    "httpStatusCode": 200,
    "items": [
        {
            "qrCode": string,
            "qrCodeText": string,
            "transactionCode": int,
            "bankSlipNumber": string,
            "digitableLine": string,
            "barcode": string,
            "amount": decimal,
            "message": string,
            "expiresAt": string,
            "error": bool
        }
    ]
}

400 - Bad Request

{
    "httpStatusCode": 400,
    "items": [
        {
            "transactionCode": int,
            "amount": decimal,
            "message": string,
            "error": bool
        }
    ]
}