We use GraphQL for our APIs. You can test on our stage system and implement for our production system. Here, you find the URLs.

We use the ProMaterial terms BusinessManager, DistributionGate, BookingGate and the technical terms API, GraphQL, GraphiQL, Authentifizierung, JWT, Token.

We can provide you with a Client ID and a Client Secret, so you can request a token and use the API.

First steps for using GraphQL.

Learn about filtering within the results, using aliases, change the language of a field and use pagination and facets.

You can use GraphiQL to play with our API. We explain how in this article.

Request an authentication token with cURl and use the GraphiQL interface to send requests.

For the implementation you need the APIs of the BusinessManager, the DistributionGate and BookingGate. Learn how they are connected and which information is reused where.

Get an overview over how to implement the ProMaterial API.

Learn how the authentication works with a native software.

You can use our BusinessManager to get a list of distributors connected to your software but you need to authenticate first. Get a quick overview here.

To use the BusinessManager API authenticate with your Client ID and Client Secret. You get a token in return.

The productsearch returns a maximum of 10.000 products for a search. Use the query allProducts to retrieve all products from a DistributionGate.

UniversalTypes are located under features.universalTypes in the result of the productsearch.

You can use search for products by different criteria, get product data, prices and availability.

Your software can communicate with the DistributionGates that connected to your DistributionChannel. You get the information you need to authenticate using the connectedDistributionGates query.

We get the prices from the ERP system of the distributor. Oftentimes, the prices are tailored to the customer, the project and the delivery type. Retrieve prices via productOrderDetails.orderUnits.

Use the pricesearch to get prices for products with set quantity for the current user, their project and the delivery type.

Add products to the shopping cart, delete Products and get the current shopping cart.

Transform a shopping cart is transformed into an order using createOrder mutation.

To search for products you can use product properties — UniversalTypes. Here, we list the most-used UniversalTypes.

Use the "login" mutation to obtain a token. Send the token with all further requests to the API.

Use the field "children".

Use the field "parent".

Set the header "Accept-Language".

Use the "utsearch" with "code" as filter criteria.

UniversalTypes are attributes for building products.

Use the "language switch" to request multi-language fields in a specific language or use aliases to get multiple languages at the same time.