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 (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) |
| Countries (ISO 3166-1 alpha-2 codes, or WORLD) for which a data source is the preferred source. Preferred source for | 26 countries
ES, SE, IE, FI, CZ, PL, NL, SK, RO, EE, HR, LV, FR, BE, GR, HU, CY, DK, LU, IT, BG, PT, MT, LT, AT, SI |
| Further countries (ISO 3166-1 alpha-2 codes, or WORLD) a data source covers. Other source for | DE
|
| Date when a data source became active in CDQ's services. Activation date | 2016-02-12 |
| 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 | 2021-08-25 (Date when a legal classification was approved (the last time). Legal approval), 2024-09-19 (Date when the level of the legal classification of a data source was approved (the last time). Legal approval level), 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
| Identifier | Technical name | Parent | Description | CDQ mapping |
|---|---|---|---|---|
| value (VIES) | record/countryCode/value | RECORD (VIES) | The country code of the business partner's VAT registration | Identifier Value (CDQ) Business Partner External ID (CDQ) Country Short Name (CDQ) Identifier Type Technical Key (CDQ) |
| value (VIES) | record/response/countryCode | response (VIES) | The country code of the business partner's VAT registration | Identifier Value (CDQ) Business Partner External ID (CDQ) Country Short Name (CDQ) Identifier Type Technical Key (CDQ) |
| value (VIES) | record/response/vatNumber | response (VIES) | The business partner's EU VAT number | Identifier Value (CDQ) Business Partner External ID (CDQ) |
| value (VIES) | record/vatValue/value | RECORD (VIES) | The business partner's EU VAT number | Identifier Value (CDQ) Business Partner External ID (CDQ) |
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 | Business Partner Name Value (CDQ) Thoroughfare Value (CDQ) Locality Value (CDQ) Post Code Value (CDQ) Locality Type Technical Key (CDQ) Post Code Type Technical Key (CDQ) Thoroughfare Type Technical Key (CDQ) Name Type Technical Key (CDQ) | |
| administrativeAreas (VIES) | record/referenceAddressDto/administrativeAreas | referenceAddressDto (VIES) | Administrative areas of the structured address | |
| careOf (VIES) | record/referenceAddressDto/careOf | referenceAddressDto (VIES) | Care-of recipient of the address | |
| characterSet (VIES) | record/referenceAddressDto/version/characterSet | version (VIES) | Character set of the structured address | |
| contexts (VIES) | record/referenceAddressDto/contexts | referenceAddressDto (VIES) | Contexts of the address: additional information about its usage or recipient | |
| country (VIES) | record/referenceAddressDto/country | referenceAddressDto (VIES) | country root field | |
| countryCode (VIES) | record/countryCode | RECORD (VIES) | countryCode root field | |
| direction (VIES) | record/referenceAddressDto/thoroughfares/direction | thoroughfares (VIES) | Direction of the thoroughfare | |
| externalId (VIES) | record/referenceAddressDto/externalId | referenceAddressDto (VIES) | External identifier of the structured address | |
| formattedAddress (VIES) | record/referenceAddressDto/formattedAddress | referenceAddressDto (VIES) | Formatted representation of the address | |
| geographicCoordinates (VIES) | record/referenceAddressDto/geographicCoordinates | referenceAddressDto (VIES) | Geographic coordinates of the address | |
| identifyingName (VIES) | record/referenceAddressDto/identifyingName | referenceAddressDto (VIES) | Name identifying the address, such as a building name | |
| language (VIES) | record/referenceAddressDto/thoroughfares/language | thoroughfares (VIES) | Language of the thoroughfare name | |
| language (VIES) | record/referenceAddressDto/metadata/language | metadata (VIES) | Language of the address (ISO 639-1) | |
| language (VIES) | record/referenceAddressDto/localities/language | localities (VIES) | Language of the locality name | |
| language (VIES) | record/referenceAddressDto/version/language | version (VIES) | Language of the structured address | |
| localities (VIES) | record/referenceAddressDto/localities | referenceAddressDto (VIES) | Localities of the structured address | |
| metadata (VIES) | record/referenceAddressDto/metadata | referenceAddressDto (VIES) | metadata root field | |
| name (VIES) | record/referenceAddressDto/thoroughfares/type/name | type (VIES) | Name of the thoroughfare type | |
| name (VIES) | record/referenceAddressDto/version/characterSet/name | version (VIES) | Name of the character set of the structured address | |
| name (VIES) | record/response/name | response (VIES) | VAT registered name of the business partner | Business Partner Name Value (CDQ) Language Technical Key (CDQ) Name Type Technical Key (CDQ) |
| name (VIES) | record/referenceAddressDto/thoroughfares/name | thoroughfares (VIES) | Name of the thoroughfare | |
| name (VIES) | record/referenceAddressDto/localities/type/name | type (VIES) | Name of the locality type | |
| name (VIES) | record/referenceAddressDto/version/language/name | version (VIES) | Name of the language of the structured address | |
| number (VIES) | record/referenceAddressDto/thoroughfares/number | thoroughfares (VIES) | House number on the thoroughfare | Thoroughfare Number (CDQ) |
| openingHours (VIES) | record/referenceAddressDto/openingHours | referenceAddressDto (VIES) | Opening hours at the address | |
| postCodes (VIES) | record/referenceAddressDto/postCodes | referenceAddressDto (VIES) | Post codes of the structured address | |
| postalDeliveryPoints (VIES) | record/referenceAddressDto/postalDeliveryPoints | referenceAddressDto (VIES) | Postal delivery points of the structured address | |
| premises (VIES) | record/referenceAddressDto/premises | referenceAddressDto (VIES) | Premises of the structured address | |
| primaryProvenance (VIES) | record/referenceAddressDto/metadata/primaryProvenance | metadata (VIES) | Primary provenance of the address data, i.e. the source it comes from | |
| referenceAddressDto (VIES) | record/referenceAddressDto | RECORD (VIES) | VAT registered address in the CDQ address model | |
| requestDate (VIES) | record/requestDate | RECORD (VIES) | requestDate root field | |
| requestIdentifier (VIES) | record/requestIdentifier | RECORD (VIES) | requestIdentifier root field | |
| response (VIES) | record/response | RECORD (VIES) | Response of the VIES VAT number validation service | |
| shortName (VIES) | record/referenceAddressDto/thoroughfares/shortName | thoroughfares (VIES) | Abbreviated name of the thoroughfare | |
| shortName (VIES) | record/referenceAddressDto/country/shortName | country (VIES) | Country code of the VAT registered address | Country Short Name (CDQ) |
| shortName (VIES) | record/referenceAddressDto/localities/shortName | localities (VIES) | Abbreviated name of the locality | |
| technicalKey (VIES) | record/referenceAddressDto/premises/type/technicalKey | type (VIES) | Technical key of the premise type | Premise Type Technical Key (CDQ) |
| technicalKey (VIES) | record/referenceAddressDto/version/language/technicalKey | version (VIES) | Technical key of the language of the structured address | |
| technicalKey (VIES) | record/referenceAddressDto/thoroughfares/type/technicalKey | type (VIES) | Technical key of the thoroughfare type | Thoroughfare Type Technical Key (CDQ) |
| technicalKey (VIES) | record/referenceAddressDto/version/characterSet/technicalKey | version (VIES) | Technical key of the character set of the structured address | |
| technicalKey (VIES) | record/referenceAddressDto/localities/type/technicalKey | type (VIES) | Technical key of the locality type | Locality Type Technical Key (CDQ) |
| thoroughfares (VIES) | record/referenceAddressDto/thoroughfares | referenceAddressDto (VIES) | Thoroughfares of the structured address | |
| traderAddress (VIES) | record/traderAddress | RECORD (VIES) | traderAddress root field | |
| traderCity (VIES) | record/traderCity | RECORD (VIES) | traderCity root field | |
| traderCityMatch (VIES) | record/traderCityMatch | RECORD (VIES) | traderCityMatch root field | |
| traderCompanyType (VIES) | record/traderCompanyType | RECORD (VIES) | traderCompanyType root field | |
| traderCompanyTypeMatch (VIES) | record/traderCompanyTypeMatch | RECORD (VIES) | traderCompanyTypeMatch root field | |
| traderName (VIES) | record/traderName | RECORD (VIES) | traderName root field | |
| traderNameMatch (VIES) | record/traderNameMatch | RECORD (VIES) | traderNameMatch root field | |
| traderPostcode (VIES) | record/traderPostcode | RECORD (VIES) | traderPostcode root field | |
| traderPostcodeMatch (VIES) | record/traderPostcodeMatch | RECORD (VIES) | traderPostcodeMatch root field | |
| traderStreet (VIES) | record/traderStreet | RECORD (VIES) | traderStreet root field | |
| traderStreetMatch (VIES) | record/traderStreetMatch | RECORD (VIES) | traderStreetMatch root field | |
| type (VIES) | record/referenceAddressDto/thoroughfares/type | thoroughfares (VIES) | Type of the thoroughfare | |
| type (VIES) | record/referenceAddressDto/postCodes/type | postCodes (VIES) | Type of the post code | |
| type (VIES) | record/referenceAddressDto/localities/type | localities (VIES) | Type of the locality | |
| type (VIES) | record/referenceAddressDto/premises/type | premises (VIES) | Type of the premise | |
| types (VIES) | record/referenceAddressDto/types | referenceAddressDto (VIES) | Types of the address | |
| url (VIES) | record/referenceAddressDto/thoroughfares/type/url | type (VIES) | URL of the thoroughfare type | |
| url (VIES) | record/referenceAddressDto/localities/type/url | type (VIES) | URL of the locality type | |
| valid (VIES) | record/valid | RECORD (VIES) | valid root field | |
| value (VIES) | record/response/countryCode | response (VIES) | The country code of the business partner's VAT registration | Identifier Value (CDQ) Business Partner External ID (CDQ) Country Short Name (CDQ) Identifier Type Technical Key (CDQ) |
| value (VIES) | record/traderPostcode/value | RECORD (VIES) | Trader postcode | |
| value (VIES) | record/requestDate/value | RECORD (VIES) | Date when the data for a given VAT number was requested | |
| value (VIES) | record/vatValue/value | RECORD (VIES) | The business partner's EU VAT number | Identifier Value (CDQ) Business Partner External ID (CDQ) |
| value (VIES) | record/response/vatNumber | response (VIES) | The business partner's EU VAT number | Identifier Value (CDQ) Business Partner External ID (CDQ) |
| value (VIES) | record/traderCityMatch/value | RECORD (VIES) | Trader city match | |
| value (VIES) | record/requestIdentifier/value | RECORD (VIES) | Identifier for proving that data was requested for a given VAT number | |
| value (VIES) | record/referenceAddressDto/thoroughfares/value | thoroughfares (VIES) | Full value of the thoroughfare of the VAT registered address | Thoroughfare Value (CDQ) |
| value (VIES) | record/countryCode/value | RECORD (VIES) | The country code of the business partner's VAT registration | Identifier Value (CDQ) Business Partner External ID (CDQ) Country Short Name (CDQ) Identifier Type Technical Key (CDQ) |
| value (VIES) | record/referenceAddressDto/premises/value | referenceAddressDto (VIES) | Premise of the address, such as a floor or unit | Premise Value (CDQ) |
| value (VIES) | record/traderStreetMatch/value | RECORD (VIES) | Trader street match | |
| value (VIES) | record/traderName/value | RECORD (VIES) | VAT registered name of the business partner | Business Partner Name Value (CDQ) Language Technical Key (CDQ) Name Type Technical Key (CDQ) |
| value (VIES) | record/traderCity/value | RECORD (VIES) | Trader city | |
| value (VIES) | record/traderPostcodeMatch/value | RECORD (VIES) | Trader postcode match | |
| value (VIES) | record/traderCompanyTypeMatch/value | RECORD (VIES) | Trader company type match | |
| value (VIES) | record/referenceAddressDto/localities/value | localities (VIES) | Name of the locality of the VAT registered address | Locality Value (CDQ) |
| value (VIES) | record/referenceAddressDto/careOf/value | careOf (VIES) | Name of the care-of recipient of the address | Care Of Value (CDQ) |
| value (VIES) | record/referenceAddressDto/country/value | country (VIES) | Country name of the VAT registered address | Country Value (CDQ) |
| value (VIES) | record/referenceAddressDto/identifyingName/value | identifyingName (VIES) | Value of the name identifying the address | Address Identifying Name Value (CDQ) |
| value (VIES) | record/traderCompanyType/value | RECORD (VIES) | Trader company type | |
| value (VIES) | record/response/valid | response (VIES) | Returns whether the given VAT number is valid | Identifier Status Technical Key (CDQ) |
| value (VIES) | record/referenceAddressDto/postCodes/value | postCodes (VIES) | Post code of the VAT registered address | Post Code Value (CDQ) |
| value (VIES) | record/valid/value | RECORD (VIES) | Returns whether the given VAT number is valid | Identifier Status Technical Key (CDQ) |
| value (VIES) | record/traderStreet/value | RECORD (VIES) | Trader street | |
| value (VIES) | record/traderNameMatch/value | RECORD (VIES) | Trader name match | |
| value (VIES) | record/traderAddress/value | RECORD (VIES) | VAT registered address of the business partner | |
| vatValue (VIES) | record/vatValue | RECORD (VIES) | vatValue root field | |
| version (VIES) | record/referenceAddressDto/version | referenceAddressDto (VIES) | Character set and language version of the structured address |