SOE technical guidance update

docs/schema/changelog.rst

@@ -16,7 +16,10 @@ ChangeLog
 ==================
 Changed 
 -------
-- Removed ``securitiesListing`` from required fields in ``hasPublicListing``. 
+- Removed ``securitiesListing`` from required fields in ``hasPublicListing``.
+
+- Scenario added to 'Representing state-owned enterprises' page covering ownership or control by a regional government.
+
 
 [0.3] - 2022-04-15
 ==================

docs/schema/guidance/repr-state-owned-enterprises.rst

@@ -43,59 +43,69 @@ Ownership-or-control by a state is known and a statement about ownership is poss
 Scenario 2
 ^^^^^^^^^^
 
-Ownership-or-control by a state body is known and a statement about ownership is possible.
+Ownership-or-control by a regional state government is known and a statement about ownership is possible.
 
 .. figure:: ../../_assets/SOE-scenario2.svg
-   :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'stateBody' and jurisdiction 'gb').
+   :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'state' and jurisdiction 'zm').
    :figwidth: 50%
    :align: center
 
 Scenario 3
 ^^^^^^^^^^
 
-A registered entity declares that it is exempt from disclosing beneficial owners because it is an SOE.
+Ownership-or-control by a state body is known and a statement about ownership is possible.
 
 .. figure:: ../../_assets/SOE-scenario3.svg
+   :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'stateBody' and jurisdiction 'gb').
+   :figwidth: 50%
+   :align: center
+
+Scenario 4
+^^^^^^^^^^
+
+A registered entity declares that it is exempt from disclosing beneficial owners because it is an SOE.
+
+.. figure:: ../../_assets/SOE-scenario4.svg
    :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'state' and jurisdiction 'nl'). The Entity statement with entityType 'registeredEntity' is also connected to an Ownership-or-control statement which has interestedParty.unspecified.reason set to 'noBeneficialOwners' and interestedParty.unspecified.description set to 'Exemption granted on the basis that the declaring entity is a state-owned enterprise'.
    :figwidth: 85%
    :align: center
 
-Scenario 4
+Scenario 5
 ^^^^^^^^^^
 
 Describing control through a golden share provision in company articles or shareholder agreement.
 
-.. figure:: ../../_assets/SOE-scenario4.svg
+.. figure:: ../../_assets/SOE-scenario5.svg
    :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'stateBody' and jurisdiction 'nl'). The Ownership-or-control statement has interests.0.type set to 'controlViaCompanyRulesOrArticles' and interests.0.details set to 'Veto rights over specified company decisions'.
    :figwidth: 50%
    :align: center
 
-Scenario 5
+Scenario 6
 ^^^^^^^^^^
 
 Describing control of an SOE by a natural person.
 
-.. figure:: ../../_assets/SOE-scenario5.svg
+.. figure:: ../../_assets/SOE-scenario6.svg
    :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'state' and jurisdiction 'zm'). The Entity statement with entityType 'registeredEntity' is also connected to an Ownership-or-control statement which has interests.0.type set to 'seniorManagingOfficial'. That last Ownership-or-control statement is connected to a Person statement with personType set to 'knownPerson'.
    :figwidth: 85%
    :align: center
 
-Scenario 6
+Scenario 7
 ^^^^^^^^^^
 
 An SOE is formed by statute.
 
-.. figure:: ../../_assets/SOE-scenario6.svg
+.. figure:: ../../_assets/SOE-scenario7.svg
    :alt: Entity statement (with entityType 'legalEntity', formedByLegislation.name set to 'National Energy Act', and formedByLegislation.date set to '1980-02-01') is connected via an Ownership-or-control statement to an Entity statement (with entityType 'stateBody' and jurisdiction 'zm'). The Ownership-or-control statement has interests.0.type set to 'controlByLegalFramework'.
    :figwidth: 50%
    :align: center
 
-Scenario 7
+Scenario 8
 ^^^^^^^^^^
 
 A state's interests in an SOE are managed via a government-linked investment entity (GLIE).
 
-.. figure:: ../../_assets/SOE-scenario7.svg
+.. figure:: ../../_assets/SOE-scenario8.svg
    :alt: Entity statement (with entityType 'registeredEntity') is connected via an Ownership-or-control statement to another Entity statement with entityType 'registeredEntity' and name 'A G.L.I.E'. That latter Entity Statement is connected via an Ownership-or-control statement to an Entity statement (with entityType 'state' and jurisdiction 'gb').
    :figwidth: 50%
    :align: center