6. eCommerce Extension

All eCommerce functionality of the Headless Server is bundled within the Blueprint module headless-server-ec. It contains a GraphQL schema extension within the file commerce-schema.graphql and Java code and Spring configuration to implement this schema extension.

The GraphQL schema extension is essentially a mapping of the CoreMedia Commerce API onto GraphQL terms, with some additions to support augmented products and categories.

The schema extension uses the GraphQL extension mechanism to add a new field commerce of type CommerceRoot to the query root object. Using this new root field, it is possible to query for catalogs, categories and products, including product variants.

eCommerce catalogs are always associated with a specific site, so you have to specify a site ID in each CommerceRootquery.

Categories may also be queried by their SEO segment.