Skip to content

cvmdata 0.3.0

Choose a tag to compare

@SidneyBissoli SidneyBissoli released this 16 Nov 01:00
70a83a0

The version submitted to rOpenSci.

One function, cvm_fetch(), reads the nine datasets of the CVM group of listed companies (104 tables): the company register, annual and quarterly financial statements, the reference form, the registration form, the corporate governance code report, insider trading positions, share buyback programmes and the index of periodic filings. cvm_versions() returns every version of a filing, with the superseded ones recovered from the CVM filing archive.

What changed since 0.2.0, in short:

  • One fetch function. cvm_fetch() replaces the per-group fetchers; companies are selected by CNPJ or B3 ticker, periods by year or by a window of reference dates; basis, reading and as_of choose the statement basis, the original or restated figures of an exercise, and the registrations in force on a date.
  • Filing versions. The current filing by default; every version with cvm_versions(), with the reason of the resubmission and a label for versions replaced only because they were filed in the wrong unit.
  • The mirror. Default source; dated snapshots that can be pinned with cvm_release_set(); SHA-256 checked on every download; a history of superseded filings.
  • Company data only. The mirror and its Zenodo editions carry data about companies; the tables that describe natural persons are read straight from the CVM, by the same call. See PRIVACY.md and DATA-LICENSE.md.
  • A DOI for the data. First Zenodo edition: 10.5281/zenodo.24260441; 10.5281/zenodo.24260440 resolves to the latest edition.

The full list of changes is in NEWS.md.

Install with pak::pak("SidneyBissoli/cvmdata@v0.3.0").