Benutzer-Werkzeuge

Webseiten-Werkzeuge


engine:procedures:om_getsurchargetypetaxes

om_GetSurchargeTypeTaxes

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-MethodGET
HTTP-AuthOptional
Tags
Engine-Kategorieorder management
Engine-TypDaten-Ermittlung
Letzte Aktualisierung7.0.7 (2015-01-29)

Parameter

Name 1) Standard-Wert Beschreibung 2) SQL-Datentyp3) ab Version
SurchargeTypeIDNULL ID einer Aufschlags-/Rabattart (wie z.B. „Sonder-Rabatt“). Falls angegeben, wird nur die Steuersatz-Konfiguration dieses „SurchargeTypes“ ermittelt.
smallint6.0.2
DateNULL Zeitpunkt, zu dem die gültige Steuersatz-Konfiguration ermittelt werden soll. Bei Angabe von „NULL“ wird die aktuell gültige Konfiguration ermittelt.
datetime6.0.2

Rückgabe

(parameterunabhängig)

Spaltenname Beschreibung SQL-Datentyp4) ab Version
SurchargeTypeIDDie ID einer Rabatt-/Aufschlagsart zu dem der Steuersatz „TaxRate“ hinterlegt ist
smallint6.0.2
ValidFromDer Zeitpunkt, ab dem der Steuersatz „TaxRate“ gültig ist
datetime6.0.2
ValidToDer Zeitpunkt, bis zu dem der Steuersatz „TaxRate“ gültig ist
datetime6.0.2
TaxRateDer im Zeitraum „ValidFrom“ bis „ValidTo“ hinterlegte Steuersatz als Prozent-Angabe
decimal(5,2)6.0.2
TaxRateIDDie ID der „TaxRate“
tinyint6.0.2
TaxRateDescriptionDie Beschreibung des Steuersatzes (z.B. „Normalsteuersatz“)
varchar(100)6.0.2
Sortierung der Rückgabe

(parameterunabängige Sortierung)

  • ValidFrom (aufsteigend)

Output-Parameter

Die Prozedur hat keine Output-Parameter.

Mögliche Return-Codes

Code Beschreibung Quelle 5)
-569Der Benutzer hat kein Ausführungsrecht für die Prozedurnur indirekt
-567Die Prozedur darf z. Zt. nicht ausgeführt werdennur indirekt
-566Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werdennur indirekt
-535Das Datum liegt nicht in der Vergangenheitnur indirekt
-530Der Wert ist nicht konvertierbarnur indirekt
-510Der Benutzer ist nicht registriertnur indirekt
-504Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochennur indirekt
-500Falsche Parameternur indirekt

XML-Schema

Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.

Historie

7.0.7 2015-01-29„Start-/Finish-Procedure“-Logik eingebaut, s. Ticket #3670
6.0.2 2011-06-08Erstmalig in dieser Version erstellt

Code-Snippets

Engine Playground

Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:

cURL

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 -
dStore_php
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();
engine/execute

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>
1)
Pflichtparameter sind unterstrichen
5)
direkt meint „von der Prozedur selber“ und indirekt meint „von intern aufgerufenen Unterprozeduren“
6)
I.d.R. auf Unix-artigen Systemen bereits installiert, Bestandteil der libxml2, siehe http://www.xmlsoft.org
engine/procedures/om_getsurchargetypetaxes.txt · Zuletzt geändert: 11.01.2016 (Externe Bearbeitung)