pixi Developer & Integration Documentation

pixiCreateReplacement

Description

Creates a replacement order from an existing order. The procedure retrieves customer, address, and location details from the source order and passes them together with the specified order lines to the replacement order creation process.


Request Parameters

#

Name

Type

Required

Example

Description

1

OrderNr

int

1

123456

The pixi order number for which to create a replacement.

2

Orderlines

varchar(max)

1

Check additional information

The order lines for which to create the replacement. Passed directly to the replacement order creation process.

3

Username

varchar(50)

0

API

The user name to record as the creator of the replacement order. Defaults to API if not provided.


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:pipiCreateReplacement>
<dem:OrderNr>123456</dem:OrderNr>
<dem:Orderlines>Check additional information</dem:Orderlines>
<dem:Username>API</dem:Username>
</dem:pipiCreateReplacement>
</soapenv:Body>
</soapenv:Envelope>


Response


Body 1: Replacement Order Details

#

Name

Type

Description

1

NewOrderNr

int

The order number of the newly created replacement order.


Additional Notes

The procedure reads customer reference, billing address, shipping address, location ID, and last order location from the source order lines and passes these to the replacement order creation process together with the Orderlines parameter.

The Orderlines parameter format is determined by the underlying replacement order creation process. Contact pixi support or refer to the replacement order workflow documentation for the expected format.

If the source OrderNr does not exist or contains no order lines, the procedure may produce unexpected results as no validation is performed on the source order before delegation.