pixi Developer & Integration Documentation

pixiUpdateSOrderline

Description

This API call updates an supplier orderline, by the given supplier orderline ID. The orderline ID can be received by the API call pixiGetSOrderlines.


Request Parameters

# Name Type Required Example Description
1 SorderlineKey integer 1 123 Supplier orderline ID
2 UserName string 1 abcdefg Username which will be displayed in the update history
3 OrderQty integer 0 123 Changes the ordered quantity (Only if supplier order is on statuses (NEW, BES)
4 Note string 0 abcdefg Adds a note to the given supplier orderline
5 QtyReceived integer 0 123 Obsolete - received quantity can only be set with delivery document
6 QtyNotDelivered integer 0 123 Writes the quantity which was not delivered to the supplier orderline (Only updated when supplier order is on status CON, @SupplierPrice is NULL and @OrderQty IS NULL or 0)
7 EstimatedDelivery string 0 YYYY-MM-DD hh:mm:ss Sets the estimated delivery date for this supplier orderline
8 SupplPrice number 0 9.99 Updates the supplier price for this item in this supplier orderline. The item supplier price itself is not changed for the item, only in this supplier order document. (Only if supplier order is on statuses (NEW, BES)

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:pixiUpdateSOrderline>
         <dem:SorderlineKey>123</dem:SorderlineKey>
         <dem:UserName>abcdefg</dem:UserName>
         <dem:OrderQty>123</dem:OrderQty>
         <dem:Note>abcdefg</dem:Note>
         <dem:QtyReceived>123</dem:QtyReceived>
         <dem:QtyNotDelivered>123</dem:QtyNotDelivered>
         <dem:EstimatedDelivery>YYYY-MM-DD hh:mm:ss</dem:EstimatedDelivery>
         <dem:SupplPrice>9.99</dem:SupplPrice>
      </dem:pixiUpdateSOrderline>
   </soapenv:Body>
</soapenv:Envelope>

Response


Body 2: Status output

# Name Type Description
1 ReturnCode string Execution status (OK/ERROR)
2 Message string Description of the status

Additional Notes

**General info**

The API call is simulating the updating of supplier orderlines like in pixi* web buying.  

There are certain limitations when updating the lines depending on the status of the supplier order.

When order is in status **NEW** or **BES** it is possible to update:

 - **OrderQty**
 - **SupplPrice**
 
In status **CON** the QtyNotDelivered can be set.

**EstimatedDelivery** and **Note** parameters have no status restrictions.


----------



**Important**

The parameter **QtyReceived** is no longer in use. The only way to set the received quantity is using the corresponding delivery for the supplier order.

When setting up a new  OrderQty or SupplPrice the discounts set on the lines will be automatically applied when calculating the orderline total.
Note that modifying OrderQty or SupplPrice is not possible when order is has status confirmed or closed (CON, CLS).
Based on the line totals also the header values will get refreshed. 


----------


Currently the automatic calculation of block prices and bonuses set per supplier are not considered when using the API call and need to be manually checked in pixi* web buying.