VIES (data source)
DataSource:VIES
| Property | Value |
|---|---|
| Identifiers | VIES (The ALEI prefix element is the ISO 3166-2 code for country and subdivision if applicable followed by the stop character <code>.</code>. 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 ALEI prefix), VIES (A technical identifier, unique in a certain context. Technical key)
|
| Language-specific short name. Monolingual short name | VIES (en) |
| Language-specific name. Monolingual name | VAT Information Exchange System (en) |
| An informal and short human-readable definition of a concept, in terms of a 'one-liner'. Short description | Official interface to the European MIAS database. |
| The country a linked concept is active or generally relevant for. Country scope | LV (Latvia), RO (Romania), GR (Greece), SE (Sweden), ES (Spain), XI (Northern Ireland, United Kingdom (Northern Ireland)), LT (Lithuania), DE (Germany), FR (France), DK (Denmark), EE (Estonia), SK (the Slovak Republic), IT (Italy), FI (Finland), HU (Hungary), CZ (Czechia), MT (Malta), CY (Cyprus), PT (Portugal), IE (Ireland), BG (Bulgaria), SI (Slovenia), BE (Belgium), LU (Luxembourg), AT (Austria), HR (Croatia), PL (Poland), NL (Netherlands) |
| Data access | European Commission (Provider or authority of a data source. Provider), website (URL that provides more information for a given concept. URL), API (URL that provides direct access to the data of a data source. Deep URL), IDENTIFIER (Search type (data sources)<br/>Describes how data can be searched in a data source.<br/>IDENTIFIER: Data can be searched by business identifiers.<br/>INDEX: Data can be searched by business identifiers.<br/>FUZZY: Data can be searched by address and name attributes. Search type)
|
| The release status in terms of development progress or maturity.<br/><code>EMPTY</code> (0): No feature considered yet, just a rough idea.<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. Release status | LIVE, REMOTE_ACCESS (Documents how a data source is integrated into the CDL with respect to data gathering:<br/><code>REMOTE ACCESS</code>: Data is not stored on CDL side but queried ad-hoc from the data source (e.g. webservices)<br/><code>COPY</code>: Data is replicated on CDL side (usually already transformed into the target CDL data model)<br/><code>UNDEFINED</code>: not yet known Integration type)
|
| Content | BUSINESS_PARTNER (Data source category<br/>Specifies the category of a data source in terms of the content.<br/>ADDRESS: The data source provides address reference data.<br/>BANK_ACCOUNT: The data source provides bank and bank account reference data.<br/>BENEFICIAL_OWNER: The data source provides information about beneficial owners of companies.<br/>BUSINESS_PARTNER: The data source provides master data about companies.<br/>CERTIFICATE: The data source provides information about business partner certifications.<br/>HEALTHCARE_ORGANIZATION: The data source provides information about HCOs.<br/>HEALTHCARE_PROFESSIONAL: The data source provides information about HCPs.<br/>INSOLVENCY: The data source provides information about insolvencies.<br/>SANCTION_AND_WATCHLIST: A data source that provides sanctioned or watched companies or persons. Data source category), 50,000,000 (Counts the number of company records available in the data source. Number of records) , 90 concepts, 30 terms
|
| Legal classification | 2020-01-01 (Date when a legal classification was approved (the last time). Legal approval), GOVERNMENTAL (Data ownership<br/>Categorizes legal right-holding by the type of the data owner, e.g. a private organization or a governmental authority.<br/>GOVERNMENTAL: The data source is owned by a governmental body, e.g., a federal, state, or municipal authority.<br/>PRIVATE: The data source is owned by a private body, e.g., a company or an association. Data ownership), FREE (Data provision<br/>Categorizes restriction of data access, i.e., whether a data source provides "open" data or requires registration.<br/>FREE: Data is provided for free, but the data source requires registration, i.e., authentication when data is downloaded or queried.<br/>OPEN: Data is provided for free and unlimited access without registration or subscription.<br/>COMMERCIAL: Data is not provided for free, but users of the data source have to pay for downloading, querying, or using the data according to a commercial contract. Data provision), CLIENT_CONTRACTED (Terms type<br/>A client or CDQ accepts the terms of use of a particular data source and the compliant use of its data.<br/>NO_TERMS: No specific terms of use are provided for a data source.<br/>STANDARD: A standard licence is used, further details are provided by license type information of the data source.<br/>EU_PUBLIC: The data source is provided by a governmental organization under EU law, i.e., from "within" a EU member country.<br/>EU_PRIVATE: The data source is provided by a private organization under EU law, i.e., from "within" a EU member country.<br/>CDQ_CONTRACTED: CDQ accepts the terms of a particular data source and the compliant use of its data.<br/>CLIENT_CONTRACTED: A client (i.e., the data end user) accepts the terms of a particular data source and the compliant use of its data. Terms type), https://ec.europa.eu/taxation customs/vies/#/disclaimer (URL that provides more information on a license, e.g., of a data source. License URL)
|
| Quota | 750,000 (The default maximum quota for a data source. Maximum Quota (default)), MONTH (Quota reset<br/>The default reset period of a defined quota for a data source.<br/>DAY: The quota of the data source is reset daily.<br/>WEEK: The quota of the data source is reset weekly.<br/>MONTH: The quota of the data source is reset monthly.<br/>YEAR: The quota of the data source is reset yearly. Quota reset (default)), CDQ (Quota control<br/>The control of changing the maximum quota and reset period for a data source.<br/>CDQ: The quota of the data source can be higher than set by CDQ.<br/>CLIENT: The quota of the data source 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 customers use their own credentials, then the quota can be increased. Quota control), YES (Quota enablement<br/>whether the quota management is turned on for a specific data source.<br/>YES: A quota is enabled for the data source.<br/>NO: The data source does not have an enabled quota. Quota enabled)
|
| Update monitoring | YES (Update monitor enablement<br/>whether the update monitoring is turned on for a specific data source.<br/>YES: An update monitor is enabled for the data source.<br/>NO: For the data source, no update monitor is enabled. Update monitoring enabled), Every 6th day of the month at 01:00 (Date and time when a data source is checked to find updates. Update frequency)
|
Managed business identifiers
No managed business identifiers in VIES
Data model concepts
| Concept | Technical name | Parent | Description | CDQ mapping |
|---|---|---|---|---|
| RECORD (VIES) | record | An artificial record that wraps one record, i.e. a row in the data source file | Thoroughfare Value (CDQ) Locality Value (CDQ) Post Code Value (CDQ) Locality Type (CDQ) Thoroughfare Type (CDQ) Post Code Type (CDQ) | |
| administrativeAreas (VIES) | referenceAddressDto_administrativeAreas | referenceAddressDto (VIES) | ||
| careOf (VIES) | referenceAddressDto_careOf | referenceAddressDto (VIES) | ||
| characterSet (VIES) | referenceAddressDto_version_characterSet | version (VIES) | ||
| contexts (VIES) | referenceAddressDto_contexts | referenceAddressDto (VIES) | ||
| country (VIES) | referenceAddressDto_country | referenceAddressDto (VIES) | country root field | |
| countryCode (VIES) | countryCode | RECORD (VIES) | countryCode root field | |
| direction (VIES) | referenceAddressDto_thoroughfares_direction | thoroughfares (VIES) | ||
| externalId (VIES) | referenceAddressDto_externalId | referenceAddressDto (VIES) | ||
| formattedAddress (VIES) | referenceAddressDto_formattedAddress | referenceAddressDto (VIES) | ||
| geographicCoordinates (VIES) | referenceAddressDto_geographicCoordinates | referenceAddressDto (VIES) | ||
| identifyingName (VIES) | referenceAddressDto_identifyingName | referenceAddressDto (VIES) | ||
| language (VIES) | referenceAddressDto_localities_language | localities (VIES) | ||
| language (VIES) | referenceAddressDto_version_language | version (VIES) | ||
| language (VIES) | referenceAddressDto_thoroughfares_language | thoroughfares (VIES) | ||
| language (VIES) | referenceAddressDto_metadata_language | metadata (VIES) | ||
| localities (VIES) | referenceAddressDto_localities | referenceAddressDto (VIES) | ||
| metadata (VIES) | referenceAddressDto_metadata | referenceAddressDto (VIES) | metadata root field | |
| name (VIES) | referenceAddressDto_version_language_name | version (VIES) | ||
| name (VIES) | referenceAddressDto_thoroughfares_type_name | type (VIES) | ||
| name (VIES) | referenceAddressDto_version_characterSet_name | version (VIES) | ||
| name (VIES) | response_name | response (VIES) | ||
| name (VIES) | referenceAddressDto_thoroughfares_name | thoroughfares (VIES) | ||
| name (VIES) | referenceAddressDto_localities_type_name | type (VIES) | ||
| number (VIES) | referenceAddressDto_thoroughfares_number | thoroughfares (VIES) | Thoroughfare Number (CDQ) | |
| openingHours (VIES) | referenceAddressDto_openingHours | referenceAddressDto (VIES) | ||
| postCodes (VIES) | referenceAddressDto_postCodes | referenceAddressDto (VIES) | ||
| postalDeliveryPoints (VIES) | referenceAddressDto_postalDeliveryPoints | referenceAddressDto (VIES) | ||
| premises (VIES) | referenceAddressDto_premises | referenceAddressDto (VIES) | ||
| primaryProvenance (VIES) | referenceAddressDto_metadata_primaryProvenance | metadata (VIES) | ||
| referenceAddressDto (VIES) | referenceAddressDto | RECORD (VIES) | ||
| requestDate (VIES) | requestDate | RECORD (VIES) | requestDate root field | |
| requestIdentifier (VIES) | requestIdentifier | RECORD (VIES) | requestIdentifier root field | |
| response (VIES) | response | RECORD (VIES) | Inferred from the paths of the concepts below it. The source metadata declares no concept of its own for this node. | |
| shortName (VIES) | referenceAddressDto_country_shortName | country (VIES) | ||
| shortName (VIES) | referenceAddressDto_localities_shortName | localities (VIES) | ||
| shortName (VIES) | referenceAddressDto_thoroughfares_shortName | thoroughfares (VIES) | ||
| technicalKey (VIES) | referenceAddressDto_premises_type_technicalKey | type (VIES) | Premise Type (CDQ) | |
| technicalKey (VIES) | referenceAddressDto_version_language_technicalKey | version (VIES) | ||
| technicalKey (VIES) | referenceAddressDto_thoroughfares_type_technicalKey | type (VIES) | Thoroughfare Type (CDQ) | |
| technicalKey (VIES) | referenceAddressDto_version_characterSet_technicalKey | version (VIES) | ||
| technicalKey (VIES) | referenceAddressDto_localities_type_technicalKey | type (VIES) | Locality Type (CDQ) | |
| thoroughfares (VIES) | referenceAddressDto_thoroughfares | referenceAddressDto (VIES) | ||
| traderAddress (VIES) | traderAddress | RECORD (VIES) | traderAddress root field | |
| traderCity (VIES) | traderCity | RECORD (VIES) | traderCity root field | |
| traderCityMatch (VIES) | traderCityMatch | RECORD (VIES) | traderCityMatch root field | |
| traderCompanyType (VIES) | traderCompanyType | RECORD (VIES) | traderCompanyType root field | |
| traderCompanyTypeMatch (VIES) | traderCompanyTypeMatch | RECORD (VIES) | traderCompanyTypeMatch root field | |
| traderName (VIES) | traderName | RECORD (VIES) | traderName root field | |
| traderNameMatch (VIES) | traderNameMatch | RECORD (VIES) | traderNameMatch root field | |
| traderPostcode (VIES) | traderPostcode | RECORD (VIES) | traderPostcode root field | |
| traderPostcodeMatch (VIES) | traderPostcodeMatch | RECORD (VIES) | traderPostcodeMatch root field | |
| traderStreet (VIES) | traderStreet | RECORD (VIES) | traderStreet root field | |
| traderStreetMatch (VIES) | traderStreetMatch | RECORD (VIES) | traderStreetMatch root field | |
| type (VIES) | type | premises (VIES) | Inferred from the paths of the concepts below it. The source metadata declares no concept of its own for this node. | |
| type (VIES) | referenceAddressDto_thoroughfares_type | thoroughfares (VIES) | ||
| type (VIES) | referenceAddressDto_postCodes_type | postCodes (VIES) | ||
| type (VIES) | referenceAddressDto_localities_type | localities (VIES) | ||
| types (VIES) | referenceAddressDto_types | referenceAddressDto (VIES) | ||
| url (VIES) | referenceAddressDto_thoroughfares_type_url | type (VIES) | ||
| url (VIES) | referenceAddressDto_localities_type_url | type (VIES) | ||
| valid (VIES) | valid | RECORD (VIES) | valid root field | |
| value (VIES) | traderCompanyTypeMatch_value | RECORD (VIES) | Trader company type match | |
| value (VIES) | referenceAddressDto_localities_value | localities (VIES) | Locality Value (CDQ) | |
| value (VIES) | referenceAddressDto_careOf_value | careOf (VIES) | Care Of Value (CDQ) | |
| value (VIES) | referenceAddressDto_country_value | country (VIES) | Country Value (CDQ) | |
| value (VIES) | referenceAddressDto_identifyingName_value | identifyingName (VIES) | Address Identifying Name Value (CDQ) | |
| value (VIES) | traderCompanyType_value | RECORD (VIES) | Trader company type | |
| value (VIES) | response_valid | response (VIES) | Returns whether the given VAT number is valid | |
| value (VIES) | referenceAddressDto_postCodes_value | postCodes (VIES) | Post Code Value (CDQ) | |
| value (VIES) | valid_value | RECORD (VIES) | Returns whether the given VAT number is valid | |
| value (VIES) | traderStreet_value | RECORD (VIES) | Trader street | |
| value (VIES) | traderNameMatch_value | RECORD (VIES) | Trader name match | |
| value (VIES) | traderAddress_value | RECORD (VIES) | VAT registered address of the business partner | |
| value (VIES) | response_countryCode | response (VIES) | The country code of the business partner's VAT registration | |
| value (VIES) | traderPostcode_value | RECORD (VIES) | Trader postcode | |
| value (VIES) | requestDate_value | RECORD (VIES) | Date when the data for a given VAT number was requested | |
| value (VIES) | vatValue_value | RECORD (VIES) | The business partner's EU VAT number | |
| value (VIES) | response_vatNumber | response (VIES) | The business partner's EU VAT number | |
| value (VIES) | traderCityMatch_value | RECORD (VIES) | Trader city match | |
| value (VIES) | requestIdentifier_value | RECORD (VIES) | Identifier for proving that data was requested for a given VAT number | |
| value (VIES) | referenceAddressDto_thoroughfares_value | thoroughfares (VIES) | Thoroughfare Value (CDQ) | |
| value (VIES) | countryCode_value | RECORD (VIES) | The country code of the business partner's VAT registration | |
| value (VIES) | referenceAddressDto_premises_value | referenceAddressDto (VIES) | Premise Value (CDQ) | |
| value (VIES) | traderStreetMatch_value | RECORD (VIES) | Trader street match | |
| value (VIES) | traderName_value | RECORD (VIES) | VAT registered name of the business partner | |
| value (VIES) | traderPostcodeMatch_value | RECORD (VIES) | Trader postcode match | |
| value (VIES) | traderCity_value | RECORD (VIES) | Trader city | |
| vatValue (VIES) | vatValue | RECORD (VIES) | vatValue root field | |
| version (VIES) | referenceAddressDto_version | referenceAddressDto (VIES) |