pixi Developer & Integration Documentation

pixiSetItemBuyingInfo

Description

Updates purchasing parameters for an item: minimum stock quantity, minimum order quantity, target stock, and safety stock. Identify the item using ItemKey, ItemNrInt, or EANUPC.

This call returns no response data. Errors are logged internally.

When Location is not provided, MinStockQty and MinOrderQty are updated globally on the item and on all location-specific records. TargetStock and SafetyStock only apply to location-specific records — provide a Location to set them.

See also: pixiSetItemBuyingInfoXML for updating multiple items in a single call.


Request Parameters

#

Name

Type

Required

Example

Description

1

ItemKey

int

0

365

Item ID. At least one identification parameter must be provided. A value of 0 is treated as not provided.

2

ItemNrInt

varchar(50)

0

54e46dd1dc2c30a39.01766786

Item shop number. At least one identification parameter must be provided.

3

EANUPC

varchar(13)

0

2000000000091

Item barcode (EAN/UPC). At least one identification parameter must be provided.

4

Location

varchar(3)

0

001

Location ID. When provided, updates the location-specific record for this location only. When omitted, updates the global item record and all location-specific records.

5

MinStockQty

varchar(10)

0

10

Minimum stock quantity for the item. Leave empty to keep the current value.

6

MinOrderQty

varchar(10)

0

5

Minimum order quantity for the item. Leave empty to keep the current value.

7

TargetStock

varchar(10)

0

50

Target stock quantity for the specified location. Requires Location to be set. Negative values are automatically set to 0. Leave empty to keep the current value.

8

SafetyStock

varchar(10)

0

5

Safety stock quantity for the specified location. Requires Location to be set. Leave empty to keep the current value.


Request body

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dem="https://api.pixi.eu/soap/demosandbox/">
<soapenv:Header/>
<soapenv:Body>
<dem:pipiSetItemBuyingInfo>
<dem:ItemKey>365</dem:ItemKey>
<dem:ItemNrInt></dem:ItemNrInt>
<dem:EANUPC></dem:EANUPC>
<dem:Location>001</dem:Location>
<dem:MinStockQty>10</dem:MinStockQty>
<dem:MinOrderQty>5</dem:MinOrderQty>
<dem:TargetStock>50</dem:TargetStock>
<dem:SafetyStock>5</dem:SafetyStock>
</dem:pipiSetItemBuyingInfo>
</soapenv:Body>
</soapenv:Envelope>


Response

This call returns no data. A successful call produces no response body. Errors are logged internally and the transaction is rolled back.


Additional Notes

Only the fields provided (non-empty) are updated. Omitting a field leaves the existing value unchanged.

Location behaviour:
No Location — updates MinStockQty and MinOrderQty globally on the item and on all location-specific records
With Location — updates only the location-specific record for that location; TargetStock and SafetyStock are only applied here

TargetStock and SafetyStock are location-specific fields and have no effect unless Location is provided.