Este método é usado para buscar bolepix gerados para pagamento.
Seguem as URLs e ambientes disponíveis:
- Produção: https://api2.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/[accountNumber]
- Homologação: https://hmlapi2.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/[accountNumber]
Request #
Exemplo de busca dos boletos pelo número da conta
curl 'https://hmlapi2.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/10023551?pageNumber=1&pageSize=50' \
--location \
--request GET \
--header 'accept: */*' \
--header 'client_id: 999abf99-999f-9999-b9ff-9a9999ce9a99' \
--header 'access_token: 9c9999d9-d99c-999f-9999-b9fd9a99bf99'
Exemplo de busca do boleto através do seu número
curl 'https://hmlapi2.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/10023551?yourNumber=4654965&pageNumber=1&pageSize=50' \
--location \
--request GET \
--header 'accept: */*' \
--header 'client_id: 999abf99-999f-9999-b9ff-9a9999ce9a99' \
--header 'access_token: 9c9999d9-d99c-999f-9999-b9fd9a99bf99'
Exemplo de busca dos boletos pela data de criação
curl 'https://hmlapi2.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/10023551?creationDate=2022-07-11&pageNumber=1&pageSize=50' \
--location \
--request GET \
--header 'accept: */*' \
--header 'client_id: 999abf99-999f-9999-b9ff-9a9999ce9a99' \
--header 'access_token: 9c9999d9-d99c-999f-9999-b9fd9a99bf99'
Exemplo de busca dos boletos pela data de vencimento
curl 'https://hmlapi2.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/10023551?dueDate=2022-08-25&pageNumber=1&pageSize=50' \
--location \
--request GET \
--header 'accept: */*' \
--header 'client_id: 999abf99-999f-9999-b9ff-9a9999ce9a99' \
--header 'access_token: 9c9999d9-d99c-999f-9999-b9fd9a99bf99'
Estrutura do request #
Header
- access_token: Token recebido do método oAuth (API Gateway);
- client_id: ID de cliente recebido do Banco Semear no momento do cadastro.
Parâmetros GET
Propriedade | Descrição | Tipo | Obrigatoriedade |
---|---|---|---|
accountNumber | Número da conta | int32 | Obrigatório |
originTransaction | Consulta realizada para o Bolepix (3 – Bolepix) | int32 | Obrigatório |
yourNumber | Seu número. Informado na geração do boleto | int32 | Opcional |
creationDate | Retorna todos os boletos criados a partir da data. Formato: YYYY-MM-DD | DateTime | Opcional |
endCreationDate | Retorna todos os boletos criados até a data. Formato: YYYY-MM-DD | DateTime | Opcional |
dueDate | Retorna todos os boletos vencidos a partir da data. Formato: YYYY-MM-DD | DateTime | Opcional |
endDueDate | Retorna todos os boletos vencidos até a data. Formato: YYYY-MM-DD | DateTime | Opcional |
status | Consulta os boletos pelo status. Formato: inteiro (1 – Em Aberto, 2- Em Cartório, 3 – Pago, 4 – Pago, 5 – Baixado, 6 – Protestado, 7- Vencido) | int32 | Opcional |
pageNumber | Número da página do response (Default: 1) | int32 | Opcional |
pageSize | Número de elementos no response (Default: 50) | int32 | Opcional |
Response #
{
"meta": {
"totalPages": 1,
"totalRegisters": 37
},
"data": [
{
"type": "partners",
"id": 40842,
"attributes": {
"id": 119339,
"cnpj": "2890111100132",
"assignorName": "PaaS",
"payerName": "Nome PaaS Bolepix",
"payerDocument": "85027978081",
"payerPhone": "",
"payerEmail": "",
"payerAddress": {
"publicPlace": null,
"number": null,
"complement": null,
"neighborhood": null,
"city": null,
"state": null,
"zipCode": null
},
"creationDate": "2024-06-27T16:24:21",
"ourNumber": "00000040842",
"yourNumber": "4454612",
"value": 34.90,
"liquidValue": 0.00,
"dueDate": "2024-06-30T00:00:00",
"operationDate": null,
"accountNumber": 110379871,
"digitableLine": "74390001131200000710900000408427197630000003490",
"barcode": "74391976300000034900001112000007100000040842",
"description": "PaaS bolepix <br>\nTAXA DE PERMANÊNCIA DE 5.93% AO DIA <br>\nAPÓS 01/07/2024 COBRAR MULTA DE 3.89%<br>\nATUALIZAÇÃO DE BOLETO VENCIDO E 2ª VIA, ACESSE BANCOSEMEAR.COM.BR <br>\nSAC 0800 702 6700 - OUVIDORIA 0800 942 7600 <br>\nPAGAR PREFERENCIALMENTE EM AGENCIAS BANCARIAS OU CASAS LÓTERICAS <br>\nVERIFIQUE OS DADOS DO REMETENTE E DO BENEFICIARIO ANTES DO PAGTO <br>\nEM CASO DE DÚVIDAS, ACIONE OS CANAIS OFICIAIS DO BANCO SEMEAR <br>",
"status": "Em Aberto",
"type": 2,
"pdf": "https://awshmllbgw.bancosemear.com.br/digital-account-billet/api/v1/paas-billets/accounts/110379871/numbers/00000040842/downloads",
"paymentLink": "https://hml-semearpay.bancosemear.com.br/pay/boleto/2mK0a6bd_cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxABfFY2t6M9Y_lxJFg==",
"originTransaction": 0,
"fineCod": 2,
"fineDate": "2024-07-01T00:00:00",
"fine": 3.89,
"interestCod": 2,
"interestDate": "2024-07-02T00:00:00",
"interest": 5.93,
"discountCod": 2,
"discountDate1": "2024-06-27T00:00:00",
"discount1": 20.00,
"discountDate2": "2024-06-28T00:00:00",
"discount2": 15.00,
"discountDate3": "2024-06-29T00:00:00",
"discount3": 30.00
}
},
Estrutura do body (Response) #
Propriedade | Descrição | Tipo |
---|---|---|
data.type | Tipo | String |
data.id | Número do bolepix | int32 |
data.attributes.id | Id interno Semear | String |
data.attributes.cnpj | CNPJ do cedente | String |
data.attributes.assignorName | Nome do cedente | String |
data.attributes.creationDate | Data de criação do bolepix | DateTime |
data.attributes.ourNumber | Número do nosso bolepix | String |
data.attributes.yourNumber | Seu número (Número informado na request) | String |
data.attributes.payerName | Nome do pagador | String |
data.attributes.payerDocument | Documento do pagador | String |
data.attributes.payerPhone | Telefone do pagador | String |
data.attributes.payerEmail | Email do pagador | String |
data.attributes.payerAddress.publicPlace | Rua do pagador | String |
data.attributes.payerAddress.number | Numero da residencia do pagador | String |
data.attributes.payerAddress.complement | Complemento do endereco do pagador | String |
data.attributes.payerAddress.neighborhood | Bairro do pagador | String |
data.attributes.payerAddress.city | Cidade do pagador | String |
data.attributes.payerAddress.state | Estado do pagador | String |
data.attributes.payerAddress.zipCode | CEP do pagador | String |
data.attributes.value | Valor do bolepix | decimal |
data.attributes.liquidValue | Valor liquido pago do bolepix | decimal |
data.attributes.dueDate | Data de vencimento do bolepix | DateTime |
data.attributes.accountNumber | Número da conta do cedente | String |
data.attributes.digitableLine | Linha digitável do bolepix | String |
data.attributes.barCode | Código de barras do bolepix | String |
data.attributes.description | Descrição | String |
data.attributes.status | Status do bolepix | String |
data.attributes.type | Tipo do bolepix | String |
data.attributes.pdf | URL de download do bolepix | String |
data.attributes.paymentLink | Link de pagamento | String |
data.attributes.txid | Identificador gerado ao cadastrar novo bolepix. | String |
data.attributes.qrCode | QrCode gerado quando PIX foi cadastrado com sucesso no bolepix. | String |
data.attributes.copyAndPast | Copia e cola gerado ao cadastrar novo pix via bolepix. | String |
data.attributes.titleSituationPix | Codigo referente ao estado do pix gerado(1 = em processamento, 2 = sucesso, 3 = falha) | String |
data.attributes.originTransaction | Determina a origem da transação (3 = BOLEPIX) | int32 |
data.attributes.fineCod | Código de multa do título | int32 |
data.attributes.fineDate | Data da multa aplicada ao título | DateTime |
data.attributes.fine | Valor/taxa de multa do título | decimal |
data.attributes.interestCod | Código de mora/juros do título | int32 |
data.attributes.interestDate | Data da mora/juros do título | DateTime |
data.attributes.interest | Valor/taxa de mora/juros aplicado ao título | decimal |
data.attributes.discountCod | Código de desconto do título | int32 |
data.attributes.discountDate1 | Data do Primeiro desconto aplicado ao título | DateTime |
data.attributes.discount1 | Valor/taxa do primeiro desconto aplicado ao título | decimal |
data.attributes.discountDate2 | Data do segundo desconto aplicado ao título | DateTime |
data.attributes.discount2 | Valor/taxa do segundo desconto aplicado ao título | decimal |
data.attributes.discountDate3 | Data do terceiro desconto aplicado ao título | DateTime |
data.attributes.discount3 | Valor/taxa do terceiro desconto aplicado ao título | decimal |