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.

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

First steps for using GraphQL.

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

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

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

Get an overview over how to implement the ProMaterial API.

Learn how the authentication works with a native software.

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.

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.

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

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

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

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

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

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.

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.

UniversalTypes are attributes for building products.

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

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

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

Set the header "Accept-Language".

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

Use the field "parent".

Use the field "children".