VIN CodeUser- or Servicekey to identify caller. Used for billing and ACL restrictions.
Format: COMPANY-APPLICATION-ENVIRONMENT-SECRET:SUFFIX
Where COMPANY,APPLICATION,SECRET delivered by ETG,
ENVIRONMENT - one of: proto,dev,test,preprod,live
SUFFIX - Optional any string, consists of letter,numbers or following chars: ".", "-", " ", ","
Required field with request settingsVIN to process
This field has to be used in a second
request using the same VIN to specify
one vehicle out of a former resulting
list of vehicles (SchwackeCode, NatCode, ETG Code)
true = output of webservice will include
all defined technical fields of vehicle
and option descriptions; false = output
contains only the minimum of defined
fields
Optional input stream which will be used
instead of calling the official
manufacturer VIN webservice. Format must
be identical to output of manufacturer
VIN webservice. Empty in normal case
the same as InputStream1change behavoiur of weservice itself or only logging part.
Request's variable "ServiceId" should allow setting ServiceCode
SERVICECODE_ERROR = 1; // bad failures, exceptions and so on
SERVICECODE_WARNING = 2; // not very bad failures, that can change result
SERVICECODE_NOCACHE = 32; // do not use local cache
SERVICECODE_NOREQUEST = 64; // do not request remote servers
SERVICECODE_DEBUG_INOUT = 128; // show incoming request / outgoing result
SERVICECODE_DEBUG_FUNC1 = 256; // show only main functions call/return
SERVICECODE_DEBUG_FUNC2 = 512; // show only middle functions call/return
SERVICECODE_DEBUG_FUNC3 = 1024; // show only small functions call/return
SERVICECODE_DEBUG_NET = 2048; // network/disk/cache IO
SERVICECODE_DEBUG_SQL = 4096; // SQL queries
SERVICECODE_INFO1 = 8192; // Program workflow (less debug)
SERVICECODE_INFO2 = 16384; // Program workflow (more debug)
SERVICECODE_INFO3 = 32768; // Program workflow (more debug)
Valuation of vehicle can be done by filling this structure. If it's empty - no valuation will be proceed
EurotaxGlass's MakeId which is the
EXPECTED value of the caller after
decoding the VIN.
The webservice will only continue if the
ExpectedMakeId is equal to the decoded
MakeId based on the VIN decoder phase 1,
otherwise it returns failure. This is important
if you want to ensure that no call to
the manufacturer is made until the VIN
is part of the EXPECTED
Manufacturer/MakeId.
This feature is also useful for the
client to compare a pre-selected Make
(ETG based) with the decoded Make based
on the VIN without the need to implement
the VIN decode logic (step 1) by itself.
User- or Servicekey to identify caller. Used for billing and ACL restrictions.
Format: COMPANY-APPLICATION-ENVIRONMENT-SECRET:SUFFIX
Where COMPANY,APPLICATION,SECRET delivered by ETG,
ENVIRONMENT - one of: proto,dev,test,preprod,live
SUFFIX - Optional any string, consists of letter,numbers or following chars: ".", "-", " ", ","
Change the internal equipment behavior,
if there is more then one clearly result
this flag decides which result to use.
0 = Behavior as today, no change in equipment logic.
1 = Return the cheapest equipment.
2 = Return the expensive equipment.
Optional company name: should refer to a unique business name. For instance, “Joe’s Garage”
Optional company address: is a single string containing the main address of that business. For instance, “1 High Street, London, UK, WC1A 4BG”
Settings, which VinSearch used to
process this VIN
VIN Code
Array with vehicles, which are found
Equipment, found via direct in-country
mapping
Esacos, extracted from field "Equipment"
0 - No error; 1 - Fatal/configuration
error. Admin help required; 2 -
Temporary failure like failed DB/third
party WS connection. Please retry later
or call Admin; 3 - Input data error.
Invalid VIN or nothing returned from
DB/third party WS for this VIN. Please
try other input data or call Admin; 999
- Unknown failure. Please call Richter
und Poweleit GmbH;
description of error
Error tag for later investigtion of
problems
Equipment, found via cross-country
mapping (reference market). Not always
perfect
Esacos, extracted from extEquipment
Valuation values
EurotaxGlass's MakeId which is DETECTED
after decoding the VIN.
This is useful for the client to compare
a pre-selected Make (ETG data based)
with the decoded Make based on the VIN
without the need to implement the VIN
decode logic by itself.
Structure of original Manufacturer
Equipment Answer
Equipment, which cannot be detected or
parsed by VinSearch engine
Production date of vehicle, if available
Delivery date, if available If not
available, RegistrationDate, SellDate or
similar date will be used, if available
Registration Date of Vehicle, used in
internal mapping (e.g. VehicleType,
EquipmentOptions). If not delivered by
Manufacturer, one of DeliveryDate or
ProductionDate will be used. It can be
changed by the system to the nearest
border of Vehicle->PeriodOfBuild Dates
if original RegistrationDate was out of
the borders.
Text description of colour, returned by
Manufacturer
Text description of colour, returned by
Manufacturer
Description of Top Colour, returned by
Manufacturer
ISO country code of delivery market
Manufacturer data decoded from the VIN codeETG Code (SchwackeCode, NatCode) of found vehicleDescription of manufacturerDescription of modelETG Vehicle Type Code of found vehicledescription of type of model
engine size in ccm
engine power in PSengine power in KWwhen this model were producedFuel typebody type (limousine, cabrio, etc..)number of doorsnumber of gearsGearbox type (automatic, manual)
The Period of build using dedicated
fields for month and year instead of
string (see also "PeriodOfBuild"). If
PoBUntilMonth and -Year is missing, the
vehicle is still build without a actual
limitation from manufacturer.
Price of new vehicle in the production timePrice of new vehicle in the production timeSettings for country, language, response format etc.ISO country codeISO language codeVersion of programVersion of mapping logicVersion of IDD dataCommon data type for date representationday of the monthmonthyearETG-wide unique user nameUser passwordETG-wide unique user ID / user signatureUser authentication dataVersion of global ETG services specification used to construct the responseIndicates that the processing of this request has failed, and provides error and optional warning messages that arose during the processing.Indicates that the processing of this request has succeeded; may provide non-fatal warning messages that arose during the processing.Processing start timestampProcessing finish timestampPlaceholder for general status report. To be filled out before sending a response back to the originator.Top level error or warning codeTop level error or warning descriptionExtended error or warning code. Can be service specificExtended error or warning description.Settings for country (market), language, response format etc.Manufacturer internal code (ordercode)
Soa Code (SA Code, ETG EQ Code) of this equipmentPrice of option in production timePrice of option in production timedescription of equipmentPeriod of buildPeriod of build1 - this equipment is a package of other equipments
0 - stand-alone equipmentEsaco codes of this equipmentmerchantability
0 - Standart / serial equipment; 1 -
Standart option / free; 2 - Option at
extra charge; 3 - Option price not
given; 4 - Option not available yet; 5 -
Mandatory at extra charge;
Esaco codeEsaco DescriptionRegistration year of vehicle. required only if valuation should be doneRegistration month of vehicle. required only if valuation should be doneKM. required only if valuation should be doneOriginal order code of equipment of manufacturerOriginal equipment description of manufacturerPlease check field ServiceId in method 'Decode'Vins in cachePlease check field ServiceId in method 'Decode'market descriptionMain function to map VIN code to ETG datGet version of Program, interne logic, IDD DatInternal function to fetch cached VINs. ServiceCode field dependend.
Get markets, available in VinSearch