Product Data API

Data Supplier API Documentation

Introduction

Overview

The EuroStocks Product-Data-Supplier-API is an interface to store Product to the EuroStocks-database and make them available on the platform as classified ads. It allows users to do all necessary operations like Get, Add, Update and Delete an ad information.

Documentation can be incomplete and/or outdated, Contact EuroStocks team by sending an email on api@eurostocks.com for any questions regarding API.

The API is available at this base URL:

https://products-data-api.eurostocks.com

Main features

  • Create a new ad

  • Update an ad

  • Deactivate an ad

  • Activate an ad

  • Delete an ad

  • Undelete an ad

  • Update Stock

  • Upload images

  • Change the order of existing images

  • Delete image

  • Get location Information

  • Products by LocationId

  • Inactive Products by LocationId

  • Deleted Products by LocationId

  • Product details by LocationId and EuroStocksAdId

  • Fitments Makes

  • Fitments Models

  • Fitments Types

Prerequisites

Product Data supplier API access can be granted to suppliers who wants to send EuroStocks Product informations, and it required username, password and API Key to access 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.

Test Account

A test environment can be provided. Please ask for the test account details and all the information will be used as mention in Prerequisites on test API url https://test-products-data-api.eurostocks.com Note: Test data will be removed time to time.

Working with Ad Data

Overview

Product Supplier API allows you to manage your Product inventory in a programmatic way and integrate it with other applications. It allows users to do all necessary operations like Get, Add, Update and Delete an ad information.

Generate sample request click here.

Platform Meta Data

eurostocksAdId

The unique identifier for an ad object on EuroStocks platform. Example: 123456

locationId

Reference to the company's location of this ad information. Example: 1234567

imageCount

No. of images supplier will sent for requested new Product

Product Data

Main categories to add products. Example: Accessoires or Auto onderdelen

Sub categories to add products. Example: Audio en toebehoren (universeel) or Bagage en Transport

Product types. Example: Afstandsbediening radio or Antenne

price

Additional Ad Information

condition

Provides Product Condition. For example : NEW or USED

delivery

Provides Product Delivery type. For example : Ophalen or Ophalen of verzenden

stock

Provides Product stock.

unlimitedStock

Provides Product unlimitedStock.

allowOrderForOutOfStock

Provides Product allowOrderForOutOfStock.

weight

Provides Product weight.

warehouseLocation

Provides Product warehouseLocation.

internalNumber

Provides Product internalNumber.

eanNumber

Provides Product eanNumber.

Provides all the feature available for selected Product type. For example: MONTAGE_MOGELIJK and SCHADE_OVERIGE_CATEGORIEEN.

Provides all the feature values available for selected feature. For example: AVAILABILITY = "RESERVED".

Provides all the attribute available for selected Product type. For example: MONTAGE_KOSTEN.

productInfo

Provides multilingual attributes which allows to add attribute for different languages. For example: PRODUCT_TITLE and PRODUCT_SPECIFIC_DESCRIPTION.

priceInfo

Provides price information which will allow to calculate price. For example : PRICE_ON_REQUEST

ktypes

Using ktypes Products can have its make, model and types.

oemNumbers

Multiple oemnumbers are allowed. Max length for a oemNumber is 20 characters. alphanumeric characters are allowed. Spaces are allowed. - / \ and + is allowed.

How Ad Data Are Rendered

Representation as JSON data in Supplier API

This is an ad fragment in JSON format for demonstration purposes only, some fields are not included.

{
   "eurostocksAdId":null,
   "locationId":1,
   "imageCount":"2",
   "mainCategory":"ACCESSORIES",
   "subCategory":"EXTERIOR",
   "productType":"BED_COVER",
   "condition":"NEW",
   "delivery":"ONLY_PICKUP",
   "stock":"10",
   "weight":"25",
   "priceInfo":{
      "PRICE":"125.99",
      "DISCOUNTED_PRICE":"110.49"
   },
   "ktypes":[
       14518
	  ,13535
	  ,13536
      ,13537
      ,13579
   ],
   "oemNumbers":[
      "120","130","140"
   ],
   "productInfo":[
      {
         "LANGUAGE_ISO_CODE":"nl",
         "PRODUCT_TITLE":"Test Product Created",
		 "EXTERNAL_PRODUCT_URL": "https://testProduct.com",
         "PRODUCT_SPECIFIC_DESCRIPTION":"NL : product Descriptions"
      },
      {
         "LANGUAGE_ISO_CODE":"en",
         "PRODUCT_TITLE":"EN : Test Product Created",
		 "EXTERNAL_PRODUCT_URL": "https://testProduct.com",
         "PRODUCT_SPECIFIC_DESCRIPTION":"EN : product Descriptions"
      }
   ],
   "features":{
      "DAMAGE_OTHER_CATEGORIES":"YES",
      "AVAILABILITY":"RESERVED"
   },
   "attributes":{	  
      "DIMENSIONS_HEIGHT":"8",
      "DIMENSIONS_LENGTH":"10",
      "DIMENSIONS_WIDTH":"12"
   }
}

Create a new ad

Create a new ad

