pixi Developer & Integration Documentation

pixiGetItemLogisticsEAN

Description

Returns EAN barcode and packing unit (VPE) data for items, intended for fulfillment partner synchronization. Results are paginated by item ID using StartKey and RowCount. Only active, non-bundle items are included.

For items that are the sole component of a VPE bundle (where the bundle quantity matches the component's order unit), the call returns two rows for that item: one with the component's own barcode and VPE=1, and one with the bundle's barcode and VPE=OrderUnit. This allows the fulfillment partner to register both the individual item barcode and the packing-unit barcode.

To retrieve all items, call repeatedly: pass the last received ItemKey as the next StartKey and repeat until the number of rows returned is less than RowCount.


Request Parameters

#

Name

Type

Required

Example

Description

1

StartKey

int

0

0

Returns items with an ItemKey greater than this value. Use 0 to start from the beginning. Pass the last received ItemKey to fetch the next page.

2

RowCount

int

0

1000

Maximum number of items to return per call. Defaults to 1000.


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:pipiGetItemLogisticsEAN>
<dem:StartKey>0</dem:StartKey>
<dem:RowCount>1000</dem:RowCount>
</dem:pipiGetItemLogisticsEAN>
</soapenv:Body>
</soapenv:Envelope>


Response


Body 1: Item EAN and VPE Data

#

Name

Type

Description

1

ItemKey

int

Item ID of the component item. Use as the StartKey value for the next page request.

2

EANUPC

varchar(13)

Item barcode. For VPE bundle components, this field appears in two rows: the component's own barcode (VPE=1) and the bundle's barcode (VPE=OrderUnit).

3

VPE

int

Packing unit. 1 for the item's own barcode row. For the bundle barcode row of a VPE component, equals the component item's order unit.


Additional Notes

Only active, non-bundle items are returned (items flagged as enabled and not marked as bundles).

VPE bundle behaviour: an item qualifies as a VPE bundle component when it is the sole component of exactly one bundle and the bundle quantity matches the component's order unit. Such items appear twice in the result:
Row 1 — component's own EAN, VPE = 1
Row 2 — bundle's EAN, VPE = component's OrderUnit

Results are ordered by ItemKey ascending. To paginate through all items:
1. Call with StartKey = 0
2. Note the last ItemKey in the response
3. Call again with StartKey = {last ItemKey}
4. Repeat until the number of rows returned is less than RowCount