Tarifwerk-Tutorial: Tarif anlegen: Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „ Dieses Tutorial soll beschreiben, wie man vorgehen kann um von einer Frachtführer-Preisliste erfolgreich einen Tarif im Tarifwerk einrichtet. == Anforderung…“)
 
Zeile 1: Zeile 1:
  
Dieses Tutorial soll beschreiben, wie man vorgehen kann um von einer Frachtführer-Preisliste erfolgreich einen Tarif im Tarifwerk einrichtet.
+
Dieses Tutorial soll die optimale Vorgehensweise beschreiben, um von einer Frachtführer-Preisliste ausgehend erfolgreich einen Tarif im Tarifwerk einzurichten.
  
== Anforderungen / Annahme ==
+
== Anforderungen ==
  
 
=== Frachtführer ===
 
=== Frachtführer ===
  
Es gibt einen Frachtführer "HSC Express". Dieser bietet europaweit einen packstückbasierten Tarif.
+
Annahme: Es gibt einen Frachtführer "HSC Express". Dieser bietet einen europaweiten packstückbasierten Tarif an.
  
 
Es können Zusatzkosten für folgende Services entstehehen: Express 12:00 Uhr, Express 15:00 Uhr und Inselzustellungen. Eine Liste von Inseln wird bereitgestellt.
 
Es können Zusatzkosten für folgende Services entstehehen: Express 12:00 Uhr, Express 15:00 Uhr und Inselzustellungen. Eine Liste von Inseln wird bereitgestellt.
Zeile 16: Zeile 16:
 
Im HVS32 gibt es folgende Versandarten für den Frachtführer HSC:
 
Im HVS32 gibt es folgende Versandarten für den Frachtführer HSC:
  
*HSC für Standardversand europaweit  
+
*"HSC" für Standardversand europaweit  
*HSC12 für Express 12:00 Uhr  
+
*"HSC12" für Express 12:00 Uhr  
*HSC15 für Express 15:00 Uhr  
+
*"HSC15" für Express 15:00 Uhr  
  
 
== Frachtführer ==
 
== Frachtführer ==
 +
 +
''Hauptartikel: [[Frachtführer_(Tarifwerk)|Frachtführer]]''
  
 
Zunächst muss der Frachtführer angelegt werden. Die Inselliste steht in der Offerte und muss entsprechend aufbereitet werden:
 
Zunächst muss der Frachtführer angelegt werden. Die Inselliste steht in der Offerte und muss entsprechend aufbereitet werden:
Zeile 37: Zeile 39:
  
 
== Zonen- und Preistabellen ==
 
== Zonen- und Preistabellen ==
 +
 +
