pixi Developer & Integration Documentation

pixiGetMergableOrders

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.