POST https://services.eurostocks.com/api/v1/productdatasupplier/productdetails

Markplaats, 2dehands and webshop will take few minutes to reflect changes. Please note, when creating a new product, activating a product or undeleting a product by default it will not get automatically added to Marktplaats.nl and/or 2dehands.be. If you want to change this behavior, please contact Eurostocks.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Data Types

RequestSuccess Response

n/a

Sample Success Request

POST /api/v1/productdatasupplier/productdetails/
HOST: products-data-api.eurostocks.com

{
   "eurostocksAdId":null,
   "locationId":1,
   "imageCount":"2",
   "mainCategory":"ACCESSORIES",
   "subCategory":"EXTERIOR",
   "productType":"BED_COVER",
   "condition":"NEW",
   "delivery":"ONLY_PICKUP",
   "stock":"10",
   "weight":"25",
   "priceInfo":{
      "PRICE":"125.99",
      "DISCOUNTED_PRICE":"110.49"
   },
   "ktypes":[
       14518
	  ,13535
	  ,13536
      ,13537
      ,13579
   ],
   "oemNumbers":[
      "120","130","140"
   ],
   "productInfo":[
      {
         "LANGUAGE_ISO_CODE":"nl",
         "PRODUCT_TITLE":"Test Product Created",
		 "EXTERNAL_PRODUCT_URL": "https://testProduct.com",
         "PRODUCT_SPECIFIC_DESCRIPTION":"NL : product Descriptions"
      },
      {
         "LANGUAGE_ISO_CODE":"en",
         "PRODUCT_TITLE":"EN : Test Product Created",
		 "EXTERNAL_PRODUCT_URL": "https://testProduct.com",
         "PRODUCT_SPECIFIC_DESCRIPTION":"EN : product Descriptions"
      }
   ],
   "features":{
      "DAMAGE_OTHER_CATEGORIES":"YES",
      "AVAILABILITY":"RESERVED"
   },
   "attributes":{      
      "DIMENSIONS_HEIGHT":"8",
      "DIMENSIONS_LENGTH":"10",
      "DIMENSIONS_WIDTH":"12"
   }
}

Sample Success Response

HTTP/1.1 201 Created
{
    "eurostocksAdId": 339584,
    "eurostocksUrl": "https://directautos.eu/nl/accessoires/exterieur/bed-cover/product/339584/test-product-created"
}

Sample Error Request

POST /api/v1/productdatasupplier/productdetails/
HOST: products-data-api.eurostocks.com


{
   "eurostocksAdId":null,
   "locationId":1,
   "imageCount":"2",
   "mainCategory":"ACCESSORIES",
   "subCategory":"EXTERIOR",
   "productType":"BED_COVER",
   "condition":"NEW",
   "delivery":"ONLY_PICKUP",
   "stock":"10",
   "weight":"25",
   "priceInfo":{
      "PRICE":"125.99",
      "DISCOUNTED_PRICE":"110.49"
   },
   "ktypes":[
       14518
	  ,13535
	  ,13536
      ,13537
      ,13579
   ],
   "oemNumbers":[
      "110",
      "120"
   ],
   "productInfo":[
      {
         "LANGUAGE_ISO_CODE":"nl",
         "PRODUCT_TITLE":"Test Product Created",
         "PRODUCT_SPECIFIC_DESCRIPTION":"NL : product Descriptions"
      },
      {
         "LANGUAGE_ISO_CODE":"en",
         "PRODUCT_TITLE":"EN : Test Product Created",
         "PRODUCT_SPECIFIC_DESCRIPTION":"EN : product Descriptions"
      }
   ],
   "features":{
      "DAMAGE_OTHER_CATEGORIES":"YES",
      "AVAILABILITY":"RESERVED"
   },
   "attributes":{
      "DIMENSIONS_HEIGHT":"8",
      "DIMENSIONS_LENGTH":"10",
      "DIMENSIONS_WIDTH":"12"
   }
}

Sample Error Response

HTTP/1.1 400 Bad Request

{
    "Code": "Invalid",
    "Message": "Multiple OEMNumber(s) are not allowed for this main category ACCESSORIES"
}

Update an ad

PUT https://services.eurostocks.com/api/v1/productdatasupplier/productdetails

Markplaats, 2dehands and webshop will take few minutes to reflect changes.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Data Types

RequestSuccess Response

n/a

Sample Success Request

PUT /api/v1/productdatasupplier/productdetails/
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

{
   "eurostocksAdId":339587,
   "locationId":1,
   "imageCount":"2",
   "mainCategory":"ACCESSORIES",
   "subCategory":"EXTERIOR",
   "productType":"BED_COVER",
   "condition":"NEW",
   "delivery":"ONLY_PICKUP",
   "stock":"10",
   "weight":"25",
   "priceInfo":{
      "PRICE":"125.99",
      "DISCOUNTED_PRICE":"110.49"
   },
   "ktypes":[
       14518
	  ,13535
	  ,13536
      ,13537
      ,13579
   ],
   "oemNumbers":[
      "120"
   ],
   "productInfo":[
      {
         "LANGUAGE_ISO_CODE":"nl",
         "PRODUCT_TITLE":"Test Product Created",
         "PRODUCT_SPECIFIC_DESCRIPTION":"NL : product Descriptions"
      },
      {
         "LANGUAGE_ISO_CODE":"en",
         "PRODUCT_TITLE":"EN : Test Product Created",
         "PRODUCT_SPECIFIC_DESCRIPTION":"EN : product Descriptions"
      }
   ],
   "features":{
      "DAMAGE_OTHER_CATEGORIES":"YES",
      "AVAILABILITY":"RESERVED"
   },
   "attributes":{
      "DIMENSIONS_HEIGHT":"8",
      "DIMENSIONS_LENGTH":"10",
      "DIMENSIONS_WIDTH":"12"
   }
}

