ItemListingInput Input

Description

Input fields for creating or updating a listing, including stock, status, pricing, location, and other listing-specific information.

Declaration

input ItemListingInput {
    stock: ItemListingInputStock
    status: String!
    available: String!
    posted: String
    secondHand: Boolean
    location: String
    supplierCode: String
    categories: [String!]
    comments: String
    taxDefinition: String
    options: [ItemListingInputOption]
    prices: ItemListingInputPrices
    barcode: String
    sku: String
    privateComments: String
    onePerCustomer: Boolean
    preventDiscogsListing: Boolean
    preOrder: Boolean
    discogsId: Float
}

Fields

Name	Type	Description
stock	ItemListingInputStock	Stock information including quantity available.
status	String!	Listing status. Valid values include "published" (visible to customers), "draft" (not visible), or "private" (visible only to admins).
available	String!	Date when the listing becomes available for purchase, in ISO 8601 format (YYYY-MM-DD).
posted	String	Date when the listing was posted or published, in ISO 8601 format (YYYY-MM-DD).
secondHand	Boolean	Whether this listing is for a second-hand item.
location	String	Location name where the item is stored or available.
supplierCode	String	Supplier code associated with this listing.
categories	[String!]	List of category names to associate this listing with.
comments	String	Public comments or notes about the listing, visible to customers.
taxDefinition	String	Tax definition identifier to apply to this listing for tax calculation.
options	[ItemListingInputOption]	List of option values for variant listings (e.g., size, color, format).
prices	ItemListingInputPrices	Pricing information including cost, sale price, and compare-at price.
barcode	String	Barcode (UPC, EAN, etc.) for the listing.
sku	String	Stock keeping unit (SKU) identifier for the listing.
privateComments	String	Private comments or notes about the listing, visible only to admins.
onePerCustomer	Boolean	Whether this listing can only be purchased once per customer.
preventDiscogsListing	Boolean	Whether to prevent this listing from being automatically listed on Discogs when Discogs sync is enabled.
preOrder	Boolean	Whether this listing is available for pre-order (item not yet available but can be ordered).
discogsId	Float	Discogs listing ID if this listing is synchronized with Discogs marketplace.