NOLookup::Brreg::DataLookup - Lookup Brreg basic organization data from the JSON formatted service offered by the Brreg data API via http://data.brreg.no/oppslag/enhetsregisteret/enheter.xhtml
(Brreg is a short name for 'Brønnysundregistrene, the Norwegian Central Organization Registry).
Use WWW::Mechanize and JSON to lookup data from the JSON API at brreg. Use NOLookup::Brreg::Entry module to map the resulting json data structure to a NOLookup::Brreg::Entry objects.
The timeout period $BRREG_TIMEOUT is used to trap and return the call if Brreg lookup is hanging for some reason.
The module provides the below methods.
Lookup based on a complete organization number.
Returns an array of one single NOLookup::Brreg::Entry object in the data when a match is found.
Lookup based on a complete or part of an organization name.
Returns 0 entries if none found.
Returns an array of NOLookup::Brreg::Entry objects in the data when matches are found.
A maximum of $max_no_pages pages are fetched, each of 100 entries.
Lookup based on registration dates. A from_date and/or a to_date can be specified.
The lookup will find registrations performed after midnight starting the from date, and until midnight at the end of the to date.
Check if org. number basic syntax is OK, i.e. 9 digits. Note that Brreg may reject the number due to stricter requirements, like checksum etc.
The raw JSON data structure, as returned by the JSON service, and then decoded to a perl data structure with decode_json().
Set if an error has occured. On errors, the lookup terminates, with more info in the status().
Set if a warning has occured. On warnings, the lookup continues, but warnings are accumulated in the status().
Further description of error/warning situations.
Found data, an array of NOLookup::Brreg::Entry data objects.
See doc. for NOLookup::Brreg::Entry for details.
The number of objects in data().
The total number of objects in data().
Only set if all data has been fetched.
Only if total_size is set, the user can assume that all data has been fetched.
If more pages (of 100 elements) can be fetched, this method gives the URL to that page.
For now, support questions should be sent to:
<(nospam)info(at)norid.no>
Please also see the README file in the distribution.
http://www.brreg.no http://data.brreg.no/oppslag/enhetsregisteret/enheter.xhtml
Trond Haugen, <(nospam)info(at)norid.no>
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.
This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.
To install NOLookup, copy and paste the appropriate command in to your terminal.
cpanm
cpanm NOLookup
CPAN shell
perl -MCPAN -e shell install NOLookup
For more information on module installation, please visit the detailed CPAN module installation guide.