Data source VIES

From CDQ
Data source/VIES
Jump to navigation Jump to search
Name ALEI prefix The ALEI prefix element is the ISO 3166-2 code for country and subdivision if applicable followed by the stop character ‘.’ This is followed by an acronym representing the register maintained by the administrative agency for the governing body of a nation, state, or community that assigned the identifier element. The prefix is assigned by ECCMA: VIES, Full name (en) English name of a concept.: VAT Information Exchange System, Short name Defines the name of a concept. Consits of “Country or Subdivision” + “Registry name”: VIES
Technical key Defines a unique key by which e.g. data model concepts can be referenced in a technical integration context. These keys are unique in the CDL context. VIES
Short description Informal and short human-readable definition of a concept. Official interface to the European MIAS database.
Description Informal and comprehensive human-readable definition of a concept. Allows to verify the validity of a VAT number issued by any European Member State. For all countries except Germany the registration data (name and address for which the VAT is registred) can be received as well. For Spain registration data can only be confirmed but not received by just providing the VAT number.
Credential type(s)  European VAT identifier
Country scope Defines a address/country a given concept is used in (or valid in, or relevant for etc.), i.e. the country-specific scope of a concept. AT (Österreich, Austria, Autriche, 奥地利), BE (Belgien, Belgium, Belgique, België, 比利时), BG (Bulgaria, Bulgarien, Bulgaria, Bulgarie, 保加利亚), CY (Republik Zypern, Kýpros, Cyprus, Chypre, Kıbrıs, 賽普勒斯), CZ (Česko, Tschechien, Czechia, Tchéquie, 捷克), DE (Deutschland, Germany, Allemagne, 德国), DK (Danmark, Dänemark, Denmark, Danmark, Danemark, Danmarki, 丹麦), EE (Estland, Estonia, Eesti, Estonie, 爱沙尼亚), ES (Espanya, Spanien, Spain, España, Espainia, Espagne, España, Espanha, 西班牙), FI (Finnland, Finland, Suomi, Finlande, Finland, 芬兰), FR (Frankreich, France, France, 法国), GR (Griechenland, Elláda, Greece, Grèce, 希腊), HR (Kroatien, Croatia, Croatie, Hrvatska, 克罗地亚), HU (Ungarn, Hungary, Hongrie, Magyarország, 匈牙利), IE (Irland, Ireland, Irlande, Éire, 爱尔兰共和国), IT (Italien, Italy, Italie, Italia, 意大利), LT (Litauen, Lithuania, Lituanie, Lietuva, 立陶宛), LU (Luxemburg, Luxembourg, Luxembourg, Lëtzebuerg, 卢森堡), LV (Lettland, Latvia, Lettonie, Latvija, 拉脫維亞), MT (Malta, Malta, Malte, Malta, 马耳他), NL (Königreich der Niederlande, Netherlands, Pays-Bas, Nederland, 荷蘭), PL (Polen, Poland, Pologne, Polska, 波兰), PT (Portugal, Portugal, Portugal, Portugal, 葡萄牙), RO (Rumänien, Romania, Roumanie, România, 羅馬尼亞), SE (Schweden, Sweden, Suède, Sverige, 瑞典), SI (Slowenien, Slovenia, Slovénie, Slovenija, 斯洛文尼亚), SK (Slowakei, the Slovak Republic, Slovaquie, Slovensko, 斯洛伐克), XI (Northern Ireland, Nordirland, United Kingdom (Northern Ireland))
Provider Provider or authority of a data source. European Commission, Search type Describes how data can be searched in the data source: By address and name attributes (FUZZY) or just identifier based (IDENTIFIER).: IDENTIFIER, website, API, manual search
Release status The release status in terms of development progress or maturity of a product feature or a business capability.<br/><code>EMPTY</code> (0): No feature considered yet, just rough idea for capability.<br/><code>IDEA</code> (1): Just an idea, not yet designed in detail.<br/><code>DESIGN</code> (2): Software design ready, development not yet started.<br/><code>DEVELOPMENT</code> (3): Software development in progress.<br/><code>ALPHA</code> (4): First functional release, in terms of a Minimal Viable Product (MVP).<br/><code>BETA</code> (5): Tested by selected users.<br/><code>RC</code> (6): Release candidate, fully tested, not yet used in production by many customers.<br/><code>LIVE</code> (7): Used in production by customers, fully monitored and supported.<br/><code>DEPRECATED</code> (-1): End of life planned, but still available.<br/><code>EOL</code> (-2): End of life, historic service, no longer available.<br/><code>BROKEN</code> (-3): Service was used in production but is currently not available. However, CDQ tries to repair or reactivate it.<br/><code>DISCONTINUED</code> (-4): The data source has ceased providing updates; nonetheless, we continue to offer the most recent available data. LIVE , Release date Date and time when a concept, e.g. a data quality rule, is released, i.e. when the status changes to <code>RELEASED</code>.: 2016-02-12, Integration type Documents how a data source is integrated into the CDL with respect to data gathering:* <code>REMOTE ACCESS</code>: Data is not stored on CDL side but queried ad-hoc from the data source (e.g. webservices)* <code>COPY</code>: Data is replicated on CDL side (usually already transformed into the target CDL data model)* <code>UNDEFINED</code>: not yet known: REMOTE_ACCESS
Content and data model Category Specifies the category of a data source. The following categories are defined:<br/><code>BUSINESS_PARTNER</code>: The data source provides master data about companies.<br/><code>ADDRESS</code>: The data source provides address reference data.<br/><code>SANCTION_AND_WATCHLIST</code>: A data source that provides sanctioned or watched companies or persons.<br/><code>BANK_ACCOUNT</code>: The data source provides bank and bank account reference data.<br/><code>CERTIFICATE</code>: The data source provides information about business partner certifications.<br/><code>BENEFICIAL_OWNER</code>: The data source provides information about beneficial owners of companies.<br/><code>INSOLVENCY</code>: The data source provides information about insolvencies.<br/><code>HEALTHCARE_PROFESSIONAL</code>: The data source provides information about HCPs.<br/><code>HEALTHCARE_ORGANIZATION</code>: The data source provides information about HCOs.<br/>: BUSINESS_PARTNER, Number of records Counts the number of company records available in the data source: 50,000,000 records , 84 concepts, 30 values, 74 mappings, 2 transformations
Linkage strategy Describes how business partners are linked to this data source, e.g. for activating update monitoring. Typically just a primary identifier of the data source is used such as a business register id. However, in some cases the linkage strategy might be much more complex. EU VATs
Managed concepts Concepts of the CDQ Data Model which are mapped to concepts provided by this data source "Data source/VIES".
Managed identifier(s) identifiers of the CDQ Data Model which are mapped to identifier information provided by this data source, (VIES).
Augmented records This data source may be used to compile augmented records.
See how data source is used

