pixiGetDatevExportWires

Liefert die DATEV-Exportzeilen für Zahlungen (Bankbuchungen und Kundenkonto-Ereignisse) in einem Zeitraum, optional gefiltert nach Shop, Land, Bankkonto, Betragsbereich und Kostenstelle.

Erzeugt den Inhalt der DATEV-Exportdatei "Payment" (Zahlungen).

1. Die Einstellung BookExportDatevActive wird geprüft. Ist sie nicht 1, wird nur eine Statuszeile mit Status = ERROR geliefert.
2. Andernfalls wird die interne Prozedur Pixi_DatevExportWires mit den übergebenen Parametern und SetStartAndEndOfDay = 0 ausgeführt, d. h. DateFrom und DateTo werden genau wie übergeben verwendet, ohne Erweiterung auf Tagesanfang/-ende.

Das Ergebnis kombiniert zwei Quellen (UNION ALL):

Bankbuchungen (BankLines)

• Bankbuchungen mit BankDate zwischen DateFrom und DateTo (inklusive). Ist die Einstellung BookExportWiresWithBookDate = 1, wird das Datum aus dem Buchungsdatum der Bankbuchung (MMTT plus Jahr, mit Korrektur beim Jahreswechsel) abgeleitet; dafür wird ein Fenster von zwei Wochen vor/nach dem Zeitraum gelesen.
• Bankbuchungen aus Bankköpfen mit Quelltyp APY werden immer ausgeschlossen; CCP nur bei gesetzter Einstellung BookExportCcpTransactions; UPD und Geschäftsvorfall 020 nur bei gesetzter Einstellung BookExportUpdTransactions.
• Kunde, Shop und Rechnung werden über die endgültige (kein Prematch) Bankzuordnung ermittelt: Rechnung, Auftrag, Lastschrift (DTAUS) oder Kundenkontoeintrag, in dieser Reihenfolge.
• CustomerNr ist die DatevAccNr des Kunden bzw. die Einstellung BookDefaultCustomerNr, wenn kein Kunde gefunden wird.
• InvoiceNr ist die externe Auftragsnummer, wenn die Zahlungsart in der Einstellung BookExportDatevUseOrderNrExternal aufgeführt ist; sonst die Rechnungsnummer (bei Lastschriften die zugeordnete Rechnung). Ersatzwert ist BookDefaultInvoiceNr; der Wert wird auf 12 Zeichen gekürzt.
• BankAccountNr ist das Buchhaltungs-Bankkonto der Bankbuchung (bei gesetzter Einstellung BookExportQueryAndUseAccountingBankAccount), das PayPal-Konto BookDefaultBankAccountNrPayPal bei Quelltyp PPL/PLL, sonst BookDefaultBankAccountNr.
• WireText setzt sich aus externer Auftragsnummer, Banktexten 1–3 und bei Kreditkartenzahlungen Kreditkarte plus Zahlungs-ID zusammen; max. 60 Zeichen, doppelte Anführungszeichen werden entfernt.

Kundenkonto-Ereignisse (CustomerAccount, Ereignisse RPP, RCC, BTC)

• Ereignisse mit EventDate >= DateFrom und < DateTo.
• Enthalten, wenn eine manuelle Buchung verknüpft ist oder wenn die Einstellung BookExportDatevExportAutomaticCAEvents aktiv und der Ereignistyp als manuell markiert ist; zusätzlich lastschriftbezogene Einträge mit zugeordneter Rechnung, wenn BookExportManualDtausToDatev gesetzt ist.
• BankAccountNr ist das Buchungskonto des Ereignistyps; BTC erhält das Plus-Zeichen, die übrigen das Minus-Zeichen.

Filter (beide Teile): ShopId (Shop des Kunden), CostCenter (Kostenstelle des Shops), Country (Land der Rechnungs-/Auftragsadresse bzw. Kundenadresse), AmoutFrom/AmoutTo (auf den Absolutbetrag) und BankAccountNr (auf das ermittelte Bankkonto).

Das Vorzeichen ist s/h, wenn die Einstellung BookExportDatevPro aktiv ist, sonst +/-. Sortierung nach BankAccountNr, BankDate, Amount.

Parameter

Antwort

Result-Set 1 · Wenn Einstellung BookExportDatevActive = 1

DATEV-Zahlungsexportzeilen aus Bankbuchungen und Kundenkonto-Ereignissen, sortiert nach BankAccountNr, BankDate, Amount.

Result-Set 2 · Wenn Einstellung BookExportDatevActive nicht 1 ist

Einzelne Fehler-Statuszeile.

<SqlRowSet1>
  <row>
    <Currency>EUR</Currency>
    <Sign>+</Sign>
    <Amount>119.0000</Amount>
    <Empty1/>
    <CustomerNr>10045</CustomerNr>
    <InvoiceNr>RE2024001234</InvoiceNr>
    <Empty2/>
    <BankDate>2024-01-15T00:00:00</BankDate>
    <BankAccountNr>1200</BankAccountNr>
    <Empty3/>
    <Empty4/>
    <Empty5/>
    <Empty6/>
    <WireText>WEB-50012 Zahlung Rechnung RE2024001234</WireText>
    <ExchRate>1.000000</ExchRate>
    <CostCenter>100</CostCenter>
    <OrderNrExternal>WEB-50012</OrderNrExternal>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiGetDatevExportWires>
      <DateFrom>2024-01-01T00:00:00</DateFrom>
      <DateTo>2024-01-31T23:59:59</DateTo>
      <!-- <ShopId>001</ShopId> -->
      <!-- <Country>DE</Country> -->
      <!-- <BankAccountNr>1200</BankAccountNr> -->
      <!-- <AmoutFrom>10.00</AmoutFrom> -->
      <!-- <AmoutTo>5000.00</AmoutTo> -->
      <!-- <CostCenter>100</CostCenter> -->
    </ns1:pixiGetDatevExportWires>
  </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:pixiGetDatevExportWires>
      <DateFrom>2024-01-01T00:00:00</DateFrom>
      <DateTo>2024-01-31T23:59:59</DateTo>
      <!-- <ShopId>001</ShopId> -->
      <!-- <Country>DE</Country> -->
      <!-- <BankAccountNr>1200</BankAccountNr> -->
      <!-- <AmoutFrom>10.00</AmoutFrom> -->
      <!-- <AmoutTo>5000.00</AmoutTo> -->
      <!-- <CostCenter>100</CostCenter> -->
    </ns1:pixiGetDatevExportWires>
  </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 = [
    'DateFrom' => '2024-01-01T00:00:00',
    'DateTo' => '2024-01-31T23:59:59',
    // 'ShopId' => '001',
    // 'Country' => 'DE',
    // 'BankAccountNr' => '1200',
    // 'AmoutFrom' => '10.00',
    // 'AmoutTo' => '5000.00',
    // 'CostCenter' => '100',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetDatevExportWires

Prozedur zuletzt geändert am 2026-10-05

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