get_normative_txt: Download normative texts from the Brazilian Central Bank...

In bacenR: Access Data from Brazilian Central Bank: IFdata, Active Institutions, Balance Sheets and Normative Acts

Download normative texts from the Brazilian Central Bank (Bacen) from a reference data.frame

Description

For each row of the input data.frame, constructs the appropriate URL for the Bacen normatives API, performs the request, extracts the returned content and applies basic cleaning to the text fields (Assunto and Texto). Returns a data.frame with all aggregated contents.

Usage

get_normative_txt(normative_data)

Arguments

normative_data

data.frame. A data.frame with at least the columns: TipodoNormativoOWSCHCS: type of the normative (e.g., "Comunicado", "Ato de Diretor", etc.) NumeroOWSNMBR: number/identifier of the normative to be queried. Typically the result of a prior query (e.g., via get_normative_data).

Details

The function performs the following steps:

1. Iterates over each row of normative_data (prints the iteration index for monitoring).

2. Encodes the normative type for URL usage (using URLencode(..., reserved = TRUE)).

3. Chooses the API route depending on the type:

   • for "Comunicado", "Ato de Diretor" and "Ato do Presidente" it uses the other-norms endpoint (exibeoutrasnormas);

   • for the rest, it uses the standard normative endpoint (exibenormativo).

4. Makes the HTTP request (via httr::GET) and converts the returned JSON into a data.frame.

5. Extracts and cleans textual fields:

   • converts HTML to plain text for the fields Assunto and Texto (using xml2::read_html + xml2::xml_text),

   • removes line breaks and extra spaces (stringr::str_replace_all, stringr::str_squish).

6. Aggregates each result into a final data.frame returned by the function.

Value

data.frame with the records returned by the API for each reference in normative_data, including the extracted and post-processed fields (e.g., Assunto, Texto).

Note

• The function assumes the BCB API returns a conteudo field with the expected fields.

• Request errors or changes in the API structure may cause failures; consider handling exceptions around the call if needed.

• Packages used internally: httr, jsonlite, xml2, stringr, dplyr, glue, purrr.

Examples

# First, download normative data
normative_data <- get_normative_data(
   "Cooperativa",
    "2023-08-01",
    "2023-08-10")
# Then, download the full texts for the retrieved normatives
normative_txt <- get_normative_txt(normative_data)

bacenR documentation built on Oct. 24, 2026, 1:07 a.m.