Sample Success Response

HTTP/1.1 200 OK					

{
    "eurostocksAdId": 339587,
    "eurostocksUrl": "https://directautos.eu/nl/auto-onderdelen/overige-auto-onderdelen/diverse-auto-onderdelen/product/339587/test-product"
}

Deactivate an ad

PUT https://services.eurostocks.com/api/v1/productdatasupplier/deactivate/{locationId}/{eurostocksAdId}

To deactivate a product, the current status of product must be active. Markplaats, 2dehands and webshop will take few minutes to reflect changes. When product is deactivated then its status will be changed to deactivated and the product Ad from Marktplaats and 2dehands will be removed if Ad is active.

Headers

NameTypeDescription

Header*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId*

Number

Unique Identification number of location for which Product is added

eurostocksAdId

Number

Unique Identification number of Product you want to deactivate

Sample Success Requestc

PUT /api/v1/productdatasupplier/deactivate/{locationId}/{eurostocksAdId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                    
{
  "eurostocksAdId": 599570,
  "Message": "Product deactivated"
}
     

Activate an ad

PUT https://services.eurostocks.com/api/v1/productdatasupplier/activate/{locationId}/{eurostocksAdId}

To activate a product, the current status of product must be deactivated. Markplaats, 2dehands and webshop will take few minutes to reflect changes. Please note, when creating a new product, activating a product or undeleting a product by default it will not get automatically added to Marktplaats.nl and/or 2dehands.be. If you want to change this behavior, please contact Eurostocks.

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

Password

String

Password which EuroStocks provides

Request Body

NameTypeDescription

locationId

Number

Unique Identification number of location for which Product is added

eurostocksAdId

Number

Unique Identification number of Product you want to activate

Sample Success Request

PUT /api/v1/productdatasupplier/activate/{locationId}/{eurostocksAdId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                    
{
  "eurostocksAdId": 599570,
  "Message": "Product activated"
}
    

Delete an ad

DELETE https://services.eurostocks.comapi/v1/productdatasupplier/{locationId}/{eurostocksAdId}

No need to delete images before deleting Product. Markplaats, 2dehands and webshop will take few minutes to reflect changes. When product is deleted then its status will be changed to deleted and the product Ad from Marktplaats and 2dehands will be removed if Ad is active.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId*

Number

Unique Identification number of location for which Product is added

eurostocksAdId*

Number

Unique Identification number of Product you want to delete

{
    // Response
}

Sample Success Request

DELETE /api/v1/productdatasupplier/{locationId}/{eurostocksAdId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                    
{
  "eurostocksAdId": 599570,
  "Message": "Product deleted"
}

Undelete an ad

PUT https://services.eurostocks.com/api/v1/productdatasupplier/undelete/{locationId}/{eurostocksAdId}

To undelete a product, the current status of product must be deleted. Markplaats, 2dehands and webshop will take few minutes to reflect changes. Please note, when creating a new product, activating a product or undeleting a product by default it will not get automatically added to Marktplaats.nl and/or 2dehands.be. If you want to change this behavior, please contact Eurostocks.

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId

Number

Unique Identification number of location for which Product is added

eurostocksAdId

Number

Unique Identification number of Product you want to undelted

Sample Success Request

PUT /api/v1/productdatasupplier/undelete/{locationId}/{eurostocksAdId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
                    
{
  "eurostocksAdId": 599570,
  "Message": "Product undeleted"
}

Update Stock

POST https://services.eurostocks.com/api/v1/productdatasupplier/stock/{eurostocksAdId}/{locationId}/{stock}/{unlimitedStock}/{allowOrderForOutOfStock}

UnlimitedStock and AllowOrderForOutOfStock is Optional Parameters, default value is false. Markplaats, 2dehands and webshop will take few minutes to reflect changes. Stock = 0 won't change the product status and it won't remove the product from Marktplaats and 2dehands if Ad is ac

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

eurostocksAdId*

Number

Unique Identification number of Product you want to undelted

locationId*

Number

Unique Identification number of location for which Product is added

stock

Number

stock value can not be greater then 999 it will accept positive and negative number

unlimitedstock

String

unlimitedstock is optional Parameter default value is false

allowOrderForOutOfStock

String

allowOrderForOutOfStock is optional Parameter default value is false

Sample Success Request

POST /api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: products-data-api.eurostocks.com

images = "binary image data"

Sample Success Response

HTTP/1.1 200 OK
                    
{
  "eurostocksAdId": 599570,
  "Message": "Product Stock Updated"
}
  

Upload an image

POST https://services.eurostocks.com/api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}

Upload new image by binary data. Markplaats, 2dehands and webshop will take few minutes to reflect changes.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId*

Number

Unique Identification number of location for which Product is added

eurostocksAdId*

Number

Unique Identification number of Product you want to delete

displaySequence*

Number

Display Sequence is a unique number for each image and, it should start from 1 and it should be incremental. Duplicate display sequence is not allowed.

{
    // Response
}

Data Types

RequestSuccess Response

binary image data

Image details in binary format

Sample Request Template

POST /api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: products-data-api.eurostocks.com

images = "binary image data"

Example Screen (Right click and select open image in new tab)

Sample Success Response

HTTP/1.1 201 Created
					
{
    "images": [
        {
            "ref": "https://images.autospulletjes.nl/1/93d16af95549c646/webshop/products/211925/xlarge/volkswagen-golf-211925-a12c238f.jpg"
        }
    ]
}

Example Screen (Right click and select open image in new tab)

Sample DisplaySequence Error Response

HTTP/1.1 400 Bad Request
					
{
    "Code": "BadRequest",
    "Message": "Image with requested displaysequence is already exists"
}

Update existing image

PATCH https://services.eurostocks.com/api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}

Replace existing image with new image. Markplaats, 2dehands and webshop will take few minutes to reflect changes.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId

Number

Unique Identification number of location for which Product is added

eurostocksAdId

Number

Unique Identification number of Product you want to replace image

displaySequence

Number

To patch an image at specific sequence use Display Sequence in the patch request.

{
    // Response
}

Data Types

RequestSuccess Response

binary image data

Image details in binary format

Sample Success Request

PATCH /api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: products-data-api.eurostocks.com
files = "binary image data"

Sample Success Response

HTTP/1.1 200 OK			
   				
{
  "images": [
      {
          "ref": "https://images.autospulletjes.nl/1/93d16af95549c646/webshop/products/211925/xlarge/volkswagen-golf-211925-fg2c238f.jpg"
      }
  ]
}

Example Screen (Right click and select open image in new tab)

Change the order of existing images

PUT https://services.eurostocks.com/api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}

Sequence will be set as per provided in the request. Markplaats, 2dehands and webshop will take few minutes to reflect changes.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId*

Number

Unique Identification number of location for which Product is added

eurostocksAdId

Number

Unique Identification number of Product

{
    // Response
}

Sample Success Request

PUT /api/v1/productdatasupplier/images/{locationId}/{eurostocksAdId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

{
    "images": [
        {
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/products/211925/xlarge/volkswagen-golf-211925-3.jpg",
			"displaySequence":2
        },
		{
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/products/211925/xlarge/volkswagen-golf-211925-1.jpg",
			"displaySequence":3
        },
		{
            "ref": "https://images.autospulletjes.nl/93d16af95549c646/webshop/products/211925/xlarge/volkswagen-golf-211925-2.jpg",
			"displaySequence":1
        }
    ]
}

Sample Success Response

HTTP/1.1 200 OK

Delete images

DELETE https://services.eurostocks.com/api/v1/productdatasupplier/image/{locationId}/{eurostocksAdId}/{displaySequence}

Delete image from the Ad using eurostocksAdId.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId*

Number

Unique Identification number of location for which Product is added

eurostocksAdId*

Number

Unique Identification number of Product

displaySequence*

Number

To delete an image at specific sequence use Display Sequence in the Delete request.

{
    // Response
}

Sample Success Request

DELETE /api/v1/productdatasupplier/image/{locationId}/{eurostocksAdId}/{displaySequence}
HOST: products-data-api.eurostocks.com

Sample Success Response

HTTP/1.1 200 OK

Example Screen (Right click and select open image in new tab)

Get Location Information

GET https://services.eurostocks.com/api/v1/productdatasupplier/locations

Get all the locations details associated with supplier.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

UserName*

String

Password which EuroStocks provides

Sample Success Request

GET /api/v1/productdatasupplier/locations
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
[
  {
    "locationId": 1,
    "locationName": "Autospulletjes",
    "postCode": "1054WS",
    "street": "Wilhelminastraat",
    "houseNumber": 162,
    "houseNumberExtension": "hs",
    "city": "Amsterdam"
  }
  ....
]

Products by LocationId

GET https://services.eurostocks.com/api/v1/productdatasupplier/productlist/{locationId}

Get product list by locationId, provides EuroStocksAdId and CreatedDate and ModifiedDate having UTC date time format.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId*

Number

LocationId for which you want the all active products list

Sample Success Request

GET /api/v1/productdatasupplier/productlist/1
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
{
  "productList": [
    {
      "eurostocksAdId": 324895,
      "createdDate": "2020-09-01T04:37:29.92Z",
      "modifiedDate": "2020-09-01T04:53:19.43Z"
    },
    {
      "eurostocksAdId": 324927,
      "createdDate": "2020-09-01T04:57:30.643Z",
      "modifiedDate": "2020-09-01T05:23:07.403Z"
    },
    {
      "eurostocksAdId": 326862,
      "createdDate": "2020-09-02T15:30:43.093Z",
      "modifiedDate": "2020-11-03T13:07:01.257Z"
    },
    {
      "eurostocksAdId": 332331,
      "createdDate": "2020-09-09T08:55:38.173Z",
      "modifiedDate": "2020-09-09T08:57:08.74Z"
    },
	...
	]
}

Inactive Products by LocationId

GET https://services.eurostocks.com/api/v1/productdatasupplier/productlist/deactivated/{locationId}

Get inactive product list by locationId, provides EuroStocksAdId and CreatedDate and ModifiedDate having UTC date time format.

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId

Number

LocationId for which you want the all inactive products list

{
    // Response
}

Sample Success Request

GET /api/v1/productdatasupplier/productlist/deactivated/{locationId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
{
  "productList": [
    {
      "eurostocksAdId": 324895,
      "createdDate": "2020-09-01T04:37:29.92Z",
      "modifiedDate": "2020-09-01T04:53:19.43Z"
    },
    {
      "eurostocksAdId": 324927,
      "createdDate": "2020-09-01T04:57:30.643Z",
      "modifiedDate": "2020-09-01T05:23:07.403Z"
    },
    {
      "eurostocksAdId": 326862,
      "createdDate": "2020-09-02T15:30:43.093Z",
      "modifiedDate": "2020-11-03T13:07:01.257Z"
    },
    {
      "eurostocksAdId": 332331,
      "createdDate": "2020-09-09T08:55:38.173Z",
      "modifiedDate": "2020-09-09T08:57:08.74Z"
    },
	...
	]
}

Deleted Products by LocationId

GET https://services.eurostocks.com/api/v1/productdatasupplier/productlist/deleted/{locationId}

Get deleted product list by locationId, provides EuroStocksAdId and CreatedDate and ModifiedDate having UTC date time format.

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId

Number

LocationId for which you want the all deleted products list

{
    // Response
}

Sample Success Request

GET /api/v1/productdatasupplier/productlist/deleted/{locationId}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
{
  "productList": [
    {
      "eurostocksAdId": 324895,
      "createdDate": "2020-09-01T04:37:29.92Z",
      "modifiedDate": "2020-09-01T04:53:19.43Z"
    },
    {
      "eurostocksAdId": 324927,
      "createdDate": "2020-09-01T04:57:30.643Z",
      "modifiedDate": "2020-09-01T05:23:07.403Z"
    },
    {
      "eurostocksAdId": 326862,
      "createdDate": "2020-09-02T15:30:43.093Z",
      "modifiedDate": "2020-11-03T13:07:01.257Z"
    },
    {
      "eurostocksAdId": 332331,
      "createdDate": "2020-09-09T08:55:38.173Z",
      "modifiedDate": "2020-09-09T08:57:08.74Z"
    },
	...
	]
}

Product details by LocationId and EuroStocksAdId

GET https://services.eurostocks.com/api/v1/productdatasupplier/productDetails/{locationId}/{eurostocksAdId}

Get product list by locationId.

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

locationId

Number

LocationId for which you want the all active products list

eurostocksAdId

Number

EurostocksAdId for which you want detail overview

Sample Success Request

GET /api/v1/productdatasupplier/productDetails/1/324895
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
{
  "eurostocksAdId": 324895,
  "locationId": 1,
  "mainCategory": "TIRES_AND_RIMS",
  "subCategory": "RIMS",
  "productType": "RIM_SET_OF_4",
  "delivery": "PICKUP_OR_SHIPPING",
  "condition": "NEW",
  "stock": "1",
  "weight": "30",
  "priceInfo": {
    "PRICE": "795.00",
    "DISCOUNTED_PRICE": "695.00"
  },
  "ktypes": [
    34969,
    5756,
    53156,
    116690,
    116682
  ],
  "productInfo": [
    {
      "LANGUAGE_ISO_CODE": "nl",
      "PRODUCT_TITLE": "838 | Nieuwe 20 inch velgen MK1 BMW X5 X6 en 5 6 7 serie",
      "PRODUCT_SPECIFIC_DESCRIPTION": "Tom Wheels and Tyres biedt aan:

Artikelnummers: 808000838 | 808000839

Nieuwe 20 inch velgen MK1CS en MK1C. Breed set!

Prijs 4 velgen: €695,- inclusief B.T.W.

Velgen passen onder:
BMW X5 X6
BMW 5 6 7 serie

Velg gegevens:
Merk: MK1
Maat: 11x20 en 9x20
Steek: 5x120
ET: 35
Asgat: 74.1
Kleur: POL/BLK
Partnummer:"
    }
  ],
  "features": {
    "STAGGERED_WHEELS_SET": "YES",
    "STAGGERED_WHEELS_OFFSET": "46",
    "STAGGERED_WHEELS_CENTERBORE": "5X120",
    "OFFSET_RIM_COMBI": "35",
    "INCH_SIZE_STAGGERED_WHEELS_RIMS": "21_INCH",
    "INCH_SIZE_RIMS": "20_INCH",
    "MATERIAL_RIMS": "LIGHT_METAL",
    "BRAND_RIMS": "MKW",
    "MOUNTING_POSSIBLE": "YES",
    "HUB_DIAMETER_STAGGERED_WHEELS": "741",
    "HUB_DIAMETER_RIMS_AND_WHEELS": "741",
    "STITCH_RIMS_AND_WHEELS": "5X120",
    "RIM_WIDTH_WIDTH_SET": "9_J",
    "RIM_WIDTH_INCH_SIZE_RIMS": "8_5_J",
    "SUITABLE_FOR_MARKETPLACE_TIRES_WHEELS": "PASSENGER_CAR",
    "CONDITION_TIRES_AND_RIMS": "NEW"
  },
  "attributes": {
    "ARTICLE_NUMBER": "9.0"
  },
  "images": [
    {
      "ref": "https://test-images.directautos.eu/93d16af95549c646/webshop/products/324895/xxlarge/838-nieuwe-20-inch-velgen-mk1-bmw-x5-x6-en-5-6-7-serie-2.jpg",
      "displaySequence": 1
    },
    {
      "ref": "https://test-images.directautos.eu/93d16af95549c646/webshop/products/324895/xxlarge/838-nieuwe-20-inch-velgen-mk1-bmw-x5-x6-en-5-6-7-serie-1.jpg",
      "displaySequence": 2
    }
  ]
}

Fitments Makes

GET https://services.eurostocks.com/api/v1/fitments/makes

Get all fitments makes information.

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

{
    // Response
}

Sample Success Request

GET /api/v1/fitments/makes
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
[
  {
    "MakeId": 2,
    "Make": "ALFA ROMEO"
  },
  {
    "MakeId": 3,
    "Make": "AUTO UNION"
  },
  {
    "MakeId": 5,
    "Make": "AUDI"
  },
  {
    "MakeId": 6,
    "Make": "AUSTIN"
  },
  {
    "MakeId": 10,
    "Make": "BEDFORD"
  },
  .....
]  

Fitments Models

GET https://services.eurostocks.com/api/v1/fitments/{makeId}/models

Get fitments models details by makeId.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

makeId*

Number

MakeId for which you want all fitments Models

{
    // Response
}

Sample Success Request

GET /api/v1/fitments/2/models
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
[
  {
    "MakeId": 2,
    "ModelId": 278,
    "Model": "145 (930_)",
    "ConstructructedFrom": "7/1/1994",
    "ConstructedTo": "1/1/2001"
  },
  {
    "MakeId": 2,
    "ModelId": 282,
    "Model": "155 (167_)",
    "ConstructructedFrom": "1/1/1992",
    "ConstructedTo": "12/1/1997"
  },
  {
    "MakeId": 2,
    "ModelId": 287,
    "Model": "164 (164_)",
    "ConstructructedFrom": "1/1/1987",
    "ConstructedTo": "10/1/1998"
  },
  .....
] 

Fitments Types

GET https://services.eurostocks.com/api/v1/fitments/{modelId}/types

Get fitments types details by modelId.

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

modelId*

Number

ModelId for which you want all fitments Types

{
    // Response
}

Sample Success Request

GET /api/v1/fitments/278/types
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK                                
[
  {
    "MakeId": 2,
    "ModelId": 278,
    "KType": 3820,
    "Car": "1.7 i.e. 16V (930.A1)",
    "ConstructionFrom": "10/1/1994",
    "ConstructionTo": "12/1/1996",
    "FirstCountry": "NL",
    "Cylinder": "4",
    "CylinderCapacity": "",
    "CylinderCapacityCcm": "1712",
    "CylinderCapacityLiter": "170",
    "Linked": "",
    "PowerHpFrom": "129",
    "PowerHpTo": "129",
    "PowerKwFrom": "95",
    "PowerKwTo": "95",
    "MotorCode": "AR 33401",
    "ConstructionType": "Hatchback",
    "ImpulsionType": "Voorwielaandrijving",
    "Valves": "4",
    "ModelName": "145 (930_)",
    "TypeName": "1.7 i.e. 16V (930.A1)",
    "TypeNumber": "3820",
    "FuelType": "Benzine",
    "FuelTypeProcess": "Zuigleidinginspuiting / Carburateur",
    "MotorType": "Ottomotor",
    "BrakeSystem": "Hydraulisch",
    "CcmTech": "1712",
    "Doors": "",
    "Voltage": "",
    "TankCapacity": "",
    "HSN_TSN": "4001679",
    "ABENr": "G731",
    "AbeFrom": "01/06/1994",
    "StatHer": "FIAT (I)",
    "StatTyp": "ALFA ROMEO 930",
    "ABS": "",
    "ASR": ""
  },
  {
    "MakeId": 2,
    "ModelId": 278,
    "KType": 3821,
    "Car": "1.6 i.e. (930.A2)",
    "ConstructionFrom": "10/1/1994",
    "ConstructionTo": "12/1/1996",
    "FirstCountry": "NL",
    "Cylinder": "4",
    "CylinderCapacity": "",
    "CylinderCapacityCcm": "1596",
    "CylinderCapacityLiter": "160",
    "Linked": "",
    "PowerHpFrom": "103",
    "PowerHpTo": "103",
    "PowerKwFrom": "76",
    "PowerKwTo": "76",
    "MotorCode": "AR 33201",
    "ConstructionType": "Hatchback",
    "ImpulsionType": "Voorwielaandrijving",
    "Valves": "2",
    "ModelName": "145 (930_)",
    "TypeName": "1.6 i.e. (930.A2)",
    "TypeNumber": "3821",
    "FuelType": "Benzine",
    "FuelTypeProcess": "Zuigleidinginspuiting / Carburateur",
    "MotorType": "Ottomotor",
    "BrakeSystem": "Hydraulisch",
    "CcmTech": "1596",
    "Doors": "",
    "Voltage": "",
    "TankCapacity": "",
    "HSN_TSN": "4001680",
    "ABENr": "G731",
    "AbeFrom": "01/06/1994",
    "StatHer": "FIAT (I)",
    "StatTyp": "ALFA ROMEO 930",
    "ABS": "",
    "ASR": ""
  },
  .....
]  

Main Categories

GET https://services.eurostocks.com/api/v1/productdatasupplier/mainCategories

Headers

NameTypeDescription

UserName

String

Username which EuroStocks provides

Password

String

Password which EuroStocks provides

APIKey

String

ApiKey which EuroStocks provides

{
    // Response
}

Sample Success Request

GET api/v1/productdatasupplier/mainCategories
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK

[
  {
    "Key": "ACCESSOIRES",
    "Description": "Accessoires"
  },
  {
    "Key": "ANTIQUE_AND_ART",
    "Description": "Antiek en Kunst"
  },
  {
    "Key": "AUTO_ONDERDELEN",
    "Description": "Auto onderdelen"
  },
  {
    "Key": "BANDEN_EN_VELGEN",
    "Description": "Banden en Velgen"
  },
  ....
]

Sub Categories

GET https://services.eurostocks.com/api/v1/productdatasupplier/subCategories/{maincategoryKey}

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

{
    // Response
}

Sample Success Request

GET api/v1/productdatasupplier/subCategories/{maincategoryKey}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK

[
  {
    "Key": "AUDIO_EN_TOEBEHOREN_UNIVERSEEL",
    "Description": "Audio en toebehoren (universeel)"
  },
  {
    "Key": "BAGAGE_EN_TRANSPORT",
    "Description": "Bagage en Transport"
  },
  {
    "Key": "ELEKTRONICA",
    "Description": "Elektronica"
  },
  {
    "Key": "EXTERIEUR",
    "Description": "Exterieur"
  },
  ....
]

Product Types

GET https://services.eurostocks.com/api/v1/productdatasupplier/productType/{subcategoryKey}

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

{
    // Response
}

Sample Success Request

GET api/v1/productdatasupplier/productType/{subcategoryKey}
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK

[
  {
    "Key": "AFSTANDSBEDIENING_RADIO",
    "Description": "Afstandsbediening radio "
  },
  {
    "Key": "ANTENNE",
    "Description": "Antenne"
  },
  {
    "Key": "ANTENNE_VERSTERKER",
    "Description": "Antenne versterker"
  },
  {
    "Key": "BEDIENINGSPANEEL_RADIO",
    "Description": "Bedieningspaneel radio"
  },
  ....
]

Features

GET https://services.eurostocks.com/api/v1/productdatasupplier/features/{productTypeKey}

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

{
    // Response
}

Sample Success Request

GET /api/v1/productdatasupplier/features/AIRBAG_SET
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
						
[
  {
    "Key": "ALLOW_OUT_OF_STOCK_ORDER",
    "Description": "Sta toe dat een product afgerekend wordt welke niet meer op voorraad is",
    "IsMultipleAllowed": false,
    "IsPriceFeature": false,
    "IsMandatory": false,
    "IsDefaultFeature": true
  },
  {
    "Key": "AVAILABILITY",
    "Description": "Beschikbaarheid",
    "IsMultipleAllowed": false,
    "IsPriceFeature": false,
    "IsMandatory": true,
    "IsDefaultFeature": false
  },
  ...
]

Feature Values

GET https://services.eurostocks.com/api/v1/productdatasupplier/featurevalues/{featureKey}

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

featureKey*

Number

Feature key to get it's values

{
    // Response
}

Sample Success Request

GET /api/v1/productdatasupplier/featurevalues/DELIVERY
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
  {
    "Key": "ONLY_PICKUP",
    "Description": "Ophalen"
  },
  {
    "Key": "ONLY_SHIPPING",
    "Description": "Verzenden"
  },
  {
    "Key": "PICKUP_OR_SHIPPING",
    "Description": "Ophalen of verzenden"
  }
]

Attributes

GET https://services.eurostocks.com/api/v1/productdatasupplier/attributes/{productTypeKey}

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

Password*

String

Password which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Request Body

NameTypeDescription

ProductTypeKey*

Number

Product type key to get attributes

{
    // Response
}

Sample Success Request

GET /api/v1/productdatasupplier/attributes/AIRBAG_SET
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
  {
    "Key": "MONTAGE_KOSTEN",
    "Description": "Montage kosten:",
    "InputType": "None",
    "IsMandatory": false,
    "IsMultilingualAttribute": false,
    "IsPriceAttribute": false,
    "IsDefaultAttribute": false
  },
  {
    "Key": "PRICE",
    "Description": "Price",
    "InputType": "None",
    "IsMandatory": true,
    "IsMultilingualAttribute": false,
    "IsPriceAttribute": true,
    "IsDefaultAttribute": false
  },
  {
    "Key": "INTERNAL_NUMBER",
    "Description": "Interne nummer",
    "InputType": "None",
    "IsMandatory": false,
    "IsMultilingualAttribute": false,
    "IsPriceAttribute": false,
    "IsDefaultAttribute": true
  },
  ...
]

Sample Success Request

GET /api/v1/productdatasupplier/languages
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
[
  {
    "Key": "de"
  },
  {
    "Key": "en"
  },
  {
    "Key": "nl"
  },
  ...
]

Sample request Body

GET https://services.eurostocks.com/api/v1/productdatasupplier/productdatasupplierRequestTemplate/{ProductTypeKey}/{mandatoryMode}

Headers

NameTypeDescription

UserName*

String

Username which EuroStocks provides

APIKey*

String

ApiKey which EuroStocks provides

Password*

String

Password which EuroStocks provides

Request Body

NameTypeDescription

ProductTypeKey*

String

Product type key to get attributes

mandatoryMode

mandatoryMode=true is when only want mandatory details associated with Product Type in request to create new Ad

mandatoryMode=false is to get all details associated with Product Type to create new Ad

{
    // Response
}

Sample Success Request

GET /api/v1/productdatasupplier/productdatasupplierRequestTemplate/AIRBAG_SET/true
HOST: products-data-api.eurostocks.com
Content-type: "application/json"

Sample Success Response

HTTP/1.1 200 OK
							
{
  "eurostocksAdId": null,
  "locationId": 0,
  "imageCount": "",
  "mainCateogry": "",
  "subCategory": "",
  "productType": "",
  "condition": "",
  "delivery": "",
  "stock": "",
  "weight": "",
  "priceInfo": {
    "PRICE": ""
  },
  "ktypes": [],
  "oemNumbers": [],
  "productInfo": [
    {
      "LANGUAGE_ISO_CODE": "nl"
    },
    {
      "LANGUAGE_ISO_CODE": "en"
    }
  ],
  "features": {
    "AVAILABILITY": ""
  },
  "attributes": {}
}

All Error Codes

Overview

List of possible error codes with each request.

Product Add/Update Product request

ErrorCode - 400

{attributeValue} is invalid value of attribute {attributekey}

{attributeValue} is required

Attribute not mapped with this product type

AttributeValue already exists for {attributekey}

{attributes} are not valid attributes

{features} are not valid features

No Features mapped with this product type

{features} is not exist for this category

{featureValue} invalid for feature {featureKey}

{attributes} are mandatory attributes

{features} are mandatory features

{featuresValue} already exist for {featureKey}

Invalid Features Value for feature {featureKey}

LANGUAGE_ISO_CODE Language is not supported

LANGUAGE_ISO_CODE is required to add multilingual attribute

{ProductType} price can not be 0.

PRICE_ON_REQUEST is not allowed for Product type {ProductType}

Extended attribute(s) is mandatory for 'nl' language

Ktype is not allow for subcategory

Stock can not be zero

Invalid characters in OEMNumber

OEMNumber length should not be more then 20 characters

Invalid price field

ErrorCode - 500

Something went wrong

Product not added

ErrorCode - 404

sub category does not exist

product type in not match with this subcategory

location is not exists

Supplier not linked with this location

No Product found

Product Add/Update image request

ErrorCode - 400

Invalid request

Product does not belongs to the supplier

Either filename or new image not found

ErrorCode - 404

Product not matched with location

ErrorCode - 500

Internal server error

Product Delete request

ErrorCode - 400

Invalid request

Product does not belongs to the supplier

ErrorCode - 404

Product not matched with location

ErrorCode - 500

Internal server error

Get Product request

ErrorCode - 400

Invalid request

Product does not belongs to the supplier

ErrorCode - 404

ErrorCode - 404

Product is not found

Product not matched with location

ErrorCode - 500

Internal server error

Price Attributes and Features

Price Features can be identified from flag "IsPriceFeature". please refer API : https://products-data-api.eurostocks.com/api/v1/productdatasupplier/features/{productTypeKey}

Price Attributes can be identified from flag "IsPriceAttribute". please refer API : https://products-data-api.eurostocks.com/api/v1/productdatasupplier/attributes/{productTypeKey}

ParameterDescription

VAT_NOT_RECLAIMABLE

Vat Not Reclaimable (Marge product), Added as Feature

PRICE

Price, Added as Attribute

PRICE_ON_REQUEST

Price On Request, Added as Feature

DISCOUNTED_PRICE

Discounted price, Added as Attribute

EXCLUDING_VAT

Price is excluding vat, Added as Feature

SPECIAL_SHIPPING_RATE

Special shipping rate, Added as Attribute

Last updated