Invoices Lesen

pixiGetCountriesInvoice

Liefert die eindeutige Liste der Länder (Code und Name), die in den Rechnungsadressen aller Rechnungen vorkommen.

Ermittelt das Land der Adresse, die mit jeder Rechnung verknüpft ist, und liefert jedes Land einmal mit Code und Namen.

Jede Rechnung aus Invoices wird über AddrRef = AddrKey mit ihrer Adresse in Addresses verknüpft. Rechnungen ohne passende Adresse entfallen.
Der Länderwert der Adresse wird in der Tabelle countries über CntCode nachgeschlagen.
Das Ergebnis wird dedupliziert (DISTINCT) und aufsteigend nach CntName sortiert.

Der Aufruf hat keine Parameter und berücksichtigt immer alle Rechnungen der Datenbank.

Hinweise

Die Suche in countries erfolgt per LEFT JOIN. Enthält eine Adresse einen Länderwert, der in countries nicht existiert (oder leer/NULL ist), wird eine Zeile mit CntCode und CntName jeweils NULL geliefert. Durch die aufsteigende Sortierung nach CntName steht diese Zeile an erster Stelle.
Der nicht gefundene Länderwert selbst wird nicht zurückgegeben, nur die NULL-Spalten.
Invoices und Addresses werden mit NOLOCK gelesen (Dirty Reads möglich); countries wird ohne Sperrhinweis gelesen.
Die Abfrage durchläuft alle Rechnungen; bei großen Datenbanken kann der Aufruf entsprechend dauern.

Parameter

Dieser Call hat keine Parameter.

Antwort

Result-Set 1 · Immer

Eine Zeile je eindeutigem Land aus den Rechnungsadressen, aufsteigend nach CntName sortiert.

Spalte	Typ	Beschreibung
`CntCode` Kann leer sein	string	Ländercode aus `countries`. NULL, wenn das Land der Adresse nicht in `countries` gefunden wird.
`CntName` Kann leer sein	string	Ländername aus `countries`. NULL, wenn das Land der Adresse nicht in `countries` gefunden wird.

Beispielantwort

<SqlRowSet1>
  <row>
    <CntCode>AT</CntCode>
    <CntName>Austria</CntName>
  </row>
  <row>
    <CntCode>DE</CntCode>
    <CntName>Germany</CntName>
  </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:pixiGetCountriesInvoice/>
  </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:pixiGetCountriesInvoice/>
  </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 = [
];

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

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

Verwendete Tabellen

Invoices · Lesen Addresses · Lesen countries · Lesen

SQL-Objekt:: dbo.pipiGetCountriesInvoice