Description
Returns a list of orders that can be merged with a specified order. An order is considered mergable when it shares the same customer, payment type, currency, and order type as the source order, has all order lines in status ANG (acknowledged/ordered), and is not reserved on any active picklist. Cash orders (payment type K) are excluded from merge candidates.
Use this call before initiating an order merge to retrieve valid candidates for the specified order.
Request Parameters
# |
Name |
Type |
Required |
Example |
Description |
1 |
OrderNr |
int |
1 |
123456 |
The pixi order number of the source order to find merge candidates for. |
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:pipiGetMergableOrders>
<dem:OrderNr>123456</dem:OrderNr>
</dem:pipiGetMergableOrders>
</soapenv:Body>
</soapenv:Envelope>Response
Body 1: Result set
# |
Name |
Type |
Description |
1 |
OrderNr |
int |
pixi order number of the mergable order. |
2 |
CreateDate |
datetime |
Date and time the mergable order was created. |
3 |
OrderNrExternal |
varchar(50) |
External order number reference for the mergable order. |
Additional Notes
An order qualifies as a merge candidate when all of the following conditions are met:
- Same customer as the source order
- Same payment type as the source order (cash orders with payment type K are always excluded)
- Same currency as the source order
- Same order type as the source order
- All order lines are in ANG (acknowledged/ordered) status
- Not reserved on any active picklist
Results are returned ordered by creation date (oldest first).
If the source order does not exist or no candidates match, an empty result set is returned.