pixiItemSearch

Sucht Artikel nach Name bzw. Artikelcode, EAN/UPC, Konfigurationstyp und Lieferant und liefert Artikelzeilen inklusive Lieferantenpreisen und offenen Lieferantenbestellmengen.

Wrapper um die interne Prozedur GOSItemSearch1. Die Parameter werden weitergereicht; Lieferantenpreise und Statistiken werden immer angefordert. Da kein Benutzername übergeben wird, sind Lieferanten- (EK-)Preise immer sichtbar.

Ablauf:

1. Ist SupplNr leer, wird ShowOnlyItemsForExactSupplier auf 0 gesetzt.
2. RowCount = 0 wird durch die Einstellung ItemSearchLimit ersetzt. Ist auch diese 0, gilt 300.
3. Ist EANUPC gesetzt, werden die Artikel-IDs gesammelt, deren Code in pixi.ItemCode exakt übereinstimmt. Dabei zählen nur Codetypen, die als scannbar markiert sind.
4. Ist ItemName gesetzt und hat der EAN-Schritt nichts gefunden, wird ItemName mit allen Artikelcodes verglichen:
   • Passt genau ein Code exakt, ist dieser Artikel das Ergebnis. Die Freitextsuche wird dann deaktiviert und Codetyp 1 verwendet.
   • Andernfalls werden alle Artikel gesammelt, deren Code mit ItemName beginnt. ItemName dient dann zusätzlich als Smart-Search-Begriff.
5. ConfigType wird als Filter für den Konfigurationstyp (TonTrArt) weitergegeben.
6. SupplNr wird als Lieferantenfilter weitergegeben. LocID bestimmt das Lager (Standard 001).
7. Es wird immer die Datenbankwährung verwendet. Ein Wechselkurs wird nicht übergeben.
8. Pro Artikel wird die offene Menge aus Lieferantenbestellungen berechnet: bestellt minus geliefert minus nicht geliefert. Gezählt werden nur Lieferantenbestellungen mit vollständig offenem Status und Mengen für das gewählte Lager. Bei angegebener SupplNr zählen nur Bestellungen dieses Lieferanten.
9. Die abschließende Abfrage liefert SELECT DISTINCT TOP (RowCount) Zeilen. Sie wird dynamisch aufgebaut.

Die Abfrage hat kein ORDER BY; die ORDER-BY-Klausel ist im Code auskommentiert. Die Reihenfolge der Zeilen ist daher nicht garantiert.

Parameter

Antwort

Result-Set 1 · Immer (kann leer sein)

Artikelzeilen aus der dynamischen Abfrage, begrenzt auf RowCount eindeutige Zeilen, ohne garantierte Reihenfolge. Die Spalten werden von pixi_ItemSearchPrepareDynamicQuery festgelegt, deren Definition nicht vorliegt. Sie umfassen Artikeldaten, Lieferantenpreise und Bestandsdaten zum Lager; die offenen Lieferantenbestelldaten werden in einer temporären Tabelle berechnet.

Beispiele

POST https://apigateway.descartes.com/tms/pixi/
Content-Type: text/xml; charset=utf-8
Authorization: Basic BASE64(USERNAME:PASSWORD)

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiItemSearch>
      <!-- <RowCount>50</RowCount> -->
      <!-- <ItemName>T-Shirt</ItemName> -->
      <!-- <ConfigType>?</ConfigType> -->
      <!-- <SupplNr>L001</SupplNr> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <LocID>001</LocID> -->
      <!-- <ShowOnlyItemsForExactSupplier>0</ShowOnlyItemsForExactSupplier> -->
    </ns1:pixiItemSearch>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiItemSearch>
      <!-- <RowCount>50</RowCount> -->
      <!-- <ItemName>T-Shirt</ItemName> -->
      <!-- <ConfigType>?</ConfigType> -->
      <!-- <SupplNr>L001</SupplNr> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <LocID>001</LocID> -->
      <!-- <ShowOnlyItemsForExactSupplier>0</ShowOnlyItemsForExactSupplier> -->
    </ns1:pixiItemSearch>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    // 'RowCount' => '50',
    // 'ItemName' => 'T-Shirt',
    // 'ConfigType' => '?',
    // 'SupplNr' => 'L001',
    // 'EANUPC' => '4006381333931',
    // 'LocID' => '001',
    // 'ShowOnlyItemsForExactSupplier' => '0',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiItemSearch', $soapArguments);

Verwendete Tabellen

SQL-Objekt:

dbo.pipiItemSearch

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben