Manual configuration

Search…
A step-by-step guide on how to set up an organization from scratch, using our CLI.
To begin receiving orders and making sales through Commerce Layer, you need to configure your organization to meet some requirements: the manual configuration involves creating all the necessary resources, linking them based on their mutual relationships, and properly populating your environment with sample (or real) data. This guide will walk you through the process of setting up a new organization using the command line from start to finish and is a good opportunity to learn (by doing) how Commerce Layer works, in deep.
Please refer to Commerce Layer data model documentation to get an overview of the most relevant API entities, their mutual relationships, and common usage with the help of E-R diagrams.
As an alternative, if you want to go straight to the chase, you can follow the short onboarding tutorial you'll be prompted as soon as you sign up to create a new organization, seed it with test data, and place your first order from scratch, in minutes.
Manual seeding reference guide
1.​Create an organization​
2.​Create an application​
3.​Install the Commerce Layer CLI​
4.​Log in to the application​
5.​Install the resources plugin​
6.​Configure your organization​
Markets
​Address​
​Merchant​
​Stock location​
​Inventory model​
​Inventory stock location​
​Price list​
​Market​
Shipping
​Shipping category​
​Shipping zone​
​Shipping method​
Payments
​Payment gateway​
​Payment method​
Products
​SKUs​
​Stock items​
​Prices​
7.​Import additional resources​
Create an organization
These are the steps you need to follow to create an organization on Commerce Layer:
1.Create a free developer account here. If you already have an account, please skip to step 3.
2.Upon successful signup, skip the onboarding tutorial for the purposes of this guide (you will set up and seed the organization manually through the CLI shortly).
3.Click on the New organization button to create a new organization for your business and enter a name on the following page as seen in the screenshots below.
Create an application
In the Commerce Layer dashboard, click on Integrations and create a new application (name: CLI / role: Admin). Upon successful creation, you'll get a client ID, client secret, and base endpoint. Remember to save that as we'll use it to interact with the CLI later.
Install the Commerce Layer CLI
Run the command below on your terminal to install the CLI using your favorite package manager:
1
npm install -g @commercelayer/cli
Copied!
1
yarn global add @commercelayer/cli
Copied!
Installing the CLI provides access to the commercelayer command which can also be accessed with the aliases clayer and cl. 
You can run commercelayer help at any point to learn about the available command options.
Log in to the application
Log into your application via the CLI using the previously created integration application credentials like so:
1
cl applications:login -o <organizationSlug> -i <clientId> -s <clientSecret> -a <applicationAlias>
Copied!
Here’s a breakdown of each of the command options:
The applications:login command lets you manage login to CLI applications.
The -o flag allows you to pass in an organization slug as a parameter.
<organizationSlug> represents the slug from your organization’s base endpoint (e.g. sample-shop from https://sample-shop.commercelayer.io).
The -i flag allows you to pass in a client ID as a parameter.
<clientId> represents the client ID from your application created on the dashboard.
The -s flag allows you to pass in a client secret as a parameter.
<clientSecret> represents the client secret from your application created on the dashboard.
The -a flag allows you to pass in an alias that will be associated with the application you want to log into on your terminal (this is useful when switching between multiple applications).
Install the resources plugin
To get started, you need to install the resources plugin so that you can execute CRUD operations on the API resources. To do that, use the command below:
1
cl plugins:install resources
Copied!
You can run the command cl resources to list all the available Commerce Layer API resources and a link to the documentation of each one. Use commercelayer resources --help to see the available commands and what they do.
 For this guide, we would be using:
The commercelayer resources:create [RESOURCE] command to create new resources.
The -r, --relationship=<value> flag which defines a relationship with another resource(s).
 The -a, --attribute=<value> flag which defines the attributes of a resource that will be used.
Configure your organization
To get your organization ready to receive orders, you need to create some resources. These resources are grouped into Markets, Shipping, Payments, and Products. The sections below describe each of these resources in sequential order, and how to create them using the previously installed resources plugin of the CLI. All the resources will be created using sample data and we will add the following for each of them:
A description of the resource with a link to the related object details in the API reference.
The command for creating the resource.
The output response of the successfully run command.
A link to the related data model where you can check the flowchart that illustrates how the specific resource relates to other API entities.
When you successfully create a new resource, you can confirm this by running cl resources:list <resource_type> and checking if the resource is in the returned list (e.g. cl resources:list payment_gateways will list all the payment gateways that have been created).
Markets
Address
The address resource is the foundation of users and merchants in Commerce Layer. It includes the literal details of a physical address of a person. An address can be associated with other resources or orders as their shipping or billing addresses.
CLI command
Response
The following command creates a new address:
1
cl resources:create address -a \
2
  business="true" \
3
  company="Sample Shop SRL" \
4
  line_1="Via Roma 123" \
5
  city="Firenze" \
6
  zip_code="50123" \
7
  state_code="FI" \
8
  country_code="IT" \
9
  phone="+39 055 1234567890" \
10
  email="[email protected]"
Copied!
On successful run, the newly created address object information is prompted:
1
{
2
  id: 'dqJkunqnQa',
3
  type: 'addresses',
4
  business: true,
5
  first_name: null,
6
  last_name: null,
7
  company: 'Sample Shop SRL',
8
  full_name: 'Sample Shop SRL',
9
  line_1: 'Via Roma 123',
10
  line_2: null,
11
  city: 'Firenze',
12
  zip_code: '50123',
13
  state_code: 'FI',
14
  country_code: 'IT',
15
  phone: '+39 055 1234567890',
16
  full_address: 'Via Roma 123, 50123 Firenze FI (IT) +39 055 1234567890',
17
  name: 'Sample Shop SRL, Via Roma 123, 50123 Firenze FI (IT) +39 055 1234567890',
18
  email: '[email protected]',
19
  notes: null,
20
  lat: null,
21
  lng: null,
22
  is_localized: false,
23
  is_geocoded: false,
24
  provider_name: null,
25
  map_url: null,
26
  static_map_url: null,
27
  billing_info: null,
28
  created_at: '2022-03-17T14:27:26.526Z',
29
  updated_at: '2022-03-17T14:27:26.526Z',
30
  reference: null,
31
  reference_origin: null,
32
  metadata: {}
33
}
Copied!
Merchant
A merchant is a fiscal representative that is selling in a specific market. Tax calculators use the merchant's address to determine the tax rate for an order. The merchant needs to be associated with a billing address. To do that we will use the ID from the previously created address resource.
CLI command
Response
The following command creates a new merchant and associates it with a billing address:
1
cl resources:create merchants -a \
2
  name="Sample Shop Manager" -r \
3
  address="dqJkunqnQa"
Copied!
On successful run, the newly created merchant object information is prompted:
1
{
2
  id: 'qnzZLHrgmn',
3
  type: 'merchants',
4
  name: 'Sample Shop Manager',
5
  created_at: '2022-03-17T14:28:27.008Z',
6
  updated_at: '2022-03-17T14:28:27.008Z',
7
  reference: null,
8
  reference_origin: null,
9
  metadata: {},
10
  address: {
11
    id: 'dqJkunqnQa',
12
    type: 'addresses',
13
    business: true,
14
    first_name: null,
15
    last_name: null,
16
    company: 'Sample Shop SRL',
17
    full_name: 'Sample Shop SRL',
18
    line_1: 'Via Roma 123',
19
    line_2: null,
20
    city: 'Firenze',
21
    zip_code: '50123',
22
    state_code: 'FI',
23
    country_code: 'IT',
24
    phone: '+39 055 1234567890',
25
    full_address: 'Via Roma 123, 50123 Firenze FI (IT) +39 055 1234567890',
26
    name: 'Sample Shop SRL, Via Roma 123, 50123 Firenze FI (IT) +39 055 1234567890',
27
    email: '[email protected]',
28
    notes: null,
29
    lat: null,
30
    lng: null,
31
    is_localized: false,
32
    is_geocoded: false,
33
    provider_name: null,
34
    map_url: null,
35
    static_map_url: null,
36
    billing_info: null,
37
    created_at: '2022-03-17T14:27:26.526Z',
38
    updated_at: '2022-03-17T14:27:26.526Z',
39
    reference: null,
40
    reference_origin: null,
41
    metadata: {}
42
  }
43
}
Copied!
Merchants and Customers | Commerce Layer Data Model
Commerce Layer
Stock location
​Stock locations contain the inventory of the SKUs (stock items) that are to be sold. A new stock location needs to be associated with an address. If the address is different from the merchant's one, then you should create a new address following the same method above and use the new address ID here. To keep it simple, we’ll use the merchant’s address.
CLI command
Response
The following command creates a new stock location and associates it with an address:
1
cl resources:create stock_locations -a \
2
  name="Europe Warehouse" -r \
3
  address="dqJkunqnQa"
Copied!
On successful run, the newly created stock location object information is prompted:
1
{
2
  id: 'okdYzuXRDM',
3
  type: 'stock_locations',
4
  number: 8207,
5
  name: 'Europe Warehouse',
6
  label_format: 'PDF',
7
  suppress_etd: null,
8
  created_at: '2022-03-17T14:29:43.763Z',
9
  updated_at: '2022-03-17T14:29:43.763Z',
10
  reference: null,
11
  reference_origin: null,
12
  metadata: {},
13
  address: {
14
    id: 'dqJkunqnQa',
15
    type: 'addresses',
16
    business: true,
17
    first_name: null,
18
    last_name: null,
19
    company: 'Sample Shop SRL',
20
    full_name: 'Sample Shop SRL',
21
    line_1: 'Via Roma 123',
22
    line_2: null,
23
    city: 'Firenze',
24
    zip_code: '50123',
25
    state_code: 'FI',
26
    country_code: 'IT',
27
    phone: '+39 055 1234567890',
28
    full_address: 'Via Roma 123, 50123 Firenze FI (IT) +39 055 1234567890',
29
    name: 'Sample Shop SRL, Via Roma 123, 50123 Firenze FI (IT) +39 055 1234567890',
30
    email: '[email protected]',
31
    notes: null,
32
    lat: null,
33
    lng: null,
34
    is_localized: false,
35
    is_geocoded: false,
36
    provider_name: null,
37
    map_url: null,
38
    static_map_url: null,
39
    billing_info: null,
40
    created_at: '2022-03-17T14:27:26.526Z',
41
    updated_at: '2022-03-17T14:27:26.526Z',
42
    reference: null,
43
    reference_origin: null,
44
    metadata: {}
45
  }
46
}
Copied!
Stock Locations | Commerce Layer Data Model
Commerce Layer
Inventory model
An inventory model defines a list of stock locations ordered by priority. The priority determines how the availability of SKUs gets calculated within a market. If an order contains line items from two or more stock locations, the order can be split into two or more shipments, according to the selected inventory strategy.
CLI command
Response
The following command creates a new inventory model:
1
cl resources:create inventory_models -a name="EUR Inventory"
Copied!
On successful run, the newly created inventory model object information is prompted:
1
{
2
  id: 'kZXEvSYlra',
3
  type: 'inventory_models',
4
  name: 'EUR Inventory',
5
  strategy: 'split_shipments',
6
  stock_locations_cutoff: 2,
7
  created_at: '2022-03-17T14:32:17.869Z',
8
  updated_at: '2022-03-17T14:32:17.869Z',
9
  reference: null,
10
  reference_origin: null,
11
  metadata: {}
12
}
Copied!
Inventory Models | Commerce Layer Data Model
Commerce Layer
Inventory stock location
​Inventory stock locations build a hierarchy of stock locations within an inventory model. In cases where an SKU is available in more stock locations, it gets shipped from the one with the highest priority. You can decide to put the associated shipments on hold if fulfilled from a specific stock location (false by default). This is useful to manage use cases like back-orders, pre-orders, or personalized orders that need to be customized before being fulfilled. To create a new inventory stock location, you need to associate it with a stock location and an inventory model. We will use the ones we created earlier.
CLI command
Response
The following command creates a new inventory stock location and associates it with a stock location and an inventory model:
1
cl resources:create inventory_stock_locations -r \
2
  inventory_model="kZXEvSYlra" \
3
  stock_location="okdYzuXRDM" -a \
4
  priority="4"
Copied!
On successful run, the newly created inventory stock location object information is prompted:
1
{
2
  id: 'aWDOVSOBzj',
3
  type: 'inventory_stock_locations',
4
  priority: 4,
5
  on_hold: false,
6
  created_at: '2022-03-17T14:33:20.771Z',
7
  updated_at: '2022-03-17T14:33:20.771Z',
8
  reference: null,
9
  reference_origin: null,
10
  metadata: {},
11
  stock_location: {
12
    id: 'okdYzuXRDM',
13
    type: 'stock_locations',
14
    number: 8207,
15
    name: 'Europe Warehouse',
16
    label_format: 'PDF',
17
    suppress_etd: null,
18
    created_at: '2022-03-17T14:29:43.763Z',
19
    updated_at: '2022-03-17T14:29:43.763Z',
20
    reference: null,
21
    reference_origin: null,
22
    metadata: {}
23
  },
24
  inventory_model: {
25
    id: 'kZXEvSYlra',
26
    type: 'inventory_models',
27
    name: 'EUR Inventory',
28
    strategy: 'split_shipments',
29
    stock_locations_cutoff: 2,
30
    created_at: '2022-03-17T14:32:17.869Z',
31
    updated_at: '2022-03-17T14:32:17.869Z',
32
    reference: null,
33
    reference_origin: null,
34
    metadata: {}
35
  }
36
}
Copied!
Price list
​Price lists determine the SKU prices and their currency within a market. When you create a price list you have to specify the related currency and you can decide whether the associated prices include taxes or not (by default taxes are included).
CLI command
Response
The following command creates a new price list associated with the European currency, with tax included (default):
1
cl resources:create price_lists -a \
2
  name="Euros Price List" \
3
  currency_code="EUR"
Copied!
On successful run, the newly created price list object information is prompted. You can see that the taxes have been included by default:
1
{
2
  id: 'dlwQyCXnqB',
3
  type: 'price_lists',
4
  name: 'Euros Price List',
5
  currency_code: 'EUR',
6
  tax_included: true,
7
  created_at: '2022-03-17T14:37:44.720Z',
8
  updated_at: '2022-03-17T14:37:44.720Z',
9
  reference: null,
10
  reference_origin: null,
11
  metadata: {}
12
}
Copied!
Price Lists and Currencies | Commerce Layer Data Model
Commerce Layer
Market
A market is an aggregation of business rules, often determined by a geographical region where merchants can sell items and customers can purchase. An organization may have one or more markets associated with a merchant, inventory model, SKUs, price lists, stock items, customer groups, and more. When you create a new market you need at least to associate it with a merchant, an inventory model, and a price list. We will use the ones we created earlier.
CLI command
Response
The following command creates a new market and associate it list associates it with a merchant, an inventory model, and a price list:
1
cl resources:create markets -r \
2
  merchant="qnzZLHrgmn" \
3
  inventory_model="kZXEvSYlra" \
4
  price_list="dlwQyCXnqB" -a \
5
  name="Europe"
Copied!
On successful run, the newly created market object information is prompted:
1
{
2
  id: 'BjydJhAPko',
3
  type: 'markets',
4
  number: 9656,
5
  name: 'Europe',
6
  facebook_pixel_id: null,
7
  checkout_url: null,
8
  external_prices_url: null,
9
  private: false,
10
  created_at: '2022-03-17T14:39:47.525Z',
11
  updated_at: '2022-03-17T14:39:47.525Z',
12
  reference: null,
13
  reference_origin: null,
14
  metadata: {},
15
  merchant: {
16
    id: 'qnzZLHrgmn',
17
    type: 'merchants',
18
    name: 'Sample Shop Manager',
19
    created_at: '2022-03-17T14:28:27.008Z',
20
    updated_at: '2022-03-17T14:28:27.008Z',
21
    reference: null,
22
    reference_origin: null,
23
    metadata: {}
24
  },
25
  price_list: {
26
    id: 'dlwQyCXnqB',
27
    type: 'price_lists',
28
    name: 'Euros Price List',
29
    currency_code: 'EUR',
30
    tax_included: true,
31
    created_at: '2022-03-17T14:37:44.720Z',
32
    updated_at: '2022-03-17T14:37:44.720Z',
33
    reference: null,
34
    reference_origin: null,
35
    metadata: {}
36
  },
37
  inventory_model: {
38
    id: 'kZXEvSYlra',
39
    type: 'inventory_models',
40
    name: 'EUR Inventory',
41
    strategy: 'split_shipments',
42
    stock_locations_cutoff: 2,
43
    created_at: '2022-03-17T14:32:17.869Z',
44
    updated_at: '2022-03-17T14:32:17.869Z',
45
    reference: null,
46
    reference_origin: null,
47
    metadata: {}
48
  }
49
}
Copied!
Markets and Business Models | Commerce Layer Data Model
Commerce Layer
Shipping
Shipping category
​Shipping categories determine which shipping methods are available for the associated SKUs. With this, an order will be split into multiple shipments if it contains line items belonging to more than one shipping category.
CLI command
Response
The following command creates a new shipping category:
1
cl resources:create shipping_categories -a name="Demo Shipping Category"
Copied!
On successful run, the newly created shipping category object information is prompted:
1
{
2
  id: 'MWjgYFbYVK',
3
  type: 'shipping_categories',
4
  name: 'Demo Shipping Category',
5
  created_at: '2022-03-17T14:41:06.380Z',
6
  updated_at: '2022-03-17T14:41:06.380Z',
7
  reference: null,
8
  reference_origin: null,
9
  metadata: {}
10
}
Copied!
Shipments and Shipping Categories | Commerce Layer Data Model
Commerce Layer
Shipping zone
​Shipping zones determine the available shipping method(s) for a given shipping address. The match is evaluated against a set of regular expressions on the address (country, state, or zip code) of a customer. Now let’s create a new shipping zone to match Italy (IT), Spain (ES), Germany (DE), France (FR), and the United Kingdom (UK).
CLI command
Response
The following command creates a new shipping zone to match Italy (IT), Spain (ES), Germany (DE), France (FR), and the United Kingdom (UK):
1
cl resources:create shipping_zones -a \
2
  name="European Countries" \
3
  country_code_regex="IT|ES|DE|FR|UK"
Copied!
On successful run, the newly created shipping zone object information is prompted:
1
{
2
  id: 'kKwxmtNVYv',
3
  type: 'shipping_zones',
4
  name: 'European Countries',
5
  country_code_regex: 'IT|ES|DE|FR|UK',
6
  not_country_code_regex: null,
7
  state_code_regex: null,
8
  not_state_code_regex: null,
9
  zip_code_regex: null,
10
  not_zip_code_regex: null,
11
  created_at: '2022-03-17T14:41:39.794Z',
12
  updated_at: '2022-03-17T14:41:39.794Z',
13
  reference: null,
14
  reference_origin: null,
15
  metadata: {}
16
}
Copied!
Shipping Zones and Methods | Commerce Layer Data Model
Commerce Layer
Shipping method
​Shipping methods are used to provide customers with delivery options. Each shipping method can have a price and can be free if the order total is over a certain amount or based on some specific promotion rules. When you create a new shipping method you need to specify its cost (amount) and the currency code. If you associate the shipping method with a market, the currency will be inherited from the market's price list. You need also to associate it with a shipping zone and a shipping category. We will use the previously created ones.
CLI command
Response
The following command creates a new shipping method and associates it with a market, a shipping zone, and a shipping category.
1
cl resources:create shipping_methods -r \
2
  market="BjydJhAPko" \
3
  shipping_zone="kKwxmtNVYv" \
4
  shipping_category="MWjgYFbYVK" -a \
5
  name="Express Delivery" \
6
  price_amount_cents="960" \
7
  free_over_amount_cents="8900"
Copied!
On successful run, the newly created shipping method object information is prompted. You can see that the currency code (EUR) has been inherited by the market's price list:
1
{
2
  id: 'bVlBrFyGKO',
3
  type: 'shipping_methods',
4
  name: 'Express Delivery',
5
  currency_code: 'EUR',
6
  disabled_at: null,
7
  price_amount_cents: 960,
8
  price_amount_float: 9.6,
9
  formatted_price_amount: '€9,60',
10
  free_over_amount_cents: 8900,
11
  free_over_amount_float: 89,
12
  formatted_free_over_amount: '€89,00',
13
  price_amount_for_shipment_cents: 960,
14
  price_amount_for_shipment_float: 9.6,
15
  formatted_price_amount_for_shipment: '€9,60',
16
  created_at: '2022-03-17T14:44:22.650Z',
17
  updated_at: '2022-03-17T14:44:22.650Z',
18
  reference: null,
19
  reference_origin: null,
20
  metadata: {},
21
  market: {
22
    id: 'BjydJhAPko',
23
    type: 'markets',
24
    number: 9656,
25
    name: 'Europe',
26
    facebook_pixel_id: null,
27
    checkout_url: null,
28
    external_prices_url: null,
29
    private: false,
30
    created_at: '2022-03-17T14:39:47.525Z',
31
    updated_at: '2022-03-17T14:39:47.525Z',
32
    reference: null,
33
    reference_origin: null,
34
    metadata: {}
35
  },
36
  shipping_zone: {
37
    id: 'kKwxmtNVYv',
38
    type: 'shipping_zones',
39
    name: 'European Countries',
40
    country_code_regex: 'IT|ES|DE|FR|UK',
41
    not_country_code_regex: null,
42
    state_code_regex: null,
43
    not_state_code_regex: null,
44
    zip_code_regex: null,
45
    not_zip_code_regex: null,
46
    created_at: '2022-03-17T14:41:39.794Z',
47
    updated_at: '2022-03-17T14:41:39.794Z',
48
    reference: null,
49
    reference_origin: null,
50
    metadata: {}
51
  },
52
  shipping_category: {
53
    id: 'MWjgYFbYVK',
54
    type: 'shipping_categories',
55
    name: 'Demo Shipping Category',
56
    created_at: '2022-03-17T14:41:06.380Z',
57
    updated_at: '2022-03-17T14:41:06.380Z',
58
    reference: null,
59
    reference_origin: null,
60
    metadata: {}
61
  }
62
}
Copied!
Shipping Zones and Methods | Commerce Layer Data Model
Commerce Layer
Payments
Payment gateway
​Payment gateways allow users to process payments through Commerce Layer's API. By default, we currently support Adyen, Braintree, Checkout.com, Klarna, PayPal, and Stripe. Manual gateways are also available (useful to process payments through wire transfer, cash, and other kinds of manual payment options). On top of that, external gateways let you integrate any payment service that is not available out-of-the-box (even your custom one). You can check the API references of each of them to understand the attributes/relationships required for their creation. For the purpose of this guide, we will create a manual gateway
CLI command
Response
The following command creates a new manual payment gateway:
1
cl resources:create manual_gateways -a name="Manual Gateway"
Copied!
On successful run, the newly created manual payment gateway object information is prompted:
1
{
2
  id: 'ExJwlspqmv',
3
  type: 'manual_gateways',
4
  name: 'Manual Gateway',
5
  created_at: '2022-03-17T14:45:27.063Z',
6
  updated_at: '2022-03-17T14:45:27.063Z',
7
  reference: null,
8
  reference_origin: null,
9
  metadata: {},
10
  require_capture: null
11
}
Copied!
You can use the command cl resources:list payment_gateways to list all the payment gateway(s) created or cl resources:list <gateway_type>_gateways to list only the specified ’s payment gateways created.
Payment Gateways | Commerce Layer Data Model
Commerce Layer
Payment method
​Payment methods represent the type of payment sources (e.g. credit card, PayPal, or Apple Pay) offered in a market. They can have a price and must be present before placing an order. By default, we currently support the following payment source types: Adyen payment, Braintree payment, Checkout.com payment, credit card, PayPal payment, Stripe payment, external payment, or wire transfer — based on the payment gateway to be associated with. The manual payment gateway only accepts the wire transfer payment source type and that's the one we will use to create the payment method, associated with the previously created payment gateway.
CLI command
Response
The following command creates a new payment method and associates it with a manual payment gateway and a wire transfer payment source:
1
cl resources:create payment_methods -r \
2
  market="BjydJhAPko" \
3
  payment_gateway="ExJwlspqmv" -a \
4
  payment_source_type="WireTransfer"
Copied!
On successful run, the newly created payment method object information is prompted:
1
{
2
  id: 'lMAeGsQQWM',
3
  type: 'payment_methods',
4
  payment_source_type: 'wire_transfers',
5
  name: 'Wire Transfer',
6
  currency_code: 'EUR',
7
  moto: false,
8
  disabled_at: null,
9
  price_amount_cents: 0,
10
  price_amount_float: 0,
11
  formatted_price_amount: '€0,00',
12
  created_at: '2022-03-17T14:50:17.021Z',
13
  updated_at: '2022-03-17T14:50:17.021Z',
14
  reference: null,
15
  reference_origin: null,
16
  metadata: {},
17
  market: {
18
    id: 'BjydJhAPko',
19
    type: 'markets',
20
    number: 9656,
21
    name: 'Europe',
22
    facebook_pixel_id: null,
23
    checkout_url: null,
24
    external_prices_url: null,
25
    private: false,
26
    created_at: '2022-03-17T14:39:47.525Z',
27
    updated_at: '2022-03-17T14:39:47.525Z',
28
    reference: null,
29
    reference_origin: null,
30
    metadata: {}
31
  },
32
  payment_gateway: {
33
    id: 'ExJwlspqmv',
34
    type: 'payment_gateways',
35
    name: 'Manual Gateway',
36
    created_at: '2022-03-17T14:45:27.063Z',
37
    updated_at: '2022-03-17T14:45:27.063Z',
38
    reference: null,
39
    reference_origin: null,
40
    metadata: {}
41
  }
42
}
Copied!
Payment Methods | Commerce Layer Data Model
Commerce Layer
Products
SKUs
​SKUs describe specific product variations that are being sold. To create an SKU you need to associate it with a shipping category that determines the available shipping options for that SKU. We will use the previously created one. You can add any additional optional attribute that fits your needs.
CLI command
Response
The following command created a new SKU and associates it with a shipping category:
1
cl resources:create skus -r \
2
  shipping_category="MWjgYFbYVK" -a \
3
  code="SKUCODE0001XLXX" \
4
  name="Grey Aeron Ergonomic Office Chair" \
5
  description="Aeron office chair is a revolutionized office seating with its defining design qualities and its patented PostureFit SL back support..." \
6
  image_url="https://images.hermanmiller.group/m/7b7b8463a1433d26/W-REK_18179_20160811174200565.png" \
7
  reference="SKUCODE0001" \
8
  do_not_ship="false" \
9
  do_not_track="false" \
10
  weight="500" \
11
  unit_of_weight="gr"
Copied!
On successful run, the newly created SKU object information is prompted:
1
{
2
  id: 'BorzSOKrYq',
3
  type: 'skus',
4
  code: 'SKUCODE0001XLXX',
5
  name: 'Grey Aeron Ergonomic Office Chair',
6
  description: 'Aeron office chair is a revolutionized office seating with its defining design qualities and its patented PostureFit SL back support...',
7
  image_url: 'https://images.hermanmiller.group/m/7b7b8463a1433d26/W-REK_18179_20160811174200565.png',
8
  pieces_per_pack: null,
9
  weight: 500,
10
  unit_of_weight: 'gr',
11
  hs_tariff_number: null,
12
  do_not_ship: false,
13
  do_not_track: false,
14
  created_at: '2022-03-17T14:54:33.123Z',
15
  updated_at: '2022-03-17T14:54:33.123Z',
16
  reference: 'SKUCODE0001',
17
  reference_origin: null,
18
  metadata: {},
19
  shipping_category: {
20
    id: 'MWjgYFbYVK',
21
    type: 'shipping_categories',
22
    name: 'Demo Shipping Category',
23
    created_at: '2022-03-17T14:41:06.380Z',
24
    updated_at: '2022-03-17T14:41:06.380Z',
25
    reference: null,
26
    reference_origin: null,
27
    metadata: {}
28
  }
29
}
Copied!
SKUs | Commerce Layer Data Model
Commerce Layer
Stock items
A stock item keeps the available inventory of an SKU in a given stock location. When you create a stock item, you must specify its quantity, and the associated SKU must be available in one of the market's stock locations.
CLI command
Response
The following command creates a new stock item for a given SKU and associates it with a stock location:
1
cl resources:create stock_items -a \
2
  sku_code="SKUCODE0001XLXX" \
3
  quantity="100" -r \
4
  stock_location="okdYzuXRDM"
Copied!
On successful run, the newly created stock item object information is prompted:
1
{
2
  id: 'YqAwfbkwlk',
3
  type: 'stock_items',
4
  sku_code: 'SKUCODE0001XLXX',
5
  quantity: 100,
6
  created_at: '2022-03-17T14:56:11.749Z',
7
  updated_at: '2022-03-17T14:56:11.749Z',
8
  reference: null,
9
  reference_origin: null,
10
  metadata: {},
11
  stock_location: {
12
    id: 'okdYzuXRDM',
13
    type: 'stock_locations',
14
    number: 8207,
15
    name: 'Europe Warehouse',
16
    label_format: 'PDF',
17
    suppress_etd: null,
18
    created_at: '2022-03-17T14:29:43.763Z',
19
    updated_at: '2022-03-17T14:29:43.763Z',
20
    reference: null,
21
    reference_origin: null,
22
    metadata: {}
23
  }
24
}
Copied!
Stock Items | Commerce Layer Data Model
Commerce Layer
Prices
​Prices are the defined cost price of an SKU associated with a currency and price list. When a customer purchases an SKU, it gets the price associated with the order's price list for that market. 
When you create a price, you must specify the amount and the compare-at amount. The currency is defined by the associated price list.
CLI command
Response
The following command creates a price for a given SKU and associates it with a price list:
1
cl resources:create prices -a \
2
  sku_code="SKUCODE0001LXXX" \
3
  amount_cents="4990" \
4
  compare_at_amount_cents="4500" -r \
5
  sku="BorzSOKrYq" \
6
  price_list="dlwQyCXnqB"
Copied!
On successful run, the newly created price object information is prompted:
1
{
2
  id: 'anOlUkBkyE',
3
  type: 'prices',
4
  currency_code: 'EUR',
5
  sku_code: 'SKUCODE0001XLXX',
6
  amount_cents: 4990,
7
  amount_float: 49.9,
8
  formatted_amount: '€49,90',
9
  compare_at_amount_cents: 4990,
10
  compare_at_amount_float: 49.9,
11
  formatted_compare_at_amount: '€49,90',
12
  created_at: '2022-03-17T14:57:14.467Z',
13
  updated_at: '2022-03-17T14:57:14.467Z',
14
  reference: null,
15
  reference_origin: null,
16
  metadata: {},
17
  price_list: {
18
    id: 'dlwQyCXnqB',
19
    type: 'price_lists',
20
    name: 'Euros Price List',
21
    currency_code: 'EUR',
22
    tax_included: true,
23
    created_at: '2022-03-17T14:37:44.720Z',
24
    updated_at: '2022-03-17T14:37:44.720Z',
25
    reference: null,
26
    reference_origin: null,
27
    metadata: {}
28
  },
29
  sku: {
30
    id: 'BorzSOKrYq',
31
    type: 'skus',
32
    code: 'SKUCODE0001XLXX',
33
    name: 'Grey Aeron Ergonomic Office Chair',
34
    description: 'Aeron office chair is a revolutionized office seating with its defining design qualities and its patented PostureFit SL back support...',
35
    image_url: 'https://images.hermanmiller.group/m/7b7b8463a1433d26/W-REK_18179_20160811174200565.png',
36
    pieces_per_pack: null,
37
    weight: 500,
38
    unit_of_weight: 'gr',
39
    hs_tariff_number: null,
40
    do_not_ship: false,
41
    do_not_track: false,
42
    created_at: '2022-03-17T14:54:33.123Z',
43
    updated_at: '2022-03-17T14:54:33.123Z',
44
    reference: 'SKUCODE0001',
45
    reference_origin: null,
46
    metadata: {}
47
  }
48
}
Copied!
Price Lists and Currencies | Commerce Layer Data Model
Commerce Layer
Import additional resources
Commerce Layer lets you import multiple resources (e.g. orders, coupons, SKUs, prices, stock items, customers, and more) in batches directly with our imports API. All you have to do is create a new import resource, specify the resource type you want to import, and populate the inputs attribute with a JSON list of items. Each element of the inputs array contains the resource attributes and relationships. You can learn more about importing resources in our documentation.
Importing resources
To do that using the CLI, first you need to install the imports plugin:
1
cl plugins:install imports
Copied!
Then create a JSON file named skus.json with an array containing the list of additional SKUs you want to import:
1
[
2
  {
3
    "code": "BEACHBAGFFFFFF000000XXXX",
4
    "name": "White Beach Bag with Black Logo",
5
    "description": "Meet your companion for a sunny summer day — our beach bag! It's large, comfy, and you can match it with our towel to create the perfect beach combo.",
6
    "image_url": "https://data.commercelayer.app/seed/images/skus/BEACHBAGFFFFFF000000XXXX_FLAT.png",
7
    "reference": "BEACHBAGFFFFFF000000",
8
    "shipping_category_id": "MWjgYFbYVK"
9
  },
10
  {
11
    "code": "BEANIEXX000000FFFFFFXXXX",
12
    "name": "Black Beanie with White Logo",
13
    "description": "Soft double-layered customizable beanie. 95% polyester, 5% spandex. Regular fit. Accurately printed, cut, and hand-sewn.",
14
    "image_url": "https://data.commercelayer.app/seed/images/skus/BEANIEXX000000FFFFFFXXXX_FLAT.png",
15
    "reference": 