Emissão de Boleto Híbrido

Uma das principais funcionalidades do nosso produto é o processo de emissão.

A geração do código de barras e a geração do QR CODE serão realizadas por meio da criação offline via sistemas do boleto híbrido. Deverão ser enviadas por meio dos contratos estabelecidos no sistema de boleto híbrido, as seguintes informações:

  • O código de barras gerado que será transmitido ao sistema de cobrança para registro;
  • O QR CODE gerado que será transmitido ao sistema de Pix para registro;
  • O produto em mãos dos nossos clientes será: Código de barras/linha digitável offline (com processo de registro de maneira assíncrona) e QR CODE atrelado ao boleto.

Por meio de uma seleção, nossos clientes escolhem a chave Pix cadastrada em sua conta transacional no Banco BS2.

Solicitamos os campos:

CampoDescriçãoFormatoObrigatório
chaveChave Pix utilizada para identificar a cobrançaTextoNão
seuNumeroIdentificador único da cobrança fornecido pelo clienteTextoSim
dataVencimentoData em que a cobrança deve ser pagaAAAA-MM-DDSim
dataLimitePosVencimentoData limite para pagamento após o vencimentoAAAA-MM-DDSim
valorValor total da cobrançaNumérico com até 2 casas decimaisSim
multa.tipoValor da multa aplicada após o vencimentoTexto (ValorFixo ou ValorPercentual)Não
multa.valorValor da multa aplicada após o vencimentoNumérico com até 2 casas decimaisNão
juros.tipoTipo de juros aplicados após o vencimentoTexto (FixoPorDiaCorrido, PercentualAoDiaCorrido, PercentualAoMesCorrido)Não
juros.valorValor dos juros aplicados após o vencimentoNumérico com até 2 casas decimaisNão
valorDescontoPercentualPercentual de desconto aplicado sobre o valor total da cobrançaNumérico com até 2 casas decimaisNão
valorDescontoFixoValor fixo de desconto aplicado sobre o valor total da cobrançaNumérico com até 2 casas decimaisNão
dataLimiteDescontoData limite para aplicação do desconto sobre a cobrançaAAAA-MM-DDNão
solicitacaoPagadorInformações adicionais ou instruções do pagadorTextoNão
Linha1Informação adicional para o boleto (linha 1)TextoNão
Linha2Informação adicional para o boleto (linha 2)TextoNão
Linha3Informação adicional para o boleto (linha 3)TextoNão
Linha4Informação adicional para o boleto (linha 4)TextoNão
Dados Pagador
documentoDocumento de identificação do pagador (CPF ou CNPJ)TextoSim
tipoDocumentoTipo de documento de identificação do pagador (CPF ou CNPJ)TextoSim
nomeNome completo do pagadorTextoSim
telefoneNúmero de telefone do pagadorTextoNão
emailEndereço de e-mail do pagadorTextoNão
bairroBairro de residência do pagadorTextoNão
logradouroLogradouro de residência do pagadorTextoNão
numeroNúmero do endereço do pagadorTextoNão
complementoComplemento do endereço do pagadorTextoNão
estadoEstado de residência do pagador (UF)TextoNão
cidadeCidade de residência do pagadorTextoNão
cepCódigo postal (CEP) do endereço do pagadorTextoNão

Exemplo de resposta:

CampoDescriçãoStatusFormato
BoletoHibridoIDIdentificador do boleto híbrido solicitado para efeitos de acompanhamentoCriadoGUID

Registra uma nova solicitação para geração de boleto híbrido.

Regras Gerais

  • O Banco BS2 realiza a validação de existência da chave Pix. Chaves inativas não serão listadas para seleção;
  • Durante o processo de seleção da chave cadastrada, será validada a existência de processos de portabilidade (eventos realizados pelo mesmo titular para as chaves CNPJ/CPF/e-mail/celular) ou Reivindicação de posse (eventos realizados entre titularidades diferentes; aplica-se para celular/e-mail);
  • Em caso de inexistência de chave Pix cadastrada para a conta transacional do nosso cliente, o Banco BS2 realizará o cadastramento do tipo chave aleatória (EVP) e prosseguirá com a solicitação do boleto híbrido;
  • Caso nosso cliente possua chaves cadastradas em sua conta transacional e não as selecione no processo de solicitação de emissão do boleto híbrido, nossos sistemas escolherão automaticamente uma chave disponível entre as pré-cadastradas, seguindo a precedência: CNPJ > Celular > E-mail > Chave Aleatória;
  • Deve-se considerar que o limite de chaves possíveis para cadastro em uma conta transacional é de 20 chaves por conta. Após a criação automática da primeira chave aleatória, esta será utilizada nas próximas emissões, caso não seja selecionado outro tipo de chave pré-cadastrada (chaves do tipo aleatória não participam dos processos de portabilidade ou reivindicação de posse);
  • Importante destacar que, caso ocorra a exclusão da chave Pix por meio de ação do nosso cliente em sua conta transacional, a emissão de novos boletos híbridos deverá ocorrer para a nova chave cadastrada ou por meio do processo automático de criação de nova chave aleatória.