Postman-Collection
Payments Lesen

pixiDatevExportPosWires

Liefert POS-Barzahlungen und optional Kassensitzungs-Ereignisse eines Zeitraums als Buchungszeilen für einen DATEV-Export.

Der Aufruf gibt alle Parameter unverändert an die interne Prozedur Pixi_DatevExportPOSWires weiter und liefert deren Ergebnis. Jede Zeile ist eine Buchungszeile für einen DATEV-Export.

Zeitraum

  • DateFrom wird auf den Tagesbeginn gesetzt.
  • DateTo wird auf das Tagesende gesetzt.
  • Berücksichtigt werden Datensätze, deren Datum zwischen DateFrom und einer Sekunde vor dem angepassten DateTo liegt.

Teil 1 – POS-Zahlungen (POSPayment, verknüpft mit Kassenbon-Kopf und Kundenadresse)

  • Ist die Einstellung ConsiderAllPosEvents 0 (Standard), werden nur Zahlungen mit Zahlungscode B exportiert. Ist sie 1, werden Zahlungen mit allen Zahlungscodes exportiert.
  • ShopId filtert auf den Shop der Kundenadresse (AddrShopID).
  • Country filtert auf die Spalte Country.
  • AmoutFrom / AmoutTo filtern auf den Absolutbetrag; beide Grenzen sind inklusiv.
  • Sign ist das Minuszeichen bei Zahlungscode - (Wechselgeld) oder negativem Betrag, sonst das Pluszeichen.
  • CustomerNr sind die ersten 10 Zeichen der externen Kundennummer. Ist diese leer, wird die Einstellung DefaultCustomerAccountNumber verwendet, sonst 0.
  • InvoiceNr ist die Belegnummer des Kassenbons.
  • WireText ist Change bei Zahlungscode -, sonst leer.

Teil 2 – Sitzungsereignisse (POSSession_event)

  • Nur enthalten, wenn ConsiderAllPosEvents 1 ist.
  • Umfasst die Ereignistypen D (Drawer Open), E (Session Stop) und S (Session Start) im Zeitraum.
  • ShopId, Country und die Betragsfilter gelten für diesen Teil nicht.
  • Amount ist der Absolutwert aus Einnahme minus Ausgabe. Sign ist Plus, wenn die Differenz ≥ 0 ist, sonst Minus.
  • CustomerNr ist das Standard-Kundenkonto. InvoiceNr ist leer.
  • WireText ist der Ereignisname, gefolgt von - und dem Ereigniskommentar, falls vorhanden.

Vorzeichen

Ist die Einstellung BookExportDatevPro gesetzt (nicht 0), lauten die Vorzeichen s (Soll) und h (Haben). Andernfalls lauten sie + und -.

Gemeinsame Spalten

  • Currency ist immer EUR.
  • BankAccountNr ist die Einstellung AccountNumberPOSPayment, oder 0, falls sie nicht gesetzt ist.
  • Die Spalten Empty1–Empty6 sind leere Platzhalter für das DATEV-Dateiformat.

Sortierung: BankAccountNr, dann BankDate, dann Sign absteigend.

Hinweise

  • Die Parameternamen AmoutFrom und AmoutTo sind im Code falsch geschrieben (fehlendes n). Sie müssen genau so übergeben werden.
  • Das Verhalten hängt von den Einstellungen BookExportDatevPro, AccountNumberPOSPayment, DefaultCustomerAccountNumber und ConsiderAllPosEvents ab. Diese werden zur Laufzeit über dbo.SettingGet gelesen.
  • Die genauen Tagesgrenzen stammen aus fPixi_GetDateStartOfDay / fPixi_GetDateEndOfDay, die nicht beiliegen. Laut Code-Kommentar wird vom Ende eine Sekunde abgezogen, damit Zeilen mit 00:00:00 nicht doppelt exportiert werden.
  • Beide Teile werden mit UNION statt UNION ALL zusammengeführt. Vollständig identische Zeilen erscheinen daher nur einmal. Das kann zum Beispiel bei zwei gleichen Zahlungen auf demselben Bon zur selben Zeit vorkommen.
  • Alle Tabellen werden mit NOLOCK gelesen; nicht festgeschriebene Daten können enthalten sein.
  • Der Filter ShopId trifft nur Zahlungen mit verknüpfter Kundenadresse.
  • Die Währung wird immer als EUR ausgegeben, unabhängig von der tatsächlichen Zahlungswährung.
  • Nur lesend; es werden keine Daten geändert.

