Struct CatalogItem

Source
pub struct CatalogItem {
Show 16 fields pub name: Option<String>, pub description: Option<String>, pub abbreviation: Option<String>, pub label_color: Option<String>, pub available_online: Option<bool>, pub available_for_pickup: Option<bool>, pub available_electronically: Option<bool>, pub category_id: Option<String>, pub tax_ids: Option<Vec<String>>, pub modifier_list_info: Option<Vec<CatalogItemModifierListInfo>>, pub variations: Option<Vec<CatalogObject>>, pub product_type: Option<CatalogItemProductType>, pub skip_modifier_screen: Option<bool>, pub item_options: Option<Vec<CatalogItemOptionForItem>>, pub image_ids: Option<Vec<String>>, pub sort_name: Option<String>,
}
Expand description

A CatalogObject instance of the ITEM type, also referred to as an item, in the catalog.

Fields§

§name: Option<String>

The item’s name. This is a searchable attribute for use in applicable query filters, its value must not be empty, and the length is of Unicode code points.

§description: Option<String>

The item’s description. This is a searchable attribute for use in applicable query filters, and its value length is of Unicode code points.

§abbreviation: Option<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. This attribute is searchable, and its value length is of Unicode code points.

§label_color: Option<String>

The color of the item’s display label in the Square Point of Sale app. This must be a valid hex color code.

§available_online: Option<bool>

If true, the item can be added to shipping orders from the merchant’s online store.

§available_for_pickup: Option<bool>

If true, the item can be added to pickup orders from the merchant’s online store.

§available_electronically: Option<bool>

If true, the item can be added to electronically fulfilled orders from the merchant’s online store.

§category_id: Option<String>

The ID of the item’s category, if any.

§tax_ids: Option<Vec<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.

§modifier_list_info: Option<Vec<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.

§variations: Option<Vec<CatalogObject>>

A list of [CatalogItemVariation] objects for this item. An item must have at least one variation.

§product_type: Option<CatalogItemProductType>

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.

§skip_modifier_screen: Option<bool>

If false, the Square Point of Sale app will present the CatalogItem’s details screen immediately, allowing the merchant to choose CatalogModifiers 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.

§item_options: Option<Vec<CatalogItemOptionForItem>>

List of item options IDs for this item. Used to manage and group item variations in a specified order.

Maximum: 6 item options.

§image_ids: Option<Vec<String>>

The IDs of images associated with this CatalogItem instance. These images will be shown to customers in Square Online Store. The first image will show up as the icon for this item in POS.

§sort_name: Option<String>

A name to sort the item by. If this name is unspecified, namely, the sort_name field is absent, the regular name field is used for sorting.

It is currently supported for sellers of the Japanese locale only.

Trait Implementations§

Source§

impl Clone for CatalogItem

Source§

fn clone(&self) -> CatalogItem

Returns a duplicate of the value. Read more
1.0.0 · Source§

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for CatalogItem

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for CatalogItem

Source§

fn default() -> CatalogItem

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for CatalogItem

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl PartialEq for CatalogItem

Source§

fn eq(&self, other: &CatalogItem) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for CatalogItem

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl Eq for CatalogItem

Source§

impl StructuralPartialEq for CatalogItem

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> ErasedDestructor for T
where T: 'static,