.. image:: https://badge.fury.io/py/iso-20275.svg .. image:: https://travis-ci.org/Gawaboumga/iso-20275-python.svg?branch=master :target: https://travis-ci.org/Gawaboumga/iso-20275-python
ISO standard 20275 ‘Financial Services – Entity Legal Forms (ELF)’, Python wrapper.
Its aim is to enable legal forms within jurisdictions to be codified and
thus facilitate the classification of legal entities according to their
legal form and is codified through: iso 20275:2019 <https://www.iso.org/obp/ui/#iso:std:iso:20275:ed-1:v1:en>__
Everything is stored in UTF-8 format.
Optional Common name of the
subdivision within the country corresponding to the: "English short
name (using Title case)" of ISO 3166-2.Optional (extended)
Alpha-2 code of ISO 3166-2.Latin-1 section <#markdown-header-latin1>__) of local
name according to ISO 01.140.10.Optional Abbreviations of the legal
entity type local name.Optional Transliterated
abbreviation of the legal entity type local name in latinized
alphabet (more than ASCII).Optional Explanation of the modification.Optional Date of the
modification according to ISO 8601.Optional Explanation on the legal entity type./!\ Beware /!\ Three datasets are available within this package. The
Elf, the Elf with additional legal forms and the Original Elf, the original one (Original Elf) is a
mapping of the original file without some normalization in the data. This is the
pure form. Whereas Elf got some modifications to clean up some
inputs. See Differences section <#markdown-header-differences>__ for
more details. Elf with additional legal forms consists of the cleaned version (Elf) to which the different forms present in the file Additional legal forms.txt <iso20275/Additional legal forms.txt>__ have been added.
By default, the package provides Elf with additional legal forms, but you can load the version that you want with:
Elf.load(newest=True, cleaned=False, additional=False)
If you don't provide newest, you can access to a previous version with timestamp like 2019-11-06. Cleaned is when you want the version with some ameliorations, additional is based on the cleaned version but with the additional legal forms.
There exists 263 elements sharing a same ELF code. You need to specify which version you would like to use explicitly.
.. code:: python
from iso20275 import Elf
len(Elf['254M']) # 2 entries for this specific entity.
Elf['254M'][0].local_name # '私人股份有限公司' for the Chinese entry.
Elf['254M'][1].local_name # Private company limited by shares for the English entry.
len(Elf['CDOV']) # 1 entry for this specific entity.
Elf['CDOV'][0].local_name # International Business Corporation.
# You can iterate over all the ELF code.
for elf_code, values in Elf.items():
pass
# You can access to both version of the dataset, a normalized one and the original. Observe the Co-opLtd.
Elf['6W6X'][0].local_abbreviations # "Co-operative Limited;Cooperative Limited;Co-op Limited;Coop Limited;Co-operative Ltd.;Cooperative Ltd.;Co-op Ltd.;Coop Ltd.;Co-operative;Cooperative;Co-op;Coop"
Elf.load(newest=True, cleaned=False) # We load the official dataset
Elf['6W6X'][0].local_abbreviations # "Co-operative Limited;Cooperative Limited;Co-op Limited;Coop Limited;Co-operative Ltd.;Cooperative Ltd.;Co-opLtd.;Coop Ltd.;Co-operative;Cooperative;Co-op;Coop"
Here, we will review which changes were made on the data or remarks were observed.
Original file (Original Elf)
Differences in comparison to the original file.
Modification:
^^^^^^^^^^^^^
No modifcation were made on the file.
Since the last version published in 2017-11-30, the file format really improved and we don't find anymore heterogeneous content.
Modified file (Elf)
~~~~~~~~~~~~~~~~~~~
Differences in comparison to the original file.
Modification:
^^^^^^^^^^^^^
- ``’`` was replaced by ``'`` at the exception of the local name of JOZN.
- ``（`` was replaced by ``(`` and ``）`` by ``)`` in transliterated name (for chinese companies).
- `` `` (NO-BREAK SPACE 0xa0) was replaced by `` `` (space).
- Fusion of the two X0SD.
- Parenthesis have been normalized, one space before opening parenthesis and one after the closing one. This concerns essentially pakistanese companies: 4XMS, 7IYW, 88OX, MOI8, QR25 and RKYF.
- Change in 6W6X: ``Co-opLtd.`` is now ``Co-op Ltd.``
- Change in 2DGO and EULU: Replace ``"""`` by ``"``
- Change in CQ5X and UCU5: Replace ``Ε`` by ``E`` (Greek letter by latin).
- Change in J8DW: ``Podnik zahr. osoby, org. zložka`` is now ``Podnik zahr. osoby, org. zložka;Podnik zahr. osoby;org. zložka``.
- Change in L9WT: ``Obec, mesto (o.,m.úrad)`` is now ``Obec, mesto (o.,m.úrad);Obec;mesto;mesto (o.,m.úrad)``.
- Change in X0SX: ``tksz,;hsz.`` is now ``tksz,;tksz.;hsz.``
- Change in HBQK: Addition of abbreviations: ``AIF - Sub scheme;AIF Scheme;AIF``.
- Change in JKJX and K361: Replace ``/`` with ``;``.
- Change in 3AZY, 3S6E, 4VD7, 6CHY, CVH6, D2I2, GLN8, IAP3, IQR2, JFET, R0B6, TUE5, YX4E, Z2FQ: Add CUMA, SDIS, PETR, SAS, SAFER, SIVOM, CIAS, SIVU, SICA, SPFPL SA à directoire, GIE, OPHLM, SCPI, GIP abbreviations respectively.
- Remove double spaces in EPG7, S2E3, DBU3, LBPW, ZJTK, JKJX, K361, DBU3, LBPW and B3JS.
- Change in FF1D: Addition of abbreviations ``PULC;UC``.
- Change in KMFX: Addition of abbreviations ``ULC;UC``.
- Change in URQH: Addition of abbreviations ``PUC;UC``.
- Change in Q9Y1: Addition of abbreviation ``IBC``.
- Change in X2X1: Addition of abbreviations ``LP;L.P.``.
- Change in 7ZMX: Addition of abbreviation ``AG``.
- Change in QFYC: Addition of abbreviation ``EIRL``.
- Change in P5JT and QNWW: Transliteration is now: ``Evropaïkós Ómilos Oikonomikoú Skopoú``.
- Trimming values, notably: ``Azerbaijani `` was replaced by ``Azerbaijani``.
Modified file with additional legal forms (Elf with additional legal forms)
Differences in comparison to the original file.
Modification: ^^^^^^^^^^^^^
The file is directly based on the modified file (Elf). We added the different forms present in the file Additional legal forms.txt <iso20275/Additional legal forms.txt>__ thanks to the script merge_additional_legal_forms.py <iso20275/merge_additional_legal_forms.py>__. This adds many countries, new legal forms in some countries already present, additions to the abbreviations used in some countries as well as legal forms in other languages.
The transliterated columns (namely Transliterated name and Abbreviations transliterated) are in a latinized alphabet (more than ASCII).
All the following characters are still present:
œ U+0153 : LATIN SMALL LIGATURE OEČ U+010C : LATIN CAPITAL LETTER C WITH CARONč U+010D : LATIN SMALL LETTER C WITH CARONě U+011B : LATIN SMALL LETTER E WITH CARONľ U+013E : LATIN SMALL LETTER L WITH CARONň U+0148 : LATIN SMALL LETTER N WITH CARONř U+0159 : LATIN SMALL LETTER R WITH CARONŠ U+0160 : LATIN CAPITAL LETTER S WITH CARONš U+0161 : LATIN SMALL LETTER S WITH CARONť U+0165 : LATIN SMALL LETTER T WITH CARONŽ U+017D : LATIN CAPITAL LETTER Z WITH CARONž U+017E : LATIN SMALL LETTER Z WITH CARONí U+00ED : LATIN SMALL LETTER I WITH ACUTEý U+00FD : LATIN SMALL LETTER Y WITH ACUTEć U+0107 : LATIN SMALL LETTER C WITH ACUTEń U+0144 : LATIN SMALL LETTER N WITH ACUTEś U+015B : LATIN SMALL LETTER S WITH ACUTEă U+0103 : LATIN SMALL LETTER A WITH BREVEů U+016F : LATIN SMALL LETTER U WITH RING ABOVEő U+0151 : LATIN SMALL LETTER O WITH DOUBLE ACUTEű U+0171 : LATIN SMALL LETTER U WITH DOUBLE ACUTEö U+00F6 : LATIN SMALL LETTER O WITH DIAERESISü U+0075 : LATIN SMALL LETTER + U ¨ U+0308 : COMBINING DIAERESISā U+0101 : LATIN SMALL LETTER A WITH MACRONī U+012B : LATIN SMALL LETTER I WITH MACRONū U+016B : LATIN SMALL LETTER U WITH MACRONċ U+010B : LATIN SMALL LETTER C WITH DOT ABOVEė U+0117 : LATIN SMALL LETTER E WITH DOT ABOVEż U+017C : LATIN SMALL LETTER Z WITH DOT ABOVEą U+0105 : LATIN SMALL LETTER A WITH OGONEKę U+0119 : LATIN SMALL LETTER E WITH OGONEKį U+012F : LATIN SMALL LETTER I WITH OGONEKų U+0173 : LATIN SMALL LETTER U WITH OGONEKł U+0142 : LATIN SMALL LETTER L WITH STROKEș U+0219 : LATIN SMALL LETTER S WITH COMMA BELOWț U+021B : LATIN SMALL LETTER T WITH COMMA BELOWş U+015F : LATIN SMALL LETTER S WITH CEDILLAţ U+0163 : LATIN SMALL LETTER T WITH CEDILLAу U+0443 : CYRILLIC SMALL LETTER UOne can found the following characters, in addition to the previously described, in the original:
Ε U+0395 : GREEK CAPITAL LETTER EPSILON - Converted into E.（ U+FF08 : FULLWIDTH LEFT PARENTHESIS - Converted into (.） U+FF09 : FULLWIDTH RIGHT PARENTHESIS - Converted into ).Differences between the version 1.1 of 2019-11-06 and the 1.2 of 2020-06-10:
New countries:
Additions:
Deprecated:
Differences between the version 1.2 of 2020-06-10 and the 1.3 of 2020-11-19:
New countries:
Additions:
Deprecated:
For the following updates of the standard, a list of changes is written on the main site: https://www.gleif.org/en/about-lei/code-lists/iso-20275-entity-legal-forms-code-list/
Written by Youri Hubaut <https://github.com/Gawaboumga>__.
Distributed under MIT license.
FAQs
ISO 20275 Entity Legal Type package for Python
We found that iso-20275 demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.