Parameter

Parameter Typ Standardwert Beschreibung
DateFrom
Pflicht
datetime
dateTime
–

Beginn des Zeitraums. Wird auf den Tagesbeginn gesetzt.

Beispiel: 2024-03-01T00:00:00

DateTo
Pflicht
datetime
dateTime
–

Ende des Zeitraums. Wird auf das Tagesende gesetzt, der angegebene Tag ist also enthalten.

Beispiel: 2024-03-31T00:00:00

ShopId
varchar(3)
string
NULL

Optionaler Shop-Filter auf den Shop der Kundenadresse (AddrShopID). Gilt nur für POS-Zahlungen, nicht für Sitzungsereignisse.

Beispiel: 001

Country
varchar(3)
string
NULL

Optionaler Filter auf die Spalte Country. Gilt nur für POS-Zahlungen.

Beispiel: DE

AmoutFrom
money
decimal
NULL

Optionaler Mindest-Absolutbetrag der Zahlung (inklusiv). Gilt nur für POS-Zahlungen. Schreibweise beachten.

Beispiel: 0.01

AmoutTo
money
decimal
NULL

Optionaler Höchst-Absolutbetrag der Zahlung (inklusiv). Gilt nur für POS-Zahlungen. Schreibweise beachten.

Beispiel: 10000.00

Antwort

Result-Set 1 · Immer (ggf. leer).

DATEV-Buchungszeilen für POS-Zahlungen und, abhängig von ConsiderAllPosEvents, Sitzungsereignisse. Sortiert nach BankAccountNr, BankDate, Sign absteigend.

Spalte Typ Beschreibung
Currency varchar(3)
string

Immer EUR.

Sign char(1)
string

+/-, bzw. s/h, wenn BookExportDatevPro aktiv ist.

Amount
Kann leer sein
money
decimal

Absolutbetrag der Zahlung bzw. Einnahme minus Ausgabe bei Sitzungsereignissen.

Empty1 varchar(1)
string

Leerer Platzhalter.

CustomerNr varchar(255)
string

Externe Kundennummer (max. 10 Zeichen), sonst Standard-Kundenkonto oder 0.

InvoiceNr
Kann leer sein
string

Belegnummer des Kassenbons; leer bei Sitzungsereignissen.

Empty2 varchar(1)
string

Leerer Platzhalter.

BankDate datetime
dateTime

Bondatum bzw. Ereigniszeitpunkt.

BankAccountNr varchar(255)
string

Wert der Einstellung AccountNumberPOSPayment oder 0.

Empty3 varchar(1)
string

Leerer Platzhalter.

Empty4 varchar(1)
string

Leerer Platzhalter.

Empty5 varchar(1)
string

Leerer Platzhalter.

Empty6 varchar(1)
string

Leerer Platzhalter.

WireText varchar
string

Change bei Wechselgeld; bei Sitzungsereignissen Drawer Open, Session Stop oder Session Start, ergänzt um - und den Kommentar, falls vorhanden; sonst leer.

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:pixiDatevExportPosWires>
      <DateFrom>2024-03-01T00:00:00</DateFrom>
      <DateTo>2024-03-31T00:00:00</DateTo>
      <!-- <ShopId>001</ShopId> -->
      <!-- <Country>DE</Country> -->
      <!-- <AmoutFrom>0.01</AmoutFrom> -->
      <!-- <AmoutTo>10000.00</AmoutTo> -->
    </ns1:pixiDatevExportPosWires>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

POSPayment · Lesen POSheader2 · Lesen Addresses · Lesen POSSession_event · Lesen
SQL-Objekt:
dbo.pipiDatevExportPosWires
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben