pixiGetInvoiceLines

Liefert alle Positionen einer Rechnung mit Artikel-, Auftragspositions-, Preis-, MwSt.-, Chargen- und Streckendaten, optional inklusive Versandkosten-, Gutschein- und manueller Rechnungszeilen.

Liefert die Rechnungspositionen der Rechnung, deren Nummer exakt InvoiceNr entspricht. Die Daten stammen aus der Reporting-View PV_Invlines, die echte Rechnungspositionen mit künstlichen Zeilen für Beträge auf Rechnungsebene kombiniert. Jede Zeile wird um Daten der Auftragsposition (BatchNumber, BestBeforeDate, TaxRate als VATPercent) und des Artikels (PicLinkLarge) ergänzt.

Sonderzeilen (gesteuert über IncludeSpecialInvLines):

• -2: Versandkosten der Rechnung (ArtName = ZZZ Versandkosten), nur wenn die Versandkosten ungleich 0 sind.
• -1: Gutscheine (ArtName = ZZZ Gutscheine), Preis als negative Gutscheinsumme.
• -3: manuelle Rechnung ohne Rechnungspositionen (ArtName = ZZZ Manuelle Rechnung ohne Artikel), Betrag = Rechnungssumme abzüglich Versandkosten.

Mit IncludeSpecialInvLines = 0 (Standard) werden diese Zeilen ausgeschlossen, mit 1 werden sie mitgeliefert. Bei Sonderzeilen enthält OrderLineKey den Sonderwert (-1, -2, -3), ItemQty ist 1 und die meisten Artikel-/Auftragsfelder (InvoiceLineKey, ArtNr, OrderNr, BoxNr, …) sind NULL.

ItemPriceNoVAT ist der Nettopreis, gerundet auf die Anzahl Nachkommastellen aus der Einstellung PrintInvLineMoneyPrecision (2, wenn die Einstellung fehlt oder 0 ist). Eine Sortierung findet nicht statt.

Parameter

Antwort

Result-Set 1 · Immer (leer, wenn die Rechnungsnummer nicht existiert).

Eine Zeile je Rechnungsposition der angeforderten Rechnung.

<SqlRowSet1>
  <row>
    <InvoiceLineKey>554321</InvoiceLineKey>
    <InvoiceNr>100123</InvoiceNr>
    <OrderLineKey>887766</OrderLineKey>
    <ArtNr>A-1001</ArtNr>
    <ArtName>T-Shirt blau M</ArtName>
    <ItemQty>2</ItemQty>
    <ItemPrice>19.9900</ItemPrice>
    <ItemNrInt>A-1001</ItemNrInt>
    <EanUpc>4012345678901</EanUpc>
    <OrderNr>50077</OrderNr>
    <OrderNrExternal>SHOP-98765</OrderNrExternal>
    <ItemPriceNoVAT>16.8000</ItemPriceNoVAT>
    <VATPercent>19.00</VATPercent>
    <VATAmount>3.1900</VATAmount>
  </row>
  <row>
    <InvoiceNr>100123</InvoiceNr>
    <OrderLineKey>-2</OrderLineKey>
    <ArtName>ZZZ Versandkosten</ArtName>
    <ItemNrInt/>
    <EanUpc/>
    <ItemQty>1</ItemQty>
    <ItemPrice>4.9500</ItemPrice>
    <ItemPriceNoVAT>4.1600</ItemPriceNoVAT>
    <VATAmount>0.7900</VATAmount>
  </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:pixiGetInvoiceLines>
      <InvoiceNr>100123</InvoiceNr>
      <!-- <IncludeSpecialInvLines>1</IncludeSpecialInvLines> -->
    </ns1:pixiGetInvoiceLines>
  </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:pixiGetInvoiceLines>
      <InvoiceNr>100123</InvoiceNr>
      <!-- <IncludeSpecialInvLines>1</IncludeSpecialInvLines> -->
    </ns1:pixiGetInvoiceLines>
  </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 = [
    'InvoiceNr' => '100123',
    // 'IncludeSpecialInvLines' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetInvoiceLines

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben