pixiGetSettings

Liefert den Wert einer einzelnen Pixi-Einstellung oder ohne Namensangabe eine Übersicht ausgewählter Einstellungen, Lizenzzähler und Stammdatenanzahlen.

Liest Systemeinstellungen aus der Tabelle Settings. Leere Zeichenketten in den Parametern werden als NULL behandelt.

Der Aufruf kennt drei Modi:

• SettingName = LocID: liefert eine Zeile mit SettingName = LocID und einem SettingValue, der alle Lager-IDs aus Location jeweils gefolgt von ; auflistet (z. B. 001; 002; ).
• Beliebiger anderer SettingName: liefert eine Zeile mit dem angefragten Namen und dessen Wert aus Settings (erster Treffer). Existiert die Einstellung nicht oder ist ihr Wert NULL, ist SettingValue gleich '0'.
• Kein SettingName (weggelassen oder leer): liefert eine Übersicht mit mehreren Zeilen:
  • die Einstellungen EnablePrintingRules, BookExportDatevActive, FulfillmentBuyingOption, pixiLicences, ReservePrepaymentOrders, ScanInWithPiccoLink, EnablePersonalizedItems, SerialNumberValidityCheckEnabled, PixiMail_CreationEnabled, PixiMail_SendingEnabled, C_ItemImportEnabled, C_OrderImportEnabled, ReturnsEnabled, EnableDbCCP, Add_0_to_12_char_BarCode, default_quantity, APIUpdateItemBinCodes, NumberOfPiccoTerminals (nur sofern in Settings vorhanden),
  • Mobile_Licenses: Anzahl aktiver Benutzersitzungen mit Sitzungstyp 4 oder 5,
  • Suppliers, Shops, Locations: Anzahl der Datensätze in den jeweiligen Tabellen,
  • ShipVendors: alle Versanddienstleister-Namen, jeweils gefolgt von , ,
  • LocID: alle Lager-IDs, jeweils gefolgt von ; ,
  • PIM: '1', wenn eine Einstellung ShopUrl auf pim.pixi.eu oder pim-beta.pixi.eu verweist, sonst '0'. Ist die Einstellung C_OrderImportEnabled gleich 1, werden zusätzlich die Kanaleinstellungen (C_ChannelSettings) geprüft.

Die Übersichtszeilen werden per UNION zusammengeführt; doppelte Zeilen entfallen, eine Sortierreihenfolge ist nicht garantiert.

Parameter

Antwort

Result-Set 1 · Wenn SettingName = LocID

Eine Zeile mit der Liste aller Lager-IDs.

Result-Set 2 · Wenn SettingName angegeben und nicht LocID ist

Eine Zeile mit der angefragten Einstellung und ihrem Wert.

Result-Set 3 · Wenn SettingName leer ist oder weggelassen wird

Übersicht ausgewählter Einstellungen, Lizenzzähler, Stammdatenanzahlen, Versanddienstleister, Lager-IDs und PIM-Kennzeichen; unsortiert.

<SqlRowSet1>
  <row>
    <SettingName>LocID</SettingName>
    <SettingValue>001; 002; </SettingValue>
  </row>
</SqlRowSet1>

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:pixiGetSettings>
      <!-- <SettingName>ReturnsEnabled</SettingName> -->
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <LocID>001</LocID> -->
    </ns1:pixiGetSettings>
  </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:pixiGetSettings>
      <!-- <SettingName>ReturnsEnabled</SettingName> -->
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <LocID>001</LocID> -->
    </ns1:pixiGetSettings>
  </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 = [
    // 'SettingName' => 'ReturnsEnabled',
    // 'ShopID' => 'SHP',
    // 'LocID' => '001',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetSettings

Prozedur zuletzt geändert am 2026-10-05

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