Primary data source The primary data source is the main data source used for augmented records. If a primary data source is defined, all values of a corresponding match are taken over into the augmented record.: n/a

Preferred data source Preferred data sources (one could also say "secondary data sources") are the data sources from which values of augmented records are taken over when </br>* a) there is no primary data source defined or </br>* b) there is no matching record in the primary data source (rare case and should not happen) or </br>* c) there are values that are not provided by the primary data source.</br>If there are several matches from different preferred data sources then </br>* a) the best match of all preferred data sources is taken, then the second, etc. </br>* b) the first data source is taken by coincidence, then a second one by coincidence etc.:

Other data source The "other" data sources contain valuable and enrichable information like identifiers, however should not be considered as a “base record” when creating golden records.: n/a

Unallowed data source Augmented records do not make use of matches of unallowed data sources.:

Quota This data source may be subject to quota limitations.
See which default quota limits apply
  • Maximum Quota (default) The default maximum quota for a data source.: 750000
  • Quota reset (default) The default reset period of a defined quota for a data source.: MONTH
  • Quota control The control of changing the maximum quota and reset period for a data source. </br></br>* CDQ - the quota can be higher than set by CDQ. </br>* CLIENT - the quota can be set higher than the default</br>* CREDENTIAL_DEPENDENT - if a customer uses CDQ credentials to assess the data source then the quota can't be higher than the default, but if the customer uses his own credentials, then the quota can be increased.: CDQ
  • Quota enabled Is the quota management turned on for specific data source.: YES
Update monitoringThis data source may be subject to update monitoring.
See details of update monitoring
Classification Framework to classify external data sources according to legal limitations and/or obligations due to integration and use of these data sources in CDQ's Cloud Services. Data ownership Categorizes legal right-holding by the type of the data owner, e.g. a private organization or a governmental authority.: GOVERNMENTALData source is owned by a governmental body, e.g., a federal, state, or municipal authority., Data provision Categorizes restriction of data access, i.e., whether data sources provide "open" data or require registration.: FREEData is provided for free, but the data source requires registration, i.e., authentication when data is downloaded or queried., Terms type A client or CDQ accepts the terms of use of a particular data source and the compliant use of its data.: CLIENT_CONTRACTEDA client (i.e., the data end user) accepts the terms of a particular data source and the compliant use of its data., legal approval: 2021-08-25, legal approval level: 2024-09-19

Licence URL URL that provides information on the licence of the target: https://ec.europa.eu/taxation customs/vies/#/disclaimer

Credential type Type of a single credential value, like.<br/><code>USERNAME</code>: Username to authenticate, typically used together with a password.<br/><code>PASSWORD</code>: Password to authenticate, typically used together with a username.<br/><code>API_KEY</code>: API key to authenticate.<br/><code>TEILNEHMER_ID</code>: Participant ID (German term, due to specific data sources), to authorize a certain user beside basic authentication with e.g. username and password.<br/><code>EU_VAT_ID_DE</code>: German VAT number to authenticate.<br/><code>EU_VAT_ID_AT</code>: Austrian VAT number to authenticate.<br/><code>EU_VAT_ID</code>: European VAT number to authenticate.<br/><code>BASE_URL</code>: Base URL to use for API communication, e.g., to differentiate testing and production environments.<br/><code>DUNS</code>: DUNS number of the own organization.<br/>: EU_VAT_ID

Concepts

Concept mappings

Download mapping paths

Values

Value mappings

Transformations