Postman-Collection
Customers Lesen

pixiAddressesDisplayDuplicates

Liefert Paare möglicherweise doppelter Kundenadressen aus der Dublettenprüfung mit Adress-, Auftrags-, Rechnungs- und Kundendaten beider Seiten.

Liest die Ergebnisse einer vorher ausgeführten Dublettenprüfung aus Addresses_Duplicates. Jeder Datensatz dort verknüpft zwei Adressen (AddrRef1/AddrRef2) und zwei Kunden (CustRef1/CustRef2) mit einer Übereinstimmungsstufe und einem Übereinstimmungstext.

Für jedes Paar liefert der Aufruf:

  • Übereinstimmungsstufe und -text,
  • Name, Firma (CareOf), Straße, Hausnummer, Ort, PLZ und Land beider Adressen,
  • Anzahl der Rechnungen und Datum der letzten Rechnung (LastDelivery1/2) je Kunde,
  • externe Kundennummer und DATEV-Kontonummer beider Kunden,
  • Auftragsnummer und Auftragsstatus der Aufträge, die die jeweilige Adresse verwenden,
  • NrOfRecords, die Gesamtzahl der nicht verwendeten Dublettendatensätze.

Filter:

  • Es werden nur Datensätze mit CustRef1 größer als StartCustRef geliefert. NULL wird als 0 behandelt.
  • Mit ShowUsed = 0 werden nur Datensätze geliefert, deren UsedFlag 0 oder NULL ist. Mit ShowUsed = 1 werden alle Datensätze geliefert, auch bereits bearbeitete.
  • RowCount begrenzt die Anzahl der gelieferten Zeilen über SET ROWCOUNT.

Die Zeilen sind aufsteigend nach CustRef1 sortiert. Zum Blättern wird der höchste gelieferte CustRef1 als StartCustRef des nächsten Aufrufs übergeben.

Hinweise

  • Alle Tabellen werden mit NOLOCK gelesen, daher können nicht festgeschriebene Daten erscheinen.
  • Die Adressen werden per Inner Join mit OrderHeader verknüpft. Ein Paar wird nur geliefert, wenn beide Adressen von mindestens einem Auftrag verwendet werden. Ein Paar erzeugt eine Zeile je Kombination aus Aufträgen der Adresse 1 und Aufträgen der Adresse 2. Die Zeilen sind daher nicht eindeutig je Dublettendatensatz.
  • Da ein CustRef1 mehrere Zeilen erzeugen kann, kann eine durch RowCount begrenzte Seite mitten in einem CustRef1 enden. Wird mit diesem CustRef1 als StartCustRef fortgesetzt, werden dessen restliche Zeilen übersprungen.
  • RowCount = 0 hebt die Begrenzung auf (SET ROWCOUNT 0).
  • NrOfRecords ist in jeder Zeile gleich. Gezählt werden alle nicht verwendeten Datensätze, deren beide Kunden existieren. StartCustRef, ShowUsed und die Verknüpfung mit Aufträgen werden dabei nicht berücksichtigt, daher kann der Wert von der Anzahl tatsächlich abrufbarer Zeilen abweichen.
  • CustKeyMatchedTo ist NULL, wenn ShowUsed = 0 ist. Andernfalls entspricht der Wert immer dem Schlüssel von Kunde 1 (CustRef1), da Kunde 1 per Inner Join verknüpft ist.
  • Der Aufruf zeigt nur Daten an. Er führt keine Kunden zusammen und setzt kein UsedFlag. Wie Addresses_Duplicates befüllt wird, ist aus diesem Code nicht ersichtlich.

Parameter

Parameter Typ Standardwert Beschreibung
StartCustRef
int 0

Es werden nur Datensätze mit CustRef1 größer als dieser Wert geliefert. Dient zum Blättern. NULL wird als 0 behandelt.

Beispiel: 0

ShowUsed
bit
boolean
0

Legt fest, ob bereits als verwendet markierte Dublettendatensätze enthalten sind.

Erlaubte Werte

  • 0 – Nur Datensätze mit `UsedFlag` 0 oder NULL; `CustKeyMatchedTo` ist NULL.
  • 1 – Alle Datensätze, auch verwendete; `CustKeyMatchedTo` ist gefüllt.

Beispiel: 0

RowCount
int 100

Maximale Anzahl gelieferter Zeilen (über SET ROWCOUNT). 0 bedeutet keine Begrenzung.

Beispiel: 100

Antwort

Result-Set 1 · Immer; kann leer sein, wenn keine passenden Dublettendatensätze existieren.

Eine Zeile je Dublettenpaar und Kombination der Aufträge beider Adressen, sortiert nach CustRef1.

Spalte Typ Beschreibung
matchlevel
Kann leer sein
string

Übereinstimmungsstufe der Dublettenprüfung (MatchLevel).

matchtext
Kann leer sein
string

Text zur Beschreibung der Übereinstimmung (MatchText).

CustRef1 int

Schlüssel des ersten Kunden.

AddrKey1 int

Schlüssel der ersten Adresse.

FirstName1
Kann leer sein
string

Vorname der Adresse 1.

LastName1
Kann leer sein
string

Nachname der Adresse 1.

Company1
Kann leer sein
string

Firma / c/o der Adresse 1 (CareOf).

Street1
Kann leer sein
string

Straße der Adresse 1.

HouseNr1
Kann leer sein
string

Hausnummer der Adresse 1.

City1
Kann leer sein
string

Ort der Adresse 1.

ZIP1
Kann leer sein
string

PLZ der Adresse 1.

Country1
Kann leer sein
string

Land der Adresse 1.

CustRef2 int

Schlüssel des zweiten Kunden.

AddrKey2 int

Schlüssel der zweiten Adresse.

FirstName2
Kann leer sein
string

Vorname der Adresse 2.

LastName2
Kann leer sein
string

Nachname der Adresse 2.

Company2
Kann leer sein
string

Firma / c/o der Adresse 2 (CareOf).

Street2
Kann leer sein
string

Straße der Adresse 2.

HouseNr2
Kann leer sein
string

Hausnummer der Adresse 2.

City2
Kann leer sein
string

Ort der Adresse 2.

ZIP2
Kann leer sein
string

PLZ der Adresse 2.

Country2
Kann leer sein
string

Land der Adresse 2.

NrOfInvoices1 int

Anzahl der Rechnungen von Kunde 1.

NrOfInvoices2 int

Anzahl der Rechnungen von Kunde 2.

LastDelivery1
Kann leer sein
dateTime

Letztes Rechnungsdatum (MAX(InvDate)) von Kunde 1; NULL ohne Rechnung.

LastDelivery2
Kann leer sein
dateTime

Letztes Rechnungsdatum (MAX(InvDate)) von Kunde 2; NULL ohne Rechnung.

CustomerNrExternal1
Kann leer sein
string

Externe Kundennummer von Kunde 1.

CustomerNrExternal2
Kann leer sein
string

Externe Kundennummer von Kunde 2.

NrOfRecords int

Gesamtzahl der nicht verwendeten Dublettendatensätze mit existierenden Kunden; in jeder Zeile gleich.

CustKeyMatchedTo
Kann leer sein
int

NULL bei ShowUsed = 0, sonst der Schlüssel von Kunde 1.

OrderNr1
Kann leer sein
int

Auftragsnummer eines Auftrags, der Adresse 1 verwendet.

OrderStatus1
Kann leer sein
string

Status dieses Auftrags.

OrderNr2
Kann leer sein
int

Auftragsnummer eines Auftrags, der Adresse 2 verwendet.

OrderStatus2
Kann leer sein
string

Status dieses Auftrags.

DatevUserAccount1
Kann leer sein
varchar(10)
string

DATEV-Kontonummer von Kunde 1 (DatevAccNr).

DatevUserAccount2
Kann leer sein
varchar(10)
string

DATEV-Kontonummer von Kunde 2 (DatevAccNr).

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:pixiAddressesDisplayDuplicates>
      <!-- <StartCustRef>0</StartCustRef> -->
      <!-- <ShowUsed>0</ShowUsed> -->
      <!-- <RowCount>100</RowCount> -->
    </ns1:pixiAddressesDisplayDuplicates>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Addresses_Duplicates · Lesen Addresses · Lesen OrderHeader · Lesen Customers · Lesen Invoices · Lesen
SQL-Objekt:
dbo.pipiAddressesDisplayDuplicates
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben