Import Calculator API v3

Documentation to calculate Import details.

Introduction

Overview

EuroStocks will provide import vehicle calculation details. v3 is updated Import Calculator with support of more input fields and more flexible to use.

Documentation can be incomplete and/or outdated, Contact EuroStocks team by sending an email on [email protected] for any questions regarding API.

Prerequisites

Import Calculator API access can be granted to suppliers who want to get import details, and it requires username, password and API Key to access the API.

Limited support for the development process and maintenance: Please note that all examples provided in our documentation are considered as guidelines for your development process but EuroStocks for itself is not able to directly assist with any of your preferred programming languages and/or used scripts.

Working with Import calculator API

Import Calculation

GET https://services.eurostocks.com/api/v3/vehicleimportcalculation/vehicleimportpricecalculation/{co2Emission}/{vehiclePrice}/{fuelType}/{mileage}?firstRegistrationDate={date}&vehicleType={vehicleTypeKey}

Request Headers

Name	Type	Description
UserName*	String	Username which EuroStocks provides
Password*	String	Password which EuroStocks provides
APIKey*	String	APIKey which EuroStocks provides

Request Parameters

Name	Type	Description
co2Emission*	Number	CO2 emission Value
vehiclePrice*	Number	Price of the vehicle
fuelType*	String	Fuel Types: pertrol, diesel, hybrid, hybrid_diesel, electricity
mileage*	Number	Mileage of the vehicle
firstRegistrationDate	Date	Formate should be {YYYY-MM-DD} OR {YYYY-MM} Example: 2018-01-11 OR 2018-01 Note: This Parameter is not mandatory By default, it would take today's Date into consideration for calculations
vehicleType	String	VehicleType key of Car or Van up to 7.5 ton Example: AUTOS OR VAN_UP_TO_7500 Note: This Parameter is not mandatory By default, it would take AUTOS into consideration for calculations

Response Model

200: OK

{
  "Status": 0,
  "Message": "string",
  "Result": {
    "BrutoBpm": 0,
    "AgeDiscount": 0,
    "RestBpm": 0,
    "NlPrice": 0
  }
}

Examples

Sample Success Request

GET /api/v3/vehicleimportcalculation/vehicleimportpricecalculation/42/66500/HYBRID_DIESEL/34000?firstRegistrationDate=2021-12-01&vehicleType=AUTOS
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK						
{
  "Status": 200,
  "Message": "",
  "Result": {
    "BrutoBpm": 1488,
    "AgeDiscount": 854.4096,
    "RestBpm": 633.5904,
    "NlPrice": 67133.5904
  }
}

Sample Failed Request

GET /api/v3/vehicleimportcalculation/vehicleimportpricecalculation/42/66500/HYBRID_DIESEL/34000?firstRegistrationDate=2&vehicleType=AUTOS
HOST: services.eurostocks.com
Content-type: "application/json"

Sample Failed Response

HTTP/1.1 500 ERROR						
{
  "Status": -2,
  "Message": "String was not recognized as a valid DateTime."
}