NAME

NOLookup::Brreg::Entry - Map a Brreg json data structure element to Brreg::Entry data objects.

DESCRIPTION

Map the json data to data objects.

Return a reference to an array of NOLookup::Brreg::Entry objects.

METHODS

module methods

The methods provided by this module.

error()

Set if an error has occured. On errors, the lookup terminates.

warning()

Set if a warning has occured. On warnings, the lookup continues.

status()

Further description of an error/warning situation.

If the returned JSON structure contains an unsupported data element, the lookup will be performed, but a warning may be returned and and with a status saying:

 'Warning: JSON data key entry not expected: xxxx'

where 'xxxx' is the unexpected key. If this happens, the module should be updated with a new method to support the element 'xxx'.

map_json_entries()

Map the JSON data structure from Brreg to NOLookup::Brreg::Entry data objects.

Returns a ref. to an array of NOLookup::Brreg::Entry data objects.

cur_page()/prev_page()/next_page()

If more pages can be fetched, those methods give the URL to that page

total_page_count()

Count of total nuber of pages matching the search

result_count()

Count of results on this page

total_result_count()

Count of total results for the search

Accessor methods

Data elements are available through acessors in the NOLookup::Brreg::Entry object. This is the possible JSON data methods, which are the accessor methods that can be used to find the returned data elements.

The accessor methods from @json_data_methods

  organisasjonsnummer 
  navn 
  oppdateringsid
  registreringsdatoEnhetsregisteret 
  stiftelsesdato
  oppstartsdato
  sisteInnsendteAarsregnskap 
* organisasjonsform
  overordnetEnhet
  maalform
  registrertIStiftelsesregisteret
  registrertIFrivillighetsregisteret
  registrertIMvaregisteret
  registrertIForetaksregisteret
  frivilligMvaRegistrertBeskrivelser

  underAvvikling
  konkurs
  underTvangsavviklingEllerTvangsopplosning
* forretningsadresse 
* postadresse
* institusjonellSektorkode 
* naeringskode1 
* naeringskode2
* naeringskode3
* _links
* page
  hjemmeside 
  antallAnsatte

Returned values:

Most of the accessor methods returns a single value, like 'navn', which returns a scalar with the name of the organization.

Some of the methods returns a hash, and are marked with an asterix (*). Hash data must be accessed via their respective keys.

The hashes are described below.

organisasjonsform()

The hash looks like follows:

  "organisasjonsform": {
    "kode": "AS",
    "beskrivelse": "Aksjeselskap",
    "_links": {
      "self": {
        "href": "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer/AS"
      }
    }
  },

forretningsadresse() / postadresse()

The hash looks like follows:

 "forretningsadresse": {
    "land": "Norge",
    "landkode": "NO",
    "postnummer": "7030",
    "poststed": "TRONDHEIM",
    "adresse": [
      "Abels gate 5"
    ],
    "kommune": "TRONDHEIM",
    "kommunenummer": "5001"
  },

institusjonellSektorkode()

The hash looks like follows:

 'institusjonellSektorkode' => {
    'beskrivelse' => 'Statlig eide aksjeselskaper mv.',
    'kode' => '1120'
  }

naeringskode1/2/3()

The hash looks like follows:

  'naeringskode1' => {
    'beskrivelse' => "Utvinning av r\x{e5}olje",
    'kode' => '06.100'
  },

frivilligMvaRegistrertBeskrivelser()

The hash looks like follows:

  'frivilligMvaRegistrertBeskrivelser' => [
    'Utleier av bygg eller anlegg'
  ],

_links()

The hash looks like follows:

 "_links": {
    "self": {
      "href": "https://data.brreg.no/enhetsregisteret/api/enheter/985821585"
    }
  }

SUPPORT

For now, support questions should be sent to:

<(nospam)info(at)norid.no>

Please also see the SUPPORT file in the distribution.

SEE ALSO

NOLookup::Brreg::DataLookup

AUTHOR

Trond Haugen, <(nospam)info(at)norid.no>

COPYRIGHT

Copyright (c) 2017- Trond Haugen <(nospam)info(at)norid.no>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

cpanm NOLookup

perl -MCPAN -e shell
install NOLookup