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.

First steps for using GraphQL.

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

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

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

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

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.

Get an overview over how to implement the ProMaterial API.

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.

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

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

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

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

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

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.

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

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

Set the header "Accept-Language".

Use the field "parent".

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

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

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.

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

Use the field "children".