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.