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) 2016 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.