pixiGetStandardReturnReasons

Liefert die Liste der Standard-Retourengründe auf Deutsch oder Englisch aus der Tabelle der Standardgründe, einer Einstellung und der Codetabelle für Retourengründe.

Stellt eine Liste von Retourengründen aus drei Quellen zusammen und liefert sie als eine Ergebnismenge.

Sprachauswahl. LanguageID = 1 wählt Deutsch; jeder andere Wert, auch NULL, wählt Englisch. Intern wechselt die Prozedur auf die Tabellenkonvention von Pixi, in der 1 = Englisch und 2 = Deutsch gilt, und filtert die Tabellen mit diesem Wert.

Quellen

1. Einträge aus RET_STANDARD_REASONS in der gewählten Sprache. Sie liefern RET_REASON_ID und REASON_TEXT. RET_REASON_CODE und LANGUAGEID sind NULL.
2. Die Einstellung CSD_ReturnWizardReasons_Deutsch (Deutsch) bzw. CSD_ReturnWizardReasons_English (andere Sprachen). Ihr Wert ist eine durch Semikolon getrennte Liste. Jeder Eintrag wird zu einer Zeile mit getrimmtem Text (max. 100 Zeichen) und RET_REASON_ID = NULL. Dieser Teil wird per UNION mit Quelle 1 verbunden, identische Zeilen aus Quelle 1 und 2 erscheinen daher nur einmal.
3. Einträge aus pixi.CodeTableValue mit CodeTableTypeId = 2 (Retourengründe), verknüpft mit ihrem Translation-Eintrag (DBObjectName = CodeTableValue) in der gewählten Sprache. Diese Zeilen liefern die ID aus der Codetabelle, den übersetzten Text und den Code. LANGUAGEID wird in die Konvention des Aufrufers zurückgerechnet (1 = Deutsch). Sie werden per UNION ALL angehängt, Duplikate werden hier also nicht entfernt.

Filter. Mit OnlyReturnReasonsFromPixiWeb = 1 werden nur Zeilen mit RET_REASON_ID geliefert. Damit entfallen die Gründe aus der Einstellung (Quelle 2).

Sortierung. Die Zeilen werden nach RET_REASON_CODE sortiert. Zeilen ohne Code (NULL) stehen vorne, ihre Reihenfolge untereinander ist nicht festgelegt.

Parameter

Antwort

Result-Set 1 · Immer

Retourengründe in der gewählten Sprache, sortiert nach RET_REASON_CODE.

<SqlRowSet1>
  <row>
    <RET_REASON_ID>3</RET_REASON_ID>
    <REASON_TEXT>Artikel defekt</REASON_TEXT>
  </row>
  <row>
    <RET_REASON_ID>17</RET_REASON_ID>
    <REASON_TEXT>Falsche Größe</REASON_TEXT>
    <RET_REASON_CODE>SIZE</RET_REASON_CODE>
    <LANGUAGEID>1</LANGUAGEID>
  </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:pixiGetStandardReturnReasons>
      <!-- <LanguageID>1</LanguageID> -->
      <!-- <OnlyReturnReasonsFromPixiWeb>0</OnlyReturnReasonsFromPixiWeb> -->
    </ns1:pixiGetStandardReturnReasons>
  </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:pixiGetStandardReturnReasons>
      <!-- <LanguageID>1</LanguageID> -->
      <!-- <OnlyReturnReasonsFromPixiWeb>0</OnlyReturnReasonsFromPixiWeb> -->
    </ns1:pixiGetStandardReturnReasons>
  </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 = [
    // 'LanguageID' => '1',
    // 'OnlyReturnReasonsFromPixiWeb' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetStandardReturnReasons

Prozedur zuletzt geändert am 2026-10-05

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