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.

next_page()

If more pages (of 100 elements) can be fetched, this method gives the URL to that page.

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 are:

  organisasjonsnummer 
  navn 
  registreringsdatoEnhetsregisteret 
  stiftelsesdato 
  sisteInnsendteAarsregnskap 
  organisasjonsform
  overordnetEnhet
  registrertIStiftelsesregisteret
  registrertIFrivillighetsregisteret
  registrertIMvaregisteret
  registrertIForetaksregisteret
* frivilligRegistrertIMvaregisteret
  underAvvikling
  konkurs
  underTvangsavviklingEllerTvangsopplosning
* forretningsadresse 
* postadresse
* institusjonellSektorkode 
* naeringskode1 
* naeringskode2
* naeringskode3
* links 
  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.

forretningsadresse() / postadresse()

The hash looks like follows:

  'forretningsadresse' => {
    'land' => 'Norge',
    'kommune' => 'STAVANGER',
    'postnummer' => '4035',
    'poststed' => 'STAVANGER',
    'kommunenummer' => '1103',
    'landkode' => 'NO',
    'adresse' => 'Forusbeen 50'
  },

institusjonellSektorkode()

The hash looks like follows:

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

naeringskode1() / naeringskode2()

The hash looks like follows:

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

frivilligRegistrertIMvaregisteret()

The hash looks like follows:

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

links()

The hash looks like follows:

  'links' => [
     {
       'rel' => 'self',
       'href' => 'http://data.brreg.no/enhetsregisteret/enhet/923609016'
     }
   ]

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