Knowledge Base

API Client Secrets

New API Client Secrets functionality for enhanced security.

Faceted Navigation

Faceted navigation, also known as faceted search, is type of navigation that allows users to refine product search results by applying filters based on specific product attributes defined by the business, such as color or size.

OrderCloud Accelerator

A new set of tools for jumpstarting solution development

The Sky's (almost) the Limit

We do our best to avoid hard limits in the API when we can, but we make exceptions in a few cases in order to deliver the best performance possible to our customers.

Implementing Single Sign On with Azure AD B2C IDP

A complete end-to-end tutorial on implementing single sign-on via OpenIDConnect with Azure AD B2C as your identity provider

Bidirectional Content Hub Integration

The bidirectional integration between OrderCloud and Content Hub aims to streamline the process of managing your product data, from content to commerce.

Incrementors

Learn how to customize ID generation for any resource

Child Products vs. Generated Variants

OrderCloud supports two different ways of handling products with Variations. This article outlines some of the major differences and things to keep in mind when designing your product model.

Entity Synchronization

OrderCloud introduces the ability to publish base entities with to the destination of your choice.

App Access for OrderCloud when using Sitecore Cloud Portal

If your organization uses Sitecore Cloud Portal, this article will share more about OrderCloud access using Sitecore Cloud Portal Organization Access and App Access.

Bundle Products for Enhanced Commerce Experiences

This article showcases different ways OrderCloud Bundles can be used to enhance the commerce experiences for your buyers.

Error Configuration

OrderCloud allows you to define a marketplace level delivery configuration which will delivery customer specific errors regarding asynchronous operations to the custom delivery target of your choosing.

Marketplace Ownership

Things to consider when choosing a Marketplace Owner.

Introducing Product Bundles

A brief overview of the new Product Bundles feature available from OrderCloud.

Order Synchronization

OrderCloud introduces Order Sync for commerce solutions, offering the ability to synchronize orders with external systems.

The Possibilities of Product Collections

Learn how Product Collections can help you achieve various experiences for your buyers.

Customer Loyalty Programs

OrderCloud’s principle of flexibility over features is proven in supporting the management of loyalty reward programs for your e-commerce solutions.

Product Synchronization

OrderCloud introduces Product Sync for commerce solutions, offering the ability to synchronize product catalogs with external systems.

Why You Should Never Use FullAccess

A brief overview on why we strongly caution against using the FullAccess role.

Delivery Configuration

OrderCloud introduces Delivery Configuration which is an integration mechanism that allows you define where certain events are to be published.

Product Collection Enhancements

Expansion of Product Collections to support more flexible use cases

Subscriptions

New feature enabling subscription ordering for buyer users.

Tracking Events

OrderCloud introduces Tracking Events for commerce solutions, offering analytical insights and infrastructure for targeted systems. Coupled with Sitecore's Send & Discover products, it provides automation without being an analytics solution. It also allows for an external endpoint configuration to reduce development time and avoid browser restrictions.

Child Products

Introducing Child Products, a new feature set that enables developers to define a product as a Parent and subsequently create Child products.

Introducing Search Index Tools for Portal

A new set of tools for troubleshooting search index issues

Promotion Enhancements

Introducing new enhancements to increase flexibility of OrderCloud Promotions.

Configuring User and Application Data Access

You have a newly created marketplace, what's next? Let's configure data access for your users and applications.

Building a Wishlist Feature with Product Collections

A product wishlist feature is one of the many permutations of the OrderCloud Product Collections resource.

Introducing the Cart API

New endpoints aimed at simplifying development of the shopping experience.

Implementing Single Sign On with Google IDP

A complete end-to-end tutorial on implementing single sign-on via OpenIDConnect with Google as your identity provider

Order Returns - Handling Calculations

Learn how to implement a strategy for handling calculations in your Order Returns solution.

Using OrderReturns for Product Returns, Refunds, and Credits

Set-up customer returns, refunds, or credit scenarios for your business using OrderReturns and Seller Approval rules.

Ad-Hoc Products

Add products from an external system directly to an OrderCloud order

Pre-built Checkout Integrations in .NET

Accelerate your development of checkout integrations in .NET by understanding OrderCloud's packages and starter projects.

Product Collections

New feature enabling buyer users to save lists of products.

OrderCloud Supported Regions and Environments

Information about Order Cloud API servers for all supported regions and environments.

Using Order Search to Suit Your Needs

OrderCloud's Premium Search on Orders gives you the ability to get a list of orders and line items with more flexibility.

Message Senders

Message Senders is a feature that helps to deliver event-driven notifications to users based on certain key commerce activities.

Introducing Order Returns

New set of features to enable all aspects of the Order Returns process.

Premium Search for Orders

Significant enhancements to querying orders and line items.

Sale Prices using Price Schedules

Overview of new feature to allow sale prices for products. Price schedules can be used to provide sale pricing while optionally using a date/time range to control the application of the sale price.

Managing Inventory with OrderCloud

OrderCloud's InventoryRecords resource gives you flexibility to set-up product inventory in a way that meets your businesses’ fulfillment workflows.

Multi-Location Inventory

Overview of a new feature to allow tracking of product inventory across multiple locations.

Working with Product Specs

Creating complex products with specs.

How to Globalize your eCommerce

In November, a new Locale feature was released to simplify globalization efforts for solutions where commerce spans across regions with different currencies and languages*. Review this guide for the use case that matches your business most, and look at the examples for recommendations on how to model your solution.

Order Checkout Integration Event

