Description
This API endpoint updates item purchasing and inventory management information through XML data submission. It processes structured XML containing buying parameters such as stock quantities, supplier codes, and ordering thresholds. The endpoint supports bulk updates for multiple items and locations, making it ideal for inventory management systems. Essential for maintaining accurate stock levels, supplier relationships, and automated reordering processes.
Request Parameters
# |
Name |
Type |
Required |
Example |
Description |
1 |
BuyingXML |
string |
0 |
See Additional Information |
XML with tags for items. |
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:pixiSetItemBuyingInfoXML>
<dem:BuyingXML>See Additional Information</dem:BuyingXML>
</dem:pixiSetItemBuyingInfoXML>
</soapenv:Body>
</soapenv:Envelope>Response
Body 1: Return values
# |
Name |
Type |
Description |
1 |
ItemKey |
integer |
pixi* item ID |
2 |
ItemNrInt |
string |
Shop item number |
3 |
EAN |
string |
Item barcode |
4 |
MinStockQty |
string |
Minimum stock quantity for the item |
5 |
MinOrderQty |
string |
Minimum order quantity for the item |
6 |
SupplierCode |
string |
Supplier code to identify the item supplier |
7 |
TargetStock |
string |
Item target stock quantity |
8 |
SafetyStock |
string |
Item safety stock quantity |
9 |
PackingUnit |
string |
Packing unit for item |
Additional Notes
**Sample XML structure:**
<BuyingInfo>
<Item>
<ItemKey></ItemKey>
<MinStockQty></MinStockQty>
<MinOrderQty></MinOrderQty>
<Location></Location>
<OrderUnit></OrderUnit>
<VPE></VPE>
<SupplierCode></SupplierCode>
<TargetStock></TargetStock>
<SafetyStock></SafetyStock>
</Item>
</BuyingInfo>
**XML node information:**
**ItemKey**
- Item ID
**MinStockQty**
- Reorder level quantity per location
- If **Location** is not provided the value is set for all locations
**MinOrderQty**
- Value will only be set when also **SupplierCode** value is provided
**Location**
- Location ID *(sample:"001")*
**OrderUnit** and **VPE**
- Set the Packing unit for item
- Keep in mind that **VPE** is only supported because of backwards compatibility.
- **OrderUnit** should be used instead
- In case both values are provided **OrderUnit** will be used and written to the database
**SupplierCode**
- Supplier code to identify the item supplier *(sample: "MGS")*
**TargetStock**
- can not be negative value
- negative value of target stock will be set to 0
**SafetyStock**
- Item safety stock
Implementation Guidelines
Batch Processing: Process multiple items in a single XML payload to improve efficiency and maintain data consistency.
Validation: Always validate XML structure before submission to prevent partial updates and data corruption.
Location Handling: When Location is not specified, changes apply to all locations - use with caution in multi-location environments.
Business Logic Considerations
Stock Management: TargetStock and SafetyStock work together to optimize inventory levels and prevent stockouts.
Supplier Integration: SupplierCode linkage enables automated procurement and vendor management processes.
Reorder Automation: MinStockQty and MinOrderQty establish automated reordering thresholds for efficient inventory management.
Error Prevention
Negative Values: System automatically converts negative TargetStock to zero - validate input data to ensure intended behavior.
Dependency Requirements: MinOrderQty requires SupplierCode - ensure both values are provided together.
Unit Compatibility: When both OrderUnit and VPE are provided, OrderUnit takes precedence - use OrderUnit for new implementations.