Start typing to search…

Glossary - Product Insert

ⓘ Required Data

Please note that all the fields marked with * are required.


Parameters

Meaning

Type

accountId *

The customer account ID in Deliverect

string

locationId *

The specific customer's location ID in Deliverect

string

products

products.productType *

Specifies the product type being inserted. See section here for productTypes.

integer

products.plu *

Unique identifier for a product. It comes from the POS.

string

products. gtin

GTIN (Global Trade Item Number) for product, which could be EAN code

  • NB:* We are not validating these as yet

array of strings

products.price *

Defined by a an int with 2 decimal digits. i.e. 5 euros is stored as 500.

integer

products.name *

Name for the product

string

products.nameTranslations

Object containing name translations. See guide here for more information.

Object

products.kitchenName

An optional additional name for the product that will be sent through with the order

string

products. visible

This specifies if the item is enabled or disabled within a location

boolean

products.stock

The current level of stock for this item

integer

products.channelOverrides

The channelOverrides allows the visible flag to apply differently per channel (see guide here)

Each key represents the ID of a channel (obtained via GET Integrated Channels) For example "7" channel ID for Uber Eat is marked as "visible": falsewhere "12"for DoorDash is marked as "visible": true

object

products.posProductId

Internal reference ID for the product coming from the POS. Optional use.

string

products.posCategoryIds *

Products should belong at least to one category defined by an array of posCategoryIds. It's important to have at least one category per product.

array of strings

products.imageUrl

Cloud hosted image URL. See section here for more details

string

products.description

Product description

string

products.descriptionTranslations

Object containing the translations for the descriptions. See guide here for more details.

object

products.deliveryTax *

Tax rate for delivery order, int with 3 decimal digits.See section here for more details.

integer

products.takeawayTax *

Tax rate for pickup order, int with 3 decimal digits. See section here for more details.

integer

products.eatInTax *

Tax rate for pickup order, int with 3 decimal digits. See section here for more details.

integer

products.multiMax

Defines how many times can the same modifier be chosen.

integer

products.min *

Minimum quantity for a modifier.

integer

products.max *

Maximum quantity for a modifier.

integer

products.maxFree

Specifies how many sub products can be ordered at zero value, normal pricing applying after set limit

integer

products.defaultQuantity

Specify a default quantity where '1' is equivalent to a 'pre-selected' item (compatible with only a few channels)

integer

products.isCombo

Indicates product is a combo.

boolean

products.isVariant

Indicates a product is a variant. See section here for more details.

boolean

products.isVariantGroup

Indicates the group contains variants. See section here for more details.

boolean

products.priceLevels

Object containing the posIds specified on the priceLevels array and their corresponding price.

"priceLevels": {  
        "UE": 900,  
        "DL": 850,  
        "TA": 825  
      }

object

products.subProducts

A product can contain additional options (see full guide here)

array of strings

autoApply

autoApply.plu

A predefined set of zero-priced items applied to an order by Deliverect. See section here for more details.

string

sortOrder

Defines the order in which an item will appear when auto-applied. See section here for more details.

integer

overloads

Specifies price variances from 'base' price dependant on where option is offered

overloads.scopes

Define surcharges applied to the specific modifier group or bundle. See section here for more details.

string

overloads.price

Determines the price for the overload. See section here for more details.

integer

overloads.bundlePrice

Determines the price for the overload when the grouping is a bundle. See section here for more details.

integer

beverageInfo

beverageInfo.caffeine

Caffeine content (in mg)

integer

beverageInfo.alcohol

Alcohol content (in % )

integer

calories

kcal / Cals

integer

caloriesRangeHigh

Where a range of calories applies to a variable option e.g. a 'Sandwich Deal' where selections are required.

To apply this, the format would be; • Minimum =calories • Maximum =caloriesRangeHigh

integer

packaging.reusable

Whether packaging is reusable

boolean

packaging.storageInstructions

How to store an item

string

packaging.count

integer

productTags

e.g.108 = mustard (see guide here)

array of integer

categories

categories.name *

Name for the category.

string

categories.posCategoryId *

Id assigned to the category.

string

categories.imageUrl

Image for the category

string

priceLevels

See section here for more information. This is mandatory when using Price Levels, otherwise, the Price Level will not work.

array of objects

priceLevels.name

Name for the price-level

string

priceLevels.posId

Id for the price-level. The value used inside the array products.priceLevels

string