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.