-
Notifications
You must be signed in to change notification settings - Fork 13
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Secondary entity classifications and entity type details block #339
Comments
This looks viable, @ScatteredInk... a few thoughts/questions:
/* I wonder whether 'form' is a better term here since - in English at least - it maps to 'legal form' quite nicely.
|
|
Some comments/questions:
is that it can be met by using the I'm not convinced that we should restructure
I don't know the answers, and they might be easily resolved, but I think we should consider them.
Some of the above is based on pushing back against restructuring
|
I think Simon's right that the options need to be fleshed out and considered carefully. Point 3 (that pushing all top level fields into a Also, if we're considering restructuring statements we should be aware of this proposal to separate statement contents into a payload and a wrapper. Not that progress need be blocked by wider considerations, but it might help to constrain our immediate ambitions. Separately, on
I don't think it would be down to us to create any codelist. We'd need to put in place a way of publishers referring to locally-defined legal forms. This could be an OCDS local-scheme-style system, or - in the first place - encouragement to include information in a publication policy. |
Thanks @siwhitehouse and @kd-ods. I think the arguments for avoiding a major restructure of an entity statement are sound - let's not do this. That then suggests paring this back to an MVP proposal of:
If that sounds like a way forward, then we can do 1 (and maybe 2) here and work on the rest in the relevant tickets. |
That sounds like a good plan, @ScatteredInk. Couple of questions/thoughts: On 2: On 4: On another issue entirely (which I should have raised earlier, sorry to raise it now, hope it's not a spanner, etc.): |
I was in two minds about this but it may be better to have this classification, as a pointer for which identifiers are expected.
Yes. Given that local forms are likely to change over time, I think we want to encourage a publication pattern where this is maintained as an external reference source that BODS statements can be checked against, as with the UK's list.
There are two differences that I see between arrangements and agreements:
The second one may be slightly artificial, legally, but is I think more representative of the de facto position. |
Thanks, @ScatteredInk - that's really helpful. Any wording and detail that we can provide to help illuminate that agreement/arrangement distinction is going to be critical. |
@ScatteredInk - I was talking to @kindly today about putting the I had thought that inclusion of the publicListing key referring to an empty object could be used to convey that information, but on reflection with @kindly, realise that that technique will not be reliably used by publishers. We need a more robust way to convey that information. Here are two options, but there are poss more:
What do you reckon? (2) feels a bit too 'special-casey' to me. We prob need to go for something more generalisable, like (1)? |
We discussed this today and think the best option is:
|
Thinking on this ticket and on #336 informed development for BODS 0.3. We now have a structure in place in the schema for entity types and entity subtypes. At the moment, the only entity type with a subtype categories is 'statebody'. (You can see it in use here.) |
There is an ISO standard (20275) for Entity Legal Forms. This list will be useful when considering subtypes of entities and how general and local categorisation might work. (It might be overkill to build ISO 20275 code usage into the BODS schema, but users' use of ISO 20275 values and our use of ISO 20275 terminology should be considered.) |
Does the implementation of entityType with type, subtype and details resolved this ticket? |
Yes - I think this can be closed and we'll use #336 for future work on entity classification. |
In addition to the work on entity types in #336, I suggest a secondary classification mechanism that allows any entity to be described with one or more relevant characteristics from an entity type specific codelist, contained within a type details block.
Justification
Entity characteristics are useful for various kinds of analysis, verification processes and data quality metrics. To date BODS has taken implicit two approaches to dealing with entity characteristics:
I suggest that we:
(i) retain the general approach of inferring relational characteristics of entities from their ownership structures; and,
(ii) allow for more explicit declarations of intrinsic characteristics using secondary classifications that will, in turn, make the inference of relational characteristics easier and allow for easier analysis of data in aggregate.
Implementation
An outline of this approach is sketched below for feedback. More detailed work would need to be broken out into separate issues.
If we adopt this approach then I think we may want to restructure our entityStatement somewhat, so that we have the relevant details about an entity separated from data about the disclosure. This would move us towards a model where we have different data structure depending on the type of data that is being modelled, e.g.,
Within a details block we could then have an
arrangementType
field (and so on for all entity types) and additional fields that are specific to each type of entity. I would also add a new common field that I think is necessary for this kind of classification:localEntityType
- this would be the local name (preferably drawn from a codelist) that maps to the choice of entity type. This would allow analysis of the use of particular legal formations for particular purposes.A very draft outline of how this might look for each entity type is set out below:
State entities
No secondary classification (although this may depend on the scope of a 'state entity').
Additional fields:
jurisdiction
State bodies
stateBodyType: state entity with legal personality, state entity without legal personality
Additional fields:
formedByStatute
- the legislation used to create aUsage notes: registered entities controlled by state bodies should be recorded as legal entities with type registered entity.
Legal entities
Legal entity type: registered legal entity, unregistered legal entity
Arrangements
Arrangement type: trust, general partnership, unincorporated organisation
Additional fields:
arangementDescription
- a description of the arrangement if available.Agreements
Agreements: joint shareholding, nominee shareholding, bearer share, contractual joint venture, contractual agreement, informal agreement, unknown agreement
Additional fields:
agreementDescription
- a description of the agreement if available.Unknown entity type: unknown legal entity, unknown arrangement, unknown agreement, unknown state, unknown state entity, unknown type, unknown structure
Usage notes: This is connected to the ongoing work on missing information. The addition of
unknown structure
would allow us to distinguish between a single unknown entity (whether of a known or unknown type) and cases where an unknown node represents an ownership structure of unknown size.Classifications that imply structure
Some potential classifications (like 'state owned enterprise' or 'subsidiary-of-listed-company') imply a certain structure, as below (and other examples on the same board):
Where that structure is known (including where an unknown entity can be used to represent an uncertainty in the structure) then I think we want to publish a full BODS statement rather than use a secondary classification. Inferences along the lines of "this company is a state-owned enterprise" can then be the responsibility of data consumers, and we can develop guidance on queries to find entities of interest if this proves difficult.
The text was updated successfully, but these errors were encountered: