General Lesen

pixiGetShops

Liefert die Stammdaten aller Shops oder eines einzelnen Shops inklusive Adresse, Kontakt, Bankdaten aus den Fußzeilen und Kostenstelle.

Liest die Shop-Stammdaten aus der Tabelle shops.

Wird ShopID übergeben, wird nur der Shop mit dieser ID geliefert.
Fehlt ShopID, ist sie NULL oder ein Leerstring, werden alle Shops geliefert.

Eine Sortierung ist nicht festgelegt. Die Zeilen kommen also in der Reihenfolge, die die Datenbank liefert. Einige Spalten werden im Ergebnis umbenannt: SI_WebAddr wird zu ShopURL, SI_Address zu ShopCompany, und die Fußzeilen SI_FootLine1 bis SI_FootLine4 werden als BIC, IBAN, KontoBLZ und BankName geliefert.

Hinweise

Die Tabelle wird mit NOLOCK gelesen, daher können auch nicht festgeschriebene Daten im Ergebnis erscheinen.
Die bankbezogenen Spaltennamen (BIC, IBAN, KontoBLZ, BankName) sind nur Aliase für die allgemeinen Fußzeilen SI_FootLine1 bis SI_FootLine4. Sie enthalten das, was in diesen Fußzeilen gepflegt ist, was nicht zwingend Bankdaten sein müssen.
Eine unbekannte ShopID löst keinen Fehler aus; die Ergebnismenge ist dann einfach leer.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ShopID`	varchar(3) string	NULL	ID des zu liefernden Shops. Ist sie leer oder `NULL`, werden alle Shops geliefert. Beispiel: `ABC`

Antwort

Result-Set 1 · Immer (leer, wenn kein Shop passt)

Eine Zeile pro Shop.

Spalte	Typ	Beschreibung
`ShopID`	varchar(3) string	Shop-ID.
`ShopName` Kann leer sein	string	Name des Shops.
`ShopURL` Kann leer sein	string	Webadresse des Shops (`SI_WebAddr`).
`Address` Kann leer sein	string	Straße/Adresse.
`City` Kann leer sein	string	Ort.
`State` Kann leer sein	string	Bundesland bzw. Region.
`ZIP` Kann leer sein	string	Postleitzahl.
`Country` Kann leer sein	string	Land.
`Contact` Kann leer sein	string	Ansprechpartner.
`Phone` Kann leer sein	string	Telefonnummer.
`Fax` Kann leer sein	string	Faxnummer.
`ShopCompany` Kann leer sein	string	Firmenadresszeile für Shop-Belege (`SI_Address`).
`eMail` Kann leer sein	string	E-Mail-Adresse.
`SI_fon` Kann leer sein	string	Telefonnummer für Shop-Belege.
`SI_Fax` Kann leer sein	string	Faxnummer für Shop-Belege.
`BIC` Kann leer sein	string	Fußzeile 1 (`SI_FootLine1`), vorgesehen für die BIC.
`IBAN` Kann leer sein	string	Fußzeile 2 (`SI_FootLine2`), vorgesehen für die IBAN.
`KontoBLZ` Kann leer sein	string	Fußzeile 3 (`SI_FootLine3`), vorgesehen für Kontonummer und BLZ.
`BankName` Kann leer sein	string	Fußzeile 4 (`SI_FootLine4`), vorgesehen für den Banknamen.
`CostCenter` Kann leer sein	string	Dem Shop zugeordnete Kostenstelle.

Beispielantwort

<SqlRowSet1>
  <row>
    <ShopID>ABC</ShopID>
    <ShopName>Example Shop</ShopName>
    <ShopURL>https://www.example-shop.de</ShopURL>
    <Address>Hauptstraße 1</Address>
    <City>München</City>
    <State>BY</State>
    <ZIP>80331</ZIP>
    <Country>DE</Country>
    <Contact>Max Mustermann</Contact>
    <Phone>+49 89 123456</Phone>
    <Fax>+49 89 123457</Fax>
    <ShopCompany>Example GmbH</ShopCompany>
    <eMail>info@example-shop.de</eMail>
    <SI_fon>+49 89 123456</SI_fon>
    <SI_Fax>+49 89 123457</SI_Fax>
    <BIC>BIC: DEUTDEMMXXX</BIC>
    <IBAN>IBAN: DE89370400440532013000</IBAN>
    <KontoBLZ>Konto 532013000 BLZ 37040044</KontoBLZ>
    <BankName>Deutsche Bank</BankName>
    <CostCenter>100</CostCenter>
  </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:pixiGetShops>
      <!-- <ShopID>ABC</ShopID> -->
    </ns1:pixiGetShops>
  </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:pixiGetShops>
      <!-- <ShopID>ABC</ShopID> -->
    </ns1:pixiGetShops>
  </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 = [
    // 'ShopID' => 'ABC',
];

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

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

Verwendete Tabellen

shops · Lesen

SQL-Objekt:: dbo.pipiGetShops