Manage B2B catalogs
Catalogs are used to determine the products that are published to customers in different contexts. For example, a business-to-business (B2B) catalog might specify that customers ordering for a specific B2B company location can purchase only the t-shirt products in the store at a 30% discount.
In this guide, you'll learn how to build price lists and publications, and associate them with catalogs to control prices and publishing for a specific B2B company location.
RequirementsAnchor link to section titled "Requirements"
- Your app can make authenticated requests to the GraphQL Admin API.
- Your app has the
write_productsaccess scope. For more information on requesting access scopes when your app is installed, refer to Getting started with OAuth.
You're familiar with the concept of catalogs.
Step 1: Associate a price list with the catalogAnchor link to section titled "Step 1: Associate a price list with the catalog"
You can associate a price list with the catalog to determine the prices that are shown to customers ordering for that B2B company location. If a price list isn't associated with the catalog, then customers ordering for this B2B company location receive the initial variant prices converted to the market currency.
Create a new price listAnchor link to section titled "Create a new price list"
priceListCreate mutation to create a new price list for the catalog. You can set the name, a percentage-based adjustment, a currency, and the ID of the catalog to associate.
Associate an existing price listAnchor link to section titled "Associate an existing price list"
priceListUpdate mutation to associate an existing price list with a catalog. You can also make changes to the name, currency, or percentage-based adjustments with the
Step 2: Associate a publicationAnchor link to section titled "Step 2: Associate a publication"
The publication determines which products are published to customers that are eligible for the catalog.
If you have an existing publication, then you can use the
catalogUpdate mutation to associate a publication or make other changes to a catalog.
To create and associate a new publication, use the
Add products and collections to the publicationAnchor link to section titled "Add products and collections to the publication"
After you create a publication, you can add products and collections to the publication with the
Step 3: Set fixed prices for specific product variantsAnchor link to section titled "Step 3: Set fixed prices for specific product variants"
priceListFixedPricesAdd mutation to set a fixed price for specific product variants.
If a product variant is published to the catalog and doesn’t have a set fixed price, then its price is automatically calculated using the percentage-based adjustment that’s specified in the
Delete fixed pricesAnchor link to section titled "Delete fixed prices"
To delete a partial set of fixed prices on a price list, you can use the
priceListFixedPricesDelete mutation. After a fixed price is deleted, the price for the affected product variant is automatically calculated using the price list parent's percentage-based adjustment.
To delete fixed prices, you need to specify the variant ID. You can specify a maximum of 250 variant IDs in the array.
- Learn how to calculate and send invoices for draft orders for B2B customers.