Customers Schreiben

pixiSetShippingLock

Setzt oder entfernt die Liefersperre (`SLocked`) eines Kunden, identifiziert über `CustKey` oder über externe Kundennummer und Shop.

Setzt das Liefersperre-Kennzeichen eines Kundendatensatzes in Customers.

UserName wird getrimmt. Ist der Wert leer oder nicht angegeben, wird API verwendet. Der Wert wird in Customers.UpdateEmp geschrieben.
Locked wird in den gespeicherten Wert umgesetzt: 1 wird zu Y. Jeder andere Wert, auch 0 und NULL, wird zu N.
Ist CustomerNrExternal nicht leer, ermittelt die Prozedur den CustKey des Kunden, dessen CustomerNrExternal übereinstimmt und dessen CustomerOf gleich ShopID ist. Passen mehrere Kunden, wird nur einer davon verwendet (TOP 1, ohne definierte Reihenfolge).
Beim Kunden mit dem ermittelten CustKey werden SLocked und UpdateEmp aktualisiert.
Zurückgegeben wird eine Zeile mit der Spalte Result: 0, wenn genau ein Kunde aktualisiert wurde, sonst 1.

Hinweise

Ist CustomerNrExternal angegeben, passt aber kein Kunde, behält die Variable den übergebenen CustKey. In diesem Fall wird der Kunde mit diesem CustKey aktualisiert, oder es wird nichts aktualisiert, wenn CustKey NULL ist.
ShopID wird mit = verglichen. Ist ShopID NULL, während CustomerNrExternal gesetzt ist, findet die Suche nie einen Treffer.
Wird weder CustKey noch eine passende externe Nummer übergeben, wird keine Zeile aktualisiert und Result = 1 zurückgegeben.
Die Suche verwendet UPDLOCK. Es gibt keine explizite Transaktion, daher gilt die Sperre nur für die Dauer dieser Anweisung.
Es werden keine Fehlermeldungen erzeugt. Erfolg oder Misserfolg zeigt nur der Wert Result an.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`CustKey`	int	NULL	Interner Schlüssel des Kunden. Wird verwendet, wenn `CustomerNrExternal` leer ist oder darüber kein passender Kunde gefunden wird. Beispiel: `10452`
`Locked`	bit boolean	1	`1` setzt die Liefersperre (`SLocked` = `Y`). Jeder andere Wert hebt sie auf (`SLocked` = `N`). Erlaubte Werte `1` – Liefersperre setzen (`SLocked` = `Y`) `0` – Liefersperre aufheben (`SLocked` = `N`) Beispiel: `1`
`CustomerNrExternal`	varchar(250) string	NULL	Externe Kundennummer, z. B. aus dem Shop. Ist sie gesetzt, wird der Kunde über diese Nummer zusammen mit `ShopID` gesucht. Beispiel: `SHOP-000123`
`ShopID`	varchar(3) string	NULL	Shop-Kürzel, das mit `Customers.CustomerOf` verglichen wird. Für die Suche über `CustomerNrExternal` erforderlich. Beispiel: `WEB`
`UserName`	varchar(50) string	NULL	Benutzername, der in `UpdateEmp` geschrieben wird. Ist er leer oder nicht angegeben, wird `API` verwendet. Beispiel: `shopsync`

Antwort

Result-Set 1 · Immer

Eine Zeile mit dem Ergebnis der Aktualisierung.

Spalte	Typ	Beschreibung
`Result`	int	`0`, wenn genau ein Kunde aktualisiert wurde, `1`, wenn kein Kunde aktualisiert wurde.

Beispielantwort

<SqlRowSet1>
  <row>
    <Result>0</Result>
  </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:pixiSetShippingLock>
      <!-- <CustKey>10452</CustKey> -->
      <!-- <Locked>1</Locked> -->
      <!-- <CustomerNrExternal>SHOP-000123</CustomerNrExternal> -->
      <!-- <ShopID>WEB</ShopID> -->
      <!-- <UserName>shopsync</UserName> -->
    </ns1:pixiSetShippingLock>
  </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:pixiSetShippingLock>
      <!-- <CustKey>10452</CustKey> -->
      <!-- <Locked>1</Locked> -->
      <!-- <CustomerNrExternal>SHOP-000123</CustomerNrExternal> -->
      <!-- <ShopID>WEB</ShopID> -->
      <!-- <UserName>shopsync</UserName> -->
    </ns1:pixiSetShippingLock>
  </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' => '10452',
    // 'Locked' => '1',
    // 'CustomerNrExternal' => 'SHOP-000123',
    // 'ShopID' => 'WEB',
    // 'UserName' => 'shopsync',
];

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

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

Verwendete Tabellen

Customers · Schreiben

SQL-Objekt:: dbo.pipiSetShippingLock