Manage client company locations

When a Shopify merchant conducts business-to-business (B2B) transactions, they sell their goods and services directly to other companies. You can use the GraphQL Admin API to create companies that represent those business customers and contain information about them.

A company can be associated with one or more company locations. Each company location contains information that can be used to change how orders are calculated and charged for a specific company context. For example, a company might have multinational branches that need to follow different billing and taxation rules.

This tutorial shows you how to add a location to a company and make updates to the location information.

Anchor to What you'll learnWhat you'll learn

In this tutorial, you'll learn how to do the following tasks:

• Add a company location to a company
• Set up tax exemptions for a company location
• Associate payment terms with a company location

Anchor to RequirementsRequirements

• You've created a company.
• You're familiar with the concept of company locations.

Anchor to Step 1: Add a company location to a companyStep 1: Add a company location to a company

You can use the companyLocationCreate mutation to create and add a company location to a company:

Anchor to Step 2: Set up tax exemptions for a company locationStep 2: Set up tax exemptions for a company location

If a company is exempt from sales tax at a location, then you should set up their tax exemption before they process any orders at that location.

Use the companyLocationAssignTaxExemptions mutation to override the relevant taxes on the company's account.

The following example sets multiple tax exemptions on one company location. For details on all possible tax exemptions, reference the TaxExemption documentation.

Anchor to Step 3: Associate payment terms with a company locationStep 3: Associate payment terms with a company location

Payment terms determine when a company needs to pay for an order. This could be in advance of the order, at the time of order, or within a given amount of time that the merchant decides upon with the company.

To attach payment terms to a company, pass the buyerExperienceConfiguration input including a paymentTermsTemplateId to the companyLocationUpdate mutation.

Refer to the paymentTermsCreate mutation documentation for information on creating payment terms.

The following example assigns payment terms with the ID gid://shopify/PaymentTermsTemplate/2 to a company location:

Anchor to Next stepsNext steps

• Learn how to associate a price list and publication to a B2B catalog to determine the available products and prices for customers ordering for a specific B2B company location.
• Learn how to manage draft orders for B2B clients by calculating and sending invoices.