Skip to content
Open source core .NET 4.5 and SQL Server Sannois, France
MAGELIAWebStore
Resources · services

The commerce operations behind the storefront

The services layer is deliberately compact. A small number of purposeful operations is easier to learn, test and integrate than a large surface.

Service groups

What the storefront can ask for

GroupTypical questionsWhy it matters
CatalogWhich catalogs exist? What is in this catalog?Defines the assortment boundary for a storefront.
CategoryWhat is the category tree? Which products belong here?Drives navigation and category landing pages.
ProductWhat are the attributes, variants and media for this product?Supplies the product detail experience.
BasketWhat is in the basket? What happens when an item is added?Holds the interactive state before an order exists.
OrderHow is the basket saved as an order? What is the current status?Turns a selection into an operational record.
InventoryWhat stock is available and where?Connects the storefront to physical availability.
Tax and shippingWhich rules apply to this basket and destination?Produces a total the customer can understand.
PromotionWhich offers apply, and in what priority?Adjusts the basket under explicit conditions.
Access

Two protocols, one boundary

OData for query style access

OData supports querying and shaping catalog data over HTTP. It is useful when the storefront needs lists, filters and projections without a bespoke method for every screen.

WCF for interactive operations

WCF covers the operations that change state, such as basket and order work. The client library wraps the calls and reads shared configuration.

Read the protocol documentation before designing a new integration. The shapes of the requests matter more than the transport.

Integration rule

Keep the contract small. A storefront that uses a few well understood operations is easier to upgrade than one that reaches into every service.

Security

Authenticate calls, restrict network access and keep secrets out of client side code.

Primary sources

Services reference shelf

Standards, documentation and tools that are relevant to this topic. They open on the publisher's site.

  • OData The open data protocol used by the WebStore services layer.
  • .NET platform Runtime, tooling and framework documentation from Microsoft.
  • Microsoft Learn Reference material for the Microsoft development stack.
  • NuGet Package distribution used by the .NET client and samples.
  • SQL Server Database engine documentation and editions.
  • OWASP Application security guidance and cheat sheets.
  • W3C Web standards for markup, accessibility and internationalization.
  • GitHub Source hosting and issue tracking for .NET projects.
  • web.dev Performance, accessibility and Core Web Vitals guidance.
  • Semantic Versioning Version numbering conventions used in release notes.
Next step

Design the integration contract first

Decide which questions the storefront must ask before choosing a client technology or a template.