Postman-Collection
Returns Lesen

pixiGetReturnItems

Liefert die Positionen eines Retourenfalls mit Artikel, Rechnungsposition, Lagerplatz sowie übersetztem Retourengrund und Qualitätsklassifizierung.

Liefert alle Retourenpositionen (pixi.ReturnLine), die zum in ReturnId angegebenen Retourenfall gehören.

Ablauf:

  1. Die Übersetzungen der Codetabellenwerte (DBObjectName = 'CodeTableValue') für die Sprache LanguageId werden in eine temporäre Tabelle geladen.
  2. Alle Retourenpositionen des Retourenfalls werden gelesen und verknüpft mit:
    • der Rechnungsposition (Invlines) und dem zugehörigen Artikel (items), die Artikelnummer, EAN, Artikelname und interne Artikelnummer liefern,
    • dem Retourengrund (ReasonId) mit Code und übersetzter Beschreibung,
    • der Qualitätsklassifizierung des Artikels (ItemQualityClassificationId) mit Code und übersetzter Beschreibung,
    • dem Lagerbuchungseintrag (InvBinItemLog), der Menge, Lager, Lagerplatz, Mindesthaltbarkeitsdatum und Charge liefert.

Alle Verknüpfungen sind Inner Joins: Eine Position erscheint nur, wenn alle referenzierten Datensätze existieren und sowohl für den Retourengrund als auch für die Klassifizierung eine Übersetzung in der angeforderten Sprache vorhanden ist.

Eine explizite Sortierung erfolgt nicht.

Hinweise

  • Die meisten Tabellen werden mit NOLOCK gelesen, daher können nicht festgeschriebene Daten geliefert werden; die Verknüpfung zur Qualitätsklassifizierung (CodeTableValue als ct2) erfolgt ohne NOLOCK.
  • Fehlt für einen Retourengrund oder eine Klassifizierung die Übersetzung in der angegebenen LanguageId, fehlt die gesamte Position im Ergebnis. Es sollte eine Sprache verwendet werden, für die Übersetzungen vorhanden sind (Standard 1).
  • Die temporäre Tabelle wird über util.TempTableDrop entfernt; dessen Definition liegt nicht vor.
  • Existiert der Retourenfall nicht oder hat er keine Positionen, wird eine leere Ergebnismenge geliefert; ein Fehler wird nicht ausgelöst.

Parameter

Parameter Typ Standardwert Beschreibung
ReturnId
Pflicht
int –

ID des Retourenfalls, dessen Positionen geliefert werden.

Beispiel: 1042

LanguageId
int 1

Sprach-ID für die übersetzten Beschreibungen von Retourengrund und Qualitätsklassifizierung.

Beispiel: 1

Antwort

Result-Set 1 · Immer (ggf. leer)

Eine Zeile pro Retourenposition des Retourenfalls.

Spalte Typ Beschreibung
Id int

ID der Retourenposition.

ReasonId int

ID des Codetabellenwerts des Retourengrunds.

ReasonDescription
Kann leer sein
string

Übersetzte Beschreibung des Retourengrunds in der angeforderten Sprache.

ItemId int

Interner Artikelschlüssel (ItemKey) des retournierten Artikels.

EANUPC
Kann leer sein
string

EAN/UPC des Artikels.

ItemName
Kann leer sein
string

Name des Artikels.

Quantity
Kann leer sein
int

Menge aus dem verknüpften Lagerbuchungseintrag.

LocationCode
Kann leer sein
string

Lager des Lagerbuchungseintrags.

BinId
Kann leer sein
int

Referenz auf den Lagerplatz des Lagerbuchungseintrags.

BestBeforeDate
Kann leer sein
dateTime

Mindesthaltbarkeitsdatum aus dem Lagerbuchungseintrag.

BatchNumber
Kann leer sein
string

Chargennummer aus dem Lagerbuchungseintrag.

InvoiceLineId int

ID der Rechnungsposition, auf die sich die Retourenposition bezieht.

IsSpecialCase
Kann leer sein
boolean

Kennzeichen, ob die Retourenposition als Sonderfall markiert ist.

CustomerComment
Kann leer sein
string

Kommentar des Kunden zur Retourenposition.

UserComment
Kann leer sein
string

Kommentar des Benutzers zur Retourenposition.

RecordModifiedOn
Kann leer sein
dateTime

Zeitpunkt der letzten Änderung der Retourenposition.

ItemNrInt
Kann leer sein
string

Interne Artikelnummer des Artikels.

ReasonCode
Kann leer sein
string

Code des Retourengrunds.

ItemClassification
Kann leer sein
string

Code der Qualitätsklassifizierung des Artikels.

ItemClassificationDescription
Kann leer sein
string

Übersetzte Beschreibung der Qualitätsklassifizierung in der angeforderten Sprache.

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:pixiGetReturnItems>
      <ReturnId>1042</ReturnId>
      <!-- <LanguageId>1</LanguageId> -->
    </ns1:pixiGetReturnItems>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Translation · Lesen ReturnLine · Lesen Invlines · Lesen items · Lesen CodeTableValue · Lesen InvBinItemLog · Lesen
SQL-Objekt:
dbo.pipiGetReturnItems
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben