Customers Lesen

pixiGetCustomerInfo

Liefert Basisinformationen zu einem Kunden: Name, Kommentar, DATEV-Konto, Sperrkennzeichen, Anzahl Rechnungen je Mahnstufe und externe Kundennummer.

Sucht den Kunden mit dem internen Schlüssel CustKey und verknüpft ihn mit seiner Hauptadresse (Customers.AddrRef → Addresses.AddrKey).

Geliefert wird eine Zeile mit:

dem Namen aus dem Adressdatensatz,
der Kundenhistorien-Notiz (CHisNote) als Comment,
der DATEV-Kontonummer als Text,
dem Sperrkennzeichen (N, falls nicht gesetzt),
der Anzahl der Rechnungen des Kunden in Mahnstufe 1, 2 und 3,
der externen Kundennummer.

Existiert kein Kunde mit diesem Schlüssel oder fehlt der zugehörige Adressdatensatz, ist die Ergebnismenge leer.

Hinweise

Alle Lesezugriffe erfolgen mit NOLOCK, die Werte können daher nicht festgeschriebene Daten enthalten.
Rechnungen mit Mahnstufen über 3 werden nicht gezählt.
Die DATEV-Kontonummer wird in varchar(10) umgewandelt.
Laut einem Kommentar im Code soll die Spaltenliste später erweitert werden.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`CustKey` Pflicht	int	–	Interner Schlüssel des Kunden (`Customers.CustKey`). Beispiel: `10234`

Antwort

Result-Set 1 · Immer; leer, wenn Kunde oder Adresse nicht existiert.

Kundeninformationen, höchstens eine Zeile.

Spalte	Typ	Beschreibung
`Name` Kann leer sein	string	Name aus dem Adressdatensatz des Kunden.
`Comment` Kann leer sein	string	Kundenhistorien-Notiz (`CHisNote`).
`DatevUserAccount` Kann leer sein	varchar(10) string	DATEV-Kontonummer des Kunden als Text.
`CustomerLocked`	string	Sperrkennzeichen des Kunden (`Slocked`); `N`, falls nicht gesetzt.
`InvoicesReminderLevel1`	int	Anzahl der Rechnungen des Kunden in Mahnstufe 1.
`InvoicesReminderLevel2`	int	Anzahl der Rechnungen des Kunden in Mahnstufe 2.
`InvoicesReminderLevel3`	int	Anzahl der Rechnungen des Kunden in Mahnstufe 3.
`CustomerNRExternal` Kann leer sein	string	Externe Kundennummer (z. B. aus dem Shop).

Beispielantwort

<SqlRowSet1>
  <row>
    <Name>Mustermann GmbH</Name>
    <Comment>Pays by invoice only</Comment>
    <DatevUserAccount>10234</DatevUserAccount>
    <CustomerLocked>N</CustomerLocked>
    <InvoicesReminderLevel1>2</InvoicesReminderLevel1>
    <InvoicesReminderLevel2>1</InvoicesReminderLevel2>
    <InvoicesReminderLevel3>0</InvoicesReminderLevel3>
    <CustomerNRExternal>SHOP-4711</CustomerNRExternal>
  </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:pixiGetCustomerInfo>
      <CustKey>10234</CustKey>
    </ns1:pixiGetCustomerInfo>
  </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:pixiGetCustomerInfo>
      <CustKey>10234</CustKey>
    </ns1:pixiGetCustomerInfo>
  </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 = [
    'CustKey' => '10234',
];

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

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

Verwendete Tabellen

Customers · Lesen Addresses · Lesen Invoices · Lesen

SQL-Objekt:: dbo.pipiGetCustomerInfo