OBJECT
Advert
An advert
link GraphQL Schema definition
- type Advert implements Node {
- # This field returns option type values set to the advert.
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- (
- String, :
- String, :
- Int, :
- Int :
- ): AdvertOptionValueConnection!
- # Availability of the advert
- AdvertAvailabilityEnum!]! : [
- # The additional cost of shipping the advert domestically, which is added to the
- # Sellers base domestic shipping rate.
- Float :
- # The additional cost of shipping the advert internationally, which is added to
- # the Sellers base international shipping rate.
- Float :
- # Terms & conditions text to display on the advert.
- String :
- Brand :
- # Brand labels before being mapped to a canonical brand. (Includes the original
- # values for both unmapped and mapped brands)
- String!]! : [
- CatalogRulesError!] : [
- # Optional product code for the advert.
- String :
- AdvertConditionEnum! :
- ISO8601DateTime! :
- # Custom form template information for the advert
- CustomFormTemplate :
- # A thumbnail image for an associated customIframeUrl
- Image :
- # A link to a video hosted on one of a number of supported custom domains. Contact
- # Marketplacer support for a full list of supported domains.If supplying a
- # customIframeUrl, you must also supply a customIframeThumbnail.
- String :
- # Description provided by seller as markdown
- String :
- # Description converted to HTML
- String :
- # Image to display on the advert tile.
- Image :
- # Whether to display the given advert.
- Boolean! :
- # PDF documents for information on advert
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- String, : String, : Int, : Int): AdvertDocumentsConnection ( :
- Float @deprecated( reason: "Use `base_domestic_shipping_cost` instead." ) :
- # This field returns option values from single-select option types.
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- (
- String, :
- String, :
- Int, :
- Int :
- ): OptionalOptionValueConnection! @deprecated( reason: "This field is deprecated in favour of AdvertOptionValues." )
- # Price used for editing by sellers
- Decimal :
- # Price used for editing by sellers Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use the string version instead. This field will be removed no earlier than July 1st, 2025.
" ) :
- # Price used for editing by sellers In string with currency symbol.
- #
- # Arguments
- # currency: Currency in which to display money fields. Defaults
- # to the currency of the marketplace's home country.
- String): String ( :
- # Price used for editing by sellers
- Decimal :
- # Price used for editing by sellers Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use the string version instead. This field will be removed no earlier than July 1st, 2025.
" ) :
- # Price used for editing by sellers In string with currency symbol.
- #
- # Arguments
- # currency: Currency in which to display money fields. Defaults
- # to the currency of the marketplace's home country.
- String): String ( :
- ErrorMessage!]! : [
- # An ID that is managed the retailer.
- String :
- # A collection of key / value pair external IDs that can be added to the Advert
- # using externalIdUpsert and advertUpsert.
- ExternalID!]! : [
- # This field returns option values from multi-select option types.
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- (
- String, :
- String, :
- Int, :
- Int :
- ): OptionValueConnection! @deprecated( reason: "This field is deprecated in favour of AdvertOptionValues." )
- # This field returns values from free-text option types.
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- (
- String, :
- String, :
- Int, :
- Int :
- ): FreetextOptionValueConnection! @deprecated( reason: "This field is deprecated in favour of AdvertOptionValues." )
- # Title for display (may include Brand and Model Year depending on configuration)
- String! :
- AdvertGenderEnum :
- # Golden Product associated to this advert
- GoldenProduct :
- # Do any of the variants have duplicate barcodes Only accessible to users:
- # admin_authorized, api_key_users. And admin users with permissions: 'Manage
- # product catalog', 'Full GraphQL API access'.
- Boolean :
- Boolean :
- Boolean @deprecated( reason: "Use `has_free_international_shipping` instead." ) :
- Boolean :
- Boolean @deprecated( reason: "Use `has_free_domestic_shipping` instead." ) :
- # Whether advert has invalid variants
- Boolean! :
- ID! :
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- String, : String, : Int, : Int): ImagesConnection! ( :
- Float @deprecated( reason: "Use `base_international_shipping_cost` instead." ) :
- Boolean :
- # Whether the advert is to be featured above other adverts. Only used in Full
- # Stack configurations.
- Boolean :
- # Whether the advert is currently part of an active promotion.
- Boolean :
- # The individual item tax rate on advert.
- Decimal :
- # Human readable version of the ID.
- Int! :
- # Lowest non-sale price available for the item.
- String :
- # Lowest non-sale price available for the item. Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use lowestOriginalPrice instead. This field will be removed no earlier than July 1st, 2025." ) :
- # Lowest non-sale price available for the item in session currency. Useful for
- # display purpose only as all monetary transactions will be charged in the
- # marketplace currency.
- String :
- # Absolute lowest price (sale price or original price) available for the item.
- String :
- # Absolute lowest price (sale price or original price) available for the item.
- # Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use lowestPrice instead. This field will be removed no earlier than July 1st, 2025." ) :
- # Absolute lowest price (sale price or original price) available for the item in
- # session currency. Useful for display purpose only as all monetary transactions
- # will be charged in the marketplace currency.
- String :
- # Maximum purchase quantity allowed for successful checkout
- Int :
- # Price Unit as a Configurable Unit of Measure
- MeasurementUnit :
- # Metadata key/values Only accessible to users: admin_authorized,
- # seller_authorized. And admin users with permissions: 'Manage product catalog',
- # 'Full GraphQL API access'.
- Metadatum!]! : [
- # Minimum purchase quantity required for successful checkout
- Int :
- # Represents an associated Golden Record as defined in the Central Product
- # Database (CPD). An advert will only have an associated model if it was created
- # as part of the CPD backfill process, otherwise it will be null.
- Model :
- # The status of an advert, determined by the relationship of the advert and it's
- # sellers online status
- Boolean! :
- # Country of origin in ISO 2 format
- String :
- # Original price formatted as a string (e.g. 'From $30')
- String @deprecated( reason: "Using this field may trigger significant slowdowns. Deprecated in favour of the `original_price_formatted` on ES Adverts" ) :
- String! :
- # Used when the price of an advert can vary, e.g. prices starting from etc.
- AdvertPriceTypeEnum :
- # Unit of measure or time associated with the advert.
- AdvertPriceUnitEnum :
- # This field returns key-value pairs of single-select and free-text option type
- # values.
- KeyValue!] @deprecated( reason: "This field is deprecated in favour of AdvertOptionValues." ) : [
- String!] : [
- # The name of the most recent active promotion that this advert is part of.
- String :
- # Whether seller published an advert.
- Boolean! :
- # Rating reviews
- AdvertRating :
- # The recommended retail price (RRP) for the item.
- String :
- # The recommended retail price (RRP) for the item. Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use the string version instead. This field will be removed no earlier than July 1st, 2025.
" ) :
- # The recommended retail price (RRP) for the item. In string with currency symbol.
- #
- # Arguments
- # currency: Currency in which to display money fields. Defaults
- # to the currency of the marketplace's home country.
- (
- String :
- ): String
- # Does this advert require vetting. (See "vetted" field) Only accessible to users:
- # admin_authorized, seller_authorized, api_key_users. And admin users with
- # permissions: 'Manage product catalog', 'Full GraphQL API access'.
- Boolean! :
- # Time when requires vetting is set to true Only accessible to users:
- # admin_authorized, seller_authorized, api_key_users. And admin users with
- # permissions: 'Manage product catalog', 'Full GraphQL API access'.
- ISO8601DateTime :
- # End of the period in which the sale price is valid (or null) Only accessible to
- # users: admin_authorized, seller_authorized, api_key_users. And admin users with
- # permissions: 'Manage product catalog', 'Full GraphQL API access'.
- ISO8601DateTime :
- # Sale price formatted as a string e.g. ('Now from $21')
- String @deprecated( reason: "Using this field may trigger significant slowdowns. Deprecated in favour of the `sale_price_formatted` on ES Adverts" ) :
- # Start of the period in which the sale price is valid (or null) Only accessible
- # to users: admin_authorized, seller_authorized, api_key_users. And admin users
- # with permissions: 'Manage product catalog', 'Full GraphQL API access'.
- ISO8601DateTime :
- # The channels where the advert can be purchased, e.g. on-line, click and collect
- # etc.
- AdvertSaleTypeEnum :
- # Additional taxons to permit the advert to appear in a wider variety of search
- # results.
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- String, : String, : Int, : Int): TaxonConnection! ( :
- Seller! :
- # The direct shipping parcel information for the advert
- ShippingParcel :
- # Either a direct parcel information or inferred from taxon
- ShippingParcel :
- # Brand Sizing Chart. Warning: this can be slow for many records.
- SizeMatrix :
- # Text descriptions of advert specifications.
- String :
- # HTML descriptions of advert specifications.
- String :
- # System generated value that represents the overall status of the advert, e.g.
- # "Online" Only accessible to users: admin_authorized, seller_authorized,
- # api_key_users. And admin users with permissions: 'Manage product catalog', 'Full
- # GraphQL API access'.
- String :
- String :
- # The Taxon (or Category) that an Advert belongs to - eg. Bikes, Shoes, Wigs
- Taxon! @deprecated( reason: "This field will error if we display an Advert that does not have a Taxon - ie. the Advert has been importedfrom an external source and not yet mapped to a Taxon. Deprecated in favour of taxonNullable. Will be removed 2022-05-01" ) :
- # Taxon labels before being mapped to a canonical taxon. (Includes the original
- # values for both unmapped and mapped taxons)
- String!]! : [
- # The Taxon (or Category) that an Advert belongs to - eg. Bikes, Shoes, Wigs.
- Taxon :
- # Whether therapeutic goods labelling is enabled on variants.
- Boolean! :
- # Whether therapeutic goods labelling is enabled on the vertical.
- Boolean! :
- # Title of the advert, excludes auto appended fields like Brand.
- String! :
- # The total cost of shipping one item domestically. Denominated in cents. Each
- # additional item in an order will incur the shipping cost returned in the
- # baseDomesticShippingCost field
- Int :
- # The total cost of shipping one item internationally. Denominated in cents. Each
- # additional item in an order will incur the shipping cost returned in the
- # baseInternationalShippingCost field
- Int :
- ISO8601DateTime! :
- String :
- # Variants returned are ordered by position
- #
- # Arguments
- # after: Returns the elements in the list that come after the
- # specified cursor.
- # before: Returns the elements in the list that come before the
- # specified cursor.
- # first: Returns the first _n_ elements from the list.
- # last: Returns the last _n_ elements from the list.
- # displayableOnly: Whether to only fetch variants that are
- # displayable (e.g. are valid, have inventory available)
- (
- String, :
- String, :
- Int, :
- Int, :
- Boolean :
- ): VariantConnection!
- # Has this advert been vetted. NOTE: Is only relevant if requiresVetting is true
- # Only accessible to users: admin_authorized, seller_authorized, api_key_users.
- # And admin users with permissions: 'Manage product catalog', 'Full GraphQL API
- # access'.
- Boolean! :
- # Whether the advert has undergone vetting and been rejected.
- Boolean! :
- # Time when advert was rejected Only accessible to users: admin_authorized,
- # seller_authorized, api_key_users. And admin users with permissions: 'Manage
- # product catalog', 'Full GraphQL API access'.
- ISO8601DateTime :
- # The reason why the advert was rejected.
- String :
- # The wholesale price for the item.
- String :
- # The wholesale price for the item. Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use the string version instead. This field will be removed no earlier than July 1st, 2025.
" ) :
- # The wholesale price for the item. In string with currency symbol.
- #
- # Arguments
- # currency: Currency in which to display money fields. Defaults
- # to the currency of the marketplace's home country.
- String): String ( :
- # Wholesale promo price of the advert
- Decimal :
- # Wholesale promo price of the advert Denominated in cents.
- Int @deprecated( reason: "Prices can be larger than is representable by a graphql integer. Use the string version instead. This field will be removed no earlier than July 1st, 2025.
" ) :
- # End of the period in which the wholesale promo price is valid (or null)
- ISO8601DateTime :
- # Wholesale promo price of the advert In string with currency symbol.
- #
- # Arguments
- # currency: Currency in which to display money fields. Defaults
- # to the currency of the marketplace's home country.
- String): String ( :
- # Start of the period in which the wholesale promo price is valid (or null)
- ISO8601DateTime :
- # When relevant, the model year of the product.
- Int :
- String :
- String :
- }
link Require by
- AdvertCategorySuggestionAn advert category suggestion generated by an AI.
- AdvertConnectionThe connection type for Advert.
- AdvertDeleteMutationPayloadAutogenerated return type of AdvertDeleteMutation.
- AdvertEdgeAn edge in a connection.
- AdvertPublishedUpdateMutationPayloadAutogenerated return type of AdvertPublishedUpdateMutation.
- AdvertsConnectionThe connection type for Advert.
- AdvertsEdgeAn edge in a connection.
- AdvertUpsertMutationPayloadAutogenerated return type of AdvertUpsertMutation.
- AllAdvertAdvert that can have any status, including deleted or unpublished.
- CartItemA good or service that a user has added to their cart.
- ESAdvertAn advert (elasticsearch cached)
- Inquirynull
- LineItemLine items associated with a cart or order.
- RankedResultRankedResult records - force first adverts for category/brand
- UnpublishedAdvertAn unpublished advert
- VariantA unique option type/option value combination that represents a variation of a purchasable item.