Gibt die konfigurierten Steuersätze zu Aufschlags-/Rabattarten zurück.
Hinweise :
Der „dStore“ versteht „SurchargeTypes“ oder kurz „Surcharges“ („Aufschläge“) als Prinzip, um zusätzlich entstehende Kosten oder aber Formen von Rabatten abzubilden - diese können sowohl relativ (also prozentual) als auch absolut angegeben werden. Rabatte zeichnen sich einfach dadurch aus, daß die Kosten mit negativem Vorzeichen behaftet sind.
Es handelt sich also um Dinge wie Versandkosten, Skonti, Guthabenverrechnung oder ein Positions- oder Auftrags-Rabatt. Steuerlich müssen oder können diese ganz unterschiedlich behandelt werden, wozu eben genau die Konfiguration von Steuersätzen zu Aufschlags-/Rabattarten notwendig ist. Neben der simplen Hinterlegung eines festen Steuersatzes zu einem „SurchargeType“ gibt es zwei Besonderheiten :
a) KEIN fester Steuersatz. Dies bedeutet, daß es sich bei dem „Surcharge“ um eine „Nebendienstleistung“ oder ein „Gesamt-Rabatt“ handelt, der steuerlich das „Schicksal der Hauptdienstleistung“ teilen muß, sprich der oder die (!) Steuersatz/Steuersätze werden dynamisch aufgrund des/der im Warenwert vorhandenen Steuersatzes/Steuersätze ermittelt (und im Falle mehrerer Steuersätze ihren Anteilen entsprechend auf den „Surcharge“ angewandt).
b) Ein Steuersatz von „0 Prozent“. Dies bedeutet, daß keine Steuern anfallen. Dies MUSS bei einer Guthabenverrechnung konfiguriert sein (diese ist ja quasi nur ein weiteres „Zahlungsmittel“ und soll nur den zu zahlenden Betrag nicht aber den Rechnungs-Betrag reduzieren), kann theoretisch aber auch bei einer anderen „Dienstleistung“ konfiguriert werden, die von der Steuer befreit ist (wie z.B. die Versandkosten der DHL).
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | order management |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
SurchargeTypeID | NULL | ID einer Aufschlags-/Rabattart (wie z.B. „Sonder-Rabatt“). Falls angegeben, wird nur die Steuersatz-Konfiguration dieses „SurchargeTypes“ ermittelt. | smallint | 6.0.2 |
Date | NULL | Zeitpunkt, zu dem die gültige Steuersatz-Konfiguration ermittelt werden soll. Bei Angabe von „NULL“ wird die aktuell gültige Konfiguration ermittelt. | datetime | 6.0.2 |
Spaltenname | Beschreibung | SQL-Datentyp4) | ab Version |
---|---|---|---|
SurchargeTypeID | Die ID einer Rabatt-/Aufschlagsart zu dem der Steuersatz „TaxRate“ hinterlegt ist | smallint | 6.0.2 |
ValidFrom | Der Zeitpunkt, ab dem der Steuersatz „TaxRate“ gültig ist | datetime | 6.0.2 |
ValidTo | Der Zeitpunkt, bis zu dem der Steuersatz „TaxRate“ gültig ist | datetime | 6.0.2 |
TaxRate | Der im Zeitraum „ValidFrom“ bis „ValidTo“ hinterlegte Steuersatz als Prozent-Angabe | decimal(5,2) | 6.0.2 |
TaxRateID | Die ID der „TaxRate“ | tinyint | 6.0.2 |
TaxRateDescription | Die Beschreibung des Steuersatzes (z.B. „Normalsteuersatz“) | varchar(100) | 6.0.2 |
(parameterunabängige Sortierung)
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 5) |
---|---|---|
-569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
-567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
-566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-510 | Der Benutzer ist nicht registriert | nur indirekt |
-504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | nur indirekt |
-500 | Falsche Parameter | nur indirekt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
7.0.7 | 2015-01-29 | „Start-/Finish-Procedure“-Logik eingebaut, s. Ticket #3670 |
6.0.2 | 2011-06-08 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/om_GetSurchargeTypeTaxes'
Mit xmllint 6) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/om_GetSurchargeTypeTaxes' | xmllint --format -
use dStore_php\WebService; $service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80); $request = new WebService\Requests\Engine\Procedure\Request( new WebService\Requests\AccessData('default'), 'om_GetSurchargeTypeTaxes', array( // 'SurchargeTypeID' => NULL, // 'Date' => NULL ) ); $service->execute($request); $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); $ResultSet = $xml_result->getRowsAsArray();
XML zur Ausführung mit der Methode engine/execute, z.B. per
curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'
<?xml version="1.0" encoding="UTF-8"?> <ListOfBatches> <Batch No="0"> <Procedure Name="om_GetSurchargeTypeTaxes"> <Parameters> <!-- <Parameter Name="SurchargeTypeID">NULL</Parameter> --> <!-- <Parameter Name="Date">NULL</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>