''Hauptartikel: [[Tarifwerk_(Tarifwerk_/_Stammdaten)#Preistabelle|Preistabelle]]''
  
 
Der Frachtführer hat die Preise in Deutschland und Europa getrennt. Für den Import in das Tarifwerk muss zwischen Zonen und Preisen getrennt werden:
 
Der Frachtführer hat die Preise in Deutschland und Europa getrennt. Für den Import in das Tarifwerk muss zwischen Zonen und Preisen getrennt werden:
Zeile 91: Zeile 95:
 
=== Preise ===
 
=== Preise ===
  
Zu jeder Zone muss es einen Preisbereich geben. Innerhalb Deutschlands gibt es 9 Einzelpreise verteilt auf 10 Zonen. Das Ergibt für Deutschland insgesamt 90 Preiseinträge. Innerhalb Europas haben wir 4 Einzelpreise * 6 Zonen = 24 Preiseinträge. Insgesamt gibt es also 114 Preiseinträge.
+
Zu jeder Zone muss es einen Preisbereich geben. Innerhalb Deutschlands gibt es 9 Einzelpreise bei 10 Zonen. Das Ergibt für Deutschland insgesamt 90 Preiseinträge. Innerhalb Europas gibt es 4 Einzelpreise * 6 Zonen = 24 Preiseinträge. Insgesamt gibt es also 114 Preiseinträge.
 
<pre>Zonennummer;Bis-Bereich 1;Bis-Bereich 2;Bis-Bereich 3;Gebühr;KG Gebühr;Schrittweite KG;Max Gebühr;Basisgewicht
 
<pre>Zonennummer;Bis-Bereich 1;Bis-Bereich 2;Bis-Bereich 3;Gebühr;KG Gebühr;Schrittweite KG;Max Gebühr;Basisgewicht
 
1;0,5;0;0;1,25;0;0;0;0
 
1;0,5;0;0;1,25;0;0;0;0
Zeile 210: Zeile 214:
  
 
== Tarifwerk ==
 
== Tarifwerk ==
 +
 +
''Hauptartikel: [[Tarifwerk_(Tarifwerk_/_Stammdaten)|Tarifwerk]]''
  
 
Sobald die Zonen erstellt sind kann das Tarifwerk erstellt werden.
 
Sobald die Zonen erstellt sind kann das Tarifwerk erstellt werden.
Zeile 216: Zeile 222:
  
 
== Zuschläge ==
 
== Zuschläge ==
 +
 +
''Hauptartikel: [[Zuschlag_(Tarifwerk)|Zuschlag]]''
  
 
=== Expressdienste (Variante 1) ===
 
=== Expressdienste (Variante 1) ===
  
In Variante 1 enthalten&nbsp;die Expressdienste beide Preise in einem Zuschlag. Der Preis wird vom Script gesteuert. Das hat den Vorteil das am Ende nur ein Tarif erzeugt werden muss.
+
In Variante 1 enthalten&nbsp;die Expressdienste beide Preise in einem Zuschlag. Der Preis wird von einem [[Script_(Tarifwerk)|Script]] gesteuert. Das hat den Vorteil das am Ende nur ein Tarif erstellt werden muss.
  
 
[[File:TW Beispiel ZS V1.png|RTENOTITLE]]
 
[[File:TW Beispiel ZS V1.png|RTENOTITLE]]
Zeile 236: Zeile 244:
 
=== Expressdienste (Variante 2) ===
 
=== Expressdienste (Variante 2) ===
  
In Variante 2 wird pro Versandart ein Tarif erstellt. Das hat den Vorteil, dass wir für die Expressdienste gar kein Script erstellen müssen
+
In Variante 2 wird pro Versandart ein Tarif erstellt. Das hat den Vorteil, dass für die Expressdienste gar kein Script erstellt werden&nbsp;muss. Allerdings muss dann pro Versandart (HSC, HSC12, HSC15) ein Tarif erstellt werden.
 +
 
 +
Es muss also ein Zuschlag für HSC Express 12:00 und ein Zuschlag für HSC Express 15:00 erstellt werden&nbsp;(hier nicht gezeigt).
  
 
[[File:TW Beispiel ZS V2.png|RTENOTITLE]]
 
[[File:TW Beispiel ZS V2.png|RTENOTITLE]]
 
Ein Zuschlag für HSC Express 15:00 muss ebenfalls erstellt werden (hier nicht gezeigt).
 
  
 
=== Inselzuschlag ===
 
=== Inselzuschlag ===
  
Den Inselzuschlag müssen wir per Script steuern. Zum Glück ist das aber ein Einzeiler.
+
Der Inselzuschlag muss per Script gesteuert werden. Das ist jedoch ein Einzeiler:
 +
<pre>shipment.isIsle()</pre>
  
 
[[File:TW Beispiel ZS IS.png|RTENOTITLE]]
 
[[File:TW Beispiel ZS IS.png|RTENOTITLE]]
  
Das Script hat folgenden Inhalt:
+
== Tarife ==
<pre>shipment.isIsle()</pre>
 
  
== Tarife ==
+
''Hauptartikel: [[Tarif_(Tarifwerk)|Tarif]]''
  
Je nach Variante müssen entweder ein oder drei Tarife erstellt werdenn
+
Je nach gewählter Variante bei den Zuschlägen&nbsp;müssen entweder ein oder drei Tarife erstellt werden.
  
 
=== Variante 1 ===
 
=== Variante 1 ===
  
In Variante 1 muss nur ein Tarif erstellt werden, da die vorhin angelegten Scripte die Zuschläge selbst steuern.
+
In Variante 1 muss nur ein Tarif erstellt werden, da die Scripte in den vorhin angelegten Zuschlägen sich&nbsp;selbst steuern.
  
 
[[File:TW Beispiel TF.png|RTENOTITLE]]
 
[[File:TW Beispiel TF.png|RTENOTITLE]]
Zeile 293: Zeile 301:
  
 
Fertig. Der Tarif kann nun Verwendet werden.
 
Fertig. Der Tarif kann nun Verwendet werden.
 +
 +
&nbsp;
  
 
=== Variante 2 ===
 
=== Variante 2 ===
  
In Variante 2 haben wir jeweils einen Zuschlag für die Expressdienste eingerichtet. Diese beinhalten keine Logik. Deswegen müssen wir jetzt drei Tarife anlegen.
+
In Variante 2 wurde jeweils ein&nbsp;Zuschlag für die Expressdienste eingerichtet. Diese beinhalten keine Logik. Deswegen müssen jetzt drei Tarife anlegt werden (eine pro Versandart).
  
 
Generell wird der Tarif ähnlich wie in Variante 1 angelegt. Deswegen werden hier nur die Unterschiede aufgelistet.
 
Generell wird der Tarif ähnlich wie in Variante 1 angelegt. Deswegen werden hier nur die Unterschiede aufgelistet.

Version vom 24. Februar 2017, 17:45 Uhr

Dieses Tutorial soll die optimale Vorgehensweise beschreiben, um von einer Frachtführer-Preisliste ausgehend erfolgreich einen Tarif im Tarifwerk einzurichten.

Anforderungen

Frachtführer

Annahme: Es gibt einen Frachtführer "HSC Express". Dieser bietet einen europaweiten packstückbasierten Tarif an.

Es können Zusatzkosten für folgende Services entstehehen: Express 12:00 Uhr, Express 15:00 Uhr und Inselzustellungen. Eine Liste von Inseln wird bereitgestellt.

RTENOTITLE

HVS32

Im HVS32 gibt es folgende Versandarten für den Frachtführer HSC:

  • "HSC" für Standardversand europaweit
  • "HSC12" für Express 12:00 Uhr
  • "HSC15" für Express 15:00 Uhr

Frachtführer

Hauptartikel: Frachtführer

Zunächst muss der Frachtführer angelegt werden. Die Inselliste steht in der Offerte und muss entsprechend aufbereitet werden:

COUNTRY;ZIPFROM;ZIPTO
DE;25859;25859
DE;25938;25938
DE;25996;25999
FR;17580;17580
FR;85330;85330
GB;IM1000;IM9999
GB;PH3100;PH4499

Danach kann der Frachtführer angelegt werden:

RTENOTITLE

Zonen- und Preistabellen

Hauptartikel: Preistabelle

Der Frachtführer hat die Preise in Deutschland und Europa getrennt. Für den Import in das Tarifwerk muss zwischen Zonen und Preisen getrennt werden:

Zonen

Innerhalb Deutschlands muss pro PLZ-Bereich eine neue Zone erstellt werden. Innerhalb Europas teilen sich mehrere Länder eine Zone. Deswegen kann z.B. die Zonennummer bei Österreich und Frankreich gleich bleiben.

Zonennummer;LKZ;VonPLZ;BisPLZ;LandGruppe
1;DE;10000;19999;
2;DE;20000;29999;
3;DE;30000;39999;
4;DE;40000;49999;
5;DE;50000;59999;
6;DE;60000;69999;
7;DE;70000;79999;
8;DE;80000;89999;
9;DE;90000;99999;
10;DE;0;09999;
11;AT;0;9999;
11;FR;0;99999;
11;NL;0;ZZZZZZZ;
12;BA;0;99999;
12;BE;0;9999;
12;BG;0;9999;
12;CZ;0;999999;
12;DK;0;9999;
12;EE;0;99999;
12;ES;0;99999;
13;JE;0;ZZZZZZZZ;
13;LT;0;ZZZZZZZZ;
13;LU;0;9999;
13;LV;0;ZZZZZZZ;
13;MC;0;99999;
14;GB;0;ZZZZZZZZ;
14;GR;0;999999;
14;HR;0;99999;
14;HU;0;9999;
14;IE;0;ZZZZZZZZ;
14;IS;0;999;
14;IT;0;99999;
15;NO;0;9999;
15;PL;0;999999;
15;PT;0;99999999;
15;RO;0;999999;
15;SE;0;999999;
15;SI;0;9999;
15;SK;0;999999;
16;VA;0;99999;
16;RS;0;99999;
16;GG;0;ZZZZZZZZ;
16;IM;0;ZZZZZZZZ;
16;FI;0;99999;

Preise

Zu jeder Zone muss es einen Preisbereich geben. Innerhalb Deutschlands gibt es 9 Einzelpreise bei 10 Zonen. Das Ergibt für Deutschland insgesamt 90 Preiseinträge. Innerhalb Europas gibt es 4 Einzelpreise * 6 Zonen = 24 Preiseinträge. Insgesamt gibt es also 114 Preiseinträge.

Zonennummer;Bis-Bereich 1;Bis-Bereich 2;Bis-Bereich 3;Gebühr;KG Gebühr;Schrittweite KG;Max Gebühr;Basisgewicht
1;0,5;0;0;1,25;0;0;0;0
1;1;0;0;1,75;0;0;0;0
1;2;0;0;2,05;0;0;0;0
1;3;0;0;2,38;0;0;0;0
1;4;0;0;2,44;0;0;0;0
1;5;0;0;2,79;0;0;0;0
1;10;0;0;3,2;0;0;0;0
1;20;0;0;4,8;0;0;0;0
1;30;0;0;5,6;0;0;0;0
2;0,5;0;0;1;0;0;0;0
2;1;0;0;1,4;0;0;0;0
2;2;0;0;1,64;0;0;0;0
2;3;0;0;1,9;0;0;0;0
2;4;0;0;1,95;0;0;0;0
2;5;0;0;2,23;0;0;0;0
2;10;0;0;2,56;0;0;0;0
2;20;0;0;3,84;0;0;0;0
2;30;0;0;4,48;0;0;0;0
3;0,5;0;0;0,8;0;0;0;0
3;1;0;0;1,12;0;0;0;0
3;2;0;0;1,31;0;0;0;0
3;3;0;0;1,52;0;0;0;0
3;4;0;0;1,56;0;0;0;0
3;5;0;0;1,79;0;0;0;0
3;10;0;0;2,05;0;0;0;0
3;20;0;0;3,07;0;0;0;0
3;30;0;0;3,58;0;0;0;0
4;0,5;0;0;1,5;0;0;0;0
4;1;0;0;2,1;0;0;0;0
4;2;0;0;2,46;0;0;0;0
4;3;0;0;2,86;0;0;0;0
4;4;0;0;2,93;0;0;0;0
4;5;0;0;3,35;0;0;0;0
4;10;0;0;3,84;0;0;0;0
4;20;0;0;5,76;0;0;0;0
4;30;0;0;6,72;0;0;0;0
5;0,5;0;0;1,8;0;0;0;0
5;1;0;0;2,52;0;0;0;0
5;2;0;0;2,95;0;0;0;0
5;3;0;0;3,43;0;0;0;0
5;4;0;0;3,51;0;0;0;0
5;5;0;0;4,02;0;0;0;0
5;10;0;0;4,61;0;0;0;0
5;20;0;0;6,91;0;0;0;0
5;30;0;0;8,06;0;0;0;0
6;0,5;0;0;1,98;0;0;0;0
6;1;0;0;2,77;0;0;0;0
6;2;0;0;3,25;0;0;0;0
6;3;0;0;3,77;0;0;0;0
6;4;0;0;3,86;0;0;0;0
6;5;0;0;4,42;0;0;0;0
6;10;0;0;5,07;0;0;0;0
6;20;0;0;7,6;0;0;0;0
6;30;0;0;8,87;0;0;0;0
7;0,5;0;0;1,26;0;0;0;0
7;1;0;0;1,76;0;0;0;0
7;2;0;0;2,07;0;0;0;0
7;3;0;0;2,4;0;0;0;0
7;4;0;0;2,46;0;0;0;0
7;5;0;0;2,81;0;0;0;0
7;10;0;0;3,23;0;0;0;0
7;20;0;0;4,84;0;0;0;0
7;30;0;0;5,64;0;0;0;0
8;0,5;0;0;1,5;0;0;0;0
8;1;0;0;2,1;0;0;0;0
8;2;0;0;2,46;0;0;0;0
8;3;0;0;2,86;0;0;0;0
8;4;0;0;2,93;0;0;0;0
8;5;0;0;3,35;0;0;0;0
8;10;0;0;3,84;0;0;0;0
8;20;0;0;5,76;0;0;0;0
8;30;0;0;6,72;0;0;0;0
9;0,5;0;0;0,75;0;0;0;0
9;1;0;0;1,05;0;0;0;0
9;2;0;0;1,23;0;0;0;0
9;3;0;0;1,43;0;0;0;0
9;4;0;0;1,46;0;0;0;0
9;5;0;0;1,67;0;0;0;0
9;10;0;0;1,92;0;0;0;0
9;20;0;0;2,88;0;0;0;0
9;30;0;0;3,36;0;0;0;0
10;0,5;0;0;2,38;0;0;0;0
10;1;0;0;3,33;0;0;0;0
10;2;0;0;3,9;0;0;0;0
10;3;0;0;4,52;0;0;0;0
10;4;0;0;4,64;0;0;0;0
10;5;0;0;5,3;0;0;0;0
10;10;0;0;6,08;0;0;0;0
10;20;0;0;9,12;0;0;0;0
10;30;0;0;10,64;0;0;0;0
11;2;0;0;6,8;0;0;0;0
11;5;0;0;7,9;0;0;0;0
11;10;0;0;8,5;0;0;0;0
11;25;0;0;10,53;0;0;0;0
12;2;0;0;7,8;0;0;0;0
12;5;0;0;9,06;0;0;0;0
12;10;0;0;9,75;0;0;0;0
12;25;0;0;12,08;0;0;0;0
13;2;0;0;9,36;0;0;0;0
13;5;0;0;10,87;0;0;0;0
13;10;0;0;11,7;0;0;0;0
13;25;0;0;14,49;0;0;0;0
14;2;0;0;11,23;0;0;0;0
14;5;0;0;13,05;0;0;0;0
14;10;0;0;14,04;0;0;0;0
14;25;0;0;17,39;0;0;0;0
15;2;0;0;13,48;0;0;0;0
15;5;0;0;15,66;0;0;0;0
15;10;0;0;16,85;0;0;0;0
15;25;0;0;20,87;0;0;0;0
16;2;0;0;16,17;0;0;0;0
16;5;0;0;18,79;0;0;0;0
16;10;0;0;20,22;0;0;0;0
16;25;0;0;25,04;0;0;0;0

Tarifwerk

Hauptartikel: Tarifwerk

Sobald die Zonen erstellt sind kann das Tarifwerk erstellt werden.

RTENOTITLE

Zuschläge

Hauptartikel: Zuschlag

Expressdienste (Variante 1)

In Variante 1 enthalten die Expressdienste beide Preise in einem Zuschlag. Der Preis wird von einem Script gesteuert. Das hat den Vorteil das am Ende nur ein Tarif erstellt werden muss.

RTENOTITLE

Das Script hat folgenden Inhalt

switch (shipment.getServiceType()) {
    case "HSC12":
        return 12.5d;
    case "HSC15":
        return 24.9d;
    default:
        return 0d;
}

Expressdienste (Variante 2)

In Variante 2 wird pro Versandart ein Tarif erstellt. Das hat den Vorteil, dass für die Expressdienste gar kein Script erstellt werden muss. Allerdings muss dann pro Versandart (HSC, HSC12, HSC15) ein Tarif erstellt werden.

Es muss also ein Zuschlag für HSC Express 12:00 und ein Zuschlag für HSC Express 15:00 erstellt werden (hier nicht gezeigt).

RTENOTITLE

Inselzuschlag

Der Inselzuschlag muss per Script gesteuert werden. Das ist jedoch ein Einzeiler:

shipment.isIsle()

RTENOTITLE

Tarife

Hauptartikel: Tarif

Je nach gewählter Variante bei den Zuschlägen müssen entweder ein oder drei Tarife erstellt werden.

Variante 1

In Variante 1 muss nur ein Tarif erstellt werden, da die Scripte in den vorhin angelegten Zuschlägen sich selbst steuern.

RTENOTITLE

Allgemein

Name: HSC Express

Währung: EUR

Frachtführer: HSC Express

Versandarten

Folgende Versandarten müssen hinzugefügt werden:

  • HSC
  • HSC12
  • HSC15

Auftraggeber

Unter Auftraggeber müssen Sie Ihren jeweiligen Auftraggeber hinzufügen für den diese Preise gelten sollen.

Tarifwerke

Unter Tarifwerke muss nur das Tarifwerk HSC Express hinzugefügt werden.

Zuschläge

Folgende Zuschläge müssen hinzugefügt werden:

  • HSC Expressdienste
  • HSC Inselzustellung

Fertig. Der Tarif kann nun Verwendet werden.

 

Variante 2

In Variante 2 wurde jeweils ein Zuschlag für die Expressdienste eingerichtet. Diese beinhalten keine Logik. Deswegen müssen jetzt drei Tarife anlegt werden (eine pro Versandart).

Generell wird der Tarif ähnlich wie in Variante 1 angelegt. Deswegen werden hier nur die Unterschiede aufgelistet.

Tarif 1

Name: HSC Express Standard

Versandarten:

  • HSC

Zuschläge:

  • HSC Instelzustellung

Tarif 2

Name: HSC Express 12:00

Versandarten:

  • HSC12

Zuschläge:

  • HSC Inselzustellung
  • HSC Express 12:00

Tarif 3

Name: HSC Express 15:00

Versandarten:

  • HSC15

Zuschläge:

  • HSC Inselzustellung
  • HSC Express 15:00