markets_write
Arguments
ID!
required
The id of the import restriction.
String!
required
What the merchant holds that satisfies the rule, such as a permit number.
Returns
An import rule of a destination country that screening found products in the catalog trip. Only rules found in the last 21 days, in countries of enabled markets with restriction screening on, are visible.
Show fields
Show fields
required
The products in the catalog that trip the rule.Requires:
products_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns products after it.
String
Backward pagination cursor — returns products before it.
Int
Forward pagination: returns the first N products (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N products (max 100, default 25). Use with
before; mutually exclusive with first/after.required
required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Show fields
Show fields
Look up a single attribute on this product by its name, if set.Requires:
products_readShow fields
Show fields
Arguments
String!
required
The machine name of the attribute to look up.
required
The merchant-defined attributes set on this product.
[String!]!
required
Barcodes associated with this product.
String!
required
The product’s long-form description.
The product’s length, width, and height, expressed in a single shared unit.
String
The Harmonized System code used for customs.
ID!
required
The id of this product.
The first (default) image for this product, if any.Requires:
products_readrequired
A paginated list of the product’s images.Requires:
products_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.The import restrictions the product trips, one per destination country and rule. Only countries of enabled markets with restriction screening on are screened, and a restriction drops off 21 days after screening last found it.Requires:
markets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns import restrictions after it.
String
Backward pagination cursor — returns import restrictions before it.
Int
Forward pagination: returns the first N import restrictions (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N import restrictions (max 100, default 25). Use with
before; mutually exclusive with first/after.required
Traceable inventory units for this product.Requires:
inventory_readThis product’s inventory level at a single location, if any.Requires:
inventory_readShow fields
Show fields
Arguments
ID!
required
The id of the location to fetch the level at.
Per-location inventory levels for this product.Requires:
inventory_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.Publishing per destination country where the product trips an import restriction, or has a publish override. Only countries of enabled markets with restriction screening on are screened. Null when publishing can’t be read.Requires:
markets_readrequired
The variant’s selected option values (e.g. Size: M, Color: Red), ordered by the family’s option positions.
String
The country of origin, as a country code.
Boolean!
required
Whether the product is a physical, shippable item.
The product family this product belongs to, if any.Requires:
products_readString
The stock keeping unit identifying this product.
[String!]!
required
Free-form tags applied to the product.
String
The tax code used to classify the product for taxation.
Boolean!
required
Whether the product is subject to tax.
String!
required
The product’s title.
String
The Universal Product Code for this product.
String
The vendor or manufacturer of the product.
Pagination metadata for the current page.
Show fields
Show fields
String
Cursor of the last edge in this page; pass to
after to page forward.Boolean!
required
Whether more items exist after this page (drives forward pagination with
first/after).Boolean!
required
Whether more items exist before this page (drives backward pagination with
last/before).String
Cursor of the first edge in this page; pass to
before to page backward.The kind of rule. Null when the source does not say.
required
The destination country that imposes the restriction.
ID!
required
The id of this import restriction.
The market that sells into the restriction’s country.Requires:
markets_readShow fields
Show fields
required
How uncharged landed-cost lines appear in the checkout breakdown.
required
required
The destination countries this market sells into.
required
Landed-cost components whose checkout charge is absorbed by the markup, drawn down in order.
Boolean!
required
Whether the market’s pricing is live.
required
Landed-cost components neither charged nor shown at checkout.
ID!
required
The id of this market.
required
Landed-cost components baked into product prices.
required
How the markup combines with the landed cost in the price.
String
The merchant-set name. Null when unnamed; the countries then identify the market.
required
How landed costs are turned into prices.
String!
required
The ISO 4217 currency of the store’s base prices, which the market’s prices are converted from.
String
A link to the regulation or source the rule comes from, when known.
String
The note recorded when the rule was marked resolved. Null while open.
Who marked the rule resolved: a team member or an API token. Null while open, when an automation or a change before this field resolved it, or when the team member has left the team.Requires:
markets_readrequired
Whether the merchant has marked the rule resolved.
String!
required
A plain-language summary of what the rule requires.
required
The most severe tier at which any product in the catalog trips the rule.
Example
mutation {
importRestrictionResolve(id: "...", note: "...") {
affectedProducts {
nodes {
barcodes
createdAt
description
hsCode
id
originCountry
physicalItem
sku
# ...
}
pageInfo { hasNextPage endCursor }
}
category
countryCode
id
lastSeenAt
regulationUrl
resolutionNote
resolvedAt
# ...
}
}