Invoices Lesen

pixiGetInvoiceShippingReport

Liefert alle Rechnungen eines Zeitraums mit DATEV-Kontonummer des Kunden und Lieferadresse, optional gefiltert nach Shop.

Listet Rechnungen zusammen mit der DATEV-Kontonummer des Kunden und der Lieferadresse der Rechnung auf. Laut Kopfkommentar wurde der Aufruf für einen bestimmten Kunden ("Customer LLL") erstellt.

Ablauf:

Eine leere ShopID wird wie NULL behandelt und bedeutet damit alle Shops.
Ohne DateFrom wird der Tagesbeginn (00:00:00) vor 30 Tagen verwendet.
Ohne DateTo wird das Ende des aktuellen Tages (23:59:59.997) verwendet.
Die Rechnungen stammen aus der Sicht bzw. Tabelle PV_Rechnungen. Zurückgegeben werden nur Rechnungen mit Rechnungsdatum >= DateFrom und Rechnungsdatum < DateTo. Die Obergrenze ist exklusiv.
Jede Rechnung wird über die Rechnungsnummer mit Invoices verknüpft. Von dort werden der Kunde (Customers, für die DATEV-Kontonummer) und die Lieferadresse (Addresses über ShipAdrRef) gelesen. Der Ländername stammt aus Countries.
Ist ShopID gesetzt, werden nur Rechnungen mit passender InvShopID geliefert.

Das Ergebnis hat keine definierte Sortierung und kein Paging.

Hinweise

Alle Tabellen werden mit NOLOCK gelesen. Das Ergebnis kann nicht festgeschriebene Daten enthalten.
DateTo wird mit < verglichen. Bei einem reinen Datum wie 2024-03-31T00:00:00 sind Rechnungen dieses Tages nicht enthalten. Um sie einzuschließen, den Folgetag oder eine Uhrzeit am Tagesende übergeben.
Die Verknüpfungen sind LEFT JOINs. Ohne Shop-Filter werden auch Rechnungen ohne passenden Eintrag in Invoices, Customers, Addresses oder Countries geliefert, mit NULL in den fehlenden Spalten. Mit Shop-Filter fallen Rechnungen ohne passende Invoices-Zeile weg.
Firma wird aus dem Feld CareOf der Adresse befüllt.
PV_Rechnungen liegt nicht vor. Ob es sich um eine Sicht handelt und wie sie die Rechnungen auswählt, ist aus dem Code nicht ersichtlich.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ShopID`	varchar(3) string	NULL	Shop-ID als Filter (`InvShopID` der Rechnung). `NULL` oder leer liefert Rechnungen aller Shops. Beispiel: `SHP`
`DateFrom`	datetime dateTime	NULL	Beginn des Zeitraums (inklusive), verglichen mit dem Rechnungsdatum. Bei `NULL` wird der Tagesbeginn vor 30 Tagen verwendet. Beispiel: `2024-03-01T00:00:00`
`DateTo`	datetime dateTime	NULL	Ende des Zeitraums (exklusiv), verglichen mit dem Rechnungsdatum. Bei `NULL` wird das Ende des aktuellen Tages (23:59:59.997) verwendet. Beispiel: `2024-04-01T00:00:00`

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile je Rechnung im Zeitraum, mit DATEV-Kontonummer des Kunden und Lieferadresse.

Spalte	Typ	Beschreibung
`Datevnummer` Kann leer sein	varchar(10) string	DATEV-Kontonummer des Kunden (`Customers.DatevAccNr`).
`Rechnungsnummer`	string	Rechnungsnummer aus `PV_Rechnungen`.
`Vorname` Kann leer sein	string	Vorname der Lieferadresse.
`Nachname` Kann leer sein	string	Nachname der Lieferadresse.
`Firma` Kann leer sein	string	Firma bzw. c/o-Zeile der Lieferadresse (`CareOf`).
`Strasse` Kann leer sein	string	Straße der Lieferadresse.
`PLZ` Kann leer sein	string	Postleitzahl der Lieferadresse.
`Stadt` Kann leer sein	string	Ort der Lieferadresse.
`Land` Kann leer sein	string	Ländername der Lieferadresse (`Countries.CntName`).
`eMail` Kann leer sein	string	In der Lieferadresse hinterlegte E-Mail-Adresse.

Beispielantwort

<SqlRowSet1>
  <row>
    <Datevnummer>10045</Datevnummer>
    <Rechnungsnummer>RE2024001234</Rechnungsnummer>
    <Vorname>Anna</Vorname>
    <Nachname>Müller</Nachname>
    <Firma>Müller GmbH</Firma>
    <Strasse>Hauptstraße 12</Strasse>
    <PLZ>80331</PLZ>
    <Stadt>München</Stadt>
    <Land>Deutschland</Land>
    <eMail>anna.mueller@example.com</eMail>
  </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:pixiGetInvoiceShippingReport>
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <DateFrom>2024-03-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-04-01T00:00:00</DateTo> -->
    </ns1:pixiGetInvoiceShippingReport>
  </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:pixiGetInvoiceShippingReport>
      <!-- <ShopID>SHP</ShopID> -->
      <!-- <DateFrom>2024-03-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-04-01T00:00:00</DateTo> -->
    </ns1:pixiGetInvoiceShippingReport>
  </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' => 'SHP',
    // 'DateFrom' => '2024-03-01T00:00:00',
    // 'DateTo' => '2024-04-01T00:00:00',
];

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

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

Verwendete Tabellen

PV_Rechnungen · Lesen Invoices · Lesen Customers · Lesen Addresses · Lesen Countries · Lesen

SQL-Objekt:: dbo.pipiGetInvoiceShippingReport