PunchOut API – v1

PunchOut API – v1

Business Overview

Overview

The PunchOut API allows procurement systems to seamlessly integrate with the Van Marcke Blue webshop. It enables users to initiate a PunchOut session to browse and select products within the familiar Van Marcke environment, then return the selected items directly to their procurement platform. This API also supports retrieving and managing the shopping cart content programmatically.

Key Business Benefits

  • Streamlined Procurement Workflow: Users can access the webshop directly from their procurement system, improving efficiency and reducing manual order entry.

  • Accurate Product Selection: Ensures up-to-date product availability and pricing directly from the source, minimizing errors.

  • Automated Cart Return: The selected products and quantities are returned automatically to the procurement system, accelerating purchase order creation.

  • International Compatibility: Supports multiple countries and languages for a consistent experience across markets.


Developer Documentation

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

Core Endpoints Overview:

  • Get PunchOut Login URL
    Endpoint: GET /login
    Description: Generates a PunchOut login URL to launch the Van Marcke Blue webshop. Supports parameters for callback URL, catalog country, language, and user agent.

  • Get Current Cart Contents
    Endpoint: GET /cart
    Description: Retrieves the list of products currently in the PunchOut cart. Useful for reviewing cart contents before submission.

  • Add Products to Cart
    Endpoint: POST /cart
    Description: Adds one or more products to the current webshop cart. Requires product ID and quantity in the request body.

  • Delete Current Cart
    Endpoint: DELETE /cart
    Description: Clears all items from the current cart, resetting it to an empty state.

Authentication:

  • JWT Bearer Token

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

Related content