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
Seu NúmeroIdentificação do cliente para a cobrançaTextoSim
Data de VencimentoData em que a cobrança deve ser pagaAAAA-MM-DDSim
Data Limite Pós-vencimentoData limite para pagamento após o vencimentoAAAA-MM-DDSim
ValorValor total da cobrançaNumérico com até 2 casas decimaisSim
MultaDetalhes sobre a multa, se houverTextoNão
TipoTipo da multa, conforme tabela Tipo de MultaTextoNão
ValorValor da multaNumérico com até 2 casas decimaisNão
JurosDetalhes sobre os juros, se houverTextoNão
TipoTipo de juros, conforme tabela Tipo de JurosTextoNão
ValorValor dos jurosNumérico com até 2 casas decimaisNão
Valor Desconto PercentualPercentual de desconto aplicado sobre o valorNumérico com até 2 casas decimaisNão
Valor Desconto FixoValor fixo de desconto aplicado sobre o valorNumérico com até 2 casas decimaisNão
Data Limite DescontoData limite para aplicação do descontoAAAA-MM-DDNão
Solicitação PagadorDescrição livre da solicitação do pagadorTextoNão
Linha 1Informação adicional - Linha 1TextoNão
Linha 2Informação adicional - Linha 2TextoNão
Linha 3Informação adicional - Linha 3TextoNão
Linha 4Informação adicional - Linha 4TextoNão
DocumentoDocumento de identificação do pagadorNúmeroSim
Tipo de DocumentoTipo de documento de identificação do pagadorTextoSim
NomeNome completo do pagadorTextoSim
Cliente IDIdentificação do cliente no sistemaTextoNão
TelefoneNúmero de telefone do pagadorTextoNão
E-mailEndereço de e-mail do pagadorTextoNão
BairroBairro do pagadorTextoNão
LogradouroLogradouro do pagadorTextoNão
NúmeroNúmero do endereço do pagadorTextoNão
ComplementoComplemento do endereço do pagadorTextoNão
EstadoEstado do pagadorTextoNão
CidadeCidade do pagadorTextoNão
CEPCEP do pagadorTextoNão

Em caso de sucesso retornaremos o código HTTP 201.

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.