Business Overview

Overview

The Products API is designed to empower your business by providing comprehensive and real‐time access to critical product information. This service allows you to streamline operations and make data‐driven decisions by integrating detailed product data into your systems.

Key Business Benefits

• Comprehensive Product Insights:
  Quickly access product details including descriptions, images, technical data, and classifications. This ensures that your sales and marketing teams always have the most up-to-date information.

• Pricing and Stock Visibility:
  Retrieve current net pricing and stock availability, both from central warehouses and specific store locations, to support dynamic pricing and inventory decisions.

• Efficient Bulk Operations:
  The API supports bulk requests for details, pricing, and stock information, enabling efficient management even when handling large volumes of products.

• Enhanced Delivery Planning:
  Calculate delivery dates based on your business rules, helping optimize logistics and customer satisfaction.

• Customer-Focused Analytics:
  Access insights into the most purchased products for customer accounts to better tailor your offerings and promotions.

• Pricelist Management:
  Check customer permissions for downloading price lists and obtain detailed CSV files with pricing data, ensuring that your customers have the accurate, up-to-date information they need.

• Product Categorization and Classification:
  Navigate through a detailed, hierarchical structure of product categories and industry-standard classifications (ETIM) to support accurate product categorization and targeted marketing

Developer Documentation

Developer Portal URL: https://developer.vanmarcke.com/product/ecommerce/api/products-v2
API Proxy Base URL: https://api.vanmarcke.com:443/v2/products

Core Endpoints Overview:

• Product Listings
  Endpoint: GET /
  Retrieve lists of products with filtering options (e.g., country, channel, language). Supports pagination and optional feature inclusion.

• Product Details
  Endpoint: GET /{productId}
  Fetch detailed information for an individual product (including images, technical documents, and descriptions).

• Product Classification Features
  Endpoint: GET /{productId}/features
  Retrieve ETIM classification features for a product.

• Product Pricing
  Endpoint: GET /{productId}/prices
  Get net pricing information for a single product.

• Central Warehouse Stock
  Endpoint: GET /{productId}/stock
  Check stock availability in the central warehouse.

• Store-specific Stock
  Endpoint: GET /{productId}/stock/{storeId}
  Get stock availability for a specific store location.

• Bulk Product Details
  Endpoint: POST /bulk/detail
  Retrieve details for multiple products (up to 50 per request).

• Bulk Pricing and Stock
  Endpoint: POST /bulk/pricesAndStock
  Get pricing and stock information in bulk for up to 50 products.

• Product ID Mapping
  Endpoint: POST /bulk/mappingProductId
  Map old (AS400) product IDs to new (SAP) product IDs for multiple products.

• Delivery Date Calculation
  Endpoint: POST /bulk/calculateDeliveryDate
  Calculate delivery dates based on provided business rules.

• Customer Most Purchased Products
  Endpoint: GET /myMostPurchased
  Retrieve the most purchased products on a customer account over a configurable history period.

• Pricelist Permission Check
  Endpoint: GET /checkPermissionPriceList
  Check if a customer has permission to download price lists.

• Request Gross Price CSV
  Endpoint: GET /requestPriceListGrossCsv
  Request a download URL for a public pricelist with gross prices in CSV format.

• Request Net Price CSV
  Endpoint: GET /requestPriceListNetCsv
  Request a CSV pricelist with customer net prices. Optionally, receive the URL via email.

• Net Pricelist Status
  Endpoint: GET /statusPriceListNetCsv
  Check the status and availability of the requested net pricelist (includes download URL when finished).

• Product Categories
  Endpoint: GET /categories
  Retrieve hierarchical product categories.

• Product Classifications
  Endpoint: GET /classifications
  Retrieve product classification data based on industry standards (e.g., ETIM).

• Specific Classification Details
  Endpoint: GET /classifications/{classCode}
  Retrieve detailed information for a specific classification class.

Authentication:

• JWT Bearer Token

• API Key Authentication (using header x-api-key).