Wir haben das inzwischen umgesetzt. Hier der vereinfachte PHP-Ablauf für die Zuordnung normaler Artikelpositionen.
$api ist dabei unser bereits authentifizierter REST-Client. Seine Methode get() liefert die JSON-Antwort als PHP-Array zurück.
1. Pickliste inklusive gespeicherter Pickpositionen abrufen
$picklistId = 40913;
$picklist = $api->get(
'/rest/fulfillment/picklist/' . $picklistId,
['with[]' => 'pickingOrderItems']
);
Die Antwort enthält unter anderem diese Struktur — hier mit beispielhaften IDs:
{
"id": 40913,
"filterOptions": {
"orderIds": [4866004, 4865999]
},
"pickingOrderItems": [
{
"orderItemId": 8070123,
"itemId": 10439,
"quantity": 3
}
]
}
Die Auftrags-IDs lassen sich somit direkt aus dem Antwortarray auslesen:
$orderIds = $picklist['filterOptions']['orderIds'] ?? null;
if (!is_array($orderIds)) {
throw new RuntimeException('Auftrags-IDs fehlen in der Pickliste.');
}
// Beispiel:
// $orderIds = [4866004, 4865999];
2. Diese Aufträge mit ihren Artikel-/Variantenpositionen laden
Dafür verwenden wir:
GET /rest/orders?orderIds=4866004,4865999&with[]=orderItems.variation&addOrderItems=1
Im PHP-Code laden wir höchstens 100 Auftrags-IDs je Abfragegruppe und berücksichtigen die Pagination:
$orderItemsById = [];
foreach (array_chunk($orderIds, 100) as $orderIdGroup) {
$page = 1;
do {
$response = $api->get('/rest/orders', [
'orderIds' => implode(',', $orderIdGroup),
'with[]' => 'orderItems.variation',
'addOrderItems' => true,
'page' => $page,
'itemsPerPage' => 250,
]);
if (!isset($response['entries'], $response['isLastPage'])) {
throw new RuntimeException('Ungültige Auftragsantwort.');
}
foreach ($response['entries'] as $order) {
foreach ($order['orderItems'] as $orderItem) {
// Index für die spätere Zuordnung anlegen:
$orderItemsById[(string) $orderItem['id']] = $orderItem;
}
}
$page++;
} while (!$response['isLastPage']);
}
3. Pickposition über orderItemId mit der Auftragsposition verbinden
Jetzt können wir zu jeder Pickposition die Varianteninformationen nachschlagen:
$result = [];
foreach ($picklist['pickingOrderItems'] as $pickItem) {
$orderItemId = (string) $pickItem['orderItemId'];
if (!isset($orderItemsById[$orderItemId])) {
throw new RuntimeException(
'Auftragsposition nicht gefunden: ' . $orderItemId
);
}
$orderItem = $orderItemsById[$orderItemId];
$result[] = [
'picklistId' => $picklistId,
'itemId' => $pickItem['itemId'],
'variationId' => $orderItem['itemVariationId'],
'variationNumber' => $orderItem['variation']['number'],
'quantity' => $pickItem['quantity'],
];
}
Damit erhalten wir beispielsweise:
[
'picklistId' => 40913,
'itemId' => 10439,
'variationId' => 1278,
'variationNumber' => 'R23-S',
'quantity' => 3,
]
Wichtig: Die Menge übernehmen wir aus pickingOrderItems.quantity, nicht aus den aktuellen Auftragspositionen. Eine gespeicherte Pickposition kann mehrere Aufträge zusammenfassen; durch erneutes Summieren der Auftragsmengen könnte man falsche oder doppelte Mengen erhalten.
Im produktiven Ablauf prüfen wir zusätzlich die eindeutige Varianten-Zuordnung innerhalb der zusammengefassten Aufträge.
Die offenen Picklisten holen wir vorher über diese Route:
GET /rest/fulfillment/picklist?state=open&sortBy=createdAt&sortOrder=desc&itemsPerPage=100&page=1
Der Parameter state=open beschränkt die Antwort auf offene Picklisten. Die Ergebnisse stehen unter entries; die Picklistennummer ist jeweils id.
Bei uns berücksichtigen wir zusätzlich nur Listen der letzten 24 Stunden. Diesen Zeitraum prüfen wir anhand von createdAt im PHP-Code:
$picklistIds = [];
$cutoff = time() - 86400; // letzte 24 Stunden
$page = 1;
$pastCutoff = false;
do {
$response = $api->get('/rest/fulfillment/picklist', [
'state' => 'open',
'sortBy' => 'createdAt',
'sortOrder' => 'desc',
'itemsPerPage' => 100,
'page' => $page,
]);
if (!isset($response['entries'], $response['isLastPage'])) {
throw new RuntimeException('Ungültige Picklisten-Antwort.');
}
foreach ($response['entries'] as $picklist) {
$createdAt = strtotime($picklist['createdAt'] ?? '');
if ($createdAt === false) {
throw new RuntimeException('Erstelldatum fehlt oder ist ungültig.');
}
// Absteigend sortiert: Ab hier sind die Listen zu alt.
if ($createdAt < $cutoff) {
$pastCutoff = true;
break;
}
$picklistIds[] = $picklist['id'];
}
$page++;
} while (!$response['isLastPage'] && !$pastCutoff);
Danach enthält $picklistIds die passenden Picklistennummern. Für jede davon folgt der zuvor beschriebene Detailabruf:
foreach ($picklistIds as $picklistId) {
$picklist = $api->get(
'/rest/fulfillment/picklist/' . $picklistId,
['with[]' => 'pickingOrderItems']
);
// Anschließend Auftrags-IDs auslesen,
// Aufträge laden und Varianten zuordnen.
}
Der Ablauf ist somit: offene Listen suchen → konkrete Liste mit Pickpositionen laden → zugehörige Aufträge und Varianteninformationen ergänzen.