Plentymarkets interface documentation

Attribute

Contracts

AttributeEbayCorrelationRepositoryContract

The contract for the attribute ebay correlation repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data):Plenty\Modules\Item\Attribute\Models\AttributeEbayCorrelation
Return type: AttributeEbayCorrelation

Creates new ebay attribute correlation

Parameters

Name

Type

Description

$data

array

public show($id, $with = []):Plenty\Modules\Item\Attribute\Models\AttributeEbayCorrelation
Return type: AttributeEbayCorrelation

Gets an ebay attribute correlation. The ID of the attribute correlation must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the ebay attribute correlation

$with

array

public update($id, $data):Plenty\Modules\Item\Attribute\Models\AttributeEbayCorrelation
Return type: AttributeEbayCorrelation

Updates an ebay attribute correlation. The ID of the attribute correlation must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the ebay attribute correlation

$data

array

public delete($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an ebay attribute correlation. The ID of the attribute correlation must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the ebay attribute correlation

public get($id):Plenty\Modules\Item\Attribute\Models\AttributeEbayCorrelation
Return type: AttributeEbayCorrelation

Gets an ebay attribute correlation. The ID of the attribute correlation must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the ebay attribute correlation

Return type: PaginatedResult

Lists ebay attribute correlations by filters.

Parameters

Name

Type

Description

$perPage

int

$page

int

$filters

array

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

AttributeMapRepositoryContract

The contract for the attribute map repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data):Plenty\Modules\Item\Attribute\Models\AttributeMap
Return type: AttributeMap

Creates a new attribute map.

Parameters

Name

Type

Description

$data

array

public find($attributeId, $marketId):Plenty\Modules\Item\Attribute\Models\AttributeMap
Return type: AttributeMap

Gets an attribute map. The ID of the attribute and the ID of the market must be specified.

Parameters

Name

Type

Description

$attributeId

int

$marketId

float

public all($columns = [], $perPage = 50, $page = 1, $filter = [], $with = []):array

Lists all attribute maps.

Parameters

Name

Type

Description

$columns

array

$perPage

int

$page

int

$filter

array

$with

array

public update($data, $attributeId, $marketId):Plenty\Modules\Item\Attribute\Models\AttributeMap
Return type: AttributeMap

Updates an attribute map. The ID of the attribute and the ID of the market must be specified.

Parameters

Name

Type

Description

$data

array

$attributeId

int

$marketId

float

public delete($attributeId, $marketId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute map. The ID of the attribute and the ID of the market must be specified.

Parameters

Name

Type

Description

$attributeId

int

$marketId

float

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

AttributeNameRepositoryContract

The contract for the attribute name repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data, $attributeId):Plenty\Modules\Item\Attribute\Models\AttributeName
Return type: AttributeName

Creates an attribute name. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$data

array

The attribute name data as associative array

$attributeId

int

The ID of the attribute ID

public delete($attributeId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute name. The ID of the attribute and the language must be specified.

Parameters

Name

Type

Description

$attributeId

int

The ID of the attribute

$lang

string

The lang of the attribute name

public update($data, $attributeId, $lang):Plenty\Modules\Item\Attribute\Models\AttributeName
Return type: AttributeName

Updates an attribute name. The ID of the attribute and the language must be specified.

Parameters

Name

Type

Description

$data

array

The attribute name data as associative array

$attributeId

int

The ID of the attribute

$lang

string

The lang of the attribute name

public findOne($attributeId, $lang):Plenty\Modules\Item\Attribute\Models\AttributeName
Return type: AttributeName

Gets an attribute name. The ID of the attribute and the language must be specified.

Parameters

Name

Type

Description

$attributeId

int

The ID of the attribute

$lang

string

The lang of the attribute name

public findByAttributeId($attributeId):Plenty\Modules\Item\Attribute\Models\AttributeName
Return type: AttributeName

Lists attribute names. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$attributeId

int

The ID of the attribute

AttributeRepositoryContract

The contract for the attribute repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data):Plenty\Modules\Item\Attribute\Models\Attribute
Return type: Attribute

Creates new attribute

Parameters

Name

Type

Description

$data

array

The attribute data as associative array

public show($id, $with = []):Plenty\Modules\Item\Attribute\Models\Attribute
Return type: Attribute

Gets an attribute. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the attribute

$with

array

An array of the with params

public update($data, $id):Plenty\Modules\Item\Attribute\Models\Attribute
Return type: Attribute

Updates an attribute. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$data

array

The attribute data as associative array

$id

int

The ID of the attribute

public delete($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the attribute

public findById($id):Plenty\Modules\Item\Attribute\Models\Attribute
Return type: Attribute

Gets an attribute. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the attribute

public findByBackendName($backendName):Plenty\Modules\Item\Attribute\Models\Attribute
Return type: Attribute

Gets an attribute. The backend name of the attribute must be specified.

Parameters

Name

Type

Description

$backendName

string

public all($columns = [], $perPage = 50, $page = 1, $filter = [], $with = []):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all attributes.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The attributes shown per page. Default value is 50.

$page

int

The shown page. Default value is 1.

$filter

array

$with

array

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

AttributeValueImageRepositoryContract

The contract for the attribute value image repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public getAttributeValueImage($itemId, $imageId, $valueId):Plenty\Modules\Item\Attribute\Models\AttributeValueImage
Return type: AttributeValueImage

Get an attribute value image link

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item ID

$imageId

int

The unique ID of the image

$valueId

int

The unique ID of the attribute value

public create($data):Plenty\Modules\Item\Attribute\Models\AttributeValueImage
Return type: AttributeValueImage

Create an attribute value image link

Parameters

Name

Type

Description

$data

array

The attribute value image data as an associative array

public delete($itemId, $imageId, $valueId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Delete an attribute value image link

Parameters

Name

Type

Description

$itemId

int

The ID of the item

$imageId

int

The ID of the image

$valueId

int

The ID of the attribute value

public update($data, $itemId, $imageId, $valueId):Plenty\Modules\Item\Attribute\Models\AttributeValueImage
Return type: AttributeValueImage

Updates an attribute value image link

Parameters

Name

Type

Description

$data

array

The attribute value image data as an associative array

$itemId

int

The unique ID of the item

$imageId

int

The unique ID of the image

$valueId

int

The unique ID of the attribute value

Return type: Collection

List attribute value image links

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

AttributeValueMapRepositoryContract

The contract for the attribute value map repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data):Plenty\Modules\Item\Attribute\Models\AttributeValueMap
Return type: AttributeValueMap

Creates a new attribute value map.

Parameters

Name

Type

Description

$data

array

public find($attributeId, $attributeValueId, $marketId):Plenty\Modules\Item\Attribute\Models\AttributeValueMap
Return type: AttributeValueMap

Gets an attribute value map. The ID of the attribute, the ID of the attribute value and the ID of the market must be specified.

Parameters

Name

Type

Description

$attributeId

int

$attributeValueId

int

$marketId

float

public all($columns = [], $perPage = 50, $page = 1, $filter = [], $with = []):array

Lists all attribute value maps.

Parameters

Name

Type

Description

$columns

array

$perPage

int

$page

int

$filter

array

$with

array

public update($data, $attributeId, $attributeValueId, $marketId):Plenty\Modules\Item\Attribute\Models\AttributeValueMap
Return type: AttributeValueMap

Updates an attribute value map. The ID of the attribute, the ID of the attribute value and the ID of the market must be specified.

Parameters

Name

Type

Description

$data

array

$attributeId

int

$attributeValueId

int

$marketId

float

public delete($attributeId, $attributeValueId, $marketId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute value map. The ID of the attribute, the ID of the attribute value and the ID of the market must be specified.

Parameters

Name

Type

Description

$attributeId

int

$attributeValueId

int

$marketId

float

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

AttributeValueMarketNameRepositoryContract

The contract for the attribute value market name repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data):Plenty\Modules\Item\Attribute\Models\AttributeValueMarketName
Return type: AttributeValueMarketName

Creates an attribute value market name. The ID of the attribute value must be specified.

Parameters

Name

Type

Description

$data

array

The attribute value market name data as associative array

public delete($valueId, $lang, $referenceType):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute value market name. The ID of the attribute value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

The ID of the attribute value

$lang

string

The lang of the attribute value name

$referenceType

string

The referenceType of the attribute value name

public update($data, $valueId, $lang, $referenceType):Plenty\Modules\Item\Attribute\Models\AttributeValueMarketName
Return type: AttributeValueMarketName

Updates an attribute value market name. The ID of the attribute value and the language must be specified.

Parameters

Name

Type

Description

$data

array

The attribute value market name data as associative array

$valueId

int

The ID of the attribute value

$lang

string

The lang of the attribute value market name

$referenceType

string

The referenceType of the attribute value name

public findOne($valueId, $lang, $referenceType):Plenty\Modules\Item\Attribute\Models\AttributeValueMarketName
Return type: AttributeValueMarketName

Gets an attribute value market name. The ID of the attribute value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

The ID of the attribute value

$lang

string

The lang of the attribute value name

$referenceType

string

The referenceType of the attribute value name

public findByAttributeId($valueId, $lang):array

Lists attribute value market names. The ID of the attribute and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

The ID of the attribute

$lang

string

The lang of the attribute value name

Return type: PaginatedResult

Search attribute value market names.

Parameters

Name

Type

Description

$page

int

$itemsPerPage

int

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

AttributeValueNameRepositoryContract

The contract for the attribute value name repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data, $valueId):Plenty\Modules\Item\Attribute\Models\AttributeValueName
Return type: AttributeValueName

Creates an attribute value name. The ID of the attribute value must be specified.

Parameters

Name

Type

Description

$data

array

The attribute value name data as associative array

$valueId

int

The ID of the attribute value

