pixi Developer & Integration Documentation

pixiSetItemSupplier

Warning: API call is no longer maintained!

Description

API call is used to modify item data connected to supplier.
Use pixiCreateItemSupplier and pixiUpdateItemSupplier instead


Request Parameters

#

Name

Type

Required

Example

Description

1

ItemKey

integer

0

123

Filter: pixi* item ID

2

ItemNrInt

string

0

Sample text

Filter: Shop item number

3

SupplNr

string

1

Sample text

Filter: Supplier number code

4

SupplPrice

number

0

19.90

Value: Supplier price for the item (when the value is not provided, the default item supplier price will be used in case of adding a new barcode)

5

EAN

string

0

Sample text

Filter: Item barcode.

6

ItemNrSuppl

string

0

Sample text

Filter: Item number supplier

7

AddEAN

boolean

0

0/1

Switch: In case parameter is set to 1, parameter EAN will be used to add a new barcode to the item.

8

PreferredSupplier

string

0

1

Switch: In case parameter is set to 1, preferred supplier will be set for selected record.

9

MinOrderQty

integer

0

123

Set value: MinOrderQty

10

OnlyPU

boolean

0

0/1

Set value: OrderOnlyPackageUnits

11

ItemDeliveryTime

integer

0

123

Set value: SupplDeliveryTime


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:pixiSetItemSupplier>
         <dem:ItemKey>123</dem:ItemKey>
         <dem:ItemNrInt>Sample text</dem:ItemNrInt>
         <dem:SupplNr>Sample text</dem:SupplNr>
         <dem:SupplPrice>19.90</dem:SupplPrice>
         <dem:EAN>Sample text</dem:EAN>
         <dem:ItemNrSuppl>Sample text</dem:ItemNrSuppl>
         <dem:AddEAN>0/1</dem:AddEAN>
         <dem:PreferredSupplier>1</dem:PreferredSupplier>
         <dem:MinOrderQty>123</dem:MinOrderQty>
         <dem:OnlyPU>0/1</dem:OnlyPU>
         <dem:ItemDeliveryTime>123</dem:ItemDeliveryTime>
      </dem:pixiSetItemSupplier>
   </soapenv:Body>
</soapenv:Envelope>


Response


Body 1: Return messages from the modification.

#

Name

Type

Description

1

Status

string

Status of the return message. (Error, New record inserted, Record updated, Warning)

2

Message

string

Detail description of the return message.


Additional Notes

With this API call, it is possible to update the EAN, ItemNrSuppl and/or SupplPrice of a specific item for a supplier.
Alternatively, it is also possible to add an additional EAN to the item, using the @AddEAN parameter. For updating an EAN of an item with multiple EANs assigned to a supplier, the ItemNrSuppl must be uniquely identifiable. Additionally, it is possible to add the same supplier multiple times with at least a different EAN.
Tip: Use pixiDeleteItemSupplier with the same parameters that were used at its creation if you want to delete accidentally created suppliers.

Important: Besides the SupplNr, all other filter criteria create a selection using OR logic, thus extending rather than narrowing it.