General Lesen

pixiGetCurrency

Liefert die Hauptwährungen aus der Pixi-Währungstabelle, optional gefiltert nach ISO-Code oder Währungs-ID.

Liest die Währungstabelle pixi.Currency und liefert nur Einträge, die als Hauptwährung gekennzeichnet sind (ParentCurrency = 1).

Ohne Parameter werden alle Hauptwährungen geliefert.
CurrencyCode filtert nach dem alphabetischen ISO-Code (CodeA), z. B. EUR.
CurrencyId filtert nach der internen Währungs-ID.
Beide Filter lassen sich kombinieren; eine Zeile muss dann beide erfüllen.
NULL-Werte werden wie die Standardwerte (Leerstring bzw. 0) behandelt, der Filter entfällt also.

Inaktive Währungen werden ebenfalls geliefert; die Spalte Active zeigt den Status. Eine Sortierung ist nicht festgelegt.

Hinweise

Die Tabelle wird mit NOLOCK gelesen, nicht festgeschriebene Änderungen können daher sichtbar sein.
Währungen, die keine Hauptwährung sind (ParentCurrency ungleich 1), werden nie geliefert, auch wenn ihr Code oder ihre ID explizit übergeben wird; das Ergebnis ist dann leer.
Die Reihenfolge der Zeilen ist nicht garantiert, da die Abfrage kein ORDER BY enthält.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`CurrencyCode`	varchar(3) string	–	Alphabetischer ISO-Währungscode (`CodeA`) als Filter. Leerstring oder NULL liefert alle Hauptwährungen. Beispiel: `EUR`
`CurrencyId`	smallint int	0	Interne Währungs-ID als Filter. `0` oder NULL deaktiviert diesen Filter. Beispiel: `2`

Antwort

Result-Set 1 · Immer (kann leer sein, wenn keine Hauptwährung den Filtern entspricht)

Eine Zeile je passender Hauptwährung.

Spalte	Typ	Beschreibung
`Id`	smallint int	Interne Währungs-ID.
`Code` Kann leer sein	varchar(3) string	Alphabetischer ISO-Währungscode (`CodeA`).
`CodeNumber` Kann leer sein	string	Numerischer ISO-Währungscode (`CodeN`).
`Active` Kann leer sein	boolean	Gibt an, ob die Währung aktiv ist.
`LocaleId` Kann leer sein	int	Der Währung zugeordnete Windows-Locale-ID (`LCID`).

Beispielantwort

<SqlRowSet1>
  <row>
    <Id>2</Id>
    <Code>EUR</Code>
    <CodeNumber>978</CodeNumber>
    <Active>1</Active>
    <LocaleId>1031</LocaleId>
  </row>
  <row>
    <Id>3</Id>
    <Code>CHF</Code>
    <CodeNumber>756</CodeNumber>
    <Active>1</Active>
    <LocaleId>2055</LocaleId>
  </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:pixiGetCurrency>
      <!-- <CurrencyCode>EUR</CurrencyCode> -->
      <!-- <CurrencyId>2</CurrencyId> -->
    </ns1:pixiGetCurrency>
  </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:pixiGetCurrency>
      <!-- <CurrencyCode>EUR</CurrencyCode> -->
      <!-- <CurrencyId>2</CurrencyId> -->
    </ns1:pixiGetCurrency>
  </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 = [
    // 'CurrencyCode' => 'EUR',
    // 'CurrencyId' => '2',
];

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

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

Verwendete Tabellen

Currency · Lesen

SQL-Objekt:: dbo.pipiGetCurrency