public delete($valueId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute value name. The ID of the attribute value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

The ID of the attribute value

$lang

string

The lang of the attribute value name

public update($data, $valueId, $lang):Plenty\Modules\Item\Attribute\Models\AttributeValueName
Return type: AttributeValueName

Updates an attribute value name. The ID of the attribute value and the language must be specified.

Parameters

Name

Type

Description

$data

array

The attribute value name data as associative array

$valueId

int

The ID of the attribute value

$lang

string

The lang of the attribute value name

public findOne($valueId, $lang):Plenty\Modules\Item\Attribute\Models\AttributeValueName
Return type: AttributeValueName

Gets an attribute value name. The ID of the attribute value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

The ID of the attribute value

$lang

string

The lang of the attribute value name

public findByValueId($valueId):Plenty\Modules\Item\Attribute\Models\AttributeValueName
Return type: AttributeValueName

Lists attribute value names. The ID of the attribute value must be specified.

Parameters

Name

Type

Description

$valueId

int

The ID of the attribute value

AttributeValueRepositoryContract

The contract for the attribute value repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
public create($data, $attributeId):Plenty\Modules\Item\Attribute\Models\AttributeValue
Return type: AttributeValue

Creates an attribute value. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$data

array

The attribute value data as associative array

$attributeId

int

The ID of the attribute

public update($data, $attributeId, $id):Plenty\Modules\Item\Attribute\Models\AttributeValue
Return type: AttributeValue

Updates an attribute value. The ID of the attribute and the ID of the value must be specified.

Parameters

Name

Type

Description

$data

array

The attribute value data as associative array

$attributeId

int

The ID of the attribute

$id

int

The ID of the value

public delete($attributeId, $id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an attribute value. The ID of the attribute and the ID of the value must be specified.

Parameters

Name

Type

Description

$attributeId

int

The ID of the attribute

$id

int

The ID of the value

public findByAttributeId($attributeId, $page = 1, $perPage = 50, $columns = [], $filter = [], $with = []):array

Lists attribute values. The ID of the attribute must be specified.

Parameters

Name

Type

Description

$attributeId

int

The ID of the attribute

$page

int

The shown page. Default value is 1.

$perPage

int

The amount of attribute values shown per page. Default value is 50

$columns

array

An array of the shown columns. All columns are returned by default.

$filter

array

$with

array

public findById($attributeId, $id, $with = []):Plenty\Modules\Item\Attribute\Models\AttributeValue
Return type: AttributeValue

Gets a attribute value. The ID of the attribute and the ID of the value must be specified.

Parameters

Name

Type

Description

$attributeId

int

The ID of the attribute

$id

int

The ID of the value

$with

array

An array of the with params

public findOne($valueId):Plenty\Modules\Item\Attribute\Models\AttributeValue
Return type: AttributeValue

Gets a attribute value. The ID of the value must be specified.

Parameters

Name

Type

Description

$valueId

int

public all($columns = [], $perPage = 50):array

Lists all attribute values.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of attribute values shown per page. Default value is 50.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

AttributeValueSetRepositoryContract

The contract for the attribute value set repository

Namespace

Plenty\Modules\Item\Attribute\Contracts

Methods
Return type: Collection

List attribute value sets

Parameters

Name

Type

Description

$filters

array

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

Attribute

The Attribute model including AttributeName and AttributeValue

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

id

int

The unique ID of the attribute.

backendName

string

The back end name of the attribute. The name must be unique and must not contain commas, colons, semicolons or quotation marks. It is not visible in the plentymarkets front end.

position

int

The position of the attribute. Attributes are displayed in the attribute overview in ascending order by position.

isSurchargePercental

bool

Flag that indicates if the surcharge is percental.

isLinkableToImage

bool

Flag that indicates if an image can be linked to the attribute.

amazonAttribute

string

The attribute of the market Amazon that this attribute is liked to. To list variations on this market, attributes must be linked to one of the attributes specified by the market. Check documentation of the market for permitted values.

fruugoAttribute

string

The attribute of the market Fruugo that this attribute is linked to. To list variations on this market, attributes must be linked to one of the attributes specified by the market.

pixmaniaAttribute

int

The attribute of the market PIXmania that this attribute is linked to. To list variations on this market, attributes must be linked to one of the attributes specified by the market. Check documentation of the market for permitted values.

ottoAttribute

string

The attribute of the market OTTO that this attribute is linked to. To list variations on this market, attributes must be linked to one of the attributes specified by the market.

googleShoppingAttribute

string

The attribute of the market Google Shopping that this attribute is linked to. To list variations on this market, attributes must be linked to one of the attributes specified by the market.

neckermannAtEpAttribute

int

The component of the market neckermann AT EP that this attribute is linked to. To list variations on this market, attributes must be linked to one of the components specified by the market. Check documentation of the market for permitted values.

typeOfSelectionInOnlineStore

string

How customers can select the attribute in the front end of a client. To allow attribute selection by check mark, attribute availability must be checked on the client side.

laRedouteAttribute

int

The attribute of the market La Redoute that this attribute is linked to. To list variations on this market, attributes must be linked to one of the attributes specified by the market. Check documentation of the market for permitted values.

isGroupable

bool

Flag that indicates if the attribute can be grouped in item lists. If yes, variations with this attribute can be shown in the ItemViewCategoriesList template first. Other attributes are nested and can only be selected after this attribute has been selected.

attributeNames

array

values

array

maps

array

Methods
public toArray()

Returns this model as an array.

AttributeEbayCorrelation

The AttributeEbayCorrelation model

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

id

int

The unique ID of the ebay attribute correlation.

attributeId

int

The ID of the attribute.

ebaySiteId

int

The ID of the ebay site the attribute correlation is for.

ebayCategoryId

int

The ID of the ebay category of an ebay site the attribute correlation is for.

ebayAttributeName

string

The attribute of the market eBay that this attribute is linked to. Attributes can be linked to a ebay property or can have a separate correlation.

useForPictures

int

Flag that indicates if the ebay attribute correlation is used for pictures.

Methods
public toArray()

Returns this model as an array.

AttributeMap

The AttributeMap model

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

marketId

float

The unique ID of the market.

attributeId

int

The unique ID of the attribute.

name

string

The name of the attribute map. The name must be unique and must not contain commas, colons, semicolons or quotation marks. It is not visible in the plentymarkets front end.

marketInformation1

string

The information regarding the marketplace.

marketInformation2

string

The information regarding the marketplace.

Methods
public toArray()

Returns this model as an array.

AttributeName

The AttributeName model including Attribute

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

attributeId

int

The id of the attribute.

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">language</a> of the attribute.

name

string

The name of the attribute. This attribute name is displayed in the online store.

attribute

Attribute

Methods
public toArray()

Returns this model as an array.

AttributeValue

The AttributeValue model including Attribute and AttributeValueName

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

id

int

The unique ID of the attribute value.

attributeId

int

The unique ID of the attribute associated with the attribute value.

backendName

string

The back end name of the attribute value. This name can only be assigned once per attribute. It is not visible in the plentymarkets front end.

position

int

The position of the attribute value. Attribute values are sorted in ascending order by position.

image

string

The name of the image associated with the attribute value; naming pattern is attr\_{valueId}.

comment

string

Optional comment on the attribute value. Comments are not visible in the plentymarkets front end.

amazonValue

string

The attribute value of the market Amazon that this attribute value maps to. To list variations on this market, attribute values must be linked to one of the values specified by the market. Check documentation of the market for permitted values.

ottoValue

string

The attribute value of the market OTTO that this attribute value maps to. To list variations on this market, attribute values must be linked to one of the attribute values specified by the market.

neckermannAtEpValue

string

The attribute value of the market Neckermann AT EP that this attribute value maps to. To list variations on this market, attribute values must be linked to one of the attribute values specified by the market. Check documentation of the market for permitted values.

laRedouteValue

string

The attribute value of the market La Redoute that this attribute value maps to. To list variations on this market, attribute values must be linked to one of the attribute values specified by the market. Check documentation of the market for permitted values.

tracdelightValue

string

percentageDistribution

int

The percentage for automatic stock distribution of attribute values. When reordering an item, the quantities of attribute values is automatically distributed among the total quantity.

attribute

Attribute

valueNames

array

valueMarketNames

array

valueMaps

array

Methods
public toArray()

Returns this model as an array.

AttributeValueImage

The AttributeValueImage model

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

imageId

int

The unique ID of the image

itemId

int

The unique ID of the item

attributeId

int

The unique ID of the attribute

valueId

int

The unique ID of the attribute value

Methods
public toArray()

Returns this model as an array.

AttributeValueMap

The AttributeValueMap model

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

marketId

float

The unique ID of the market.

attributeId

int

The unique ID of the attribute.

attributeValueId

int

The unique ID of the attribute value.

name

string

The name of the attribute value map. The name must be unique and must not contain commas, colons, semicolons or quotation marks. It is not visible in the plentymarkets front end.

marketInformation1

string

The information regarding the marketplace.

marketInformation2

string

The information regarding the marketplace.

Methods
public toArray()

Returns this model as an array.

AttributeValueMarketName

The AttributeValueMarketName model including AttributeValue

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

valueId

int

The unique ID of the attribute value.

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">language</a> of the attribute value market.

name

string

The name of the attribute value market.

name2

string

The name2 of the attribute value market.

attributeId

int

referenceType

string

attributeValue

AttributeValue

Methods
public toArray()

Returns this model as an array.

AttributeValueName

The AttributeValueName model including AttributeValue

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

valueId

int

The unique ID of the attribute value.

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">language</a> of the attribute value.

name

string

The name of the attribute value. This attribute value name is displayed in the online store.

attributeValue

AttributeValue

Methods
public toArray()

Returns this model as an array.

AttributeValueSet

The AttributeValueSet model

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

attributeValueSetId

int

The ID of the attribute value set

attributeId

int

The ID of the attribute

valueId

int

The ID of the attribute value

isLinkableToImage

int

Flag that indicates if an image can be linked to the attribute.

attributeValue

AttributeValue

attribute

Attribute

Methods
public toArray()

Returns this model as an array.

AttributeValueSetId

The AttributeValueSetId model

Namespace

Plenty\Modules\Item\Attribute\Models

Properties
Name Type Description

id

int

The ID of the attribute value set id

hash

int

a hash

amazon_variation_set

string

size

int

Methods
public toArray()

Returns this model as an array.

Availability

Contracts

AvailabilityRepositoryContract

Repository for item availability.

Namespace

Plenty\Modules\Item\Availability\Contracts

Methods
public findAvailability($id):Plenty\Modules\Item\Availability\Models\Availability
Deprecated!

This method will not be supported in the future. Please refrain from using it as soon as possible.

Return type: Availability

Gets an item availability. The ID of the availability must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the item availability

public find($id):Plenty\Modules\Item\Availability\Models\Availability
Return type: Availability

Gets an item availability. The ID of the availability must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the item availability

public update($data):Plenty\Modules\Item\Availability\Models\Availability
Return type: Availability

Updates an item availability.

Parameters

Name

Type

Description

$data

array

public all():array

Lists all item availabilities.

Models

Availability

The item availability model

Namespace

Plenty\Modules\Item\Availability\Models

Properties
Name Type Description

id

int

The ID of this availability

icon

string

The icon of this availability

averageDays

int

The average delivery time in days for this availability

names

array

Methods
public toArray()

Returns this model as an array.

AvailabilityName

The item availability name model

Namespace

Plenty\Modules\Item\Availability\Models

Properties
Name Type Description

availabilityId

int

The ID of the availability that the name belongs to

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language code</a> of the availability name

name

string

The name of the item availability in the specified language

Methods
public toArray()

Returns this model as an array.

Barcode

Contracts

BarcodeRepositoryContract

The contract for the barcode repository

Namespace

Plenty\Modules\Item\Barcode\Contracts

Methods
public showBarcode($barcodeId):Plenty\Modules\Item\Barcode\Models\Barcode
Return type: Barcode

Gets a barcode. The ID of the barcode must be specified.

Parameters

Name

Type

Description

$barcodeId

int

The ID of the barcode.

public createBarcode($data):Plenty\Modules\Item\Barcode\Models\Barcode
Return type: Barcode

Creates a barcode.

Parameters

Name

Type

Description

$data

array

The barcode data as associative array

public updateBarcode($data, $barcodeId):Plenty\Modules\Item\Barcode\Models\Barcode
Return type: Barcode

Updates a barcode. The ID of the barcode must be specified.

Parameters

Name

Type

Description

$data

array

The barcode data as associative array

$barcodeId

int

The ID of the barcode.

public deleteBarcode($barcodeId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a barcode. The ID of the barcode must be specified.

Parameters

Name

Type

Description

$barcodeId

int

The unique ID of the barcode

public findBarcodeById($barcodeId):Plenty\Modules\Item\Barcode\Models\Barcode
Return type: Barcode

Gets a barcode. The ID of the barcode must be specified.

Parameters

Name

Type

Description

$barcodeId

int

The unique ID of the barcode

public findBarcodesByType($barcodeType, $perPage = 50):array

Lists barcodes. The type of the barcode must be specified.

Parameters

Name

Type

Description

$barcodeType

string

The type of the barcode

$perPage

int

The number of barcodes shown per page. Default value is 50.

public allBarcodes($columns = [], $perPage = 50, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all barcodes.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The number of barcodes shown per page. Default value is 50.

$page

int

The shown page. Default value is 1.

public createBarcodeReferrerRelation($data, $barcodeId):Plenty\Modules\Item\Barcode\Models\BarcodeLinkReferrer
Return type: BarcodeLinkReferrer

Creates new barcode referrer for specified referrer.

Parameters

Name

Type

Description

$data

array

The barcode data as associative array

$barcodeId

int

The unique ID of the barcode

public deleteBarcodeReferrerRelation($referrer, $barcodeId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes barcode referrer with specified referrer.

Parameters

Name

Type

Description

$referrer

float

The float value of the referrer

$barcodeId

int

The unique ID of the barcode

public findBarcodesByReferrerRelation($referrer, $perPage = 50):array

Gets barcode referrer by specified referrer.

Parameters

Name

Type

Description

$referrer

float

The float value of the referrer

$perPage

int

The number of barcodes shown per page. Default value is 50.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

Barcode

The barcode model including barcode referrer

Namespace

Plenty\Modules\Item\Barcode\Models

Properties
Name Type Description

id

int

The unique ID of the barcode

name

string

The name of the barcode

type

string

The type of the barcode. Possible values: GTIN_8, GTIN_13, GTIN_14, GTIN_128, ISBN, QR, CODE_128, UPC

createdAt

string

The time the code was created.

referrers

array

Methods
public toArray()

Returns this model as an array.

BarcodeLinkReferrer

The barcode link referrer model including the barcode

Namespace

Plenty\Modules\Item\Barcode\Models

Properties
Name Type Description

barcodeId

int

The unique ID of the barcode

referrerId

float

The unique ID of the referrer. To activate all referrers, the value <strong>-1</strong> must be specified. This value activates all referrers in the system by default, including any referrers added at a later stage.

createdAt

string

The time the barcode was created.

updatedAt

string

The time the barcode was last updated.

barcode

Barcode

Methods
public toArray()

Returns this model as an array.

Builders

Item

ItemBelongsToAtLeastOneAmazonFlatFile

Used to represent the ItemBelongsToAmazonFlatFile filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\AmazonFilter
Return type: AmazonFilter

Will return a TypeInterface filter if at least one flat file is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setAmazonFlatFiles($flatFiles):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemBelongsToAtLeastOneAmazonFlatFile
Return type: ItemBelongsToAtLeastOneAmazonFlatFile
Parameters

Name

Type

Description

$flatFiles

string

public addAmazonFlatFile($flatFile):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemBelongsToAtLeastOneAmazonFlatFile
Return type: ItemBelongsToAtLeastOneAmazonFlatFile
Parameters

Name

Type

Description

$flatFile

string

public setAmazonFlatFilesRef($flatFilesRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemBelongsToAtLeastOneAmazonFlatFile
Return type: ItemBelongsToAtLeastOneAmazonFlatFile
Parameters

Name

Type

Description

$flatFilesRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

ItemHasFlagOne

Used to represent the ItemHasFlagOne filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\ItemFilter
Return type: ItemFilter

Will return a ItemFilter if a flag is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setFlag($flag):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasFlagOne
Return type: ItemHasFlagOne
Parameters

Name

Type

Description

$flag

int

public setFlagRef($flagRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasFlagOne
Return type: ItemHasFlagOne
Parameters

Name

Type

Description

$flagRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

ItemHasFlagTwo

Used to represent the ItemHasFlagTwo filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\ItemFilter
Return type: ItemFilter

Will return a ItemFilter if a flag is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setFlag($flag):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasFlagTwo
Return type: ItemHasFlagTwo
Parameters

Name

Type

Description

$flag

int

public setFlagRef($flagRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasFlagTwo
Return type: ItemHasFlagTwo
Parameters

Name

Type

Description

$flagRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

ItemHasIds

Used to represent the ItemHasIds filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\ItemFilter
Return type: ItemFilter

Will return a ItemFilter if at least one item id is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public setItemIds($itemIds):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasIds
Return type: ItemHasIds
Parameters

Name

Type

Description

$itemIds

int

public addItemId($itemId):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasIds
Return type: ItemHasIds
Parameters

Name

Type

Description

$itemId

int

public getKey():string
public setItemIdsRef($itemIdsRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasIds
Return type: ItemHasIds
Parameters

Name

Type

Description

$itemIdsRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

Sku

VariationHasSku

Used to represent the VariationHasSku filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\SkuFilter
Return type: SkuFilter

Will return a SkuFilter if at least accountId, marketId or status are provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setMarketId($marketId):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
Parameters

Name

Type

Description

$marketId

float

public setAccountId($accountId):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
Parameters

Name

Type

Description

$accountId

int

public setStatus($status):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
Parameters

Name

Type

Description

$status

string

public setMarketIdRef($marketIdRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
Parameters

Name

Type

Description

$marketIdRef

string

public setAccountIdRef($accountIdRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
Parameters

Name

Type

Description

$accountIdRef

string

public setStatusRef($statusRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
Parameters

Name

Type

Description

$statusRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

Tag

VariationHasTags

Used to represent the HasAllTags filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Tag

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\TagFilter
Return type: TagFilter

Will return a TagFilter if at least one tag id is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public setTagIds($tagIds):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Tag\VariationHasTags
Return type: VariationHasTags
Parameters

Name

Type

Description

$tagIds

int

public addTagId($tagId):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Tag\VariationHasTags
Return type: VariationHasTags
Parameters

Name

Type

Description

$tagId

int

public getKey():string
public setTagIdsRef($tagIdsRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Tag\VariationHasTags
Return type: VariationHasTags
Parameters

Name

Type

Description

$tagIdsRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

VariationBase

VariationHasAtLeastOneAvailability

Used to represent the VariationHasAtLeastOneAvailability filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\VariationBaseFilter
Return type: VariationBaseFilter

Will return a VariationBaseFilter if at least one availability is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setAvailabilities($availabilities):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationHasAtLeastOneAvailability
Return type: VariationHasAtLeastOneAvailability
Parameters

Name

Type

Description

$availabilities

int

public addAvailability($availability):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationHasAtLeastOneAvailability
Return type: VariationHasAtLeastOneAvailability
Parameters

Name

Type

Description

$availability

int

public setAvailabilitiesRef($availabilitiesRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationHasAtLeastOneAvailability
Return type: VariationHasAtLeastOneAvailability
Parameters

Name

Type

Description

$availabilitiesRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

VariationIsActive

Used to represent the VariationIsActive filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase

Methods
public setShouldBeActive($shouldBeActive):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationIsActive
Return type: VariationIsActive
Parameters

Name

Type

Description

$shouldBeActive

bool

public setShouldBeActiveRef($shouldBeActiveRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationIsActive
Return type: VariationIsActive
Parameters

Name

Type

Description

$shouldBeActiveRef

string

public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\VariationBaseFilter
Return type: VariationBaseFilter

Will return a VariationBaseFilter if shouldBeActive is defined. Otherwise null will be returned

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

VariationClient

VariationIsVisibleForAtLeastOneClient

Used to represent the VariationIsVisibleForAtLeastOneClient filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationClient

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\ClientFilter
Return type: ClientFilter

Will return a ClientFilter if at least one client id is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setClients($clients):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationClient\VariationIsVisibleForAtLeastOneClient
Return type: VariationIsVisibleForAtLeastOneClient
Parameters

Name

Type

Description

$clients

int

public addClient($client):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationClient\VariationIsVisibleForAtLeastOneClient
Return type: VariationIsVisibleForAtLeastOneClient
Parameters

Name

Type

Description

$client

int

public setClientsRef($clientsRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationClient\VariationIsVisibleForAtLeastOneClient
Return type: VariationIsVisibleForAtLeastOneClient
Parameters

Name

Type

Description

$clientsRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

VariationMarket

VariationIsVisibleForAtLeastOneMarket

Used to represent the VariationIsVisibleForAtLeastOneMarket filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationMarket

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\MarketFilter
Return type: MarketFilter

Will return a MarketFilter if at least one market id is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setMarketIds($marketIds):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationMarket\VariationIsVisibleForAtLeastOneMarket
Return type: VariationIsVisibleForAtLeastOneMarket
Parameters

Name

Type

Description

$marketIds

float

public addMarketId($marketId):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationMarket\VariationIsVisibleForAtLeastOneMarket
Return type: VariationIsVisibleForAtLeastOneMarket
Parameters

Name

Type

Description

$marketId

float

public setMarketIdsRef($marketIdsRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationMarket\VariationIsVisibleForAtLeastOneMarket
Return type: VariationIsVisibleForAtLeastOneMarket
Parameters

Name

Type

Description

$marketIdsRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

VariationProperty

VariationHasAtLeastOnePropertySelection

Used to represent the VariationHasPropertySelection filter in both the catalog export and UI.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationProperty

Methods
public setFilterData($filterData):void

This method will be called in the export process if the filter was registered as a custom filter. In the template definition this should not be called. Use the specific setter methods instead.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):Plenty\Modules\Item\Search\Filter\VariationPropertyFilter
Return type: VariationPropertyFilter

Will return a VariationPropertyFilter if at least property selection id is provided. Otherwise null is returned.

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter
public getKey():string
public setPropertySelectionIds($propertySelectionIds):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationProperty\VariationHasAtLeastOnePropertySelection
Return type: VariationHasAtLeastOnePropertySelection
Parameters

Name

Type

Description

$propertySelectionIds

int

public addPropertySelectionId($propertySelectionId):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationProperty\VariationHasAtLeastOnePropertySelection
Return type: VariationHasAtLeastOnePropertySelection
Parameters

Name

Type

Description

$propertySelectionId

int

public setPropertySelectionIdsRef($propertySelectionIdsRef):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationProperty\VariationHasAtLeastOnePropertySelection
Return type: VariationHasAtLeastOnePropertySelection

Links a key in the settings as source of the value for $propertySelectionIds.

Parameters

Name

Type

Description

$propertySelectionIdsRef

string

public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

Filters

Builders

VariationCatalogExportFilterBuilder

Base class for filters that are used in catalog variation exports.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders

Methods
public setRequired($required):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$required

bool

public setIsVisible($isVisible):Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationCatalogExportFilterBuilder
Return type: VariationCatalogExportFilterBuilder

Fluent setter

Parameters

Name

Type

Description

$isVisible

bool

public getKey():string
public setFilterData($filterData):void

This method will be filled by the specified values in a catalog. It should be used to provide the necessary manipulation so the filter that is returned by getFilter can be consumed by the export.

Parameters

Name

Type

Description

$filterData

public getFilter($settings = []):void

Returns the filter that will be given to the export

Parameters

Name

Type

Description

$settings

array

public getUiFilter():Plenty\Modules\Catalog\Models\Filters\CatalogUiFilter
Return type: CatalogUiFilter

Returns the UI representation of the filter

VariationFilterBuilderFactory

This factory provides methods to retrieve all available catalog variation filter builders.

Namespace

Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders

Methods
public variationIsActive():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationIsActive
Return type: VariationIsActive
public variationHasSku():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Sku\VariationHasSku
Return type: VariationHasSku
public itemBelongsToAmazonFlatFile():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemBelongsToAtLeastOneAmazonFlatFile
Return type: ItemBelongsToAtLeastOneAmazonFlatFile
public itemHasFlagOne():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasFlagOne
Return type: ItemHasFlagOne
public itemHasFlagTwo():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasFlagTwo
Return type: ItemHasFlagTwo
public itemHasIds():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Item\ItemHasIds
Return type: ItemHasIds
public variationHasTags():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\Tag\VariationHasTags
Return type: VariationHasTags
public variationHasAtLeastOneAvailability():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationBase\VariationHasAtLeastOneAvailability
Return type: VariationHasAtLeastOneAvailability
public variationIsVisibleForAtLeastOneClient():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationClient\VariationIsVisibleForAtLeastOneClient
Return type: VariationIsVisibleForAtLeastOneClient
public variationIsVisibleForAtLeastOneMarket():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationMarket\VariationIsVisibleForAtLeastOneMarket
Return type: VariationIsVisibleForAtLeastOneMarket
public variationHasAtLeastOnePropertySelection():Plenty\Modules\Item\Catalog\ExportTypes\Variation\Filters\Builders\VariationProperty\VariationHasAtLeastOnePropertySelection

DataLayer

Contracts

ItemDataLayerRepositoryContract

Deprecated! (since 2017-08-22)

Please use Plenty\Modules\Item\Variation\Contracts\VariationSearchRepositoryContract or Plenty\Modules\Item\Search\Contracts\VariationElasticSearchSearchRepositoryContract instead

Namespace

Plenty\Modules\Item\DataLayer\Contracts

Methods
Return type: RecordList
Parameters

Name

Type

Description

$columns

array

$filter

array

$params

array

public lookup($filter = [], $params = [], $calculateNumberOfRows = false):Plenty\Modules\Item\DataLayer\Services\ItemDataLayerResultLookup
Return type: ItemDataLayerResultLookup
Parameters

Name

Type

Description

$filter

array

$params

array

$calculateNumberOfRows

bool

public searchWithPagination($columns, $filter = [], $params = []):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult
Parameters

Name

Type

Description

$columns

array

$filter

array

$params

array

Models

DataLayerModel

Namespace

Plenty\Modules\Item\DataLayer\Models

Methods
public toArray()

Returns this model as an array.

ItemBase

ItemDataLayer - ItemBase

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

abo

int

addCmsPage

int

amazonFba

int

amazonProductType

int

apiCondition

int

storeSpecial

int

bestofferAutoDeclinePrice

float

condition

int

crossSellingCharacter

int

customsTariffNumber

string

defaultShippingCost

float

directCrossArticle

int

ebayCategory

int

ebayCategory2

int

ebayPreset

int

ebayStoreCategory

int

ebayStoreCategory2

int

epid

string

fedas

string

markingOne

int

markingTwo

int

flashFile

string

flashHeight

int

flashWidth

int

free1

string

free2

string

free3

string

free4

string

free5

string

free6

string

free7

int

free8

int

free9

int

free10

int

free11

int

free12

int

free13

int

free14

int

free15

int

free16

int

free17

int

free18

int

free19

int

free20

int

ageRestriction

int

hasAttribute

string

id

int

inactive

int

createDate

string

isPacket

int

marketStockBuffer

int

noCoupon

int

producingCountryId

int

position

int

priceOnly4orderby

int

producer

string

producerId

int

rating

int

ratingCount

int

revenueAccount

int

scoActive

int

scoMinPrice

float

scoMinStockNet

int

serialNumber

int

shippingWithAmazonFba

string

sitemapPublished

int

storingPosition

string

lastUpdateTimestamp

string

type

int

votes

int

variationCount

int

tradoriaCategory

int

Methods
public toArray()

Returns this model as an array.

ItemCrossSelling

ItemCrossSelling

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

itemId

int

crossItemId

relationship

dynamic

Methods
public toArray()

Returns this model as an array.

ItemDescription

ItemDescription

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

itemId

int

characterCache

string

characterCacheXml

string

characterUpdate

int

description

string

id

int

keywords

string

lang

string

metaDescription

string

name1

string

name2

string

name3

string

shortDescription

string

technicalData

string

urlContent

string

Methods
public toArray()

Returns this model as an array.

ItemProperty

ItemProperty

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

itemPropertyId

int

propertyId

int

propertyValue

propertyValueType

string

isOrderProperty

bool

propertyOrderMarkup

float

Methods
public toArray()

Returns this model as an array.

ItemSetConfig

ItemSetConfig

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

id

int

rebate

float

Methods
public toArray()

Returns this model as an array.

ItemShippingProfiles

ItemShippingProfiles

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

id

int

name

string

backendName

string

tags

array

Methods
public toArray()

Returns this model as an array.

Record

Record

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

itemBase

ItemBase

itemPropertyList

array

itemCrossSellingList

array

itemDescription

ItemDescription

itemShippingProfilesList

array

variationAttributeValueList

array

variationBarcode

VariationBarcode

variationBarcodeList

array

variationBase

VariationBase

variationBundleComponentList

array

variationCategoryList

array

variationImageList

array

variationLinkMarketplace

array

variationLinkWebstore

array

variationMarketStatus

VariationMarketStatus

variationRecommendedRetailPrice

VariationRetailPrice

variationRecommendedRetailPriceList

array

variationRetailPrice

VariationRetailPrice

variationRetailPriceList

array

variationSetRetailPrice

VariationSetRetailPrice

variationStandardCategory

VariationStandardCategory

variationStock

VariationStock

variationStockBuffer

VariationStockBuffer

variationStockList

array

variationSupplierList

array

variationWarehouse

VariationWarehouse

variationWarehouseList

array

variationSpecialOfferRetailPrice

VariationSpecialOfferRetailPrice

variationSpecialOfferRetailPriceList

array

itemSetConfig

ItemSetConfig

Methods
public toArray()

Returns this model as an array.

RecordList

RecordList

Namespace

Plenty\Modules\Item\DataLayer\Models

Methods
public toArray()

Returns this model as an array.

VariationAttributeValue

VariationAttributeValue

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

attributeId

int

attributeValueId

int

Methods
public toArray()

Returns this model as an array.

VariationBarcode

VariationBarcode

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

code

int

createdTimestamp

string

barcodeId

int

barcodeType

string

Methods
public toArray()

Returns this model as an array.

VariationBase

VariationBase

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

active

int

attributeValueSetId

int

autoStockInvisible

string

bundleTyp

string

autoStockNoStockIcon

string

autoStockPositiveStockIcon

string

autoStockVisible

string

availability

int

averageOrderQuantity

string

content

string

unitCombinationId

int

createdTimestamp

string

customNumber

string

estimatedAvailability

string

externalId

string

extraShippingCharge1

float

extraShippingCharge2

float

heightMm

int

id

int

itemId

int

lastUpdateTimestamp

string

lengthMm

int

limitOrderByStockSelect

int

mainWarehouse

int

model

string

operatingCostsPercent

float

packingUnits

int

packingUnitType

int

parentVariationId

int

parentItemVariationQuantity

float

picking

string

customsPercent

float

position

int

priceCalculationId

int

primaryVariation

string

primaryVariationId

int

purchasePrice

float

storageCosts

float

transportationCosts

float

unitId

unitLoadDevice

int

unitsContained

int

vatId

int

variationName

string

weightG

int

weightNetG

int

maximumOrderQuantity

float

minimumOrderQuantity

float

intervalOrderQuantity

float

availableUntil

string

releaseDate

int

widthMm

int

propertyVariationId

int

Methods
public toArray()

Returns this model as an array.

VariationBundleComponent

VariationBundleComponent

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

componentVariationId

int

componentQuantity

float

CreatedTimestamp

string

LastUpdateTimestamp

string

Methods
public toArray()

Returns this model as an array.

VariationCategory

VariationCategory

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

categoryId

int

position

int

neckermannPrimary

Methods
public toArray()

Returns this model as an array.

VariationImage

VariationImage

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

imageId

int

type

int

fileType

string

path

string

position

int

lastUpdateTimestamp

string

createTimestamp

string

cleanImageName

string

attributeValueId

int

Methods
public toArray()

Returns this model as an array.

VariationLinkMarketplace

VariationLinkMarketplace

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

created

string

marketplaceId

float

Methods
public toArray()

Returns this model as an array.

VariationLinkWebstore

VariationLinkWebstore

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

created

string

plentyId

int

Methods
public toArray()

Returns this model as an array.

VariationMarketStatus

VariationMarketStatus

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

id

int

marketId

float

marketAccountId

int

initialSku

sku

parentSku

active

int

createdTimestamp

lastExportTimestamp

deletedTimestamp

marketStatus

additionalInformation

Methods
public toArray()

Returns this model as an array.

VariationRetailPrice

VariationRetailPrice

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

priceId

int

price

float

retailPriceNet

float

basePrice

int

basePriceNet

float

unitPrice

float

unitPriceNet

float

orderParamsMarkup

float

orderParamsMarkupNet

float

classRebatePercent

float

classRebate

float

classRebateNet

float

categoryRebatePercent

float

categoryRebate

float

categoryRebateNet

float

vatId

int

vatValue

float

currency

string

exchangeRatio

float

Methods
public toArray()

Returns this model as an array.

VariationSetRetailPrice

VariationSetRetailPrice

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

priceId

int

price

float

retailPriceNet

float

basePrice

int

basePriceNet

float

unitPrice

float

unitPriceNet

float

orderParamsMarkup

float

orderParamsMarkupNet

float

classRebatePercent

float

classRebate

float

classRebateNet

float

categoryRebatePercent

float

categoryRebate

float

categoryRebateNet

float

vatId

int

vatValue

float

currency

string

exchangeRatio

float

Methods
public toArray()

Returns this model as an array.

VariationSpecialOfferRetailPrice

VariationSpecialOfferRetailPrice

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

retailPriceId

int

retailPrice

float

retailPriceNet

float

basePrice

float

basePriceNet

float

unitPrice

float

unitPriceNet

float

orderParamsMarkup

float

orderParamsMarkupNet

float

vatId

int

vatValue

float

currency

exchangeRatio

float

lastUpdateTimestamp

Methods
public toArray()

Returns this model as an array.

VariationStandardCategory

VariationStandardCategory

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

categoryId

int

plentyId

int

manually

string

Methods
public toArray()

Returns this model as an array.

VariationStock

VariationStock

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

warehouseId

int

stockPhysical

reservedStock

reservedEbay

reorderDelta

stockNet

int

updateAmazon

updatePixmania

warehouseType

reordered

reservedBundle

averagePurchasePrice

warehousePriority

lastUpdateTimestamp

string

lastCalculateTimestamp

reservedOutOfStock

reservedBasket

Methods
public toArray()

Returns this model as an array.

VariationStockBuffer

VariationStockBuffer

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

stockBuffer

int

Methods
public toArray()

Returns this model as an array.

VariationSupplier

VariationSupplier

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

createdTimestamp

string

deliveryTimeInDays

discount

float

discountable

string

id

int

itemNumber

string

itemVariationId

lastPriceQuery

string

lastUpdateTimestamp

string

minimumOrderValue

int

packagingUnit

float

purchasePrice

float

supplierId

int

Methods
public toArray()

Returns this model as an array.

VariationWarehouse

VariationWarehouse

Namespace

Plenty\Modules\Item\DataLayer\Models

Properties
Name Type Description

variationId

int

warehouseId

int

warehouseZoneId

int

storageLocationType

string

reorderLevel

int

maximumStock

int

stockBuffer

int

stockTurnoverInDays

int

storageLocationId

int

lastUpdateTimestamp

string

createdTimestamp

string

Methods
public toArray()

Returns this model as an array.

Services

ItemDataLayerResultLookup

ItemDataLayer Lookup

Namespace

Plenty\Modules\Item\DataLayer\Services

Methods
public getNumberOfRows():int
public getResult():array

DefaultShippingCost

Contracts

DefaultShippingCostRepositoryContract

The contract for the default shipping cost repository

Namespace

Plenty\Modules\Item\DefaultShippingCost\Contracts

Methods
public findShippingCost($itemId, $referrerId, $shippingDestinationId, $paymentMethodId):float
Parameters

Name

Type

Description

$itemId

int

The ID of the item

$referrerId

float

The ID of the referrer

$shippingDestinationId

int

The ID of the shipping destination

$paymentMethodId

int

The ID of the payment method

Models

DefaultShippingCost

The default shipping cost model

Namespace

Plenty\Modules\Item\DefaultShippingCost\Models

Properties
Name Type Description

id

int

itemId

int

profileId

int

Methods
public toArray()

Returns this model as an array.

Item

Contracts

ItemRepositoryContract

The contract for the item repository

Namespace

Plenty\Modules\Item\Item\Contracts

Methods
public add($data):void

Creates an item.

Parameters

Name

Type

Description

$data

array

The item data as an associative array

public show($itemId, $columns = [], $lang = &quot;de&quot;, $with = []):void

Get an item. The ID of the item must be specified.

Parameters

Name

Type

Description

$itemId

int

The ID of the item

$columns

array

The array of the shown columns. All columns are returned by default.

$lang

string

The language of the item

$with

array

The relations to be loaded.

Parameters

Name

Type

Description

$columns

The array of the shown columns. All columns are returned by default.

$lang

The language of the item

$page

int

The shown page. Default value is 1.

$itemsPerPage

int

The items shown per page. Default value is 50.

$with

array

The relations to be loaded.

public update($data, $itemId):Plenty\Modules\Item\Item\Models\Item
Return type: Item

Update a item. The ID of the item must be specified.

Parameters

Name

Type

Description

$data

array

$itemId

int

public bulkUpdate($data):Illuminate\Support\Collection
Return type: Collection

Update up to 50 items. The ID of the item must be specified.

Parameters

Name

Type

Description

$data

array

public delete($itemId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Delete an item. The ID of the item must be specified.

Parameters

Name

Type

Description

$itemId

int

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

Item

The item model

Namespace

Plenty\Modules\Item\Item\Models

Properties
Name Type Description

id

int

The ID of the item. The ID must be unique.

position

int

The position of the item

itemType

string

The type of the item. Because Set items are managed using a separate route, this value is always Default.

stockType

int

The stock type of the item. Possible values: <ul><li>0 = Stocked item (default)</li> <li>1 = Production item</li> <li>2 = Colli</li> <li>3 = Special order item</li></ul>

storeSpecial

int

Option to present items more prominently in the online store. <ul><li>1 = Special offer</li><li>2 = New items</li><li>3 = Top items</li></ul>

ownerId

int

The plentymarkets user that is assigned as owner of this item.

manufacturerId

int

The ID of the manufacturer of the item

producingCountryId

int

The ID of the country in which the item was manufactured.

mainVariationId

int

The ID of the main variation of the item. The ID must be unique.

revenueAccount

int

The revenue account the item is linked to. An individual revenue account can be saved for each item in plentymarkets. If this is not done, plentymarkets automatically determines a revenue account based on the VAT rate.

couponRestriction

int

Indicates if the item can be purchased using a promotional coupon. <ul><li>0 = Permitted</li> <li>1 = Not permitted</li> <li>2 = Purchasable with coupon only</li></ul>

condition

int

The condition of the item. Possible values: <ul><li>0 = New</li><li>1 = Used</li> <li>2 = Boxed as new</li> <li>3 = New with label</li> <li>4 = Factory seconds</li></ul>

conditionApi

int

The condition of the item that is transferred to markets via API. <ul><li>0 = New</li> <li>1 = Used but as new</li> <li>2 = Used but very good</li> <li>3 = Used but good</li> <li>4 = Used but acceptable</li> <li>5 = Factory seconds</li></ul>

createdAt

string

Timestamp of the date and time the item was created.

updatedAt

string

Timestamp of the last date and time the item was updated.

isSubscribable

bool

Flag that indicates if the item can be ordered as a subscription item. If yes, the item can be ordered for delivery at regular intervals.

isSerialNumber

bool

Flag that indicates if serial numbers are to be assigned to variations of this item to uniquely identify every item sold. Serial numbers ensure traceability of an item in case of errors or problems.

isShippingPackage

bool

Flag that indicates if a shipping package is to be used for this item. If yes and the variation’s dimensions are entered in the <b>Settings</b> tab of a variation, the correct shipping package is assigned automatically.

amazonFbaPlatform

int

Indicates the platform used for Fulfilment by Amazon (FBA). <ul><li>0 = Do not use</li> <li>1 = AMAZON EU (Europe)</li> <li>2 = AMAZON FE (Far East)</li> <li>3 = AMAZON NA (North America)</li></ul>

isShippableByAmazon

bool

Flag that indicates if the item can be shipped with Amazon Multi-Channel. Amazon Multi-Channel Fulfillment is a service for fulfilling orders from sales channels other than Amazon platforms using inventory stored in the Amazon fulfillment center.

amazonProductType

int

The Amazon product type of the item. List of IDs: https://www.plentymarkets.co.uk/manual/data-exchange/data-formats/item/

amazonFedas

string

The FEDAS product classification key of the item.

ebayPresetId

int

The eBay preset ID. This plentymarkets ID must be specified to save values for $ebayCategory, $ebayCategory2, $ebayStoreCategory and $ebayStoreCategory2.

ebayCategory

int

The eBay category 1 of the item. This category is used when a new listing is created.

ebayCategory2

int

The eBay category 2 of the item. This category is used when a new listing is created.

ebayStoreCategory

int

The ID of the eBay store category 1 of the item. This value is used for new listings.

ebayStoreCategory2

int

The ID of the eBay store category 2 of the item. This value is used for new listings.

rakutenCategoryId

int

The ID of the Rakuten category of this item.

flagOne

int

Flag 1 of the item. Flags can be used to organise and filter items. Each item can be assigned up to two flags. Possible values: 1 to 31, 0 = no flag

flagTwo

int

Flag 2 of the item. Flags can be used to organise and filter items. Each item can be assigned up to two flags. Possible values: 1 to 11, 0 = no flag

ageRestriction

int

The age customers must be to purchase the item. Items with an age rating of 18+ must be linked to a shipping profile for which the PostIdent option is activated. <ul><li>0 = None available</li> <li>3 = Released for ages 3 and up</li> <li>6 = Ages 6 and up</li> <li>9 = Ages 9 and up</li> <li>12 = Ages 12 and up</li> <li>14 = Ages 14 and up</li> <li>16 = Ages 16 and up</li> <li>18 = Ages 18 and up</li> <li>50 = Not marked</li> <li>88 = Not required</li> <li>99 = Unknown</li></ul>

feedback

int

The feedback, i.e. rating, that this item received. Possible values are 1 to 5 or 1 to 10 depending on the maximum rating setting. An initial feedback can be saved for items. The saved value will then be displayed as the initial feedback. Every time new feedback is submitted, the average value will be recalculated automatically.

free1

string

The content of the free text field 1. This can be displayed in the online store or on eBay.

free2

string

The content of the free text field 2. This can be displayed in the online store or on eBay.

free3

string

The content of the free text field 3. This can be displayed in the online store or on eBay.

free4

string

The content of the free text field 4. This can be displayed in the online store or on eBay.

free5

string

The content of the free text field 5. This can be displayed in the online store or on eBay.

free6

string

The content of the free text field 6. This can be displayed in the online store or on eBay.

free7

string

The content of the free text field 7. This can be displayed in the online store or on eBay.

free8

string

The content of the free text field 8. This can be displayed in the online store or on eBay.

free9

string

The content of the free text field 9. This can be displayed in the online store or on eBay.

free10

string

The content of the free text field 10. This can be displayed in the online store or on eBay.

free11

string

The content of the free text field 11. This can be displayed in the online store or on eBay.

free12

string

The content of the free text field 12. This can be displayed in the online store or on eBay.

free13

string

The content of the free text field 13. This can be displayed in the online store or on eBay.

free14

string

The content of the free text field 14. This can be displayed in the online store or on eBay.

free15

string

The content of the free text field 15. This can be displayed in the online store or on eBay.

free16

string

The content of the free text field 16. This can be displayed in the online store or on eBay.

free17

string

The content of the free text field 17. This can be displayed in the online store or on eBay.

free18

string

The content of the free text field 18. This can be displayed in the online store or on eBay.

free19

string

The content of the free text field 19. This can be displayed in the online store or on eBay.

free20

string

The content of the free text field 20. This can be displayed in the online store or on eBay.

maximumOrderQuantity

float

The maximum order quantity of an item permitted per order. If a maximum order quantity is specified, no more than this quantity of any combination of the variations of the item can be ordered. Decimal values are possible to allow orders by weight or length. Default value is 0. If value is 0, the maximum order quantity is unlimited.

manufacturer

Manufacturer

producingCountry

Country

texts

array

ebayTitles

array

itemShippingProfiles

array

itemProperties

array

itemCrossSelling

array

variations

array

An array of the variations of the item.

itemImages

array

An array of the images of the item.

customsTariffNumber

string

Deprecated: The customs tariff number of the item; usually a 11 digit code number based on the Harmonised System

Methods
public toArray()

Returns this model as an array.

ItemEbayTitle

The item ebay title model

Namespace

Plenty\Modules\Item\Item\Models

Properties
Name Type Description

title

string

The title.

itemId

int

The unique ID of the item.

id

int

The unique ID of the ebay title.

Methods
public toArray()

Returns this model as an array.

ItemText

The item text model

Namespace

Plenty\Modules\Item\Item\Models

Properties
Name Type Description

lang

string

The language of the item text.

name1

string

Default name of the item displayed in the online store and used for markets. The maximum length is 240 characters. The item name is also used for structuring the item URL.

name2

string

Alternative item name that can be used e.g. for markets. The maximum length is 240 characters.

name3

string

Alternative item name that can be used e.g. for markets. The maximum length is 240 characters.

shortDescription

string

The preview text of the item. This short description text can be displayed as a teaser in item lists.

metaDescription

string

The meta description of the item. This description is analysed by search engines and displayed in search results. This text should be treated as an advertising text to maximise click-through from search engine result pages. Current recommended limit is 156 characters.

description

string

The detailed description of the item.

technicalData

string

Technical data of the item.

keywords

string

HTML meta keywords to tag the item for search engines. More than one keyword can be separated by commas.

urlPath

string

The item’s URL path in the online store. By default, the URL path consists of the categories and the item name. The path is assigned automatically when the item is created and is displayed as part of the URL when the item is selected in the online store.

Methods
public toArray()

Returns this model as an array.

ItemCoupon

Hooks

CheckItemRestriction

CheckItemRestriction

Namespace

Plenty\Modules\Item\ItemCoupon\Hooks

Methods
public handle($basketItemEvent):void
Parameters

Name

Type

Description

$basketItemEvent

BasketItemEvent

ItemCrossSelling

Contracts

DynamicItemCrossSellingRepositoryContract

Repository for dynamic item cross-selling

Namespace

Plenty\Modules\Item\ItemCrossSelling\Contracts

Methods
public create($data):Plenty\Modules\Item\ItemCrossSelling\Models\DynamicItemCrossSelling
Return type: DynamicItemCrossSelling

Create a new dynamic cross-selling link

Parameters

Name

Type

Description

$data

array

public show($itemId, $crossItemId):Plenty\Modules\Item\ItemCrossSelling\Models\DynamicItemCrossSelling
Return type: DynamicItemCrossSelling

Get one dynamic cross-selling link of an item by item ID and cross-selling item ID

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

$crossItemId

int

The unique ID of the linked cross-selling item

public delete($itemId, $crossItemId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Delete a dynamic cross-selling link. The ID of the item and the ID of the cross-selling item must be specified. An exception is thrown if at least one relation exists.

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

$crossItemId

int

The unique ID of the linked cross-selling item

public findByItemId($itemId):array

List dynamic cross-selling links by item ID

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

public findAllByItemId($itemId):array

List all dynamic cross-selling links where the given item ID occurs

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

ItemCrossSellingRepositoryContract

Repository for item cross-selling

Namespace

Plenty\Modules\Item\ItemCrossSelling\Contracts

Methods
public create($data):Plenty\Modules\Item\ItemCrossSelling\Models\ItemCrossSelling
Return type: ItemCrossSelling
Parameters

Name

Type

Description

$data

array

public update($itemId, $crossItemId, $data):Plenty\Modules\Item\ItemCrossSelling\Models\ItemCrossSelling
Return type: ItemCrossSelling

Update an item cross-selling. The item ID and the cross item ID must be specified.

Parameters

Name

Type

Description

$itemId

int

$crossItemId

int

$data

array

public show($itemId):Plenty\Modules\Item\ItemCrossSelling\Models\ItemCrossSelling
Return type: ItemCrossSelling
Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

public delete($itemId, $crossItemId):bool
Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

$crossItemId

int

The unique ID of the linked cross-selling item

public findByItemId($itemId):array
Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

public findAllByItemId($itemId):array

List all cross-selling links where the given item ID occurs

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

Return type: PaginatedResult
Parameters

Name

Type

Description

$itemsPerPage

int

$page

int

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

DynamicItemCrossSelling

The item dynamic cross-selling model including the item

Namespace

Plenty\Modules\Item\ItemCrossSelling\Models

Properties
Name Type Description

itemId

int

The unique ID of the item to which cross-selling items are linked

crossItemId

int

The unique ID of the cross-selling item that is linked to the item

count

int

The count

lastUpdate

int

Last update integer

item

Item

Methods
public toArray()

Returns this model as an array.

ItemCrossSelling

The item cross-selling model including the item

Namespace

Plenty\Modules\Item\ItemCrossSelling\Models

Properties
Name Type Description

itemId

int

The unique ID of the item to which cross-selling items are linked

crossItemId

int

The unique ID of the cross-selling item that is linked to the item

relationship

string

The cross-selling relationship between item and cross-selling item. Possible values:<ul><li>Accessory = The cross-selling item is an accessory of the item.</li><li>ReplacementPart = The cross-selling item is a replacement part for the item.</li><li>Similar = The cross-selling item is similar to the item.</li><li>Bundle = The cross-selling item is suitable to be sold as a bundle with the item.</li></ul>

isDynamic

bool

Flag that indicates if the cross-selling link was generated automatically.

item

Item

Methods
public toArray()

Returns this model as an array.

ItemImage

Contracts

ItemImageAvailabilityRepositoryContract

The contract for the item image availability repository

Namespace

Plenty\Modules\Item\ItemImage\Contracts

Methods
public create($data):Plenty\Modules\Item\ItemImage\Models\ItemImageAvailability
Return type: ItemImageAvailability

Creates an image availability

Parameters

Name

Type

Description

$data

array

The image availability data as associative array

public delete($data):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an image availability.

Parameters

Name

Type

Description

$data

array

The image availability data as associative array

public findByImageId($imageId):Plenty\Modules\Item\ItemImage\Models\ItemImageAvailability
Return type: ItemImageAvailability

Lists image availabilities. The ID of the image must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

public findByType($imageId, $type):Plenty\Modules\Item\ItemImage\Models\ItemImageAvailability
Return type: ItemImageAvailability

Lists image availabilities. The ID of the image and the type must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

$type

string

The type of the image

ItemImageNameRepositoryContract

The contract for the item image name repository

Namespace

Plenty\Modules\Item\ItemImage\Contracts

Methods
public create($data):Plenty\Modules\Item\ItemImage\Models\ItemImageName
Return type: ItemImageName

Creates an image name

Parameters

Name

Type

Description

$data

array

The image name data as associative array

public update($data, $imageId, $lang):Plenty\Modules\Item\ItemImage\Models\ItemImageName
Return type: ItemImageName

Updates an image name. The ID of the image and the language must be specified.

Parameters

Name

Type

Description

$data

array

The image name data as associative array

$imageId

int

The ID of the image

$lang

string

The language of the image name

public delete($imageId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an image name. The ID of the image and the language must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

$lang

string

The language of the image name

public findOne($imageId, $lang):Plenty\Modules\Item\ItemImage\Models\ItemImageName
Return type: ItemImageName

Gets an image name. The ID of the image and the language must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

$lang

string

The language of the image name

public findByImageId($imageId):array

Lists all image names. The ID of the image must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

ItemImageRepositoryContract

The contract for the item image repository

Namespace

Plenty\Modules\Item\ItemImage\Contracts

Methods
public update($data, $imageId):Plenty\Modules\Item\ItemImage\Models\ItemImage
Return type: ItemImage

Updates an image. The ID of the image must be specified.

Parameters

Name

Type

Description

$data

array

The image data as associative array

$imageId

int

The ID of the image

public delete($imageId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an image. The ID of the item must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

public show($imageId):Plenty\Modules\Item\ItemImage\Models\ItemImage
Return type: ItemImage

Shows an image. The ID of the item must be specified.

Parameters

Name

Type

Description

$imageId

int

The ID of the image

public findByItemId($itemId):array

Lists images. The ID of the item must be specified.

Parameters

Name

Type

Description

$itemId

int

The ID of the image

public findByVariationId($variationId):array

Lists images. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findByItemIdAndOriginalChecksum($itemId, $checksum):Plenty\Modules\Item\ItemImage\Models\ItemImage
Return type: ItemImage

Shows an image. The ID of the item and hash must be specified.

Parameters

Name

Type

Description

$itemId

int

The ID of the item

$checksum

string

The MD5 checksum of the image

public upload($data):Plenty\Modules\Item\ItemImage\Models\ItemImage
Return type: ItemImage

Uploads an item image

Parameters

Name

Type

Description

$data

array

The image data as associative array

public warmup($urls, $queue = &quot;plentymarkets-command&quot;):void

Calls a stack of image urls to prepare cache

Parameters

Name

Type

Description

$urls

array

array of urls to call

$queue

string

name of queue

public syncOldImagesToCDN():void
public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

ItemImageSettingsRepositoryContract

Get, update or invalidate item image settings

Namespace

Plenty\Modules\Item\ItemImage\Contracts

Methods
public get():Plenty\Legacy\Models\Item\ItemImageSettings
Return type: ItemImageSettings
public update($data):Plenty\Legacy\Models\Item\ItemImageSettings
Return type: ItemImageSettings
Parameters

Name

Type

Description

$data

public invalidate($path):Plenty\Legacy\Models\Item\ItemImageSettings
Return type: ItemImageSettings
Parameters

Name

Type

Description

$path

string

public invalidateStatus():void

Models

ItemImage

The ItemImage Model

Namespace

Plenty\Modules\Item\ItemImage\Models

Properties
Name Type Description

id

int

The unique ID of the image

itemId

int

The unique ID of the item the image is associated with

fileType

string

The file format of the image. Possible file formats: jpg, jpeg, png, gif, svg

path

string

The path under which the image is saved.

position

int

The position of the image. The position is used for sorting images in the online store.

createdAt

string

The time the image was uploaded.

updatedAt

string

The time the image details were last updated.

md5Checksum

string

The MD5 hash value of the image file

md5ChecksumOriginal

string

The MD5 hash value of the original image file

hasLinkedVariations

int

Indicates if the item is linked with variations. Returns 1 if at least one variation is linked with the image, otherwise 0.

size

int

The size of the image in pixels

width

int

The width of the image in pixels

height

int

The height of the image in pixels

url

string

The URL under which the image can be accessed after the upload.

urlMiddle

string

The URL that points to the medium-sized version of the item image.

urlPreview

string

The URL that points to the first preview version of the item image.

urlSecondPreview

string

The URL that points to the second preview version of the item image.

names

array

Lists the image’s name details as an array.

availabilities

array

Lists the image’s availability details as an array.

attributeValueImages

array

Lists the attribute value image’s details as an array.

Methods
public toArray()

Returns this model as an array.

ItemImageAvailability

ItemImageAvailability

Namespace

Plenty\Modules\Item\ItemImage\Models

Properties
Name Type Description

imageId

int

The ID of the image. The ID must be unique.

type

string

The type of referrer for which the image is available. Possible types: <ul><li>mandant = The image can be made available for clients (stores).</li><li>marketplace = The image can be made available for markets.</li><li>listing = The image can be made available for listings.</li></ul>

value

float

For the type <b>mandant</b>, this is the plentyID of the client (store) for which the image is available. For the types <b>marketplace</b> and <b>listing</b>, this is the ID of the referrer for which the image is available. <ul><li><strong>-1.00</strong> = The image is available for all referrers of this type.</li></ul>

Methods
public toArray()

Returns this model as an array.

ItemImageName

ItemImageName

Namespace

Plenty\Modules\Item\ItemImage\Models

Properties
Name Type Description

imageId

int

The ID of the image. The ID must be unique.

lang

string

The language of the image name

name

string

The name of the image in the specified language

alternate

string

The alternative name of the image in the specified language

Methods
public toArray()

Returns this model as an array.

ItemImageUpload

ItemImage

Namespace

Plenty\Modules\Item\ItemImage\Models

Properties
Name Type Description

id

int

The ID of the image. The ID must be unique.

itemId

int

The ID of the item the image is associated with

fileType

string

The file format of the image. Possible file formats: JPG, JPEG, PNG, GIF, SVG

path

string

The path under which the image is saved. Permitted characters for file names: alphanumeric (a-z, A-Z, 0-9), hypens (-), underscores (_).

position

int

The position of the image. The position is used for sorting images in the online store.

created

string

The time the image was uploaded.

updated

string

The time the image details were last updated.

uploadImageData

string

The base64 encoded image data of the image

uploadUrl

string

The URL under which the image can be accessed for uploading. Permitted characters for file names: alphanumeric (a-z, A-Z, 0-9), hypens (-), underscores (_).

uploadFileName

string

The file name assigned to the uploaded image. Permitted characters for file names: alphanumeric (a-z, A-Z, 0-9), hypens (-), underscores (_).

names

array

names

availabilities

array

availabilities

Methods
public toArray()

Returns this model as an array.

ItemLabel

Contracts

ItemLabelRepositoryContract

The contract for the item label repository

Namespace

Plenty\Modules\Item\ItemLabel\Contracts

Methods
public generateLabel($data):string

Get a variation label

Parameters

Name

Type

Description

$data

array

The required data to generate the item label

public generateItemLabel($data):string

Get a item label

Parameters

Name

Type

Description

$data

array

The required data to generate the item label

public listTemplates():array

List item label templates

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

ItemLabel

The item label model

Namespace

Plenty\Modules\Item\ItemLabel\Models

Properties
Name Type Description

labelId

int

The unique ID of the label template

itemId

int

The unique ID of the item

Methods
public toArray()

Returns this model as an array.

ItemListingCategory

Contracts

ItemListingCategoryRepositoryContract

Search for item listing categories

Namespace

Plenty\Modules\Item\ItemListingCategory\Contracts

Methods
Return type: Collection

Search for item listing categories

public get($id):void

Gets one item listing category

Parameters

Name

Type

Description

$id

int

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

ItemListingShopCategoryRepositoryContract

Get item listing shop categories

Namespace

Plenty\Modules\Item\ItemListingCategory\Contracts

Methods
public get($ebayAccountId):Illuminate\Support\Collection
Return type: Collection

Get a list of listing shop categories

Parameters

Name

Type

Description

$ebayAccountId

int

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

ItemProperty

Contracts

ItemPropertyRepositoryContract

The contract for the item property repository

Namespace

Plenty\Modules\Item\ItemProperty\Contracts

Methods
public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

ItemProperty

ItemPropertyValue

Namespace

Plenty\Modules\Item\ItemProperty\Models

Properties
Name Type Description

id

int

The id of the variation property value

itemId

int

The id of the variation

propertyId

int

The id of the property item

propertySelectionId

int

The id of the property selection

valueInt

int

The int value of the variation property value

valueFloat

float

The float value of the variation property value

valueFile

string

The file value of the variation property value

surcharge

float

The surcharge of the variation property value

property

Property

propertySelection

array

valueTexts

array

Methods
public toArray()

Returns this model as an array.

ItemPropertyValueText

The ItemPropertyValueText

Namespace

Plenty\Modules\Item\ItemProperty\Models

Properties
Name Type Description

valueId

int

lang

string

value

string

Methods
public toArray()

Returns this model as an array.

ItemSerialNumber

Contracts

ItemSerialNumberRepositoryContract

The contract of the item serial number repository

Namespace

Plenty\Modules\Item\ItemSerialNumber\Contracts

Methods
public all($perPage = 100, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all serial numbers.

Parameters

Name

Type

Description

$perPage

int

$page

int

public show($id):Plenty\Modules\Item\ItemSerialNumber\Models\ItemSerialNumber
Return type: ItemSerialNumber

Gets a serial number. The ID of the serial number must be specified.

Parameters

Name

Type

Description

$id

int

public create($data):Plenty\Modules\Item\ItemSerialNumber\Models\ItemSerialNumber
Return type: ItemSerialNumber

Creates a serial number

Parameters

Name

Type

Description

$data

array

public update($id, $data):Plenty\Modules\Item\ItemSerialNumber\Models\ItemSerialNumber
Return type: ItemSerialNumber

Updates a serial number. The ID of the serial number must be specified.

Parameters

Name

Type

Description

$id

int

$data

array

public delete($id):Plenty\Repositories\Contracts\DeleteResponseContract
Return type: DeleteResponseContract

Deletes a serial number. The ID of the serial number must be specified.

Parameters

Name

Type

Description

$id

int

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

Models

ItemSerialNumber

The item serial number model

Namespace

Plenty\Modules\Item\ItemSerialNumber\Models

Properties
Name Type Description

id

int

The ID of the serial number

orderId

int

The ID of the order

orderItemId

int

The ID of the order item

itemId

int

The ID of the item

serialNumber

string

The serial number

createdAt

string

The date the serial number was created

Methods
public toArray()

Returns this model as an array.

ItemShippingProfiles

Contracts

ItemShippingProfilesRepositoryContract

Repository for ItemShippingProfiles

Namespace

Plenty\Modules\Item\ItemShippingProfiles\Contracts

Methods
public find($id):Plenty\Modules\Item\ItemShippingProfiles\Models\ItemShippingProfiles
Return type: ItemShippingProfiles

Finds a shipping profile link by ID

Parameters

Name

Type

Description

$id

int

The unique ID of the link between shipping profile and item

public findByItemId($itemId):array

Lists all shipping profiles activated for an item

Parameters

Name

Type

Description

$itemId

int

The unique ID of the item

public create($data):Plenty\Modules\Item\ItemShippingProfiles\Models\ItemShippingProfiles
Return type: ItemShippingProfiles

Activates a shipping profile for an item

Parameters

Name

Type

Description

$data

array

public delete($id):array

Deactivates a shipping profile for an item

Parameters

Name

Type

Description

$id

int

The unique ID of the link between shipping profile and item

public getItemShippingProfiles($itemsPerPage, $page):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all shipping profiles of all items

Parameters

Name

Type

Description

$itemsPerPage

int

$page

int

public createBulk($data):array

Activates up to 50 shipping profiles for items

Parameters

Name

Type

Description

$data

array

public deleteBulk($itemId):void

Deactivates all shipping profiles for an item

Parameters

Name

Type

Description

$itemId

int

public deleteOne($shippingProfileId, $itemId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Delete the link between the specified shipping profile and item

Parameters

Name

Type

Description

$shippingProfileId

int

$itemId

int

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

Models

ItemShippingProfiles

The shipping profile model

Namespace

Plenty\Modules\Item\ItemShippingProfiles\Models

Properties
Name Type Description

id

int

The unique ID of the link between item and shipping profile

itemId

int

The unique ID of the item

profileId

int

The unique ID of the shipping profile

Methods
public toArray()

Returns this model as an array.

Manufacturer

Contracts

ManufacturerCommissionRepositoryContract

The contract for the manufacturer commission repository

Namespace

Plenty\Modules\Item\Manufacturer\Contracts

Methods
public find($id):Plenty\Modules\Item\Manufacturer\Models\ManufacturerCommission
Return type: ManufacturerCommission

Gets a manufacturer commission. The ID of the manufacturer commission must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the manufacturer

public create($data):Plenty\Modules\Item\Manufacturer\Models\ManufacturerCommission
Return type: ManufacturerCommission

Creates a manufacturer commission.

Parameters

Name

Type

Description

$data

array

The manufacturer commission data as an associative array

public update($data, $id):Plenty\Modules\Item\Manufacturer\Models\ManufacturerCommission
Return type: ManufacturerCommission

Updates a manufacturer commission. The ID of the manufacturer commission must be specified.

Parameters

Name

Type

Description

$data

array

The manufacturer commission data as an associative array

$id

int

The ID of the manufacturer

public delete($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a manufacturer commission. The ID of the manufacturer commission must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the manufacturer

public findByManufacturerId($manufacturerId):array

Lists manufacturer commissions. The ID of the manufacturer must be specified.

Parameters

Name

Type

Description

$manufacturerId

int

The ID of the manufacturer

ManufacturerExternalRepositoryContract

The contract for the manufacturer external repository

Namespace

Plenty\Modules\Item\Manufacturer\Contracts

Methods
public find($manufacturerId, $marketId):Plenty\Modules\Item\Manufacturer\Models\ManufacturerExternal
Return type: ManufacturerExternal

Gets a manufacturer external. The ID of the manufacturer and the ID of the market must be specified.

Parameters

Name

Type

Description

$manufacturerId

int

The ID of the manufacturer

$marketId

int

The ID of the market

public create($data):Plenty\Modules\Item\Manufacturer\Models\ManufacturerExternal
Return type: ManufacturerExternal

Creates a manufacturer external.

Parameters

Name

Type

Description

$data

array

The manufacturer external data as an associative array

public update($data, $manufacturerId, $marketId):Plenty\Modules\Item\Manufacturer\Models\ManufacturerExternal
Return type: ManufacturerExternal

Updates a manufacturer external. The ID of the manufacturer and the ID of the market must be specified.

Parameters

Name

Type

Description

$data

array

The manufacturer external data as an associative array

$manufacturerId

int

The ID of the manufacturer

$marketId

int

The ID of the market

public delete($manufacturerId, $marketId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a manufacturer external. The ID of the manufacturer and the ID of the market must be specified.

Parameters

Name

Type

Description

$manufacturerId

int

The ID of the manufacturer

$marketId

int

The ID of the market

Lists manufacturer externals.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

ManufacturerRepositoryContract

The contract for the manufacturer repository

Namespace

Plenty\Modules\Item\Manufacturer\Contracts

Methods
public create($data):Plenty\Modules\Item\Manufacturer\Models\Manufacturer
Return type: Manufacturer

Creates a manufacturer.

Parameters

Name

Type

Description

$data

array

The manufacturer data as an associative array

public update($data, $manufacturerId):Plenty\Modules\Item\Manufacturer\Models\Manufacturer
Return type: Manufacturer

Updates a manufacturer. The ID of the manufacturer must be specified.

Parameters

Name

Type

Description

$data

array

The manufacturer data as an associative array

$manufacturerId

int

The ID of the manufacturer

public delete($manufacturerId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a manufacturer. The ID of the manufacturer must be specified.

Parameters

Name

Type

Description

$manufacturerId

int

The ID of the manufacturer

public findById($manufacturerId, $with = []):Plenty\Modules\Item\Manufacturer\Models\Manufacturer
Return type: Manufacturer

Gets a manufacturer. The ID of the manufacturer must be specified.

Parameters

Name

Type

Description

$manufacturerId

int

The ID of the manufacturer

$with

array

public all($columns = [], $perPage = 50, $page = 1, $with = []):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all manufacturers.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of manufacturers shown per page. Default value is 50.

$page

int

The shown page. Default value is 1.

$with

array

Return type: PaginatedResult

Lists manufacturers by filter

Parameters

Name

Type

Description

$params

array

The filter array

$columns

array

An array of the shown columns. All columns are returned by default.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

Manufacturer

The item manufacturer model

Namespace

Plenty\Modules\Item\Manufacturer\Models

Properties
Name Type Description

id

int

The unique ID of the manufacturer.

name

string

The name of the manufacturer

legalName

string

The legal name of the manufacturer

externalName

string

The external name of the manufacturer. The external name is used for the item export to external markets. If no external name is saved, the Name will be used. The external name will also be transferred to FINDOLOGIC and will be indexed for item searches.

logo

string

The URL of the manufacturer’s logo

url

string

The URL of the manufacturer’s website

contactUrl

string

The Contact URL of the manufacturer’s website

street

string

The street of the manufacturer’s address

houseNo

string

The house number of the manufacturer’s address

postcode

string

The postal code of the manufacturer’s address

town

string

The town of the manufacturer’s address

phoneNumber

string

The phone number of the manufacturer

faxNumber

string

The fax number of the manufacturer

email

string

The email address of the manufacturer

countryId

int

The ID of the <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">country</a> in which the manufacturer is based; 0 = unknown.

pixmaniaBrandId

int

The manufacturer’s ID on the market Pixmania

neckermannAtEpBrandId

int

The manufacturer’s ID on the market Neckermann Austria, Enterprise version

laRedouteBrandId

int

The manufacturer’s ID on the market La Redoute

position

int

The position of the manufacturer

comment

string

Internal comments about the manufacturer (optional)

updatedAt

string

The time the manufacturer information was last updated.

responsibleName

string

The name of the EU-Responsible person

responsibleStreet

string

The street of the EU-Responsible person

responsibleHouseNo

string

The house number of the EU-Responsible person

responsiblePostCode

string

The postal code of the EU-Responsible person

responsibleTown

string

The town of the EU-Responsible person

responsibleCountry

int

The country of the EU-Responsible person

responsibleEmail

string

The email address of the EU-Responsible person

responsibleContactUrl

string

The contact form the EU-Responsible person

responsiblePhoneNo

string

The phone number of the EU-Responsible person

responsibleCountryIso

string

The ISO code of the country of the EU-Responsible person

responsibleCountryName

string

The name of the country of the EU-Responsible person

commissions

array

externals

array

gpsrCountry

Country

Methods
public toArray()

Returns this model as an array.

ManufacturerCommission

The item manufacturer commission model

Namespace

Plenty\Modules\Item\Manufacturer\Models

Properties
Name Type Description

id

int

The unique ID of the manufacturer commission

manufacturerId

int

The unique ID of the manufacturer

plentyId

int

The unique ID of the client (store) that the commission applies to. The route /rest/webstores provides access to clients (stores).

referrerId

float

The unique ID of the referrer that the commission applies to. The route /rest/orders/referrers provides access to referrers.

commission

float

The manufacturer commission value in percent

manufacturer

Manufacturer

Methods
public toArray()

Returns this model as an array.

ManufacturerExternal

The item manufacturer external model

Namespace

Plenty\Modules\Item\Manufacturer\Models

Properties
Name Type Description

manufacturerId

int

The unique ID of the manufacturer

marketId

int

The unique ID of the market

value

string

The external value

manufacturer

Manufacturer

Methods
public toArray()

Returns this model as an array.

PackingUnit

Contracts

PackingUnitRepositoryContract

Get the packing units for the item variations

Namespace

Plenty\Modules\Item\PackingUnit\Contracts

Methods
public getPackingUnits($language):array

Get the item variation packing units

Parameters

Name

Type

Description

$language

string

Optional. The language of the packing units. If no language will be provided, all of them will be returned

public getPackingUnitsById($id, $language = &quot;all&quot;, $isUnitId = false):Plenty\Modules\Item\PackingUnit\Models\PackingUnit
Return type: PackingUnit

Get the item variation packing unit for a specific given id

Parameters

Name

Type

Description

$id

int

The id of the packing unit

$language

string

Optional. The language of the packing units. If no language will be provided, all of them will be returned

$isUnitId

bool

Optional. The flag to say if the id provided is the ID of the unit (from 0 to 39). If the flag is true, the query will take into account the ID as being the unit ID

Models

PackingUnit

The model that holds the names of the item variation packing units

Namespace

Plenty\Modules\Item\PackingUnit\Models

Properties
Name Type Description

id

int

The id of the packing unit entry. Primary key auto-increment

unitId

int

The id of the packing unit as it was until now (from 0 to 39 without 33)

unitNameEN

string

The name of the packing unit in English

unitNameDE

string

The name of the packing unit in German

Methods
public toArray()

Returns this model as an array.

Property

Contracts

PropertyGroupNameRepositoryContract

The contract for the property group name repository

Namespace

Plenty\Modules\Item\Property\Contracts

Methods
public create($data, $propertyGroupId):Plenty\Modules\Item\Property\Models\PropertyGroupName
Return type: PropertyGroupName

Creates a property group name. The ID of the property group must be specified.

Parameters

Name

Type

Description

$data

array

The property group name data as an associative array

$propertyGroupId

int

The ID of the property group

public delete($propertyGroupId, $lang):bool

Deletes a property group name. The ID of the property group and the language must be specified.

Parameters

Name

Type

Description

$propertyGroupId

int

The ID of the property group

$lang

string

The specific language of the property group name

public update($data, $propertyGroupId, $lang):Plenty\Modules\Item\Property\Models\PropertyGroupName
Return type: PropertyGroupName

Updates a property group name. The ID of the property group and the language must be specified.

Parameters

Name

Type

Description

$data

array

The property group name data as an associative array

$propertyGroupId

int

The ID of the property group

$lang

string

The specific language of the property group name

public findOne($propertyGroupId, $lang):Plenty\Modules\Item\Property\Models\PropertyGroupName
Return type: PropertyGroupName

Gets a property group name. The ID of the property group and the language must be specified.

Parameters

Name

Type

Description

$propertyGroupId

int

The ID of the property group

$lang

string

The specific language of the property group name

public findByPropertyGroupId($propertyGroupId):array

Lists property group names. The ID of the property group must be specified.

Parameters

Name

Type

Description

$propertyGroupId

int

The ID of the property group

PropertyGroupRepositoryContract

The contract for the property group repository

Namespace

Plenty\Modules\Item\Property\Contracts

Methods
public create($data):Plenty\Modules\Item\Property\Models\PropertyGroup
Return type: PropertyGroup

Creates a property group.

Parameters

Name

Type

Description

$data

array

The property group data as an associative array

public show($id):Plenty\Modules\Item\Property\Models\PropertyGroup
Return type: PropertyGroup

Gets a property group. The ID of the property group must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property group

public update($data, $id):Plenty\Modules\Item\Property\Models\PropertyGroup
Return type: PropertyGroup

Updates a property group. The ID of the property group must be specified.

Parameters

Name

Type

Description

$data

array

The property group data as an associative array

$id

int

The ID of the property group

public delete($id):bool

Deletes a property group. The ID of the property group must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property group

public findById($id):Plenty\Modules\Item\Property\Models\PropertyGroup
Return type: PropertyGroup

Gets a property group. The ID of the property group must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property group

public all($columns = [], $perPage = 50, $page = 1, $with = []):array

Lists all property groups.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of shown property groups per page. Default value is 50.

$page

int

The shown page. Default value is 1.

$with

array

public findByBackendName($backendName):Plenty\Modules\Item\Property\Models\PropertyGroup
Return type: PropertyGroup

Gets a property group. The backend name of the property group must be specified.

Parameters

Name

Type

Description

$backendName

string

PropertyMarketReferenceRepositoryContract

The contract for the property market reference repository

Namespace

Plenty\Modules\Item\Property\Contracts

Methods
public create($data, $propertyId):Plenty\Modules\Item\Property\Models\PropertyMarketReference
Return type: PropertyMarketReference

Creates a property market reference. The ID of the property must be specified.

Parameters

Name

Type

Description

$data

array

The property market component data as an associative array

$propertyId

int

The ID of the property

public delete($propertyId, $marketReference):bool

Deletes a property market reference. The ID of the property and the language must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

$marketReference

float

The market reference value

public update($data, $propertyId, $marketReference):Plenty\Modules\Item\Property\Models\PropertyMarketReference
Return type: PropertyMarketReference

Updates a property market reference. The ID of the property and the language must be specified.

Parameters

Name

Type

Description

$data

array

The property market component data as an associative array

$propertyId

int

The ID of the property

$marketReference

float

The market reference value

public findOne($propertyId, $marketReference):Plenty\Modules\Item\Property\Models\PropertyMarketReference
Return type: PropertyMarketReference

Gets a property market reference. The ID of the property and the language must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

$marketReference

float

The market reference value

public findByPropertyId($propertyId):Plenty\Modules\Item\Property\Models\PropertyMarketReference
Return type: PropertyMarketReference

List of property market references. The ID of the property must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

public getPropertyMarketReferences($referrerId, $componentId = null, $filters = []):array

Lists all property market references.

Parameters

Name

Type

Description

$referrerId

float

The ID of the referrer

$componentId

int

The ID of the component

$filters

array

You can pass here multiple filters. Available: componentId - pass multiple component IDs that should be searched for externalComponent - pass the external component value that should be searched for

PropertyNameRepositoryContract

The contract for the property name repository

Namespace

Plenty\Modules\Item\Property\Contracts

Methods
public create($data, $propertyId):Plenty\Modules\Item\Property\Models\PropertyName
Return type: PropertyName

Creates a property name. The ID of the property must be specified.

Parameters

Name

Type

Description

$data

array

The property name data as an associative array

$propertyId

int

The ID of the property

public delete($propertyId, $lang):bool

Deletes a property name. The ID of the property and the language must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

$lang

string

The language of the property name

public update($data, $propertyId, $lang):Plenty\Modules\Item\Property\Models\PropertyName
Return type: PropertyName

Updates a property name. The ID of the property and the language must be specified.

Parameters

Name

Type

Description

$data

array

The property name data as an associative array

$propertyId

int

The ID of the property

$lang

string

The language of the property name

public findOne($propertyId, $lang):Plenty\Modules\Item\Property\Models\PropertyName
Return type: PropertyName

Gets a property name. The ID of the property and the language must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

$lang

string

The language of the property name

public findBypropertyId($propertyId):Plenty\Modules\Item\Property\Models\PropertyName
Return type: PropertyName

Lists property names. The ID of the property must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

PropertyRepositoryContract

The contract for the property repository

Namespace

Plenty\Modules\Item\Property\Contracts

Methods
public create($data):Plenty\Modules\Item\Property\Models\Property
Return type: Property

Creates a property.

Parameters

Name

Type

Description

$data

array

The property data as an associative array

public show($id):Plenty\Modules\Item\Property\Models\Property
Return type: Property

Gets a property. The ID of the property must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property

public update($data, $id):Plenty\Modules\Item\Property\Models\Property
Return type: Property

Updates a property. The ID of the property must be specified.

Parameters

Name

Type

Description

$data

array

The property data as an associative array

$id

int

The ID of the property

public delete($id):bool

Deletes a property. The ID of the property must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property

public findById($id):Plenty\Modules\Item\Property\Models\Property
Return type: Property

Gets a property. The ID of the property must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property

public all($columns = [], $perPage = 50, $page = 1):array

Lists all properties.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of attribute values shown per page. Default value is 50

$page

int

The shown page. Default value is 1.

Return type: PaginatedResult

Search properties.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of attribute values shown per page. Default value is 50

$page

int

The shown page. Default value is 1.

$with

array

$filter

array

public findByBackendName($backendName):Plenty\Modules\Item\Property\Models\Property
Return type: Property

Gets an property. The backend name of the property must be specified.

Parameters

Name

Type

Description

$backendName

string

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

PropertySelectionRepositoryContract

The contract for the property selection repository

Namespace

Plenty\Modules\Item\Property\Contracts

Methods
public create($data, $propertyId):Plenty\Modules\Item\Property\Models\PropertySelection
Return type: PropertySelection

Creates a property selection. The ID of the property must be specified.

Parameters

Name

Type

Description

$data

array

The property selection data as an associative array

$propertyId

int

The ID of the property

public createLang($data, $propertyId, $id):Plenty\Modules\Item\Property\Models\PropertySelection
Return type: PropertySelection

Creates a property selection lang. The ID of the property selection must be specified.

Parameters

Name

Type

Description

$data

array

The property selection data as an associative array

$propertyId

int

The ID of the property

$id

int

The ID of the property selection

public findByProperty($propertyId, $lang = null):array

List of property selections. The ID of the property must be specified.

Parameters

Name

Type

Description

$propertyId

int

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language</a> of the property selection

public findByPropertyId($propertyId):Plenty\Modules\Item\Property\Models\PropertySelection
Deprecated!

This method will not be supported in the future. Please refrain from using it as soon as possible.

Return type: PropertySelection

List of property selections. The ID of the property must be specified.

Parameters

Name

Type

Description

$propertyId

int

The ID of the property

public deleteSelection($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a property selection. The ID of the property selection must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property selection

public delete($id, $lang):bool

Deletes a property selection in a specified language. The ID of the property selection and the language must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property selection

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language</a> of the property selection

public findOne($id, $lang):Plenty\Modules\Item\Property\Models\PropertySelection
Return type: PropertySelection

Get a property selection in the specified language. The ID of the property selection and the language must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property selection

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language</a> of the property selection

public findSelection($id):array

Get a property selection. The ID of the property selection must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the property selection

public update($data, $id, $lang):Plenty\Modules\Item\Property\Models\PropertySelection
Return type: PropertySelection

Updates a property selection. The ID of the property selection and the language must be specified.

Parameters

Name

Type

Description

$data

array

The property selection data as an associative array

$id

int

The ID of the property selection

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language</a> of the property selection

Models

Property

The property including Property name and property market reference

Namespace

Plenty\Modules\Item\Property\Models

Properties
Name Type Description

id

int

The ID of the property

position

int

The position of the property

propertyGroupId

int

The ID of the property group the property is assigned to. Value is null if property is not assigned to a property group.

unit

string

The unit of measurement of the property. Value is null if no unit is associated.

backendName

string

The backend name of the property. The back end name is not visible to customers.

comment

string

Internal comment/note saved for the property. Internal comments are not visible to customers.

valueType

string

Permitted property values are: <ul><li>empty = No property type</li><li>int = A whole number can be saved for an item, e.g. a size.</li><li>float = A number with decimal places can be saved for an item, e.g. a measurement.</li><li>selection = One of several options can be saved for the item. The values of the property value Selection can be managed using the route PropertySelection.</li><li>text = Text can be saved for an item.</li><li>file = A file can be saved for an item.</li></ul>

isSearchable

bool

Flag that indicates if items can be found by entering the property name as a search term.

isOderProperty

bool

Flag that indicates if the property is available in the order process. Depending on the property type, customers e.g. can enter a text or value or select an option from a drop-down list.

isShownOnItemPage

bool

Flag that indicates if the property will be shown on the item’s page in the online store-

isShownOnItemList

bool

Flag that indicates if the property will be shown in the item listing in the online store.

isShownAtCheckout

bool

Flag that indicates if the property will be shown in the order process.

isShownInPdf

bool

Flag that indicates if the property will be shown in PDF documents.

isShownAsAdditionalCosts

bool

Display as additional costs

surcharge

float

The surcharge for the property. Surcharges will automatically be added to the item price in the detailed view of an item and in the order process. The default value is 0.00, i.e. no surcharge. In the plentymarkets front end, the template variable PriceDynamic displays the price of a variation including the surcharge.

updatedAt

string

The time the property was last updated.

names

array

marketComponents

array

group

array

selections

array

Methods
public toArray()

Returns this model as an array.

PropertyGroup

The PropertyGroup including PropertyGroupName

Namespace

Plenty\Modules\Item\Property\Models

Properties
Name Type Description

id

int

The unique ID of the property group

backendName

string

The back end name of the property group. This name is not visible to customers.

orderPropertyGroupingType

string

Indicates how order properties are grouped for selection in the order process. This parameter is applicable to order properties of the type None only.<ul><li>none = Order properties are not grouped.</li><li>single = One of the grouped order properties can be selected from the drop-down list.</li><li>multi = Multiple order properties can be selected.</li></ul>

isSurchargePercental

bool

Flag that indicates if surcharge values are calculated in percent.

ottoComponentId

int

updatedAt

string

The time the property group was last updated.

names

array

properties

array

Methods
public toArray()

Returns this model as an array.

PropertyGroupName

The PropertyGroupName including PropertyGroup

Namespace

Plenty\Modules\Item\Property\Models

Properties
Name Type Description

propertyGroupId

int

lang

string

name

string

description

string

propertyGroup

PropertyGroup

Methods
public toArray()

Returns this model as an array.

PropertyMarketReference

The PropertyMarketReference including Property

Namespace

Plenty\Modules\Item\Property\Models

Properties
Name Type Description

propertyId

int

The unique ID of the property

componentId

int

The unique ID of the reference for the market

marketId

float

The unique ID of the market

externalComponent

string

The external reference of the property

property

Property

Methods
public toArray()

Returns this model as an array.

PropertyName

The PropertyName including Property

Namespace

Plenty\Modules\Item\Property\Models

Properties
Name Type Description

propertyId

int

The unique ID of the property

lang

string

The language code of the property name

name

string

The name of the property. The property name is displayed in the online store.

description

string

The description of the property. The property description is displayed in the online store.

property

Property

Methods
public toArray()

Returns this model as an array.

PropertySelection

The property selection including the property

Namespace

Plenty\Modules\Item\Property\Models

Properties
Name Type Description

id

int

The unique ID of the selection

propertyId

int

The unique ID of the property

lang

string

The code of the language for which name and description of the selection were saved.

name

string

The name of the selection. The name is displayed in the online store.

description

string

The description of the selection. This description is displayed in the online store.

property

Property

Methods
public toArray()

Returns this model as an array.

SalesPrice

Contracts

SalesPriceAccountRepositoryContract

The contract for the sales price referrer account repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceAccount
Return type: SalesPriceAccount

Activates a referrer account for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The account data as an associative array

$salesPriceId

int

The unique ID of the sales price

public delete($salesPriceId, $accountType, $accountId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates a referrer account for a sales price. The ID of the sales price, the type and the ID of the referrer account must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$accountType

int

The type of the referrer account linked to the sales price

$accountId

int

The ID of the referrer account linked to the sales price

public findOne($salesPriceId, $accountType, $accountId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceAccount
Return type: SalesPriceAccount

Gets a referrer account for a sales price. The ID of the sales price, the type and the ID of the referrer account must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$accountType

int

The type of the referrer account linked to the sales price

$accountId

int

The ID of the referrer account linked to the sales price

public findByPriceId($salesPriceId):array

Lists the activated referrer accounts of a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

public deleteByPriceId($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates the referrer accounts for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

SalesPriceCountryRepositoryContract

The contract for the sales price country repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceCountry
Return type: SalesPriceCountry

Activates a country for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The sales price country data as an associative array.

$salesPriceId

int

The unique ID of the sales price

public delete($salesPriceId, $countryId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates a country for a sales price. The ID of the sales price and the ID of the country must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

$countryId

int

The unique ID of the <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">country</a>; -1 = all countries.

public findOne($salesPriceId, $countryId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceCountry
Return type: SalesPriceCountry

Gets a country for a sales price. The ID of the sales price and the ID of the country must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

$countryId

int

The unique ID of the <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">country</a>.

public findByPriceId($salesPriceId):array

Lists the countries for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

public deleteByPriceId($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes countries from a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

SalesPriceCurrencyRepositoryContract

The contract for the sales price currency repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceCurrency
Return type: SalesPriceCurrency

Activates a currency for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The sales price currency data as an associative array

$salesPriceId

int

The unique ID of the sales price

public delete($salesPriceId, $currency):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates a currency for a sales price. The ID of the sales price and the ISO code of the currency must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$currency

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#currencies" target="_blank">ISO</a> code of the currency; -1 = all currencies.

public findOne($salesPriceId, $currency):Plenty\Modules\Item\SalesPrice\Models\SalesPriceCurrency
Return type: SalesPriceCurrency

Gets a sales price currency. The ID of the sales price and the ISO code of the currency must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

$currency

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#currencies" target="_blank">ISO</a> code of the currency; -1 = all currencies.

public findByPriceId($salesPriceId):array

Lists the active currencies of a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

public deleteByPriceId($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates the currencies of a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

SalesPriceCustomerClassRepositoryContract

The contract for the sales price customer class repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceCustomerClass
Return type: SalesPriceCustomerClass

Activates a customer class for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The customer class data as an associative array

$salesPriceId

int

The unique ID of the sales price

public delete($salesPriceId, $customerClassId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates a customer class for a sales price. The ID of the sales price and the ID of the customer class must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$customerClassId

int

The unique ID of the customer class

public findOne($salesPriceId, $customerClassId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceCustomerClass
Return type: SalesPriceCustomerClass

Gets a customer class for a sales price. The ID of the sales price and the ID of the customer class must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$customerClassId

int

The unique ID of the customer class

public findByPriceId($salesPriceId):array

Lists the active customer classes of a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

public deleteByPriceId($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates the customer classes of a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

SalesPriceNameRepositoryContract

The contract for the sales price name repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceName
Return type: SalesPriceName

Creates a sales price name. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The sales price name data as an associative array

$salesPriceId

int

The unique ID of the sales price

public update($data, $salesPriceId, $lang):Plenty\Modules\Item\SalesPrice\Models\SalesPriceName
Return type: SalesPriceName

Updates a sales price name. The ID of the sales price and the language code must be specified.

Parameters

Name

Type

Description

$data

array

The sales price name data as an associative array

$salesPriceId

int

The unique ID of the sales price

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language code</a> of the sales price name

public delete($salesPriceId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a sales price name. The ID of the sales price and the language code must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language code</a> of the sales price name

public findOne($salesPriceId, $lang):Plenty\Modules\Item\SalesPrice\Models\SalesPriceName
Return type: SalesPriceName

Gets a sales price name. The ID of the sales price and the language code must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language code</a> of the sales price name

public findByPriceId($salesPriceId):array

Lists all sales price names of a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

SalesPriceOnlineStoreRepositoryContract

The contract for the sales price online store repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceOnlineStore
Return type: SalesPriceOnlineStore

Activates a client (store) for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The client (store) data as an associative array

$salesPriceId

int

The unique ID of the sales price

public delete($salesPriceId, $onlineStoreId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates a client (store) for a sales price. The ID of the sales price and the ID of the client (store) must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$onlineStoreId

int

The unique ID of the client (store)

public deleteByPriceId($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates all clients (stores) for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

public findOne($salesPriceId, $onlineStoreId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceOnlineStore
Return type: SalesPriceOnlineStore

Gets client (store) information for a sales price. The ID of the sales price and the ID of the client (store) must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$onlineStoreId

int

The ID of the online store

public findByPriceId($salesPriceId):array

Lists the active clients (stores) for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

SalesPriceReferrerRepositoryContract

The contract for the sales price referrer repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public create($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceReferrer
Return type: SalesPriceReferrer

Activates a referrer for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The sales price referrer data as an associative array

$salesPriceId

int

The unique ID of the sales price

public delete($salesPriceId, $referrerId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates a referrer for a sales price. The ID of the sales price and the ID of the referrer must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$referrerId

int

The ID of the referrer

public findOne($salesPriceId, $referrerId):Plenty\Modules\Item\SalesPrice\Models\SalesPriceReferrer
Return type: SalesPriceReferrer

Gets a referrer. The ID of the sales price and the ID of the referrer must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$referrerId

int

The ID of the referrer

public findByPriceId($salesPriceId):array

Lists all activated referrers of a sales. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

public deleteByPriceId($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deactivates all referrers for a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

SalesPriceRepositoryContract

The contract for the sales price repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
public show($salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPrice
Return type: SalesPrice

Gets a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

public create($data):Plenty\Modules\Item\SalesPrice\Models\SalesPrice
Return type: SalesPrice

Creates a sales price.

Parameters

Name

Type

Description

$data

array

The sales price data as an associative array

public update($data, $salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPrice
Return type: SalesPrice

Updates a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$data

array

The sales price data as an associative array

$salesPriceId

int

The ID of the sales price

public delete($salesPriceId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

public findById($salesPriceId):Plenty\Modules\Item\SalesPrice\Models\SalesPrice
Return type: SalesPrice

Gets a sales price. The ID of the sales price must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The ID of the sales price

public all($columns = [], $perPage = 50, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all sales prices.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of sales prices shown per page. Default value is 50

$page

int

The shown page. Default value is 1

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

SalesPriceSearchRepositoryContract

The contract for the sales price search repository

Namespace

Plenty\Modules\Item\SalesPrice\Contracts

Methods
Return type: SalesPriceSearchResponse
Parameters

Name

Type

Description

$request

SalesPriceSearchRequest

public searchAll($request):array
Parameters

Name

Type

Description

$request

SalesPriceSearchRequest

Models

SalesPrice

The item sales price model.

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

id

int

The unique ID of the sales price

position

int

The position of the sales price

minimumOrderQuantity

float

The minimum order quantity of the sales price. Sales prices with different minimum quantities can be used to create a quantity based graduation of prices in plentymarkets.

type

string

The price type of the sales price.<ul><li>RRP = Sales price is the recommended retail price (RRP). If the RRP and another sales price are linked with a variation, the RRP will be displayed in the online store as red strike-through text next to the sales price.</li><li>Special offer = Sales price as a special offer. Special offers are used for markets, e.g. Amazon and Hitmeister.</li></ul>

isCustomerPrice

bool

Flag that indicates if the sales price is a customer price. Currently, this setting is not in use.

isDisplayedByDefault

bool

Flag that indicates if the sales price is displayed automatically in the Sales Prices area of the plentymarkets backend when a new item is created. When false, the sales price can still be added manually when a new item is created.

isLiveConversion

bool

Flag that indicates if the sales price is converted live in the online store. When true, the default currency price will be converted into the active currencies based on the conversion rates saved in plentymarkets.

interval

string

The interval of the price. Possible values are: daily, weekly, monthly, quarterly, semi-annual and annual.

createdAt

string

The time the sales price was created.

updatedAt

string

The time the sales price was last updated.

names

array

names

accounts

array

accounts

countries

array

countries

currencies

array

currencies

customerClasses

array

customerClasses

referrers

array

referrer

clients

array

clients

Methods
public toArray()

Returns this model as an array.

SalesPriceAccount

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

referrerId

int

The ID of the referrer linked to the sales price

accountId

int

The ID of the referrer account linked to the sales price

createdAt

string

The time the referrer account was linked to the sales price.

updatedAt

string

The time the link was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceCountry

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

countryId

int

The unique ID of the <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">country</a>

createdAt

string

The time the country was activated.

updatedAt

string

The time the relationship between country and sales price was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceCurrency

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

currency

string

The ISO code of the <a href="https://developers.plentymarkets.com/rest-doc/introduction#currencies" target="_blank">currency</a>; -1 = all currencies.

createdAt

string

The time the currency was activated.

updatedAt

string

The time the relationship between currency and sales price was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceCustomerClass

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

customerClassId

int

The unique ID of the customer class

createdAt

string

The time the customer class was activated.

updatedAt

string

The time the relationship between customer class and sales price was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceName

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

lang

string

The <a href='https://developers.plentymarkets.com/rest-doc/introduction#languages' target='_blank'>language code</a> of the sales price name

nameInternal

string

The internal name of the sales price. The internal name is used in the plentymarkets back end only.

nameExternal

string

The external name of the sales price. The external name is displayed in the online store and as such is visible for customers.

createdAt

string

The time the name was created.

updatedAt

string

The time the name was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceOnlineStore

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

plentyId

int

The unique ID of the client (store)

createdAt

string

The time the client (store) was activated.

updatedAt

string

The time the relationship between the client (store) and the sales price was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceReferrer

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

The unique ID of the sales price

referrerId

float

The unique ID of the referrer

createdAt

string

The time the referrer was activated.

updatedAt

string

The time the relationship between referrer and sales price was last updated.

Methods
public toArray()

Returns this model as an array.

SalesPriceSearchRequest

SalesPriceSearchRequest DataModel

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

variationId

int

type

string

plentyId

int

customerClassId

int

countryId

int

currency

string

accountId

int

accountType

string

referrerId

int

quantity

int

ignoreType

bool

vatId

int

customsTariffNumber

string

defaultPriceOnly

bool

itemQuantityList

array

Methods
public toArray()

Returns this model as an array.

SalesPriceSearchResponse

SalesPriceSearchResponse

Namespace

Plenty\Modules\Item\SalesPrice\Models

Properties
Name Type Description

salesPriceId

int

price

float

priceNet

float

basePrice

float

basePriceNet

float

unitPrice

float

unitPriceNet

float

lowestPrice

float

lowestPriceNet

float

customerClassDiscountPercent

float

customerClassDiscount

float

customerClassDiscountNet

float

categoryDiscountPercent

float

categoryDiscount

float

categoryDiscountNet

float

vatId

int

vatValue

float

currency

string

interval

string

conversionFactor

float

minimumOrderQuantity

float

updatedAt

string

type

string

pricePosition

int

Methods
public toArray()

Returns this model as an array.

Aggregations

AttributeValueListAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():string
public getSize():int
public getAggregation():array
public getPath():string
public process($data):array
Parameters

Name

Type

Description

$data

array

public toArray():array
public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

AttributeValueListAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():string
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

AvailabilityAggregation

aggregation for item availabilities

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():string
public getAggregation():array
public setInclude($string):void
Parameters

Name

Type

Description

$string

string

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

AvailabilityAggregationProcessor

aggregation processor for item availabilities

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():void
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

CardinalityAggregationBase

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getAggregation():array
public getField():string
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

CategoryAllTermsAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():void
public setSize($size = 10):void
Parameters

Name

Type

Description

$size

public getAggregation():array
public setInclude($string):void
Parameters

Name

Type

Description

$string

string

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

CategoryBranchTermsAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():void
public getAggregation():array
public setInclude($string):void
Parameters

Name

Type

Description

$string

string

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

CategoryProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

FacetAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():string
public getSize():int
public getAggregation():array
public getPath():string
public process($data):array
Parameters

Name

Type

Description

$data

array

public toArray():array
public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

FacetAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():string
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

FacetFacetTermsAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():void
public getAggregation():array
public setInclude($string):void
Parameters

Name

Type

Description

$string

string

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

FacetFacetValuesTermsAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():void
public getAggregation():array
public setInclude($string):void
Parameters

Name

Type

Description

$string

string

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

FacetFilterAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public setFacetId($facetId):void
Parameters

Name

Type

Description

$facetId

int

public getName():string
public getAggregation():array
public addFilter($filter):void
Parameters

Name

Type

Description

$filter

TypeInterface

public setIndex($index):void
Parameters

Name

Type

Description

$index

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

FacetTermsAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public setFacetId($facetId):void
Parameters

Name

Type

Description

$facetId

int

public getName():string
public getField():void
public getAggregation():array
public setInclude($string):void
Parameters

Name

Type

Description

$string

string

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

FeedbackAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():string
public getRanges():void
public getAggregation():void
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

FeedbackAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():string
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

ItemAttributeValueCardinalityAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getField():void
public getName():string
public getAggregation():array
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

ItemAttributeValueCardinalityAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):void
Parameters

Name

Type

Description

$data

public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

ItemCardinalityAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getField():void
public getName():string
public getAggregation():array
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

ItemCardinalityAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):void
Parameters

Name

Type

Description

$data

public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

OptimizedAttributeValueListAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():string
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

PriceFacetFilterAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public setFacetId($facetId):void
Parameters

Name

Type

Description

$facetId

int

public getName():string
public getAggregation():array
public addFilter($filter):void
Parameters

Name

Type

Description

$filter

TypeInterface

public setIndex($index):void
Parameters

Name

Type

Description

$index

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

PriceRangeAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getField():void
public getName():void
public getAggregation():void
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

PriceRangeAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():string
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

VariationAttributeValueListAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getName():string
public getField():string
public getSize():int
public getAggregation():array
public setSorting($sorting):void
Parameters

Name

Type

Description

$sorting

SortingInterface

public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

VariationAttributeValueListAggregationProcessor

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getName():string
public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

VariationCardinalityAggregation

To be written

Namespace

Plenty\Modules\Item\Search\Aggregations

Methods
public getField():void
public getName():string
public getAggregation():array
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public addAggregation($aggregation):void
Parameters

Name

Type

Description

$aggregation

AggregationInterface

public addSource($source):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$source

SourceInterface

public setPage($page, $rowsPerPage):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Aggregation\AggregationInterface
Return type: AggregationInterface
Parameters

Name

Type

Description

$page

int

$rowsPerPage

int

public getSources():void

Contracts

VariationElasticSearchAvailibilityRepositoryContract

VariationElasticSearchAvailibilityRepositoryContract

Namespace

Plenty\Modules\Item\Search\Contracts

Methods
public isReady():bool
public isAvailable():bool

VariationElasticSearchMultiSearchRepositoryContract

deprecated

Deprecated! (since 2023-09-01)

Please use Plenty\Modules\Pim\VariationDataInterface\Contracts\VariationDataInterfaceContract instead

Namespace

Plenty\Modules\Item\Search\Contracts

Methods
public setIndex($index):Plenty\Modules\Cloud\ElasticSearch\Contracts\ElasticSearchMultiSearchRepositoryContract
Return type: ElasticSearchMultiSearchRepositoryContract
Parameters

Name

Type

Description

$index

IndexInterface

public addSearch($search):Plenty\Modules\Cloud\ElasticSearch\Contracts\ElasticSearchMultiSearchRepositoryContract
Return type: ElasticSearchMultiSearchRepositoryContract
Parameters

Name

Type

Description

$search

public execute():array

VariationElasticSearchScrollRepositoryContract

deprecated

Deprecated! (since 2023-09-01)

Please use Plenty\Modules\Pim\VariationDataInterface\Contracts\VariationDataInterfaceContract instead

Namespace

Plenty\Modules\Item\Search\Contracts

Methods
public hasNext():bool
public setNumberOfDocumentsPerShard($size):void
Parameters

Name

Type

Description

$size

int

public clear():void
public setIndex($index):Plenty\Modules\Cloud\ElasticSearch\Contracts\ElasticSearchSearchRepositoryContract
Return type: ElasticSearchSearchRepositoryContract
Parameters

Name

Type

Description

$index

IndexInterface

public addSearch($search):Plenty\Modules\Cloud\ElasticSearch\Contracts\ElasticSearchSearchRepositoryContract
Return type: ElasticSearchSearchRepositoryContract
Parameters

Name

Type

Description

$search

public execute():array

VariationElasticSearchSearchRepositoryContract

deprecated

Deprecated! (since 2023-09-01)

Please use Plenty\Modules\Pim\VariationDataInterface\Contracts\VariationDataInterfaceContract instead

Namespace

Plenty\Modules\Item\Search\Contracts

Methods
public execute():array
public setIndex($index):Plenty\Modules\Cloud\ElasticSearch\Contracts\ElasticSearchSearchRepositoryContract
Return type: ElasticSearchSearchRepositoryContract
Parameters

Name

Type

Description

$index

IndexInterface

public addSearch($search):Plenty\Modules\Cloud\ElasticSearch\Contracts\ElasticSearchSearchRepositoryContract
Return type: ElasticSearchSearchRepositoryContract
Parameters

Name

Type

Description

$search

VariationElasticSearchSettingsRepositoryContract

Read and update search settings

Namespace

Plenty\Modules\Item\Search\Contracts

Methods
public getLanguages():Plenty\Modules\Item\Search\Models\LanguageSettings
Return type: LanguageSettings

Get language settings

public saveLanguages($data):Plenty\Modules\Item\Search\Models\LanguageSettings
Return type: LanguageSettings

Update language settings

Parameters

Name

Type

Description

$data

array

public getSearchSettings():Plenty\Modules\Item\Search\Models\SearchSettings
Return type: SearchSettings

Get search settings

public saveSearchSettings($data):Plenty\Modules\Item\Search\Models\SearchSettings
Return type: SearchSettings

Update search settings

Parameters

Name

Type

Description

$data

array

public getSuggestSettings():Plenty\Modules\Item\Search\Models\SuggestSettings
Return type: SuggestSettings
public saveSuggestSettings($data):Plenty\Modules\Item\Search\Models\SuggestSettings
Return type: SuggestSettings
Parameters

Name

Type

Description

$data

array

Filter

AmazonFilter

to be written

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getPimFilter():void
public hasAnyFlatFile($flatFiles):Plenty\Modules\Item\Search\Filter\AmazonFilter
Return type: AmazonFilter
Parameters

Name

Type

Description

$flatFiles

array

public hasAnyProductType($productTypes):Plenty\Modules\Item\Search\Filter\AmazonFilter
Return type: AmazonFilter
Parameters

Name

Type

Description

$productTypes

array

public hasAnyProductTypeId($productTypeIds):Plenty\Modules\Item\Search\Filter\AmazonFilter
Return type: AmazonFilter
Parameters

Name

Type

Description

$productTypeIds

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

AttributeFilter

Filters the index by specific attributes or attribute values

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasAttribute($attributeId):void
Parameters

Name

Type

Description

$attributeId

int

public hasAnyAttribute($attributeIds):void
Parameters

Name

Type

Description

$attributeIds

array

public hasAllAttributes($attributeIds):void
Parameters

Name

Type

Description

$attributeIds

array

public hasAttributeValue($attributeValueId):void
Parameters

Name

Type

Description

$attributeValueId

int

public hasAnyAttributeValue($attributeValueIds):void
Parameters

Name

Type

Description

$attributeValueIds

array

public hasAllAttributeValues($attributeValueIds):void
Parameters

Name

Type

Description

$attributeValueIds

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

BarcodeFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getPath():string
public hasCode($code, $precision):void
Parameters

Name

Type

Description

$code

$precision

string

public hasType($type):void
Parameters

Name

Type

Description

$type

string

public hasId($id):void
Parameters

Name

Type

Description

$id

int

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

CategoryFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public isInAtLeastOneCategory($categoryIds, $depth = self::DEPTH_ANY):void
Parameters

Name

Type

Description

$categoryIds

array

$depth

string

public static getPathByDepth($depth):string
Parameters

Name

Type

Description

$depth

string

public isInEachCategory($categoryIds, $depth = self::DEPTH_ANY):void
Parameters

Name

Type

Description

$categoryIds

array

$depth

string

public isInCategory($categoryId, $depth = self::DEPTH_ANY):void
Parameters

Name

Type

Description

$categoryId

int

$depth

string

public isInACategory():void
public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

ClientFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public isVisibleForClient($clientId):void
Parameters

Name

Type

Description

$clientId

int

public isVisibleForAtLeastOneClient($clientIds):void
Parameters

Name

Type

Description

$clientIds

array

public isVisibleForAllClients($clientIds):void
Parameters

Name

Type

Description

$clientIds

array

public hasAutomaticClientVisibility($values):void

-1, 0, 1, 2

Parameters

Name

Type

Description

$values

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

CrossSellingFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getPath():string
public hasRelation($relation):Plenty\Modules\Item\Search\Filter\CrossSellingFilter
Return type: CrossSellingFilter
Parameters

Name

Type

Description

$relation

string

public hasAnyRelation($relations):Plenty\Modules\Item\Search\Filter\CrossSellingFilter
Return type: CrossSellingFilter
Parameters

Name

Type

Description

$relations

array

public isDynamic():Plenty\Modules\Item\Search\Filter\CrossSellingFilter
Return type: CrossSellingFilter
public isManual():Plenty\Modules\Item\Search\Filter\CrossSellingFilter
Return type: CrossSellingFilter
public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

FacetFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasAtLeastOneFacet($facetIds):void
Parameters

Name

Type

Description

$facetIds

array

public hasEachFacet($facetIds):void
Parameters

Name

Type

Description

$facetIds

array

public hasFacet($facetIds):void
Parameters

Name

Type

Description

$facetIds

int

public hasAFacet():void
public hasAtLeastOneFacetValue($facetId, $valueIds):void
Parameters

Name

Type

Description

$facetId

int

$valueIds

array

public hasEachFacetValue($facetId, $valueIds):void
Parameters

Name

Type

Description

$facetId

int

$valueIds

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

FeedbackRangeFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasFeedbackGreaterThan($value):void
Parameters

Name

Type

Description

$value

int

public getType():string
public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

ImageFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getPath():void
public hasMarketId($marketId):void
Parameters

Name

Type

Description

$marketId

int

public setSection($section):void
Parameters

Name

Type

Description

$section

string

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

ItemFilter

to bew written

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasId($id):void
Parameters

Name

Type

Description

$id

int

public hasIds($ids):void
Parameters

Name

Type

Description

$ids

array

public hasAnImage():void
public hasFlag1($flagId):void
Parameters

Name

Type

Description

$flagId

int

public hasFlag2($flagId):void
Parameters

Name

Type

Description

$flagId

int

public hasManufacturer($manufacturerId):void
Parameters

Name

Type

Description

$manufacturerId

int

public hasManufacturers($manufacturerIds):void
Parameters

Name

Type

Description

$manufacturerIds

array

public hasAManufacturer():void
public isItemType($itemType):void
Parameters

Name

Type

Description

$itemType

string

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

MarketFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public isVisibleForMarket($marketId):void
Parameters

Name

Type

Description

$marketId

int

public isVisibleForAtLeastOneMarket($marketIds):void
Parameters

Name

Type

Description

$marketIds

array

public isVisibleForAllMarkets($marketIds):void
Parameters

Name

Type

Description

$marketIds

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

PriceFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public between($min = null, $max = null):void
Parameters

Name

Type

Description

$min

float

$max

float

public betweenByClient($min = null, $max = null, $clientId = null):void
Parameters

Name

Type

Description

$min

float

$max

float

$clientId

int

public toArray():array

DIRTY CHEAT FOR OLD IO TESTS

public getType():string
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

PropertyFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getPath():void
public hasAtLeastOneProperty($ids):Plenty\Modules\Item\Search\Filter\PropertyFilter
Return type: PropertyFilter
Parameters

Name

Type

Description

$ids

array

public hasEachProperty($ids):Plenty\Modules\Item\Search\Filter\PropertyFilter
Return type: PropertyFilter
Parameters

Name

Type

Description

$ids

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

SalesPriceFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasAtLeastOnePrice($priceIds):void
Parameters

Name

Type

Description

$priceIds

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

SearchFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public setNamesString($string, $lang):void
Parameters

Name

Type

Description

$string

string

$lang

string

public setSearchString($value, $lang, $precision = \Plenty\Modules\Cloud\ElasticSearch\Lib\ElasticSearch::SEARCH_TYPE_EXACT, $operator = \Plenty\Modules\Cloud\ElasticSearch\Lib\ElasticSearch::OR_OPERATOR):void
Parameters

Name

Type

Description

$value

string

$lang

string

$precision

string

$operator

string

public setVariationNumber($value):void
Parameters

Name

Type

Description

$value

string

public toArray():array
public setMinimumShouldMatch($minimumShouldMatch):void
Parameters

Name

Type

Description

$minimumShouldMatch

int

public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

SkuFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getPath():void
public hasMarketId($marketId):void
Parameters

Name

Type

Description

$marketId

float

public hasAccountId($accountId):void
Parameters

Name

Type

Description

$accountId

int

public hasStatus($status):void
Parameters

Name

Type

Description

$status

string

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

TagFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasTag($tagId):void
Parameters

Name

Type

Description

$tagId

int

public hasAnyTag($tagIds):void
Parameters

Name

Type

Description

$tagIds

array

public hasAllTags($tagIds):void
Parameters

Name

Type

Description

$tagIds

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

TextFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasAnyName():void
public hasNameInLanguage($lang = self::LANG_DE, $filter = self::FILTER_ANY_NAME):void
Parameters

Name

Type

Description

$lang

string

$filter

string

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

public static isLanguageSupported($lang):bool
Parameters

Name

Type

Description

$lang

string

public static isLanguageActivated($lang):bool
Parameters

Name

Type

Description

$lang

string

public static getM10lByLanguage($lang, $fallback = &quot;en&quot;):string
Parameters

Name

Type

Description

$lang

string

$fallback

string

public static getLanguageByM10l($lang, $fallback = &quot;english&quot;):string
Parameters

Name

Type

Description

$lang

string

$fallback

string

VariationAvailabilityUpdatedAtFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getTimestamp():void
public getType():string
public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

VariationBaseFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasNumber($number, $precision):void
Parameters

Name

Type

Description

$number

string

$precision

string

public isActive():void
public isInactive():void
public hasId($id):void
Parameters

Name

Type

Description

$id

int

public hasIds($ids):void
Parameters

Name

Type

Description

$ids

array

public hasItemId($itemId):void
Parameters

Name

Type

Description

$itemId

int

public hasItemIds($itemIds):void
Parameters

Name

Type

Description

$itemIds

array

public isMain():void
public isChild():void
public isSalable($bool = true):void
Parameters

Name

Type

Description

$bool

bool

public isSalableAndActive($bool = true):void
Parameters

Name

Type

Description

$bool

bool

public isHiddenInCategoryList($bool = true):void
Parameters

Name

Type

Description

$bool

public hasADescriptionInLanguage($language):void
Parameters

Name

Type

Description

$language

string

public hasAnImageOrItemHasAnImage():void
public hasAnImage():void
public hasManufacturer($manufacturerId):void
Parameters

Name

Type

Description

$manufacturerId

int

public hasSupplier($supplierId):void
Parameters

Name

Type

Description

$supplierId

int

public hasAtLeastOneAvailability($availabilities):void
Parameters

Name

Type

Description

$availabilities

array

public hasActiveChildren($bool = true):void
Parameters

Name

Type

Description

$bool

bool

public hasChildren($bool = true):void
Parameters

Name

Type

Description

$bool

bool

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

VariationBundleFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasBundleType($bundleType):void
Parameters

Name

Type

Description

$bundleType

string

public hasNoBundleType():void

use if value is "null"

public toArray():array
public setMinimumShouldMatch($minimumShouldMatch):void
Parameters

Name

Type

Description

$minimumShouldMatch

int

public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

VariationLastUpdatedFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public getTimestamp():void
public getType():string
public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

VariationPropertyFilter

foo

Namespace

Plenty\Modules\Item\Search\Filter

Methods
public hasPropertySelection($id):void
Parameters

Name

Type

Description

$id

int

public hasAtLeastOnePropertySelection($ids):void
Parameters

Name

Type

Description

$ids

array

public hasEachPropertySelection($ids):void
Parameters

Name

Type

Description

$ids

array

public toArray():array
public addStatement($statement):void
Parameters

Name

Type

Description

$statement

StatementInterface

public addQuery($statement):void
Parameters

Name

Type

Description

$statement

Helper

SearchHelper

To be written

Namespace

Plenty\Modules\Item\Search\Helper

Methods
public getFacetSearch():Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Document\DocumentSearch
Return type: DocumentSearch
public getFacetFilter():Plenty\Modules\Item\Search\Filter\FacetFilter
Return type: FacetFilter
public getSearchQuery($query):Plenty\Modules\Item\Search\Query\SearchQuery
Return type: SearchQuery
Parameters

Name

Type

Description

$query

string

Models

LanguageSettings

The language settings model

Namespace

Plenty\Modules\Item\Search\Models

Properties
Name Type Description

languages

array

Methods
public toArray()

Returns this model as an array.

SearchSettings

The search settings model

Namespace

Plenty\Modules\Item\Search\Models

Properties
Name Type Description

fields

array

Methods
public toArray()

Returns this model as an array.

SuggestSettings

The suggest settings model

Namespace

Plenty\Modules\Item\Search\Models

Properties
Name Type Description

fields

array

Methods
public toArray()

Returns this model as an array.

Mutators

BarcodeMutator

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public getPath():string
public mutateObject($data):array
Parameters

Name

Type

Description

$data

array

public addMarket($marketId):Plenty\Modules\Item\Search\Mutators\BarcodeMutator
Return type: BarcodeMutator
Parameters

Name

Type

Description

$marketId

int

public getDependencies():array
public mutate($data):array
Parameters

Name

Type

Description

$data

array

DefaultCategoryMutator

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public getPath():string
public mutateRow($data, $key):array
Parameters

Name

Type

Description

$data

array

$key

public setPlentyId($plentyId):Plenty\Modules\Item\Search\Mutators\DefaultCategoryMutator
Return type: DefaultCategoryMutator
Parameters

Name

Type

Description

$plentyId

int

public getDependencies():array
public mutate($data):array
Parameters

Name

Type

Description

$data

array

FacetMutator

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public mutate($data):array
Parameters

Name

Type

Description

$data

array

public static facetSort($a, $b):int
Parameters

Name

Type

Description

$a

array

$b

array

public getDependencies():array

ImageDomainMutator

Converts image domains to client specific image domains.

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public getPath():string
public mutateObject($data):array
Parameters

Name

Type

Description

$data

array

public setClient($plentyId):Plenty\Modules\Item\Search\Mutators\ImageDomainMutator
Return type: ImageDomainMutator
Parameters

Name

Type

Description

$plentyId

int

public mutate($data):array
Parameters

Name

Type

Description

$data

array

public getDependencies():array

ImageMutator

To be written…​

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public getPath():string
public setSorting($field):void
Parameters

Name

Type

Description

$field

string

public setSections($sections):void
Parameters

Name

Type

Description

$sections

public mutateObject($data):array
Parameters

Name

Type

Description

$data

array

public addMarket($marketId):Plenty\Modules\Item\Search\Mutators\ImageMutator
Return type: ImageMutator
Parameters

Name

Type

Description

$marketId

int

public addClient($plentyId):Plenty\Modules\Item\Search\Mutators\ImageMutator
Return type: ImageMutator
Parameters

Name

Type

Description

$plentyId

int

public addListing($listingId):Plenty\Modules\Item\Search\Mutators\ImageMutator
Return type: ImageMutator
Parameters

Name

Type

Description

$listingId

int

public getDependencies():array
public mutate($data):array
Parameters

Name

Type

Description

$data

array

KeyMutator

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public getKeyList():array
public setKeyList($keyList):void
Parameters

Name

Type

Description

$keyList

public getNestedKeyList():void
public setNestedKeyList($nestedKeyList):void
Parameters

Name

Type

Description

$nestedKeyList

public mutate($data):array
Parameters

Name

Type

Description

$data

array

public getDependencies():array

SkuMutator

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public getPath():string
public mutateObject($data):array
Parameters

Name

Type

Description

$data

array

public setMarket($marketId):Plenty\Modules\Item\Search\Mutators\SkuMutator
Return type: SkuMutator
Parameters

Name

Type

Description

$marketId

int

public setAccount($accountId):Plenty\Modules\Item\Search\Mutators\SkuMutator
Return type: SkuMutator
Parameters

Name

Type

Description

$accountId

int

public getDependencies():array
public mutate($data):array
Parameters

Name

Type

Description

$data

array

VariationPropertyGroupMutator

To be written…​

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public mutate($data):array
Parameters

Name

Type

Description

$data

array

public getDependencies():void

VariationPropertyMutator

To be written…​

Namespace

Plenty\Modules\Item\Search\Mutators

Methods
public mutate($data):array
Parameters

Name

Type

Description

$data

array

public getDependencies():void

Query

SearchQuery

foo

Namespace

Plenty\Modules\Item\Search\Query

Methods
public addBarcode($boost):void
Parameters

Name

Type

Description

$boost

int

public addNumericField($field, $boost):void
Parameters

Name

Type

Description

$field

string

$boost

int

public addMultilingualField($field, $language, $boost):void
Parameters

Name

Type

Description

$field

string

$language

string

$boost

int

public addField($field, $boost):void
Parameters

Name

Type

Description

$field

string

$boost

int

public toArray():array
public setType($type):void
Parameters

Name

Type

Description

$type

string

public setOperator($operator):Plenty\Modules\Cloud\ElasticSearch\Lib\Query\Type\Query\MultiMatchQuery
Return type: MultiMatchQuery
Parameters

Name

Type

Description

$operator

string

public setFuzzy($fuzzy):Plenty\Modules\Cloud\ElasticSearch\Lib\Query\Type\Query\MultiMatchQuery
Return type: MultiMatchQuery
Parameters

Name

Type

Description

$fuzzy

bool

public static isLanguageSupported($lang):bool
Parameters

Name

Type

Description

$lang

string

public static isLanguageActivated($lang):bool
Parameters

Name

Type

Description

$lang

string

public static getM10lByLanguage($lang, $fallback = &quot;en&quot;):string
Parameters

Name

Type

Description

$lang

string

$fallback

string

public static getLanguageByM10l($lang, $fallback = &quot;english&quot;):string
Parameters

Name

Type

Description

$lang

string

$fallback

string

Repositories

VariationElasticSearchAvailibilityRepository

VariationElasticSearchAvailibilityRepository

Namespace

Plenty\Modules\Item\Search\Repositories

Methods
public isReady():bool
public isAvailable():bool

Sort

NameSorting

To be written

Namespace

Plenty\Modules\Item\Search\Sort

Methods
public toArray():array
public static isLanguageSupported($lang):bool
Parameters

Name

Type

Description

$lang

string

public static isLanguageActivated($lang):bool
Parameters

Name

Type

Description

$lang

string

public static getM10lByLanguage($lang, $fallback = &quot;en&quot;):string
Parameters

Name

Type

Description

$lang

string

$fallback

string

public static getLanguageByM10l($lang, $fallback = &quot;english&quot;):string
Parameters

Name

Type

Description

$lang

string

$fallback

string

Suggestions

SearchSuggestion

foo

Namespace

Plenty\Modules\Item\Search\Suggestions

Methods
public setLanguage($language):Plenty\Modules\Item\Search\Suggestions\SearchSuggestion
Return type: SearchSuggestion
Parameters

Name

Type

Description

$language

string

public getName():void
public getField():void
public toArray():array
public process($data):array
Parameters

Name

Type

Description

$data

array

public setText($text):Plenty\Modules\Cloud\ElasticSearch\Lib\Search\Suggestion\BaseSuggestion
Return type: BaseSuggestion
Parameters

Name

Type

Description

$text

string

SearchSuggestionProcessor

to be written

Namespace

Plenty\Modules\Item\Search\Suggestions

Methods
public process($data):array
Parameters

Name

Type

Description

$data

array

public getDependencies():array
public addMutator($mutator):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$mutator

MutatorInterface

public addCondition($conditions):Plenty\Modules\Cloud\ElasticSearch\Lib\Processor\BaseProcessor
Return type: BaseProcessor
Parameters

Name

Type

Description

$conditions

ConditionInterface

Stock

Events

BasketItemWarnOversell

The event is triggered to warn about an overselling.

Namespace

Plenty\Modules\Item\Stock\Events

Methods
public getBasketItem():Plenty\Modules\Basket\Models\BasketItem
Return type: BasketItem
public getQuantity():int

Hooks

CheckItemStock

CheckItemStock

Namespace

Plenty\Modules\Item\Stock\Hooks

Methods
public handle($basketItemEvent):void
Parameters

Name

Type

Description

$basketItemEvent

BasketItemEvent

public getQuantityForItem($basketItem):void

Check the quantity of the same variation in other basket items.

Parameters

Name

Type

Description

$basketItem

BasketItem

The basket item to check

Unit

Contracts

UnitNameRepositoryContract

The contract for the unit name repository

Namespace

Plenty\Modules\Item\Unit\Contracts

Methods
public create($data, $unitId):Plenty\Modules\Item\Unit\Models\UnitName
Return type: UnitName

Creates a unit name. The ID of the unit must be specified.

Parameters

Name

Type

Description

$data

array

The unit name data as an associative array

$unitId

int

The ID of the unit

public delete($unitId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a unit name. The ID of the unit and the language must be specified.

Parameters

Name

Type

Description

$unitId

int

The ID of the unit

$lang

string

The lang of the unit name

public update($data, $unitId, $lang):Plenty\Modules\Item\Unit\Models\UnitName
Return type: UnitName

Updates a unit name. The ID of the unit and the language must be specified.

Parameters

Name

Type

Description

$data

array

The unit name data as an associative array

$unitId

int

The ID of the unit

$lang

string

The language of the unit name

public findOne($unitId, $lang):Plenty\Modules\Item\Unit\Models\UnitName
Return type: UnitName

Gets a unit name. The ID of the unit and the language must be specified.

Parameters

Name

Type

Description

$unitId

int

The ID of the unit

$lang

string

The language of the unit name

public findByUnitId($unitId):array

Lists unit names. The ID of the unit must be specified.

Parameters

Name

Type

Description

$unitId

int

The ID of the unit

UnitRepositoryContract

The contract for the unit repository

Namespace

Plenty\Modules\Item\Unit\Contracts

Methods
public create($data):Plenty\Modules\Item\Unit\Models\Unit
Return type: Unit

Creates a unit.

Parameters

Name

Type

Description

$data

array

The unit data as an associative array

public show($id):Plenty\Modules\Item\Unit\Models\Unit
Return type: Unit

Gets a unit. The ID of the unit must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the unit

public update($data, $id):Plenty\Modules\Item\Unit\Models\Unit
Return type: Unit

Updates a unit. The ID of the unit must be specified.

Parameters

Name

Type

Description

$data

array

The unit data as an associative array

$id

int

The ID of the unit

public delete($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a unit. The ID of the unit must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the unit

public findById($id):Plenty\Modules\Item\Unit\Models\Unit
Return type: Unit

Gets a unit. The ID of the unit must be specified.

Parameters

Name

Type

Description

$id

int

The ID of the unit

public all($columns = [], $perPage = 50, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all units.

Parameters

Name

Type

Description

$columns

array

An array of the shown columns. All columns are returned by default.

$perPage

int

The amount of units shown per page. Default value is 50.

$page

int

The shown page. Default value is 1.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

Unit

The unit model including the unit name

Namespace

Plenty\Modules\Item\Unit\Models

Properties
Name Type Description

id

int

The unique ID of the unit

position

int

The position of the unit

unitOfMeasurement

string

The International System of Units (ISO) <a href="https://developers.plentymarkets.com/rest-doc/introduction#units" target="_blank">code</a> of the unit

isDecimalPlacesAllowed

bool

Flag that indicates if decimal places are allowed for this unit of measurement. If false, only integer values are allowed for the unit.

updatedAt

string

The time the unit was last updated.

createdAt

string

The time the unit was created.

names

array

Methods
public toArray()

Returns this model as an array.

UnitName

The unit name model including the unit

Namespace

Plenty\Modules\Item\Unit\Models

Properties
Name Type Description

unitId

int

The unique ID of the unit

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language</a> of the unit name

name

string

The name of the unit

unit

Unit

Methods
public toArray()

Returns this model as an array.

UnitCombination

Contracts

UnitCombinationRepositoryContract

Interface for unit combination

Namespace

Plenty\Modules\Item\UnitCombination\Contracts

Methods
public all($itemsPerPage = 50, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Returns all unit combinations

Parameters

Name

Type

Description

$itemsPerPage

int

$page

int

public get($id):Plenty\Modules\Item\UnitCombination\Models\UnitCombination
Return type: UnitCombination

Returns the unit combination that matches the specified ID

Parameters

Name

Type

Description

$id

int

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

UnitCombination

The unitCombination model

Namespace

Plenty\Modules\Item\UnitCombination\Models

Properties
Name Type Description

id

int

The id of the unitCombination

unitId

int

The id of the unit

content

int

The content of the unit

unit

Unit

Methods
public toArray()

Returns this model as an array.

Variation

Contracts

VariationExportServiceContract

Enhances the loading speed.

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public addPreloadTypes($types):void
Parameters

Name

Type

Description

$types

array

public preload($values, $parameters = []):array
Parameters

Name

Type

Description

$values

array

$parameters

array

public getData($dataType, $variationId):void
Parameters

Name

Type

Description

$dataType

string

$variationId

int

public getAll($variationId):void
Parameters

Name

Type

Description

$variationId

int

public resetPreLoadedData():void

Resets the pre loaded data

public resetPreloadTypes():void

Resets the current pre load types

VariationImageServiceContract

Preload all variations linked to an image for several item IDs

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public preload($values):array
Parameters

Name

Type

Description

$values

array

public getData($itemId, $imageId = null):void
Parameters

Name

Type

Description

$itemId

int

$imageId

int

public resetPreLoadedData():void
public getAll():array

VariationInheritanceServiceContract

To be written…​

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public activate($variation, $type):void
Parameters

Name

Type

Description

$variation

Variation

$type

string

public deactivate($variation, $type):void
Parameters

Name

Type

Description

$variation

Variation

$type

string

VariationLookupRepositoryContract

lookup repository for variations

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public hasBarcode($code, $barcodeId = null):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$code

string

$barcodeId

int

public hasId($id):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$id

int

public hasItemId($itemId):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$itemId

int

public hasExternalId($externalId):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$externalId

string

public hasNumber($number):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$number

string

public hasSupplierItemNumber($supplierVariationNumber):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$supplierVariationNumber

string

public hasAttributeValueMap($attributeValueMap):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$attributeValueMap

array

public limit($limit):Plenty\Modules\Item\Variation\Contracts\VariationLookupRepositoryContract
Return type: VariationLookupRepositoryContract
Parameters

Name

Type

Description

$limit

int

public lookup():array

VariationMultiPackServiceContract

The contract for the variation bundle service

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public createMultiPackBundle($variationId, $componentId, $quantity):void
Parameters

Name

Type

Description

$variationId

int

$componentId

int

$quantity

int

public setMainVariationBundleItem($variationId):void
Parameters

Name

Type

Description

$variationId

int

public updateMultiPackBundle($variationId, $quantityId, $quantity):void
Parameters

Name

Type

Description

$variationId

int

$quantityId

int

$quantity

int

public getAttributeValueSetId($itemId):int
Parameters

Name

Type

Description

$itemId

int

public matchUnit($itemId):int
Parameters

Name

Type

Description

$itemId

int

public isMultiPack($itemId):bool
Parameters

Name

Type

Description

$itemId

int

VariationRepositoryContract

The contract for the variation repository

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public show($variationId, $with, $lang):Plenty\Modules\Item\Variation\Models\Variation
Return type: Variation

Gets a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$with

array

$lang

string

public showMultiple($ids, $with):array
Parameters

Name

Type

Description

$ids

array

$with

array

public create($data):Plenty\Modules\Item\Variation\Models\Variation
Return type: Variation

Creates a variation.

Parameters

Name

Type

Description

$data

array

The variation data as an associative array

public createPrimary($data):Plenty\Modules\Item\Variation\Models\Variation
Return type: Variation

Creates a primary variation.

Parameters

Name

Type

Description

$data

array

The variation data as an associative array

public delete($variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findById($variationId):Plenty\Modules\Item\Variation\Models\Variation
Return type: Variation

Get a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public update($data, $variationId):Plenty\Modules\Item\Variation\Models\Variation
Return type: Variation

Update a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$data

array

$variationId

int

public updateBulk($data):array

Updates up to 50 variations.

Parameters

Name

Type

Description

$data

array

public changePrimaryVariation($variationId):Plenty\Modules\Item\Variation\Models\Variation
Return type: Variation

Change main variation. Changes the variation with the specified variation ID to the new main variation.

Parameters

Name

Type

Description

$variationId

int

public patchBulk($rows):Illuminate\Support\Collection
Return type: Collection
Parameters

Name

Type

Description

$rows

array

VariationSearchRepositoryContract

A repository for comfortable searches for variations

Namespace

Plenty\Modules\Item\Variation\Contracts

Methods
public setSearchFilter($name, $params):void
Parameters

Name

Type

Description

$name

int

$params

array

public setSearchParam($name, $value):void
Parameters

Name

Type

Description

$name

string

$value

string

public setSearchParams($params):void
Parameters

Name

Type

Description

$params

array

Return type: PaginatedResult
public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Events

BeforeStatisticAccess

The event is triggered before a statics will be loaded

Namespace

Plenty\Modules\Item\Variation\Events

Methods
public isAccessAllowed():bool
public setAccessAllowed($accessAllowed):Plenty\Modules\Item\Variation\Events\BeforeStatisticAccess
Return type: BeforeStatisticAccess
Parameters

Name

Type

Description

$accessAllowed

bool

public getStatistic():string
public setStatistic($statistic):Plenty\Modules\Item\Variation\Events\BeforeStatisticAccess
Return type: BeforeStatisticAccess
Parameters

Name

Type

Description

$statistic

string

Exceptions

VariationException

Class VariationException

Namespace

Plenty\Modules\Item\Variation\Exceptions

Models

Variation

Variation

Namespace

Plenty\Modules\Item\Variation\Models

Properties
Name Type Description

id

int

The ID of the variation. The ID must be unique.

isMain

bool

Flag that indicates if the variation is the main variation of the item.

mainVariationId

int

The variation ID of the item’s main variation. Value is NULL if this variation is the item’s main variation.

itemId

int

The item ID of the item that this variation belongs to.

position

int

The position of the variation. Value is inherited from the item’s main variation if inheritance is active.

isActive

bool

Flag that indicates if the variation is active. Only active variations can be offered in the online store and/or on markets.

number

string

The unique variation number of the variation. The variation number must be specified.

model

string

The model of the variation. Value is inherited from the item’s main variation if inheritance is active.

externalId

string

The external variation ID of this variation. The external variation number is optional and allows importing items and variations from external systems to plentymarkets.

availability

int

The availability of the variation. Possible values: 1 to 10, null = Variation inherits value of main variation.

estimatedAvailableAt

string

The estimated delivery date of variations on reorder.

purchasePrice

float

The net purchase price. Value e.g. is used for price calculations.

movingAveragePrice

float

The moving average purchase price of the variation.

createdAt

string

The time the variation was created.

updatedAt

string

The time the variation was last updated.

relatedUpdatedAt

string

The time at which related information for this variation was last updated. Related information is defined as information that is linked to the variation, i.e. barcodes, categories, images, markets, clients (stores), prices, suppliers, warehouses and the default category.

availabilityUpdatedAt

string

The time at which the availability of this variation was last updated.

priceCalculationId

string

The ID of the price calculation linked to the variation. (deprecated)

priceCalculationUUID

string

The UUID of the price calculation linked to the variation.

picking

string

The order picking type of the variation. Possible values: single_picking, no_single_picking, exclude_from_picklist, null (no order picking type)

stockLimitation

int

The stock limitation for the variation. Possible values: <ul><li>0 = No limitation, i.e. stock is not limited. The variations’s availability is not checked automatically.</li><li>1 = Stock is limited to net stock. The variation’s availability is checked automatically.</li><li>2 = Do not administer stock for this variation.</li></ul>

isVisibleIfNetStockIsPositive

bool

Flag that indicates if the variation is visible in the online store if net stock is positive. If true, the variation automatically becomes visible when the net stock changes to positive.

isInvisibleIfNetStockIsNotPositive

bool

Flag that indicates if the variation is invisible in the online store if net stock is not positive. If true, the variation automatically becomes invisible when the net stock changes to 0 or negative.

isAvailableIfNetStockIsPositive

bool

Flag that indicates if the variation is available in the online store if net stock is positive. If true, the variation automatically becomes available when the net stock changes to positive.

isUnavailableIfNetStockIsNotPositive

bool

Flag that indicates if the variation is unavailable in the online store if net stock is not positive. If true, the variation automatically becomes available when the net stock changes to 0 or negative.

isVisibleInListIfNetStockIsPositive

bool

Flag that indicates if the variation is visible in the item list of the online store if net stock is positive. If true, the variation automatically becomes visible in categories, search results and item lists (store specials, cross-selling, last seen items) when the net stock changes to positive.

isInvisibleInListIfNetStockIsNotPositive

bool

Flag that indicates if the variation is invisible in the item list of the online store if net stock is not positive. If true and no net stock is available for the variation, the variation can only be opened using the direct URL. The variation is not shown in the categories, search results or item lists (store specials, cross-selling, last seen items).

mainWarehouseId

int

The ID of the main warehouse of the variation.

maximumOrderQuantity

float

The maximum order quantity permitted per order. Decimal values are possible to allow orders by weight or length. Default value is 0. If value is 0, the maximum order quantity is unlimited.

minimumOrderQuantity

float

The minimum order quantity. Decimal values are possible to allow orders by weight or length.

intervalOrderQuantity

float

The quantity intervals the variation can be ordered in. Decimal values are possible to allow orders by weight or length.

availableUntil

string

The last date the item will be available for sale.

releasedAt

string

The release date of the variation. This is the date on which the variation will become available. The variation can be visible in the online store before this date, e.g. for preorders.

name

string

The name of the variation

unitCombinationId

int

The unit combination id of the variation

weightG

int

The gross weight of the variation in gramms (g). This weight includes the packaging for variations that are packaged separately. This value is used for calculating shipping packages and weight-based shipping costs.

weightNetG

int

The net weight of the variation in gramms (g). This is the weight of the variation without packaging.

widthMM

int

The width of the variation in millimetres (mm)

lengthMM

int

The length of the variation in millimeters (mm)

heightMM

int

The height of the variation in millimetres (mm)

extraShippingCharge1

float

The extra shipping charge 1 for the variation. Extra shipping charges are useful for large or bulky items that are particularly expensive to ship. Charge 1 is added to the regular shipping costs for the first item of an order. If different variations are ordered, the extra shipping charge 1 of the variation with the highest charge 1 is selected.

extraShippingCharge2

float

The extra shipping charge 2 for the variation. Extra shipping charges are useful for large or bulky items that are expensive to ship. Charge 2 is added to the shipping costs for any additional items of an order.

unitsContained

int

The number of sales units contained in one package. Default value is 1.

palletTypeId

int

The ID of the pallet type

packingUnits

int

The number of packing units if the item consists of multiple packages. Value is 0 if an item is sent as one package. All items of an order that have the value 0 will be packed into one package.

packingUnitTypeId

int

The ID of the packing unit type.

transportationCosts

float

The net transportation costs for the variation. This value is used for price calculations and for calculating the acquisition price.

storageCosts

float

The net storage costs for the variation

customs

float

The customs rate in percent

operatingCosts

float

The operating costs for the variation in percent

vatId

int

The ID of the VAT rate of the variation. VAT rates are created for each client (store) and linked to the variation.

bundleType

string

Indicates the bundle type of the variation. Possible values:<ul><li>bundle = The variation is a bundle</li><li>bundle_item = The variation is a bundle component.</li><li>Null = The variation is not associated with a bundle</li></ul>

automaticClientVisibility

int

Indicates if the variation is set as available for any clients (stores). Possible values:<ul><li>0 / -1 (GET) or 0 (POST) = Variation is not available in any client (store).</li><li>1 / 2 (GET) or 1 (POST) = Variation is available in at least one client (store).</li></ul>The variation’s actual visibility depends on the settings for net stock dependency.

automaticListVisibility

int

Indicates if the variation currently is visible in item lists. 3 = Variation is visible in item list because $isHiddenInCategoryList is false. 2, 1 = Variation is visible in item list because $isVisibleInListIfNetStockIsPositive is true and net stock is positive. 0, -1 = Variation is invisible in item list because $isInvisibleInListIfNetStockIsNotPositive is true and net stock is 0 or negative. -2 = Variation is invisible in item list because $isHiddenInCategoryList is true.

isHiddenInCategoryList

bool

Flag that indicates if the variation is hidden in the category list. If true, the variation will not be shown in any item category and will not be returned as a search result. The variation can only be accessed via its URL.

defaultShippingCosts

float

The default shipping costs for the variation.

mayShowUnitPrice

bool

Display unit price in the online store

salesRank

int

The sales rank of the variation. This ranking is used to position top items automatically if the option <b>Automatically sort by monthly sales</b> (<b>Settings » Client (store) » Standard » Item layouts » Basic settings</b>) is set to <b>Yes</b>. The sales ranking is calculated daily. If the option <b>Automatically sort by monthly sales</b> is set to <b>No</b>, a value of 0 is returned and variations are sorted by position instead.

parentVariationId

int

parentVariationQuantity

float

singleItemCount

int

customsTariffNumber

string

The customs tariff number of the variation; usually a 11 digit code number based on the Harmonised System

campaignId

int

The id of the campaign for the variation

categoryVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Categories are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of categories is active.</li></ul>

marketVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Markets are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of markets is active.</li></ul>

clientVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Clients (stores) are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of clients (stores) is active.</li></ul>

salesPriceVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Sales prices are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of sales prices is active.</li></ul>

supplierVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Suppliers are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of suppliers is active.</li></ul>

warehouseVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Warehouses are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of warehouses is active.</li></ul>

propertyVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Properties are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of properties is active.</li></ul>

tagVariationId

int

Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.<ul><li>ID of the variation = Tags are not inherited from the main variation.</li><li>ID of the item’s main variation = Inheritance of tags is active.</li></ul>

hasCalculatedBundleWeight

bool

Indicates if the gross bundle weight is calculated by its components.

hasCalculatedBundleNetWeight

bool

Indicates if the net bundle weight is calculated by its components.

hasCalculatedBundlePurchasePrice

bool

Indicates if the net purchase price is calculated by its components.

hasCalculatedBundleMovingAveragePrice

bool

Indicates if the moving average net purchase price is calculated by its components.

variationBarcodes

array

An array of the barcodes of the variation.

variationBundleComponents

array

An array of the bundle components of the variation.

variationComponentBundles

array

An array of the bundles that this variation is a component of.

variationProperties

array

An array of the properties of the variation.

properties

array

An array of the properties of the variation.

propertiesV2

array

variationSalesPrices

array

An array of the sales prices of the variation.

marketItemNumbers

array

An array of the barcodes of the variation.

variationCategories

array

An array of the categories of the variation.

variationClients

array

An array of the clients (stores) of the variation.

variationMarkets

array

An array of the markets of the variation.

variationDefaultCategory

VariationDefaultCategory

An array of the default category of the variation.

variationSuppliers

array

An array of the suppliers of the variation.

itemTexts

array

An array of the texts of the variation.

variationTexts

array

An array of the texts of the variation.

variationWarehouses

array

An array of the warehouses of the variation.

tags

array

An array of the tags of the variation.

comments

array

An array of the comments of the variation.

images

array

An array of the images of the variation.

itemImages

array

An array of the images of the item linked to the variation.

itemCrossSelling

array

An array of the cross selling items of the item linked to the variation.

itemShippingProfiles

array

An array of the shipping profiles of the item linked to the variation.

variationAdditionalSkus

array

An array of additional SKUs of the variation.

variationSkus

array

An array of SKUs of the variation.

variationAttributeValues

array

An array of the attribute values of the variation.

unit

UnitCombination

The UnitCombination of the Variation. Object contains unitId and content.

parent

Variation

The details of the main variation of the variation if applicable.

item

Item

children

array

stockStorageLocations

array

An array of the stockStorageLocations of the variation.

Methods
public toArray()

Returns this model as an array.

Services

ExportPreloadValue

ExportPreloadValue

ExportPreloadValue

Namespace

Plenty\Modules\Item\Variation\Services\ExportPreloadValue

Properties
Name Type Description

itemId

int

variationId

int

Methods
public toArray()

Returns this model as an array.

VariationAdditionalSku

Contracts

VariationAdditionalSkuRepositoryContract

The contract of the variation additional sku repository

Namespace

Plenty\Modules\Item\VariationAdditionalSku\Contracts

Methods

Lists additional SKUs

Parameters

Name

Type

Description

$filter

array

public get($id):Plenty\Modules\Item\VariationAdditionalSku\Models\VariationAdditionalSku
Return type: VariationAdditionalSku

Gets an additional SKU

Parameters

Name

Type

Description

$id

int

The unique ID of the additional SKU

public create($data):Plenty\Modules\Item\VariationAdditionalSku\Models\VariationAdditionalSku
Return type: VariationAdditionalSku

Creates an additional SKU

Parameters

Name

Type

Description

$data

array

public update($id, $data):Plenty\Modules\Item\VariationAdditionalSku\Models\VariationAdditionalSku
Return type: VariationAdditionalSku

Updates an additional SKU

Parameters

Name

Type

Description

$id

int

The unique ID of the SKU

$data

array

public delete($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an additional SKU

Parameters

Name

Type

Description

$id

int

The unique ID of the additional SKU

Models

VariationAdditionalSku

The variation additional SKU model for order import

Namespace

Plenty\Modules\Item\VariationAdditionalSku\Models

Properties
Name Type Description

id

int

The ID of the additional sku

variationId

int

The ID of the variation.

marketId

float

The ID of the market reference.

marketAccountId

int

The ID of the market account.

sku

string

The additional sku for this variation.

createdAt

string

The time the SKU was created (YYYY-MM-DD HH:MM:SS).

updatedAt

string

The time the SKU was updated (YYYY-MM-DD HH:MM:SS).

Methods
public toArray()

Returns this model as an array.

VariationBarcode

Contracts

VariationBarcodeRepositoryContract

The contract of the variation barcode repository

Namespace

Plenty\Modules\Item\VariationBarcode\Contracts

Methods
public show($barcodeId, $variationId):Plenty\Modules\Item\VariationBarcode\Models\VariationBarcode
Return type: VariationBarcode

Gets a variation barcode. The ID of the variation and the ID of the barcode must be specified.

Parameters

Name

Type

Description

$barcodeId

int

The unique ID of the barcode

$variationId

int

The unique ID of the variation

public create($data):Plenty\Modules\Item\VariationBarcode\Models\VariationBarcode
Return type: VariationBarcode

Creates a variation barcode.

Parameters

Name

Type

Description

$data

array

The variation barcode data as an associative array

public update($data, $barcodeId, $variationId):Plenty\Modules\Item\VariationBarcode\Models\VariationBarcode
Return type: VariationBarcode

Updates a variation barcode. The ID of the variation and the ID of the barcode must be specified.

Parameters

Name

Type

Description

$data

array

The variation barcode data as an associative array

$barcodeId

int

The unique ID of the barcode

$variationId

int

The unique ID of the variation

public delete($barcodeId, $variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a variation barcode. The ID of the variation and the ID of the barcode must be specified.

Parameters

Name

Type

Description

$barcodeId

int

The unique ID of the barcode

$variationId

int

The unique ID of the variation

public findByVariationId($variationId):array

Lists all barcodes of a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

Models

VariationBarcode

Variation Barcode

Namespace

Plenty\Modules\Item\VariationBarcode\Models

Properties
Name Type Description

code

string

The code of the variation’s barcode. The combination of code and barcode ID must be unique.

barcodeId

int

The unique ID of the barcode linked to the variation. The combination of code and barcode ID must be unique.

variationId

int

The unique ID of the variation

createdAt

string

The time the variation’s code was created.

barcode

Barcode

The barcode of the variation’s barcode

Methods
public toArray()

Returns this model as an array.

VariationBundle

Contracts

InternalVariationBundleRepositoryContract

The contract for the variation bundle repository

Namespace

Plenty\Modules\Item\VariationBundle\Contracts

Methods
public show($bundleId):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Gets a variation bundle. The ID of the bundle must be specified.

Parameters

Name

Type

Description

$bundleId

int

The ID of the bundle

public create($data):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Creates a variation bundle.

Parameters

Name

Type

Description

$data

array

The variation bundle data as an associative array

public update($data, $bundleId):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Updates a variation bundle. The ID of the bundle must be specified.

Parameters

Name

Type

Description

$data

array

The variation bundle data as an associative array

$bundleId

int

The ID of the bundle

public delete($bundleId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a variation bundle component. The ID of the bundle must be specified.

Parameters

Name

Type

Description

$bundleId

int

The ID of the bundle

public findByVariationId($variationId):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Lists variation bundles. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findByComponentId($componentId):array

Lists variation bundles. The ID of the component variation must be specified.

Parameters

Name

Type

Description

$componentId

int

The ID of the component variation

VariationBundleRepositoryContract

The contract for the variation bundle repository

Namespace

Plenty\Modules\Item\VariationBundle\Contracts

Methods
public show($bundleId):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Gets a variation bundle. The ID of the bundle must be specified.

Parameters

Name

Type

Description

$bundleId

int

The ID of the bundle

public create($data):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Creates a variation bundle.

Parameters

Name

Type

Description

$data

array

The variation bundle data as an associative array

public update($data, $bundleId):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Updates a variation bundle. The ID of the bundle must be specified.

Parameters

Name

Type

Description

$data

array

The variation bundle data as an associative array

$bundleId

int

The ID of the bundle

public delete($bundleId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a variation bundle component. The ID of the bundle must be specified.

Parameters

Name

Type

Description

$bundleId

int

The ID of the bundle

public findByVariationId($variationId):Plenty\Modules\Item\VariationBundle\Models\VariationBundle
Return type: VariationBundle

Lists variation bundles. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findByComponentId($componentId):array

Lists variation bundles. The ID of the component variation must be specified.

Parameters

Name

Type

Description

$componentId

int

The ID of the component variation

Models

VariationBundle

The variation bundle

Namespace

Plenty\Modules\Item\VariationBundle\Models

Properties
Name Type Description

id

int

The unique ID of the link that marks a variation as a bundle component

variationId

int

The unique ID of the variation to which other variations are added to create a bundle

componentVariationId

int

The unique ID of the variation added as bundle component

componentQuantity

int

The quantity of the variation to be added as bundle component

lastUpdatedTimestamp

string

The time the bundle was last updated.

createdAt

string

The time the bundle was created.

Methods
public toArray()

Returns this model as an array.

VariationCategory

Contracts

VariationCategoryRepositoryContract

The contract for the variation category repository

Namespace

Plenty\Modules\Item\VariationCategory\Contracts

Methods
public show($variationId, $categoryId):Plenty\Modules\Item\VariationCategory\Models\VariationCategory
Return type: VariationCategory

Gets the link between a category and a variation.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$categoryId

int

The ID of the category

public create($data):Plenty\Modules\Item\VariationCategory\Models\VariationCategory
Return type: VariationCategory

Creates a link between a category and a variation.

Parameters

Name

Type

Description

$data

array

The variation category data as an associative array

public update($data, $variationId, $categoryId):Plenty\Modules\Item\VariationCategory\Models\VariationCategory
Return type: VariationCategory

Updates a link between a category and a variation.

Parameters

Name

Type

Description

$data

array

The variation category data as an associative array

$variationId

int

The ID of the variation

$categoryId

int

The ID of the category

public delete($variationId, $categoryId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the link between a category and a variation.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$categoryId

int

The ID of the category

public findByVariationId($variationId):Plenty\Modules\Item\VariationCategory\Models\VariationCategory
Return type: VariationCategory

Lists the categories linked to a variation.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findByVariationIdWithInheritance($variationId):Plenty\Modules\Item\VariationCategory\Models\VariationCategory
Return type: VariationCategory

Lists the categories linked to a variation including inheritance information.

Parameters

Name

Type

Description

$variationId

int

public updateBulk($data):Illuminate\Support\Collection
Return type: Collection

Updates up to 50 links between variations and categories.

Parameters

Name

Type

Description

$data

array

The array containing the data.

public createBulk($data):Illuminate\Support\Collection
Return type: Collection

Creates up to 50 links between variations and categories.

Parameters

Name

Type

Description

$data

array

The array containing the data.

Models

VariationCategory

Variation Category

Namespace

Plenty\Modules\Item\VariationCategory\Models

Properties
Name Type Description

variationId

int

The unique ID of the variation

categoryId

int

The unique ID of the category

position

int

The position of the category

isNeckermannPrimary

string

Flag that indicates if the category is the primary category for the market Neckermann for this variation.

Methods
public toArray()

Returns this model as an array.

VariationClient

Contracts

VariationClientRepositoryContract

The contract of the variation client repository

Namespace

Plenty\Modules\Item\VariationClient\Contracts

Methods
public findOne($plentyId, $variationId):Plenty\Modules\Item\VariationClient\Models\VariationClient
Return type: VariationClient

Gets a client (store) linked to a variation.

Parameters

Name

Type

Description

$plentyId

int

The unique ID of the client (store)

$variationId

int

The unique ID of the variation

public create($data):Plenty\Modules\Item\VariationClient\Models\VariationClient
Return type: VariationClient

Creates a link between a variation and a client (store).

Parameters

Name

Type

Description

$data

array

The variation client data as an associative array

public delete($plentyId, $variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the link between a variation and a client (store).

Parameters

Name

Type

Description

$plentyId

int

The unique ID of the client (store)

$variationId

int

The unique ID of the variation

public findByVariationId($variationId):Plenty\Modules\Item\VariationClient\Models\VariationClient
Return type: VariationClient

Lists the clients (stores) linked to a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public findByVariationIdWithInheritance($variationId):Plenty\Modules\Item\VariationClient\Models\VariationClient
Return type: VariationClient

Lists the clients (stores) linked to a variation including inheritance information.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

Models

VariationClient

Variation Client

Namespace

Plenty\Modules\Item\VariationClient\Models

Properties
Name Type Description

variationId

int

The unique ID of the variation

plentyId

int

The unique ID of the client (store)

createdAt

string

The time at which the client (store) was linked to the variation.

Methods
public toArray()

Returns this model as an array.

VariationDefaultCategory

Contracts

VariationDefaultCategoryRepositoryContract

The contract of the variation default category repository

Namespace

Plenty\Modules\Item\VariationDefaultCategory\Contracts

Methods
public show($plentyId, $variationId):Plenty\Modules\Item\VariationDefaultCategory\Models\VariationDefaultCategory
Return type: VariationDefaultCategory

Gets the default category of a variation for the client (store) specified. The ID of the variation and the plenty ID of the client (store) must be specified.

Parameters

Name

Type

Description

$plentyId

int

The unique plenty ID of the client (store)

$variationId

int

The unique ID of the variation

public create($data):Plenty\Modules\Item\VariationDefaultCategory\Models\VariationDefaultCategory
Return type: VariationDefaultCategory

Creates a link between a variation and a category that designates the category as the default category for this client (store).

Parameters

Name

Type

Description

$data

array

The variation default category data as an associative array

public update($data, $plentyId, $variationId):Plenty\Modules\Item\VariationDefaultCategory\Models\VariationDefaultCategory
Return type: VariationDefaultCategory

Updates the default category linked to a variation. The ID of the variation and the plenty ID of the client (store) must be specified.

Parameters

Name

Type

Description

$data

array

The variation default category data as an associative array

$plentyId

int

The unique plenty ID of the client (store)

$variationId

int

The unique ID of the variation

public delete($plentyId, $variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the link between a variation and a default category. The ID of the variation and the plenty ID of the client (store) must be specified.

Parameters

Name

Type

Description

$plentyId

int

The unique plenty ID of the client (store)

$variationId

int

The unique ID of the variation

public findByVariationId($variationId):Plenty\Modules\Item\VariationDefaultCategory\Models\VariationDefaultCategory
Return type: VariationDefaultCategory

Lists the default categories of a variation for all clients (stores). The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

Models

VariationDefaultCategory

Variation Default Category

Namespace

Plenty\Modules\Item\VariationDefaultCategory\Models

Properties
Name Type Description

variationId

int

The unique ID of the variation

branchId

int

The unique ID of the category branch

plentyId

int

The unique plenty ID of the client (store)

manually

string

Methods
public toArray()

Returns this model as an array.

VariationDescription

Contracts

VariationDescriptionRepositoryContract

The contract of the variation description repository

Namespace

Plenty\Modules\Item\VariationDescription\Contracts

Methods
public create($data):Plenty\Modules\Item\VariationDescription\Models\VariationDescription
Return type: VariationDescription

Creates texts

Parameters

Name

Type

Description

$data

array

The variation description data as an associative array

public update($data, $variationId, $lang):Plenty\Modules\Item\VariationDescription\Models\VariationDescription
Return type: VariationDescription

Updates texts

Parameters

Name

Type

Description

$data

array

The variation description data as an associative array

$variationId

int

The unique ID of the variation

$lang

string

The unique code of the language

public delete($variationId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes texts

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$lang

string

The unique code of the language

public find($variationId, $lang):Plenty\Modules\Item\VariationDescription\Models\VariationDescription
Return type: VariationDescription

Gets texts

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$lang

string

The unique code of the language

public findById($id):Plenty\Modules\Item\VariationDescription\Models\VariationDescription
Return type: VariationDescription

Get texts

Parameters

Name

Type

Description

$id

int

The unique ID of the item texts

public findByVariationId($variationId):array

List texts

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

Models

VariationDescription

Variation Default Category

Namespace

Plenty\Modules\Item\VariationDescription\Models

Properties
Name Type Description

id

int

The unique ID of the description

itemId

int

The unique ID of the item that this description belongs to

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">language code</a> of the description

name

string

The default name of the item. By default, this name is displayed in the online store. For Default items, this name is also used for markets. Character limit: max. 240 characters.

title

string

The html title for webshop of the item. By default, this title is displayed in the online store html. Character limit: max. 240 characters.

name2

string

Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters.

name3

string

Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters.

previewDescription

string

The preview text. The preview text is a short description that can be displayed in item lists.

metaDescription

string

The meta description of the item. This description is analysed by search engines and displayed in search results. This text should be treated as an advertising text to maximise click-through from search engine result pages. Current recommended limit is 156 characters.

description

string

The item description. This is a detailed description displayed in the item layout of the online store.

technicalData

string

The technical data for the item. To display the technical data in the online store, insert the template variable TechnicalData and an optional title into the template ItemViewSingleItem.

urlPath

string

The URL path of the item in the online store. By default, the URL path consists of the categories and the item name. The path will be assigned automatically by plentymarkets when the item is created and will be displayed as part of the URL when the item is selected in the online store.

metaKeywords

string

Meta keywords to tag the item for search engines. More than one keyword can be separated by commas.

Methods
public toArray()

Returns this model as an array.

VariationImage

Contracts

VariationImageRepositoryContract

The contract of the variation image repository

Namespace

Plenty\Modules\Item\VariationImage\Contracts

Methods
public create($data):Plenty\Modules\Item\VariationImage\Models\VariationImage
Return type: VariationImage

Creates link between image and variation

Parameters

Name

Type

Description

$data

array

The variation image data as an associative array

public delete($variationId, $imageId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes Link between image and variation

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$imageId

int

The unique ID of the image

public findByImageId($imageId):array

Lists variations linked to an image

Parameters

Name

Type

Description

$imageId

int

The unique ID of the image

public findByVariationId($variationId):array

Lists images linked to a variation

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public findByItemId($itemId):array

Lists all images linked to an item. The ID of the item must be specified.

Parameters

Name

Type

Description

$itemId

int

The unique ID of the image

public findById($id):Plenty\Modules\Item\VariationImage\Models\VariationImage
Return type: VariationImage

Gets an image link

Parameters

Name

Type

Description

$id

int

The unique ID of the image link

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

VariationImage

Namespace

Plenty\Modules\Item\VariationImage\Models

Properties
Name Type Description

id

int

The unique ID of the link between a variation and an image

itemId

int

The unique ID of the item

variationId

int

The unique ID of the variation

imageId

int

The unique ID of the image

createdAt

string

The time the image was linked to the variation.

updatedAt

string

The time the link between an image and a variation was last updated.

Methods
public toArray()

Returns this model as an array.

VariationMarket

Contracts

VariationMarketRepositoryContract

The contract of the variation market repository

Namespace

Plenty\Modules\Item\VariationMarket\Contracts

Methods
public findOne($variationId, $marketplaceId):Plenty\Modules\Item\VariationMarket\Models\VariationMarket
Return type: VariationMarket

Gets the data of a market linked to a variation. The ID of the market and the ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$marketplaceId

float

The unique ID of the market

public create($data):Plenty\Modules\Item\VariationMarket\Models\VariationMarket
Return type: VariationMarket

Creates a link between a market and a variation and adds market data.

Parameters

Name

Type

Description

$data

array

The variation market data as an associative array

public delete($marketplaceId, $variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the link between a market and a variation. The ID of the market and the ID of the variation must be specified.

Parameters

Name

Type

Description

$marketplaceId

int

The unique ID of the market

$variationId

float

The unique ID of the variation

public findByVariationId($variationId):Plenty\Modules\Item\VariationMarket\Models\VariationMarket
Return type: VariationMarket

Lists the markets linked to a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public findByVariationIdWithInheritance($variationId):Plenty\Modules\Item\VariationMarket\Models\VariationMarket
Return type: VariationMarket

Lists the markets linked to a variation with inheritance details. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public getVariationMarkets($itemsPerPage = 50, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Lists all links between variations and markets.

Parameters

Name

Type

Description

$itemsPerPage

int

$page

int

public createBulk($data):void

Creates up to 50 links between variations and markets.

Parameters

Name

Type

Description

$data

array

public deleteBulk($itemId, $variationId):void

Deletes all market links of the variation specified.

Parameters

Name

Type

Description

$itemId

int

$variationId

int

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

Models

VariationMarket

Variation Market

Namespace

Plenty\Modules\Item\VariationMarket\Models

Properties
Name Type Description

variationId

int

The unique ID of the variation

marketId

int

The unique ID of the market

createdAt

string

The time the link between the variation and the market was created.

Methods
public toArray()

Returns this model as an array.

VariationMarketIdentNumber

Contracts

VariationMarketIdentNumberRepositoryContract

The contract of the variation market ident number repository

Namespace

Plenty\Modules\Item\VariationMarketIdentNumber\Contracts

Methods
public show($variationMarketIdentNumberId):Plenty\Modules\Item\VariationMarketIdentNumber\Models\VariationMarketIdentNumber
Return type: VariationMarketIdentNumber

Gets a market ident number (ASIN/ePID) of a variation. The ID of the market ident number must be specified.

Parameters

Name

Type

Description

$variationMarketIdentNumberId

int

The unique ID of the market ident number

public create($data):Plenty\Modules\Item\VariationMarketIdentNumber\Models\VariationMarketIdentNumber
Return type: VariationMarketIdentNumber

Creates a new market ident number (ASIN/ePID) for a variation.

Parameters

Name

Type

Description

$data

array

The variation market ident number data as an associative array

public update($data, $variationMarketIdentNumberId):Plenty\Modules\Item\VariationMarketIdentNumber\Models\VariationMarketIdentNumber
Return type: VariationMarketIdentNumber

Updates a market ident number (ASIN/ePID) of a variation. The ID of the market ident number must be specified.

Parameters

Name

Type

Description

$data

array

The variation market ident number data as an associative array

$variationMarketIdentNumberId

int

The unique ID of the market ident number

public delete($variationMarketIdentNumberId, $variationId = null):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a market ident number (ASIN/ePID) of a variation. The ID of the market ident number must be specified.

Parameters

Name

Type

Description

$variationMarketIdentNumberId

int

The unique ID of the market ident number

$variationId

int

The unique ID of the variation which belongs to the market ident number ID

public findByVariationId($variationId):array

Lists the market ident numbers (ASIN/ePID) of a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

Models

VariationMarketIdentNumber

Variation Market Ident Number

Namespace

Plenty\Modules\Item\VariationMarketIdentNumber\Models

Properties
Name Type Description

id

int

The unique ID of the market ident number (ASIN/ePID) of a variation

variationId

int

The unique ID of the variation

countryId

int

The country code of the market ident number (ASIN/ePID)

type

string

The type of market ident number (ASIN/ePID)

position

int

The position of the market ident number (ASIN/ePID)

value

string

The value of the market ident number (ASIN/ePID)

Methods
public toArray()

Returns this model as an array.

VariationProperty

Contracts

VariationPropertyValueRepositoryContract

The contract of the variation property value repository

Namespace

Plenty\Modules\Item\VariationProperty\Contracts

Methods
public create($data):Plenty\Modules\Item\VariationProperty\Models\VariationPropertyValue
Return type: VariationPropertyValue

Creates a link between a property value and a variation and adds property value data.

Parameters

Name

Type

Description

$data

array

The variation property value data as an associative array

public show($variationId, $id):Plenty\Modules\Item\VariationProperty\Models\VariationPropertyValue
Return type: VariationPropertyValue

Gets the data of a property value linked to a variation. The ID of the variation property value and the variation ID must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$id

int

The unique ID of the link between a variation and a property value

public update($data, $variationId, $id):Plenty\Modules\Item\VariationProperty\Models\VariationPropertyValue
Return type: VariationPropertyValue

Updates the data of a variation property linked to a variation. The ID of the variation property value and the variation ID must be specified.

Parameters

Name

Type

Description

$data

array

The variation property value data as an associative array

$variationId

int

The ID of the Variation

$id

int

The unique ID of the link between a property value and a variation

public delete($variationId, $id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the link between a property value and a variation. The ID of the variation property value and the variation ID must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$id

int

The unique ID of the link between a variation and a property value

public deleteAll($variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes all links between a variation and its property values. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findByVariationId($variationId):array

Lists the property values linked to a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public createBulk($data):Illuminate\Support\Collection
Return type: Collection

Creates a list of variation properties.

Parameters

Name

Type

Description

$data

array

The array containing the data.

public updateBulk($data):Illuminate\Support\Collection
Return type: Collection

Updates a list of variation properties.

Parameters

Name

Type

Description

$data

array

The array containing the data.

VariationPropertyValueTextRepositoryContract

The contract of the variation property value text repository

Namespace

Plenty\Modules\Item\VariationProperty\Contracts

Methods
public create($data):Plenty\Modules\Item\VariationProperty\Models\VariationPropertyValueText
Return type: VariationPropertyValueText

Saves text for a specific property of the type Text in the specified language. The ID of the property value and the language must be specified.

Parameters

Name

Type

Description

$data

array

public update($valueId, $lang, $data):Plenty\Modules\Item\VariationProperty\Models\VariationPropertyValueText
Return type: VariationPropertyValueText

Updates the text saved for a specific property of the type Text in the specified language. The ID of the property value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

$lang

string

$data

array

public delete($valueId, $lang):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the text saved for a specific property of the type Text in the specified language. The ID of the property value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

$lang

string

public show($valueId, $lang):Plenty\Modules\Item\VariationProperty\Models\VariationPropertyValueText
Return type: VariationPropertyValueText

Gets the text saved for a specific property of the type Text in the specified language. The ID of the property value and the language must be specified.

Parameters

Name

Type

Description

$valueId

int

$lang

string

public findByPropertyValue($valueId):void

Gets the texts saved for a specific property of the type Text in all available languages. The ID of the property value must be specified.

Parameters

Name

Type

Description

$valueId

int

Models

VariationPropertyValue

The variation property value model. Represents a link between characteristic and item.

Namespace

Plenty\Modules\Item\VariationProperty\Models

Properties
Name Type Description

id

int

The unique ID of the link between the variation and the property value

variationId

int

The unique ID of the variation

propertyId

int

The unique ID of the property

propertySelectionId

int

The unique ID of the property selection of the variation

valueInt

int

The int value of the property value of the variation

valueFloat

float

The float value of the property value of the variation

valueFile

string

The file value of the property value of the variation

surcharge

float

The surcharge of the property value of the variation

names

array

Collection of the variationPropertyValueNames names that belong to this variationPropertyValue

property

Property

propertySelection

PropertySelection

valueTexts

array

Methods
public toArray()

Returns this model as an array.

VariationPropertyValueName

The property name of the variation

Namespace

Plenty\Modules\Item\VariationProperty\Models

Properties
Name Type Description

propertyValueId

int

The unique ID of the link between the variation and the property

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#countries" target="_blank">language</a> of the property value name.

value

string

The value of the property value name in the specified language

Methods
public toArray()

Returns this model as an array.

VariationPropertyValueText

The variation property value text model. Includes language specific information for a variation property value.

Namespace

Plenty\Modules\Item\VariationProperty\Models

Properties
Name Type Description

valueId

int

The unique ID of the link between the variation and the property

lang

string

The <a href="https://developers.plentymarkets.com/rest-doc/introduction#languages" target="_blank">language</a> of the property value text

value

string

The text saved for the property of the type Text

characteristic

VariationPropertyValue

Methods
public toArray()

Returns this model as an array.

VariationSalesPrice

Contracts

VariationSalesPriceRepositoryContract

The contract of the variation sales price repository

Namespace

Plenty\Modules\Item\VariationSalesPrice\Contracts

Methods
public show($salesPriceId, $variationId):Plenty\Modules\Item\VariationSalesPrice\Models\VariationSalesPrice
Return type: VariationSalesPrice

Gets the price data of a sales price linked to a variation. The ID of the sales price and the ID of the variation must be specified.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$variationId

int

The unique ID of the variation

public create($data):Plenty\Modules\Item\VariationSalesPrice\Models\VariationSalesPrice
Return type: VariationSalesPrice

Creates a link between a sales price and a variation and adds sales price data.

Parameters

Name

Type

Description

$data

array

The variation sales price data as an associative array

public update($data, $salesPriceId, $variationId):Plenty\Modules\Item\VariationSalesPrice\Models\VariationSalesPrice
Return type: VariationSalesPrice

Updates the data of a sales price linked to a variation.

Parameters

Name

Type

Description

$data

array

The variation sales price data as an associative array

$salesPriceId

int

The unique ID of the sales price

$variationId

int

The unique ID of the variation

public delete($salesPriceId, $variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a link between a sales price and a variation and deletes the sales price data. The ID of the sales price and the ID of the variation must be specified. An exception is thrown if at least one relation exists.

Parameters

Name

Type

Description

$salesPriceId

int

The unique ID of the sales price

$variationId

int

The unique ID of the variation

public deleteAll($variationId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes all links between a variation and its sales prices and deletes the sales price data. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

public findByVariationId($variationId):Plenty\Modules\Item\VariationSalesPrice\Models\VariationSalesPrice
Return type: VariationSalesPrice

Lists the data of the sales prices linked to a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public findByVariationIdWithInheritance($variationId):Plenty\Modules\Item\VariationSalesPrice\Models\VariationSalesPrice
Return type: VariationSalesPrice

Lists the data of the sales prices linked to a variation with inheritance details. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public updateBulk($data):Illuminate\Support\Collection
Return type: Collection

Updates a list of variation prices. The variation ID, sales price ID and a new price must be specified.

Parameters

Name

Type

Description

$data

array

The array containing the data.

public createBulk($data):Illuminate\Support\Collection
Return type: Collection

Creates a list of variation prices. The variation ID, sales price ID and a new price must be specified.

Parameters

Name

Type

Description

$data

array

The array containing the data.

public findAll($itemsPerPage = 100, $page = 1):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Gets all sales price relations.

Parameters

Name

Type

Description

$itemsPerPage

int

$page

int

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

Models

VariationSalesPrice

VariationSalesPrice

Namespace

Plenty\Modules\Item\VariationSalesPrice\Models

Properties
Name Type Description

variationId

int

The unique ID of the variation

salesPriceId

int

The unique ID of the sales price

price

float

The price of the variation saved for this sales price

lowestPrice

float

The lowest price of the variation saved for this sales price

lowestPriceCalculation

bool

Is the lowest price calculation active for this sales price

updatedAt

string

The time the sales price was last updated.

createdAt

string

The time the sales price was created.

Methods
public toArray()

Returns this model as an array.

VariationSku

Contracts

VariationSkuBulkRepositoryContract

The contract of the variation SKU bulk repository.

Namespace

Plenty\Modules\Item\VariationSku\Contracts

Methods
public create($data):void

Creates multiple SKUs.

Parameters

Name

Type

Description

$data

array

public updateStatus($ids, $status):void

Updates status for multiple SKUs.

Parameters

Name

Type

Description

$ids

array

$status

string

public updateExportedAt($ids, $time = &quot;&quot;):void

Updates exportedAt for multiple SKUs.

Parameters

Name

Type

Description

$ids

array

$time

string

public updateStockUpdatedAt($ids, $time = &quot;&quot;):void

Updates stockUpdatedAt for multiple SKUs.

Parameters

Name

Type

Description

$ids

array

$time

string

public updateDeletedAt($ids, $time = null):void

Updates deletedAt for multiple SKUs.

Parameters

Name

Type

Description

$ids

array

$time

string

public delete($data):int

Deletes multiple SKUs.

Parameters

Name

Type

Description

$data

array

VariationSkuRepositoryContract

The contract of the variation sku repository

Namespace

Plenty\Modules\Item\VariationSku\Contracts

Methods
public generateSkuWithParent($variation, $marketId, $accountId, $sku = null, $parentSku = null, $setLastExportedTimestamp = true, $returnObject = false):void

Generates or updates an SKU and parent SKU

Parameters

Name

Type

Description

$variation

array

The array of values from the variation

$marketId

float

The unique ID of the market

$accountId

int

The unique ID of the account

$sku

string

$parentSku

string

$setLastExportedTimestamp

bool

$returnObject

bool

public generateSku($variationId, $marketId, $accountId, $sku = null, $setLastExportedTimestamp = true, $returnObject = false):void

Generates or updates an SKU

Parameters

Name

Type

Description

$variationId

int

The unique ID of the SKU

$marketId

float

The unique ID of the market

$accountId

int

The unique ID of the account

$sku

string

$setLastExportedTimestamp

bool

$returnObject

bool

public create($data):Plenty\Modules\Item\VariationSku\Models\VariationSku
Return type: VariationSku

Creates an SKU

Parameters

Name

Type

Description

$data

array

public update($data, $skuId):Plenty\Modules\Item\VariationSku\Models\VariationSku
Return type: VariationSku

Updates an SKU

Parameters

Name

Type

Description

$data

array

$skuId

int

The unique ID of the SKU

public delete($skuId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes an SKU

Parameters

Name

Type

Description

$skuId

int

The unique ID of the SKU

public show($skuId):Plenty\Modules\Item\VariationSku\Models\VariationSku
Return type: VariationSku

Gets an SKU

Parameters

Name

Type

Description

$skuId

int

The unique ID of the SKU

Lists SKUs

Parameters

Name

Type

Description

$filter

array

$limit

int

limits the result to the specified amound

$page

int

defines at which entity the result should start depending on the provided limit

public findByVariationId($variationId):array

Lists SKUs

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public clearCriteria():void

Resets all Criteria filters by creating a new instance of the builder object.

public applyCriteriaFromFilters():void

Applies criteria classes to the current repository.

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

VariationSku

The variation SKU model

Namespace

Plenty\Modules\Item\VariationSku\Models

Properties
Name Type Description

id

int

The row ID of the table plenty_item_variation_market_status

variationId

int

The ID of the variation

marketId

float

The ID of the market

accountId

int

The ID of the market account

initialSku

string

The initial SKU of the variation. The initial SKU cannot be modified even if the variation SKU is changed. However, it is possible to reset the variation SKU to the initial SKU.

sku

string

The SKU of the variation. The SKU is adjustable but may not exist twice for the combination of market Id and account Id.

parentSku

string

The Parent SKU of the variation. The Parent SKU is adjustable. The same Parent SKU value should be used on variations of same article.

isActive

bool

Flag that indicates if the item is ready for export (currently not in use).

createdAt

string

The time the SKU was created (YYYY-MM-DD HH:MM:SS).

updatedAt

string

The time the SKU was updated (YYYY-MM-DD HH:MM:SS).

exportedAt

string

The time the variation was last exported (YYYY-MM-DD HH:MM:SS).

stockUpdatedAt

string

deletedAt

string

The time the variation was deleted (YYYY-MM-DD HH:MM:SS).

status

string

The status of the variation after the export. Possible entries are INACTIVE, ERROR, SENT and ACTIVE.

additionalInformation

string

The field that contains additional information.

Methods
public toArray()

Returns this model as an array.

VariationStock

Contracts

VariationStockRepositoryContract

The contract of the variation stock repository

Namespace

Plenty\Modules\Item\VariationStock\Contracts

Methods
public listStockByWarehouse($variationId, $columns = [], $page = 1, $itemsPerPage = 200):array

List stock per warehouse

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$columns

array

The properties to be loaded

$page

int

The requested page

$itemsPerPage

int

The number of items per page

public listStockMovements($variationId, $columns, $page, $itemsPerPage):array

List stock movements for a variation

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$columns

array

The properties to be loaded

$page

int

The requested page

$itemsPerPage

int

The number of items per page

public bookIncomingItems($variationId, $data):array

Book incoming stock

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$data

array

The request data

public bookOutgoingItems($variationId, $data):array

Book outgoing stock

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$data

array

The request data

public correctStock($variationId, $data, $calcStockLater = false, $finishReceiptLater = false, $deactivateAutoTransaction = false):array

Correct stock

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$data

array

The request data

$calcStockLater

bool

$finishReceiptLater

bool

$deactivateAutoTransaction

bool

public redistributeStock($variationId, $data):Plenty\Repositories\Models\PaginatedResult
Return type: PaginatedResult

Redistribute stock

Parameters

Name

Type

Description

$variationId

int

The ID of the variation

$data

array

The request data

public finishReceipt():void

Finish receipt

public setFilters($filters = []):void

Sets the filter array.

Parameters

Name

Type

Description

$filters

array

public getFilters():void

Returns the filter array.

public getConditions():void

Returns a collection of parsed filters as Condition object

public clearFilters():void

Clears the filter array.

Models

VariationStock

The variation stock model

Namespace

Plenty\Modules\Item\VariationStock\Models

Properties
Name Type Description

itemId

int

The ID of the item

variationId

int

The ID of the variation

warehouseId

int

The ID of the warehouse

reservedListing

float

The quantity of a variation that is reserved for listings

reservedBundles

float

The quantity of a variation that is reserved for item bundles

valueOfGoods

float

The value of goods based on the physical stock

purchasePrice

float

The purchase price of the variation stock

physicalStock

float

The physical stock of the variation stock

reservedStock

float

The reserved stock of the variation stock

netStock

float

The net stock is the stock that can still be sold

reorderLevel

float

The quantity of a variation that triggers a reorder

deltaReorderLevel

float

The quantity of a variation that is required to reach the reorder level

Methods
public toArray()

Returns this model as an array.

VariationStockMovement

The variation stock movement model

Namespace

Plenty\Modules\Item\VariationStock\Models

Properties
Name Type Description

id

int

The ID of the stock movement

itemId

int

The ID of the item

variationId

int

The ID of the variation

warehouseId

int

The ID of the warehouse

reasonString

string

The reason string

attributeValues

string

The attribute values of a variation

processRowId

int

The ID is either the actual ID of an order or of an incoming item data set. Whether it is an order ID or an incoming item data set ID depends on the processRowType.

quantity

int

The quantity

reason

int

The reason for the movement

createdAt

string

The date and time that the movement was created. This date is in W3C format.

processRowType

int

The type of the stock movement <ul> <li>1 = incoming item data set</li> <li>2 = order</li> <li>3 = deleted stock movement</li> <li>4 = new stock intake</li> </ul>

bestBeforeDate

string

The best before date for the movement

batch

string

The batch for the movement

storageLocationName

string

The name of the storage location

warehouseName

string

The name of the warehouse

purchasePrice

int

The purchase price of a variation

userId

int

The id of the user. Can be null if the movement was not triggered by an user.

Methods
public toArray()

Returns this model as an array.

VariationSupplier

Contracts

VariationSupplierRepositoryContract

The contract for the variation supplier repository

Namespace

Plenty\Modules\Item\VariationSupplier\Contracts

Methods
public show($id):Plenty\Modules\Item\VariationSupplier\Models\VariationSupplier
Return type: VariationSupplier

Gets the data of a supplier linked to a variation. The variation supplier ID must be specified.

Parameters

Name

Type

Description

$id

int

The unique ID of the link between variation and supplier

public create($data):Plenty\Modules\Item\VariationSupplier\Models\VariationSupplier
Return type: VariationSupplier

Creates a link between a supplier and a variation and adds supplier data.

Parameters

Name

Type

Description

$data

array

The variation supplier data as an associative array

public update($data, $id):Plenty\Modules\Item\VariationSupplier\Models\VariationSupplier
Return type: VariationSupplier

Updates the data of a supplier linked to a variation. The variation supplier ID must be specified.

Parameters

Name

Type

Description

$data

array

The variation supplier data as an associative array

$id

int

The unique ID of the link between variation and supplier

public delete($id):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes a link between a supplier and a variation. The variation supplier ID must be specified.

Parameters

Name

Type

Description

$id

int

The unique ID of the link between variation and supplier

public findByVariationId($variationId):array

Lists the data of the suppliers linked to a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public findByVariationIdWithInheritance($variationId):array

Lists the data of the suppliers linked to a variation with inheritance details. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

Models

VariationSupplier

Variation Supplier

Namespace

Plenty\Modules\Item\VariationSupplier\Models

Properties
Name Type Description

id

int

The unique ID of the link between variation and supplier

variationId

int

The unique ID of the variation

supplierId

int

The unique ID of the supplier

purchasePrice

float

The price at which the variation was purchased from this supplier.

minimumPurchase

int

The minimum quantity of the variation that has to be ordered from the supplier. This value is also used as a quantity suggestion when creating reorders.

itemNumber

string

The external item number assigned to the variation by this supplier

lastPriceQuery

string

The date of the last price query to this supplier. This helps to plan price negotiations.

deliveryTimeInDays

int

The delivery time in days for the variation saved for this supplier

discount

float

The discount in percent the supplier grants for the variation.

isDiscountable

string

Flag that indicates if the supplier’s discount for this variation is active.

packagingUnit

float

The packaging unit of the supplier if it differs from the packaging unit settings in plentymarkets.

lastUpdateTimestamp

string

The time the supplier data was last updated

createdAt

string

The time the supplier data was created

currencyPurchasePrice

float

The purchase price in the currency of the supplier

itemDescription

string

The supplier item description

Methods
public toArray()

Returns this model as an array.

VariationWarehouse

Contracts

VariationWarehouseRepositoryContract

The contract for the variation warehouse repository

Namespace

Plenty\Modules\Item\VariationWarehouse\Contracts

Methods
public show($variationId, $warehouseId):Plenty\Modules\Item\VariationWarehouse\Models\VariationWarehouse
Return type: VariationWarehouse

Gets the data of a warehouse linked to a variation. The ID of the variation and the ID of the warehouse must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$warehouseId

int

The unique ID of the warehouse

public create($data):Plenty\Modules\Item\VariationWarehouse\Models\VariationWarehouse
Return type: VariationWarehouse

Creates a link between a warehouse and a variation and adds warehouse data.

Parameters

Name

Type

Description

$data

array

The variation warehouse data as an associative array

public update($data, $variationId, $warehouseId):Plenty\Modules\Item\VariationWarehouse\Models\VariationWarehouse
Return type: VariationWarehouse

Updates the data of a warehouse linked to a variation. The ID of the variation and the ID of the warehouse must be specified.

Parameters

Name

Type

Description

$data

array

The variation warehouse data as an associative array

$variationId

int

The unique ID of the variation

$warehouseId

int

The unique ID of the warehouse

public delete($variationId, $warehouseId):Plenty\Repositories\Models\DeleteResponse
Return type: DeleteResponse

Deletes the link between a warehouse and a variation. The ID of the variation and the ID of the warehouse must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$warehouseId

int

The unique ID of the warehouse

public findByVariationId($variationId):array

Lists all warehouse data of a variation. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

public findByVariationIdWithInheritance($variationId, $with = [], $warehouseId = null, $storageLocationId = null):array

Lists all warehouse data of a variation with inheritance details. The ID of the variation must be specified.

Parameters

Name

Type

Description

$variationId

int

The unique ID of the variation

$with

array

$warehouseId

int

$storageLocationId

int

Models

VariationWarehouse

Variation Warehouse

Namespace

Plenty\Modules\Item\VariationWarehouse\Models

Properties
Name Type Description

variationId

int

The unique ID of the variation

warehouseId

int

The unique ID of the warehouse

warehouseZoneId

int

The unique ID of the warehouse zone

storageLocationType

string

The storage location type of the warehouse

reorderLevel

int

The reorder level for the variation in this warehouse

maximumStock

int

The maximum stock for the variation in this warehouse

stockTurnoverInDays

int

The stock turnover in days for the variation in this warehouse

storageLocation

int

The storage location of the variation in this warehouse

stockBuffer

int

The stock buffer for the variation in this warehouse

isBatch

bool

Is for warehouse and variation stock batch active

isBestBeforeDate

bool

Is for warehouse and variation stock best before date active

lastUpdateTimestamp

string

The time the warehouse data was last updated.

createdAt

string

The time the warehouse data was created.

Methods
public toArray()

Returns this model as an array.