Skip to content
This repository was archived by the owner on Apr 23, 2021. It is now read-only.

Latest commit

 

History

History
27 lines (20 loc) · 3.42 KB

CatalogItem.md

File metadata and controls

27 lines (20 loc) · 3.42 KB

CatalogItem

Description

An item (i.e., product family) in the Catalog object model.

Properties

Name Type Description Notes
name String The item's name. Searchable. This field must not be empty. This field has max length of 512 Unicode code points. [optional]
description String The item's description. Searchable. This field has max length of 4096 Unicode code points. [optional]
abbreviation String The text of the item's display label in the Square Point of Sale app. Only up to the first five characters of the string are used. Searchable. This field has max length of 24 Unicode code points. [optional]
labelColor String The color of the item's display label in the Square Point of Sale app. This must be a valid hex color code. [optional]
availableOnline Boolean If `true`, the item can be added to shipping orders from the merchant's online store. [optional]
availableForPickup Boolean If `true`, the item can be added to pickup orders from the merchant's online store. [optional]
availableElectronically Boolean If `true`, the item can be added to electronically fulfilled orders from the merchant's online store. [optional]
categoryId String The ID of the item's category, if any. [optional]
taxIds List<String> A set of IDs indicating the taxes enabled for this item. When updating an item, any taxes listed here will be added to the item. Taxes may also be added to or deleted from an item using `UpdateItemTaxes`. [optional]
modifierListInfo List<CatalogItemModifierListInfo> A set of `CatalogItemModifierListInfo` objects representing the modifier lists that apply to this item, along with the overrides and min and max limits that are specific to this item. Modifier lists may also be added to or deleted from an item using `UpdateItemModifierLists`. [optional]
variations List<CatalogObject> A list of CatalogObjects containing the `CatalogItemVariation`s for this item. [optional]
productType String The product type of the item. May not be changed once an item has been created. Only items of product type `REGULAR` or `APPOINTMENTS_SERVICE` may be created by this API; items with other product types are read-only. See CatalogItemProductType for possible values [optional]
skipModifierScreen Boolean If `false`, the Square Point of Sale app will present the `CatalogItem`'s details screen immediately, allowing the merchant to choose `CatalogModifier`s before adding the item to the cart. This is the default behavior. If `true`, the Square Point of Sale app will immediately add the item to the cart with the pre-selected modifiers, and merchants can edit modifiers by drilling down onto the item's details. Third-party clients are encouraged to implement similar behaviors. [optional]
itemOptions List<CatalogItemOptionForItem> List of item options IDs for this item. Used to manage and group item variations in a specified order. Maximum: 6 item options. [optional] [beta]