Histórico da Página

O que é o Boleto Híbrido?

O boleto híbrido é uma forma solução de pagamento inovadora moderna e prática que combina a simplicidade e segurança o melhor de dois mundos: a confiabilidade do boleto registrado com e a agilidade do Pix. Essa solução permite que o consumidor escolha como deseja pagar sua compraCom ele, o cliente pode escolher como prefere pagar: utilizando o boleto bancário tradicional ou realizando o pagamento instantâneo via Pix, tudo em uma única experiência de pagamento.

Com o boleto híbrido, o consumidor tem flexibilidade e praticidade ao optar entre o pagamento via boleto registrado, que conta com todas as garantias e regulamentações bancárias, ou o pagamento rápido e seguro proporcionado pelo Pix. Ambas as modalidades são protegidas por mecanismos de segurança robustos, garantindo a tranquilidade nas transações.

um único documento e processo integrado.

Essa flexibilidade oferece uma experiência simples e eficiente, garantindo que o cliente tenha controle sobre sua escolha de pagamento, sem abrir mão da segurança. O boleto registrado segue todas as normas bancárias e oferece a opção de pagamento em prazo mais longo, enquanto o Pix possibilita a confirmação instantânea, ideal para quem precisa de agilidade.

Por que adotar o Boleto Híbrido?

Além de beneficiar o cliente, o boleto híbrido traz diversas vantagens para empresas. Uma delas é a integração direta com o banco, eliminando a necessidade de enviar ou processar arquivos de remessa e retorno. Todas as informações, como pagamentos realizados e atualizações, são automaticamente sincronizadas com o sistema por meio de processos agendados. Isso reduz erros, simplifica a gestão financeira e economiza tempoAlém disso, essa forma de pagamento reduz riscos de fraudes, uma vez que o boleto registrado segue as diretrizes estabelecidas pelo Banco Central, e o Pix, por sua vez, oferece proteção adicional com a autenticação instantânea das transações.

Vantagens do Boleto Híbrido:

Flexibilidade: O usuário pode optar entre pagar com boleto ou Pix, de acordo com sua preferência.
Segurança: Tanto o boleto registrado quanto o Pix oferecem níveis elevados de proteção contra fraudes.
Agilidade: O Pix permite a confirmação de pagamento imediata, enquanto o boleto oferece a opção de um prazo maior para quitação.
Praticidade: Todas as opções de pagamento estão reunidas em uma única interface, facilitando a experiência do usuário.

...

.

Contratação:

Deck of Cards

id	0

Card

label	Permissão

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:

Image Added

Card

id	1
label	Parâmetros de Configuração do Boleto Híbrido

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

1. Acessando os Parâmetros

No sistema, vá até 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.
Image Modified
Baixa: Informe os meios de pagamento que serão utilizados para realizar a baixa do boleto híbrido.
Image Modified

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.
Image Modified

2. Configurar Dados Adicionais

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

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.
  Image Modified
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.
  Image Modified

Vinculação de Chave PIX

Cada chave PIX pode estar vinculada a apenas um convênio.

Registro de Boletos Híbridos

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

Atualização Automática pelo Banco

Os seguintes campos são gerados pelo banco e atualizados automaticamente no boleto após a confirmação do registro:
- Nosso Número
- Linha Digitável
- Código de Barras
- QR Pix

Card

id	2
label	Regras

Card

id	3
label	Funcionalidades disponíveisDisponíveis

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.
Image Modified

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

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

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
  
  Image Modified
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.
  Image Modified

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).
Image Modified
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.
  Image Modified
Na visão de transações:
- Selecione a transação desejada.
- Acesse o menu Processos > Cancelar Registro de Boleto Híbrido.

Card

id	8
label	Bancos habilitadosHabilitados

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

Descrição	Itaú (341)	BB (001)	Santander (033)	Sicoob (756)	Bradesco (237)	Sicredi (748)
Valor Fixo	Sim	Sim	Não	Sim	Sim	Não
Percentual	Sim	Sim	Sim	Sim	Sim	Sim

Regras para Juros

Descrição	Itaú (341)	BB (001)	Santander (033)	Sicoob (756)	Bradesco (237)	Sicredi (748)
Valor por Dia Corrido	Sim	Sim	Não	Sim	Sim	Sim
Percentual por Dia Corrido	Sim	Sim	Não	Não	Sim	Sim
Percentual por Mês Corrido	Sim	Sim	Sim	Sim	Não	Não
Percentual por Ano Corrido	Não	Não	Não	Não	Não	Não
Valor por Dia Útil	Sim	Não	Não	Não	Não	Não
Percentual por Dia Útil	Sim	Não	Não	Não	Não	Não

Regras para Desconto

Descrição	Itaú (341)	BB (001)	Santander (033)	Sicoob (756)	Bradesco (237)	Sicredi (748)
Valor Fixo até o Vencimento	Sim	Sim	Sim	Sim	Sim	Sim
Percentual até o Vencimento	Sim	Sim	Não	Sim	Sim	Sim
Valor por Dia Corrido Antecipado	Não	Não	Não	Não	Não	Não
Valor por Dia Útil Antecipado	Não	Não	Não	Não	Não	Não
Percentual por Dia Corrido Antecipado	Não	Não	Não	Não	Não	Não
Percentual por Dia Útil Antecipado	Não	Não	Não	Não	Não	Não

Regras para Protesto

Descrição	Itaú (341)	BB (001)	Santander (033)	Sicoob (756)	Bradesco (237)	Sicredi (748)
Dias para Protesto	Sim	Sim	Sim	Sim	Sim	Sim

Card

label	API de Registro de Boleto Híbrido

Autenticação

Sim (Basic, Bearer Token)

Estrutura da Url

POST	http://{ambiente}/api/financial/v1/hybrid-bank-slip

Requisição

Campo	Descrição
PaymentChannel	Deve ser enviado Fixo "Web"
companyId	Código da Coligada do boleto
BankSlipId	Id do Boleto.

Bloco de código

theme	RDark

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

Resposta

200 - Success

Bloco de código

{
    "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

Bloco de código
{ "httpStatusCode": 400, "items": [ { "transactionCode": int, "amount": decimal, "message": string, "error": bool } ] }

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

O que é o Boleto Híbrido?

Por que adotar o Boleto Híbrido?

Vantagens do Boleto Híbrido:

Contratação:

1. Acessando os Parâmetros

2. Configuração dos Campos

Convênio

1. Ativar o Boleto Híbrido

2. Configurar Dados Adicionais

3. Configurações Adicionais

1. Transações

2. Registro Online

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

4. Cancelamento de Registro

Regras para Multa

Regras para Juros

Regras para Desconto

Regras para Protesto

Autenticação

Estrutura da Url

Requisição

Resposta

200 - Success

400 - Bad Request