Dados de Nível 1: formato LEI-CDF versão 3.1
As informações do cartão profissional disponíveis junto aos dados de referência da pessoa jurídica do Identificador de Entidade Jurídica (LEI), por exemplo, o nome oficial de uma entidade jurídica e seu respectivo endereço registrado, são conhecidos como dados de “Nível 1”. Elas respondem à pergunta “quem é quem”.
O formato Arquivo de Dados Comuns-LEI (CDF) define como as Organizações emissoras de LEI relatam os dados de referência de LEI e de Nível 1.
Em novembro de 2016, a GLEIF publicou o formato LEI-CDF inicial versão 1.0. Em maio de 2017, a GLEIF publicou o formato LEI-CDF versão 2.1 e em maio de 2021, o formato LEI-CDF versão 3.1. As mudanças introduzidas na versão 3.1, em comparação com o formato LEI-CDF versão 2.1, são baseadas nas políticas do ROC, Eventos de Entidade Jurídica (anteriormente chamado de "Ações Corporativas") e Dados Históricos no Sistema Global LEI, e o documento Diretriz de Elegibilidade do LEI para Entidades Governamentais Gerais. O documento de Notas de Lançamento e a definição de esquema XML correspondente estão disponíveis para download no rodapé desta página.
O diagrama abaixo apresenta a estrutura do formato LEI-CDF versão 3.1, incluindo definições de conteúdos de dados a serem fornecidos.
A value of type
FileContentEnum
in a file conforming to this standard SHALL be one of the following code strings:LOU_FULL_PUBLISHED
LOU_DELTA_PUBLISHED
GLEIF_FULL_PUBLISHED
GLEIF_DELTA_PUBLISHED
QUERY_RESPONSE
LEIHeader
.
lei:ExtensionType
Data element(s) defined by the sender of the file. A description of Extension
element structure and content should be provided separately.
[0,1]
OtherEntityNames
for other names).
lei:NameType
A string expressed in a natural language, including a code (xml:lang
attribute) indicating which natural language is used.
[1,1]
OtherName
elements (providing all types of names other than the Primary Legal Name) for the Entity. Transliterated versions of names are provided in a separate element.
lei:OtherEntityNamesType
Each of the one or more OtherEntityName
elements contained here includes an optional xml:lang
language code, permitting OtherEntityName
to be repeated as many times as necessary to express the same type of alternative name in multiple languages.
[0,1]
TransliteratedOtherEntityName
elements, each with a mandatory type
and an optional xml:lang
attribute
[0,1]
AddressType
in a file conforming to this standard SHALL include data elements as specified below:
- Language (
xml:lang
attribute) - One mandatory
FirstAddressLine
- An optional
AddressNumber
taken from theFirstAddressLine
- An optional
AddressNumberWithinBuilding
taken from theFirstAddressLine
- An optional
MailRouting
taken from theFirstAddressLine
- 0-3 optional
AdditionalAddressLine
elements -
City
-
Region
(optional) -
Country
-
PostalCode
(optional)
AddressType
in a file conforming to this standard SHALL include data elements as specified below:- Language (
xml:lang
attribute) - One mandatory
FirstAddressLine
- An optional
AddressNumber
taken from theFirstAddressLine
- An optional
AddressNumberWithinBuilding
taken from theFirstAddressLine
- An optional
MailRouting
taken from theFirstAddressLine
- 0-3 optional
AdditionalAddressLine
elements -
City
-
Region
(optional) -
Country
-
PostalCode
(optional)
OtherAddress
elements for the Entity. This may be used to provide alternative language forms of legal address or headquarters address. Transliterated other addresses are provided in a separate element.
lei:OtherAddressesType
A value of type OtherAddress
in a file conforming to this standard SHALL include the following data elements:- Language (
xml:lang
attribute) - One mandatory
FirstAddressLine
- An optional
AddressNumber
taken from theFirstAddressLine
- An optional
AddressNumberWithinBuilding
taken from theFirstAddressLine
- An optional
MailRouting
taken from theFirstAddressLine
- 0-3 optional
AdditionalAddressLine
elements -
City
-
Region
(optional) -
Country
-
PostalCode
(optional)
OtherAddress
element includes an optional language code, permitting OtherAddress
to be repeated as many times as necessary to express the same address type in multiple languages.
[0,1]
TransliteratedOtherAddress
elements, each containing a transliterated version of one of the addresses for the Legal Entity, including the following elements: - Language (
xml:lang
attribute) - One mandatory
FirstAddressLine
- An optional
AddressNumber
taken from theFirstAddressLine
- An optional
AddressNumberWithinBuilding
taken from theFirstAddressLine
- An optional
MailRouting
taken from theFirstAddressLine
- 0-3 optional
AdditionalAddressLine
elements -
City
-
Region
(optional) -
Country
-
PostalCode
(optional)
TransliteratedOtherAddress
element includes an optional language code, permitting TransliteratedOtherAddress
to be repeated as many times as necessary to express a transliterated version of each address type in multiple languages. The xml:lang
attribute indicates the language of the original address used as a source for the transliteration.
[0,1]
RegistrationAuthorityType
in a file conforming to this standard SHALL include data elements as specified below:-
RegistrationAuthorityID
- The reference code of the registration authority, taken from the Registration Authorities Code List maintained by GLEIF -
OtherRegistrationAuthorityID
- A legacy / historical reference code of a registration authority -
RegistrationAuthorityEntityID
- The identifier of the Entity at the indicated registration authority
Legalform
data element is also dependent).
lei:JurisdictionCodeType
A value of type JurisdictionCode
in a file conforming to this standard SHALL either be- a 2-character country code conforming to ISO 3166-1 alpha-2 or
- a region code conforming to ISO 3166-2.
EntityCategoryTypeEnum
in a file conforming to this standard SHALL be one of the following code strings:
-
BRANCH
- The Legal Entity is a branch of another Legal Entity. -
new GENERAL
- The legal entity is a general legal entity. -
FUND
- The Legal Entity is a fund managed by another Legal Entity. -
SOLE_PROPRIETOR
- The Legal Entity is an individual acting in a business capacity. -
new RESIDENT_GOVERNMENT_ENTITY
- The legal entity is a non-market producer, part of a central, state or local government, social security funds or a non-profit institution (NPI) controlled by government units. -
new INTERNATIONAL_ORGANIZATION
- The legal entity is a non-resident unit created by international agreements or other arrangements for the provision of non-market services or financial intermediation at the international level.
new
Indicates and specifies further (where applicable) the sub-category (sub-sector) of Legal Entity identified by this LEI Record
and already categorized by the EntityCategory
.
lei:EntitySubCategoryTypeEnum
A value of type EntitySubCategoryTypeEnum
in a file conforming to this standard SHALL be one of the following code strings:
-
new CENTRAL_GOVERNMENT
- The legal entity is a central government subsector which consists of the institutional units plus non-profit institution (NPI) controlled by the central government institutions. -
new STATE_GOVERNMENT
- The legal entity is a state government subsector which consists of the institutional units that exercise some government functions at a level below that of the central government and above that of the government institutional units existing at a local level. -
new LOCAL_GOVERNMENT
- The legal entity is a local government subsector which consists of local governments that are separate institutional units. -
new SOCIAL_SECURITY
- The legal entity is a social security scheme which covers a wide variety of programmes, providing benefits in cash or in kind for old age, invalidity or death, survivors, sickness and maternity, work injury, unemployment, family allowance, health care, etc.
EntityLegalFormCode
codes but not the specific codes conforming to the ISO standard it requires.
lei:LegalFormType
A value of type LegalFormType
in a file conforming to this standard SHALL include data elements as specified below:-
EntityLegalFormCode
- A current code from the GLEIF-maintained list MUST be used. Values of theLegalFormEnum
code list are maintained by ISO / GLEIF through the Entity Legal Form (ELF), available from the GLEIF website. -
OtherLegalForm
- A legacy code or textual description for the Legal Entity\'s legal form, used until a current code from the GLEIF-maintained list can be used.
deprecated
Another Entity associated with this Entity if needed to fully identify this Entity or to place it in an appropriate context.
lei:AssociatedEntityType
A value of type AssociatedEntityType
in a file conforming to this standard SHALL include one or the other (not both) of the following data elements:-
AssociatedLEI
- The LEI of the associated Entity -
AssociatedEntityName
- The name of the associated Entity
EntityStatusEnum
in a file conforming to this standard SHALL be one of the following code strings:-
ACTIVE
- As of the last report or update, the Legal Entity reported that it was legally registered and operating. -
INACTIVE
- It has been determined that the Entity that was assigned the LEI is no longer legally registered and/or operating, whether as a result of business closure, acquisition by or merger with another (or new) Entity, or determination of illegitimacy. -
new NULL
- The entity status is not applicable.
new
The date on which the legal entity was first established as defined in ISO 17442.
lei:LEIDateTimeProfileGeYear0001
A date and time,including the timezone,based on ISO 8601.
[0,1]
deprecated
The date the Legal Entity ceased operation or was merged. This element SHALL be present if EntityExpirationReason
is present, and omitted otherwise.
lei:LEIDateTimeProfile
A date and time, including the timezone, based on ISO 8601.
[0,1]
EntityExpirationDate
is present, and omitted otherwise.
lei:EntityExpirationReasonEnum
A value of type EntityExpirationReasonEnum
in a file conforming to this standard SHALL be one of the following code strings:-
DISSOLVED
- The Entity ceased to operate -
CORPORATE_ACTION
- The Entity was acquired or merged with another Entity -
OTHER
- The reason for expiry is neither ofDISSOLVED
norCORPORATE_ACTION
SuccessorEntityType
in a file conforming to this standard SHALL include one (not both) of the following data elements:
-
SuccessorLEI
- The LEI of the successor Entity. -
SuccessorEntityName
- The name of the successor Entity.
new The SuccessorEntity
is a repeating field from LEI version 3.1 onwards.
[0,*]
new
Container for a finite number of events specified by the LEI ROC in the life of a legal entity that would impact the Reference Data in the Global LEI System.
lei:LegalEntityEventsType
The LegalEntityEvents
element contains one or more LegalEntityEvent
elements with the following attributes and child elements.
- Child Elements:
-
new LegalEntityEventType
- The type of legal entity event. This field must contain a validLegalEntityEventTypeEnum
as specified in the LEI CDF version 3.1. -
new LegalEntityEventEffectiveDate
(optional) - The date when the legal entity event becomes legally effective. -
new LegalEntityEventRecordedDate
- The date when the legal entity event was recorded in the Global LEI System. -
new ValidationDocuments
- Type of source document(s) used for validating the legal entity event. This field must contain a validValidationDocumentsTypeEnum
as specified in the LEI CDF version 3.1. -
new ValidationReference
(optional) - A reference to a specific document or other source used as the basis of validation for this legal entity event. -
new AffectedFields
(optional) - A list of LEI Record Set elements that are expected to be updated in the LEI Record Set as a result of a legal entity event.
- Attributes:
-
new group_type
- Describes whether or not this legal entity event is part of a group of multiple or a complex event. This field must contain a validLegalEntityEventGroupTypeEnum
as specified in the LEI CDF version 3.1. -
new event_status
- Describes the status of the legal entity event with regard to event timeline. This field must contain a validLegalEntityEventStatusEnum
as specified in the LEI CDF version 3.1. -
new group_id
(optional) - An optional identifier assigned to link legal entity events that are part of the same group of multiple or a complex event. -
new group_sequence_no
(optional) - An optional number which indicates the sequence of each legal entity event within a group of events.
ManagingLOU
.
lei:LEIDateTimeProfile
A date and time, including the timezone, based on ISO 8601.
[1,1]
ManagingLOU
.
lei:LEIDateTimeProfile
A date and time, including the timezone, based on ISO 8601.
[1,1]
ManagingLOU
.
lei:RegistrationStatusEnum
A value of type RegistrationStatusEnum
in a file conforming to this standard SHALL be one of the following code strings:-
PENDING_VALIDATION
- An application for an LEI that has been submitted and which is being processed and validated -
ISSUED
- An LEI Registration that has been validated and issued, and which identifies an Entity that was an operating Legal Entity as of the last update -
DUPLICATE
- An LEI Registration that has been determined to be a duplicate registration of the same Legal Entity as another LEI Registration; the DUPLICATE status is assigned to the non-surviving registration (i.e. the LEI that should no longer be used) -
LAPSED
- An LEI registration that has not been renewed by the NextRenewalDate and is not known by public sources to have ceased operation -
deprecated MERGED
- An LEI registration for an Entity that has been merged into another Legal Entity, such that this Legal Entity no longer exists as an operating Entity -
RETIRED
- An LEI registration for an Entity that has ceased operation, without having been merged into another Entity -
ANNULLED
- An LEI registration that was marked as erroneous or invalid after it was issued -
CANCELLED
- An LEI registration that was abandoned prior to issuance of an LEI -
TRANSFERRED
- An LEI registration that has been transferred to a different LOU as the managing LOU -
PENDING_TRANSFER
- An LEI registration that has been requested to be transferred to another LOU. The request is being processed at the sending LOU -
PENDING_ARCHIVAL
- An LEI registration is about to be transferred to a different LOU, after which its registration status will revert to a non-pending status
ValidationSourcesTypeEnum
in a file conforming to this standard SHALL be one of the following code strings:- PENDING
- ENTITY_SUPPLIED_ONLY
- PARTIALLY_CORROBORATED
- FULLY_CORROBORATED
ValidationAuthorityType
in a file conforming to this standard SHALL include data elements as specified below:-
ValidationAuthorityID
- The reference code of the registration authority, taken from the Registration Authorities Code List maintained by GLEIF -
OtherValidationAuthorityID
- A legacy / historical reference code of a registration authority -
ValidationAuthorityEntityID
- The identifier of the Entity at the indicated registration authority
OtherValidationAuthorityType
in a file conforming to this standard SHALL include data elements as specified below:-
ValidationAuthorityID
- The reference code of the registration authority, taken from the Registration Authorities Code List maintained by GLEIF -
OtherValidationAuthorityID
- A legacy / historical reference code of a registration authority -
ValidationAuthorityEntityID
- The identifier of the Entity at the indicated registration authority
Observação: os novos valores de enumeração e os campos adicionados no LEI-CDF versão 3.1 estão destacados em amarelo. Da mesma forma, os campos e valores descontinuados estão destacados em cinza; eles são mantidos para compatibilidade técnica retroativa.
A Transição de Estado e as Regras de Validação (STVR) descrevem as regras de negócios e suas implementações técnicas para a emissão, atualização, gerenciamento e publicação dos Dados de Referência de LEI de acordo com os formatos de Arquivo de Dados Comuns (CDF).
Para obter os documentos técnicos e os exemplos de arquivos necessários para atualização das versões atuais, consulte a página Documentos de apoio.
Envie suas dúvidas sobre o formato LEI-CDF para info@gleif.org.
Arquivos Relevantes para Download
- As Notas de Lançamento para o LEI-CDF 3.1: lei-cdf_version_3.1-documentation.html
- A definição de esquema XML correspondente: 2021-03-04_lei-cdf-v3-1.xsd
- Baixar como PDF: Transição de estado e regras de validação para formatos do Arquivo de Dados Comuns (versão 2.7.1) (State Transition and Validation Rules for Common Data File Formats (Version 2.7.1))