Skip to main content

Recuperação de Boleto e Segunda via

Lista de Boletos​

Request​

ENDPOINT
/bankslip_collection/fund_class/FUND_CLASS_KEY/bankslip_profile/BANKSLIP_PROFILE_KEY/bankslip/BANKSLIP_KEY
MÉTODO
GET

Response​

Response Body
Response Body
{
        
    "bankslip_key": "c9eb109c-800f-4cf5-b209-2119c9d77a72",
    "external_participant_control_number": "801KFZFNB4UZ34MLGJG2X9WNG",
    "asset_type": "duplicata_mercantil",
    "bankslip_configuration": {
        "bankslip_configuration_key": "1b382eb7-7006-4389-975b-afa76b0ad7b4",
        "bankslip_profile": {
            "bankslip_profile_key": "5910d4a3-f5df-432a-902f-849a1a77cd86",
            "bankslip_profile_code": "329-09-0001-4993010",
            "bankslip_profile_number": 1,
            "bankslip_provider": "qi_scd",
            "additional_information": {
                "external_beneficiary_key": "2666e7a3-0bd7-46fc-8f6b-725f2ef9b13f"
            },
            "internal_account_key": "6b5335ed-1380-4348-9520-8998ca6e388b",
            "fund_class": {
                "fund_class_key": "7f03069e-1854-4cee-8e59-a6a548976015",
                "document_number": "51.620.927/0001-65",
                "name": "Sample_Name",
                "manager": {
                    "name": "Sample name",
                    "manager_key": "5cb734e9-c33b-4e7e-bb40-f894aa82b153",
                    "document_number": "51.620.927/0001-65"
                }
            }
        }
    },
    "due_date": "2026-04-21",
    "face_value": 629.33,
    "status": "pending_registration",
    "participant_control_number": "801KFZFNB4UZ34MLGJG2X9WNG",
    "borrower": {
        "document_number": "755.510.684-12",
        "name": "Tomador",
        "person_type": "legal_person",
        "address": {
            "postal_code": "05425-020"
        }
    },
    "assignor": {
        "name": "Assignor LTDA",
        "document_number": "37.341.966/0001-00",
        "person_type": "legal_person"
    },
    "occurrences": [
        {
            "occurrence_key": "e9898e50-cd2b-492f-9201-7e5c5f231853",
            "status": "pending_submission",
            "type": "registration",
            "occurrence_data": null
        }
    ],
    "settlement_instructions": [
        {
            "settlement_instruction_key": "fe419363-bf04-4b3a-90bd-185618baa720",
            "status": "pending_bankslip_payment",
            "asset_type": "duplicata_mercantil",
            "asset_key": "22fc5c95-3622-48ad-b26a-99f8d0499e69",
            "external_id": "758638e4-6fe6-4b69-8799-30728ca16a22",
            "issue_date": "2025-01-17",
            "maturity_date": "2026-09-17",
            "face_value": 629.33,
            "order_number": "49761-1"
        }
    ],
    "bankslip_url": "https://bankslip-proxys-bucket-production.s3.amazonaws.com/"

        
}

Bankslip​

CampoTipoDescrição
bankslip_keystringIdentificador único do boleto.
external_participant_control_numberstringNúmero de controle externo do participante.
asset_typestringTipo de ativo atrelado.
due_datedateData de vencimento do boleto.
face_valuenumberValor nominal do boleto.
statusstringStatus atual do boleto.
participant_control_numberstringNúmero de controle interno do participante.
bankslip_configurationobjectObjeto que contém a configuração do boleto (ver abaixo).
borrowerobjectObjeto que representa o tomador (sacado).
assignorobjectObjeto que representa o cedente do recebível.
occurrencesarrayLista de ocorrências relacionadas ao boleto (cada item é um objeto).
settlement_instructionsarrayLista de instruções de liquidação relacionadas ao boleto.
bankslip_urlarrayLink para recuperação de segunda via.

Bankslip Configuration​

CampoTipoDescrição
bankslip_configuration_keystringChave de configuração do boleto.
bankslip_profileobjectPerfil de boleto associado.

Bankslip Profile​

CampoTipoDescrição
bankslip_profile_keystringIdentificador do perfil de boleto.
bankslip_profile_codestringCódigo do perfil.
bankslip_profile_numbernumberNúmero do perfil.
bankslip_providerstringProvedor do boleto.
additional_informationobjectInformações adicionais (ver abaixo).
internal_account_keystringIdentificador da conta interna associada.
fund_classobjectObjeto representando o fundo de investimento (ver abaixo).

Fund Class​

CampoTipoDescriçãoCaracteres
namestringNome da classe de fundoaté 255
fund_class_keystringChave única de identificação da classe de fundo36
document_numberstringCNPJ da classe de fundo-

Borrower​

CampoTipoDescrição
namestringNome do tomador.
document_numberstringDocumento (CPF/CNPJ).
person_typestringTipo de pessoa.
addressobjectEndereço do tomador (ver abaixo).

Address​

CampoTipoDescrição
streetstringLogradouro do endereço.
numberstringNúmero do endereço.
neighborhoodstringBairro.
citystringCidade.
postal_codestringCEP.
ufstringUnidade federativa (sigla do estado).
countrystringPaís no formato ISO Alpha-3.

Assignor (Cedente)​

CampoTipoDescrição
namestringNome do cedente.
document_numberstringDocumento (CNPJ).
person_typestringTipo de pessoa.

Occurrences​

Cada item do array é um objeto com os seguintes campos:

CampoTipoDescrição
occurrence_keystringIdentificador da ocorrência.
statusstringStatus da ocorrência.
typestringTipo da ocorrência.
occurrence_dataobjectDados adicionais da ocorrência.

Settlement Instructions​

Cada item do array é um objeto com os seguintes campos:

CampoTipoDescrição
settlement_instruction_keystringIdentificador da instrução de liquidação.
statusstringStatus da instrução de liquidação.
asset_typestringTipo do ativo.
asset_keystringChave única do ativo no sistema.
external_idstringIdentifica externo do cliente (utilizado na cessão).
issue_datedateData de emissão.
maturity_datedateData de vencimento.
face_valuenumberValor de face do ativo.
order_numberstringNúmero do contrato.
installment_numbernumberNúmero da parcela do ativo.