O boleto híbrido é uma combinação entre boleto e PIX referente a mesma cobrança, em outra palavras, é possível fornecer aos clientes um tipo de cobrança que pode ser quitada através do código de barras de um boleto ou via QRCode do PIX.
Vale ressaltar que para realizar a utilização do boleto híbrido conforme a listagem dos bancos disponíveis abaixo, é necessário possuir o Web Service ativo.
Bancos disponíveis
Banco |
Boleto Híbrido |
Impressão com QRCode |
Banco do Brasil (001) |
✔️(v2) |
✔️ |
Caixa Econômica Federal (104) |
✔️(*) |
✔️ |
Itaú (341) |
✔️(v2) |
✔️ |
Sicoob (756) |
✔️ |
✔️ |
Sicredi (748) |
✔️(v3) |
✔️ |
Santander (033) |
✔️(v2) |
✔️ |
* As funcionalidades foram recentemente criadas e testadas, seguindo a documentação que está sujeita a alterações no início do uso direto com o banco.
Para utilização desse recurso basta seguir as instruções seguintes.
Emitindo o boleto híbrido VIA API
POST
Produção:
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/json |
cnpj-sh | CNPJ da Software House | 01001001000113 |
token-sh | Token da Software House | f22b97c0c9a3d41ac0a3875aba69e5aa |
cnpj-cedente | CNPJ do Cedente | 01001001000113 |
Body
No body você poderá utilizar os campos de inclusão de um boleto de acordo com a documentação: campos utilizados para inclusão de um boleto e, acrescentar o campo "hibrido": true no JSON de emissão:
{
...
...
"TituloNossoNumero":"123",
"TituloValor":"100,00",
"hibrido": true
}
Resposta
Sucesso:
{ "_status": "sucesso", "_dados": { "idintegracao": "ABCDEFGH", "situacao": "SALVO", "TituloNumeroDocumento": "0000000123", "TituloNossoNumero": "123", "CedenteContaCodigoBanco": "001", "CedenteContaNumero": "1234", "CedenteConvenioNumero": "1234", "TituloCodigoReferencia": null } }
Consultando o boleto híbrido
GET
Produção:
Resposta
A resposta será composta por diversos campos de acordo com a documentação: consultando um boleto. Contudo serão acrescidos os campos referentes ao boleto híbrido de acordo com o exemplo abaixo.
Sucesso:
{ "hibrido": true, "UrlPix": "http://plugboleto.com.br/api/v1/boletos/impressao/HRKCVJXVV/pix", }
Impressão do boleto híbrido
Para saber mais sobre os tipos de impressão, acesse a documentação referente aos exemplos de impressão.
Exemplo de boleto híbrido:
Referência:
Link 02: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360022352434-Consultando-um-Boleto
Link 03: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360015834554-Exemplos-de-impress%C3%A3o
Emitindo o boleto híbrido VIA OCX
POST
Produção:
TspdBoletox.Incluir(WideString)
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/json |
cnpj-sh | CNPJ da Software House | 01001001000113 |
token-sh | Token da Software House | f22b97c0c9a3d41ac0a3875aba69e5aa |
cnpj-cedente | CNPJ do Cedente | 01001001000113 |
Body
No body você poderá utilizar os campos de inclusão de um boleto de acordo com a documentação: campos utilizados para inclusão de um boleto e, acrescentar o campo HIBRIDO=TRUE no TXT de emissão:
{
...
...
TituloNossoNumero=2469
TituloNumeroDocumento=00015
TituloDataVencimento=29/01/2019
TituloDataEmissao=14/01/2019
HIBRIDO=TRUE
}
Resposta
Sucesso:
.:: Incluir Boleto ::.
Mensagem: Boleto(s) processado(s) com sucesso.
Status: SUCESSO
Item: 1
IdIntegracao: H1F1EW-fX
Situacao: SALVO
NossoNumero: 1482 341
Banco: 341 12345
Conta: 12345
Convenio: 1234123456
Erro: 'boleto': Boleto com Nosso Número 1483 já existe para este convênio.
ErroClasse: VALIDACAO
Consultando o boleto híbrido
GET
Produção:
TspdBoletoX.Consultar(WideString)
Resposta
A resposta será composta por diversos campos de acordo com a documentação: Consultando o boleto. Contudo serão acrescidos os campos referentes ao boleto híbrido de acordo com o exemplo abaixo.
Sucesso:
{ HIBRIDO=TRUE, URLPI=http://plugboleto.com.br/api/v1/boletos/impressao/HRKCVJXVV/pix", }
Impressão do boleto híbrido
Para saber mais sobre os tipos de impressão, acesse a documentação referente aos exemplos de impressão.
Exemplo de boleto híbrido:
Comentários
1 comentário
quando sai boleto hibrido para outros bancos , pelo menos os mais comuns como itau e bradesco ?
Por favor, entre para comentar.