Making your product visible

In this section, we have investigated your default buyer catalog and created a new product with a default price schedule. Our default catalog has ViewAllProducts set to true, so you might think that your product is ready for buyer users to purchase. This is a common misconception, as products are not inherently part of a catalog. They exist separately, so that sellers can share products across many catalogs.

Connecting the dots

To make the product visible in our example, assign it directly to the default buyer catalog. This is called a product-catalog assignment.

In other scenarios, this assignment is created automatically when you assign products to a category within a catalog, similar to when you update a buyer organization's DefaultCatalogID and OrderCloud creates the buyer-catalog assignment for you.

See Product visibility for more information.

For this reason, many developers overlook the fact that they need to explicitly assign a product to a catalog in the absence of categories.

Assign the product to the default catalog

POST https://sandboxapi.ordercloud.io/v1/catalogs/productassignments HTTP/1.1
Authorization: Bearer INSERT_ACCESS_TOKEN_HERE
Content-Type: application/json; charset=UTF-8;

{
    "CatalogID": "BUYER_ORGANIZATION",
    "ProductID": "SHIRT"
}

You now have a working product catalog. It may be simple, but it has everything you need to start creating orders in the next section.