Cvrvaelger

# Gemfile
gem "cvrvaelger"

require "cvrvaelger"

client = Cvrvaelger::Client.new(
  api_key: ENV.fetch("CVRVAELGER_API_KEY")
)

company = client.lookup("47458714")
company.cvr          # => "47458714"
company.name         # => "LEGO SYSTEM A/S"
company.address_line # => "Åstvej 1"
company.postal_code # => "7190"
company.city         # => "Billund"
company.status       # => "aktiv"

# Picker: 8 digits → lookup; otherwise exact, case-sensitive name match.
# Datafordeler string filters are `eq` / `in` only (no contains / fuzzy).
hits = client.search("LEGO SYSTEM A/S")
client.search("lego") # => []

# Optional bitemporal cut-off (GraphQL `virkningstid`, default: now)
client.lookup("47458714", at: Time.utc(2020, 1, 1))

# Fildownload: list metadata and stream a zip to disk
files = client.available_file_downloads(entity: "Navn", type_of_data: "Current", format: "json")
client.download_latest(entity: "Virksomhed", type: "current", format: "json", to: "tmp/virksomhed.zip")
client.download_file(files.first.file_name, to: "tmp/navn.zip")

# Incremental sync after a TotalDownload baseline (persist last event_id yourself).
# See Datafordeler transitions guide for entitetsbaserede hændelser.
status = client.register_import_status
page = client.events(since_event_id: last_id, first: 100)
page.events.each do |event|
  # from_failed_import marks duplicate catch-up events — handle in the host app.
  next if event.event_action == "d" # delete local row for event.object_datafordeler_row_id

  case event.entity_name
  when "Virksomhed"
    client.virksomhed_by_row_id(event.object_datafordeler_row_id) # => Hash or nil
  when "Navn"
    client.navn_by_row_id(event.object_datafordeler_row_id)
  when "Adressering"
    client.adressering_by_row_id(event.object_datafordeler_row_id)
  # other entities: query GraphQL yourself
  end
end
page = client.events(since_event_id: last_id, first: 100, after: page.end_cursor) if page.has_next_page