With many ecommerce systems, what a customer pays for tax and shipping, or how their promotion discount is applied to their order can be difficult to determine at the time they’re checking out. The Order Checkout Integration Event was designed to make these calculations and estimations more customizable to better suit your business needs.

Globalization for Marketplaces

Overview of new features to enable configuration of multi-currency and multi-language Marketplaces.

Products, Pricing, and Ordering in OrderCloud Marketplaces

New features to enable buyers to select which suppliers to view product pricing for and order directly from.

Using Webhooks

The OrderCloud API supports user-defined HTTP callbacks, known as webhooks. You can choose exactly which OrderCloud API endpoints will trigger your hook, the roles to be passed onto the configured Base URL, and any additional configuration data OrderCloud may need to authenticate into 3rd party systems

Marketplaces in OrderCloud

Moving beyond single-seller environments

How to Calculate Tax with OrderCloud

This guide is designed to be an overview of how we support tax calculation integration and management with some focus on a particular vendor we recommend highly, Avalara.

Start .NET middleware from Scratch

Step by step instructions to stand up a hosted middleware using .NET Catalyst

Configuring Custom Password Security

As part of our ongoing commitment to security we have released an enhanced password security feature to give you greater control over password requirements for users of your applications.

Access Control Using Portal Teams

Building teams of Portal Users enables streamlined control of your contributors and the data they can access.

OrderCloud Regions

Regions The Portal supports managing marketplaces across multiple regions. As Sitecore OrderCloud continues to expand globally, the ability to quickly spin up a marketplace in a physical location near client operations will be critical.

OrderCloud Environments

OrderCloud supports three distinct environments: free Sandboxes, and Staging, and Production environments for customers.

Introducing Line Item-Level Promotions

Automatically apply specific promos/discount amounts to specific line items

What's New for Premium Search

Premium Search is now available on product admin endpoints, and introducing the new searchType parameter.

Introducing Premium Search

Premium Search is the next evolution in search technology offered by the OrderCloud platform, powered by Elasticsearch.

Single Sign On via OpenID Connect

SSO (Single Sign On) allows your users to authenticate themselves to the OrderCloud API by logging into any identity provider you trust.

Impersonating Users

The OrderCloud API supports this capability by allowing certain users to make API calls on behalf of a buyer user, which we refer to as impersonation.

Rules-Based Promotion Expressions

Writing custom rule-base expressions for your order promotions may seem intimidating at first, but once you get the hang of it you'll realize there are virtually limitless possibilities which provide the flexibility to meet almost any business need.

Same Product, Multiple Price Schedules

Price schedules are one of the critical factors related to product visibility and there are several ways that you can build relationships between products and price schedules.

Product Visibility Requirements

You have many options to achieve product visibility, each with a unique purpose. The path you take depends on your business requirements. By the end of this guide you will be familiar enough with the available product visibility options to choose a method that works best for your marketplace.

Catalog Visibility Rules

Learn about these powerful features aimed at simplifying catalog management.

Advanced Querying

Most OrderCloud resources have list endpoints that can return thousands, even hundreds of thousands of items. We understand that effectively querying this data is not only practical but necessary and have built an assortment of API tools to help pinpoint and extract the exact data you and your users need.

Understanding Security Profiles

Security profiles are groups of roles (permissions), each of which grant users access to specific API endpoints and functionality. This lets you lock down access to your marketplace at the API level which is very powerful.

Leveraging Extended Properties in the Development of Custom eCommerce Apps

We can't predict every column in every table that your hypothetical database might need. That's why we created our own schema-less solution with Extended Properties (XP) and exposed it on every API resource.

Introduction to API Clients

OrderCloud uses the term API Clients to identify various access points to your marketplace's data. These access points have properties that control what parties can use it, how they can gain access, and for how long that access remains valid.

The Rules Engine Has Arrived

Extend platform behavior using a system of rules similar to XP allowing you to extend the data model.

Four Reasons You Should Stop Using PUT For Updates

To update an existing resource, when should you use PUT and when should you use PATCH? Here are 4 reasons why you should stop using PUT for updates.

XP Best Practices

This is not intended to be an introductory post. It's less about learning something you don't know and more about un-learning something you think you know.

Flexibility Over Features

Removing constraints and broadening the possibilities of how the OrderCloud data model can be utilized allows you to leverage best-in-breed components.

Understanding Orders

The central concept within OrderCloud is not surprisingly the order. This is the object where buyers, sellers, products, payments, and almost everything come together to form a business transaction.

Anonymous Shopping

Anonymous Shopping, or Guest Checkout, is when a user is enabled to browse a catalog of products and/or checkout without registering themselves. Accomplishing this requires OrderCloud developers to pull together a lot of platform knowledge. We'll summarize that information here.

Authentication

OrderCloud's authentication system is built on top of an open authorization standard called OAuth2 which is increasingly becoming an industry standard for security and permission-based application experiences.

Understanding OrderCloud Assignments

When you save an assignment you are creating a relationship between a party and an object (OrderCloud "thing" such as product, category, etc). For example you might assign a usergroup to a category, thereby granting a user in that group visibility to that category.

Using Extended Properties

The reality of all enterprise platforms is the need to customize the data model. To accommodate this, OrderCloud designed a property called Extended Properties (XP) to allow enterprise customization of the OrderCloud data model.

Me and My Stuff

OrderCloud provides the Me Resource whose job it is to flatten these assignments for the currently authenticated user and just "show me what I can see" regardless at which level these assignments are made.