Description

API call is used to update existing supplier relationships for items. This call only performs UPDATE operations. To create new supplier relationships, use pixiCreateItemSupplier.

Request Parameters

#	Name	Type	Required	Example	Description
1	ItemKey	integer	0	1301	Filter: pixi item ID. At least one of ItemKey, EAN or ItemNrInt must be provided.
2	ItemNrInt	string	0	10001	Filter: Shop item number. At least one of ItemKey, EAN or ItemNrInt must be provided.
3	EAN	string	0	3000330010101	Filter: Current barcode (EANUPC). Used to identify a specific AddItem record when multiple EAN codes exist for the same item/supplier. At least one of ItemKey, EAN or ItemNrInt must be provided.
4	NewEAN	string	0	4006381333931	Value: New barcode to set on the AddItem record (EANUPC). If not provided, the existing EANUPC value is preserved.
5	SupplNr	string	1	mark	MANDATORY - Supplier number code. Must exist in the Suppliers table.
6	SupplPrice	number	0	12.99	Value: New supplier price. If not provided, existing SupplPrice is preserved.
7	ItemNrSuppl	string	0	SUPPL-001	Value: New supplier item number. If not provided, existing ItemNrSuppl is preserved.
8	PreferredSupplier	boolean	0	1	Switch: When set to 1, all other supplier items for the same item are reset to PreferredSupplier=0 before updating. If not provided, existing value is preserved.
9	MinOrderQty	integer	0	10	Value: New minimum order quantity. If not provided, existing MinOrderQty is preserved.
10	OnlyPU	boolean	0	1	Value: New flag indicating order only by package units (OrderOnlyPackageUnits). If not provided, existing value is preserved.
11	ItemDeliveryTime	integer	0	5	Value: New supplier delivery time in days (SupplDeliveryTime). If not provided, existing value is preserved.
12	IsActive	boolean	0	1	Switch: Mark supplier item as active (1) or inactive (0). If not provided, existing Active value is preserved.

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:pixiUpdateItemSupplier>
         <dem:ItemKey>1301</dem:ItemKey>
         <dem:ItemNrInt>10001</dem:ItemNrInt>
         <dem:EAN>3000330010101</dem:EAN>
         <dem:NewEAN>4006381333931</dem:NewEAN>
         <dem:SupplNr>mark</dem:SupplNr>
         <dem:SupplPrice>12.99</dem:SupplPrice>
         <dem:ItemNrSuppl>SUPPL-001</dem:ItemNrSuppl>
         <dem:PreferredSupplier>1</dem:PreferredSupplier>
         <dem:MinOrderQty>10</dem:MinOrderQty>
         <dem:OnlyPU>1</dem:OnlyPU>
         <dem:ItemDeliveryTime>5</dem:ItemDeliveryTime>
         <dem:IsActive>1</dem:IsActive>
      </dem:pixiUpdateItemSupplier>
   </soapenv:Body>
</soapenv:Envelope>

Response

Body 1: Return message from the update operation

#	Name	Type	Description
1	Status	string	Status of the return message. Possible values: Error, Record updated.
2	Message	string	Detail description of the return message.

Additional Notes

This call only performs UPDATE operations. To create a new supplier relationship, use pixiCreateItemSupplier.

Only provided parameters will be updated. NULL (omitted) parameters preserve the existing values — except UpdateDate, which is always set to the current date and time.

At least one update parameter must be supplied: SupplPrice, NewEAN, ItemNrSuppl, PreferredSupplier, MinOrderQty, OnlyPU, ItemDeliveryTime, or IsActive.

Use EAN as an additional filter when multiple EAN codes exist for the same item/supplier combination, to target the correct item supplier record.

When PreferredSupplier=1, all other supplier records for the item are reset to PreferredSupplier=0 before the update is applied.