pp - jtl 2 ls one - planpro saas
TRANSCRIPT
PP - JTL 2 LS One SEITE 1 VON 2
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
PLAN PRO
Unternehmens-Kommunikation/
PLAN PRO SAAS Datacenter GmbH
Rosenweg 5
24245 Kirchbarkau
E-Mail: [email protected]
https://planprosaas.com/
PP - JTL 2 LS One SEITE 2 VON 2
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
PP - JTL 2 LS ONE Version: 1.3 | Stand: 16.04.2018
PLAN PRO SAAS Datacenter GmbH Rosenweg 5 24245 Kirchbarkau
E-Mail: [email protected] Web: https://planprosaas.com/ Shop: https://lizenzshop.planprosaas.com/ Lizenzaktivierung: https://lizenzaktivierung.planprosaas.com/
PP - JTL 2 LS One SEITE 2 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Inhalt
PP - JTL 2 LS ONE .............................................................................................................................. 2
1. Einleitung .................................................................................................................................. 4
2. Übertragene Daten ................................................................................................................... 5
2.1. Voraussetzung der Daten ................................................................................................. 6
2.1.1 JTL-Artikel-Nr. ........................................................................................................... 6
2.1.2 Inkrementelle Synchronisation ................................................................................ 6
3. Kunden ..................................................................................................................................... 7
3.2. Zuordnungen .................................................................................................................... 7
3.1.1 Kundendetails - Adresse ........................................................................................... 8
3.1.2 Kundendetails - Details ........................................................................................... 10
3.1.3 Kundendetails - Hauptbuch .................................................................................... 11
3.1.4 Kundendetails - Kundenadresse ............................................................................. 12
4. Artikel ..................................................................................................................................... 13
4.3. Zuordnungen .................................................................................................................. 13
4.3.1 Allgemein - Allgemein ............................................................................................. 14
4.3.2 Beschreibung – Zusätzliche Informationen ............................................................ 15
4.3.3 Allgemein - Preise ................................................................................................... 16
4.3.4 Allgemein - Bestand ................................................................................................ 17
5. Transaktionen ......................................................................................................................... 18
5.1. Zuordnungen .................................................................................................................. 18
5.1.1 Normale Transaktionen .......................................................................................... 19
6. Optionale Felder ..................................................................................................................... 30
7. Synchronisation ausführen ..................................................................................................... 31
7.1. Installation PP - JTL 2 LS One .......................................................................................... 31
7.2. Konfiguration .................................................................................................................. 36
7.2.1 JTL Verbindung ....................................................................................................... 36
7.2.2 LS One Verbindung ................................................................................................. 37
PP - JTL 2 LS One SEITE 3 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.2.3 LS One Einstellungen .............................................................................................. 38
7.2.4 JTL Einstellungen .................................................................................................... 39
7.3. Ausführung in der Shell .................................................................................................. 40
7.3.1 PUSH ....................................................................................................................... 42
7.3.2 PULL ........................................................................................................................ 43
8. Aufgabenplanung ................................................................................................................... 44
9. Aufgabenplanung ändern ....................................................................................................... 54
10. Datenbankfelder-Mapping ................................................................................................. 56
PP - JTL 2 LS One SEITE 4 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
1. Einleitung
Allgemeine Beschreibung
Diese Lösung stellt die Schnittstelle zwischen dem Kassensystem LS One 2017 und JTL Version
1.3.15.6 zum bidirektionalen Austausch von Daten dar. Die am POS erzeugten Buchungen
werden in die JTL-Datenbank übertragen und stehen zur Verarbeitung durch die JTL
Geschäftslogik bereit.
Kunden und Artikeldaten werden aus der JTL-Datenbank in die LS One-Datenbank übermittelt.
Es wird angenommen, dass die Buchungen von den Kassensystemen über den Data-Director in
die zentrale Site Manager-Datenbank übertragen wurden.
PP - JTL 2 LS One SEITE 5 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
2. Übertragene Daten
Daten Richtung
Artikel JTL > LS One
Kunden JTL > LS One
Transaktionen LS One > JTL
PP - JTL 2 LS One SEITE 6 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
2.1. Voraussetzung der Daten
2.1.1 JTL-Artikel-Nr.
Die in JTL festgelegte Artikelnummer kann hundert Zeichen enthalten, die Artikelnummer in LS
One hingegen nur zwanzig Zeichen.
Für LS One werden deshalb die ersten 18 Zeichen der Artikelnummer verwendet.
Dazu wird eine Mapping-Tabelle mit dem Namen JTL_MAPPING in LS One angelegt.
Solange die 18-stellige „ItemID“ (Artikelnummer aus JTL) eindeutig ist, wird diese verwendet. Im
Falle einer Kollision werden die letzten beiden Zeichen der „ItemID“ verwendet, um einen Zähler
(02-99) zu inkrementieren. Der Standard-Fall ist dabei „01“ und wird in LS One nicht angezeigt.
2.1.2 Inkrementelle Synchronisation
Für die Synchronisation der Artikel wird das Feld „dMod“ der Tabelle „tArtikel“ verwendet.
Bei der Synchronisation wird der maximale Wert gespeichert. Bei der nächsten Ausführung
werden nur die Datensätze verwendet, welche die vorherigen um fünf Minuten überschreiten.
Bei den Transaktionen wird der „Replicationcounter“ von LS Retail verwendet.
Die Werte werden in den Benutzereinstellungen im Benutzerverzeichnis „AppData\Local\...“
gespeichert.
PP - JTL 2 LS One SEITE 7 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
3. Kunden
3.2. Zuordnungen
Folgende Daten werden aus JTL exportiert und in LS One übernommen.
JTL LS One
KundenNr ID
zu Händen Kontakt
Titel mit in Bildschirmname
Anrede
Name Vorname
Name
Geburtstag Geburtsdatum
Straße
Adresse
PLZ
Ort
Bundesland
Land
A. Zusatz
Tel Telefon
E-Mail E-Mail-Adresse
Mobil Mobiltelefon
Ust-IdNr Identifikationsnummer
Steuernr MwSt.-Nummer
Kreditlimit Kreditlimit
Zahlungsart = Bar Barzahlungskunde = ja
PP - JTL 2 LS One SEITE 8 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
3.1.1 Kundendetails - Adresse
PP - JTL 2 LS One SEITE 9 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
PP - JTL 2 LS One SEITE 10 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
3.1.2 Kundendetails - Details
PP - JTL 2 LS One SEITE 11 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
3.1.3 Kundendetails - Hauptbuch
PP - JTL 2 LS One SEITE 12 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
3.1.4 Kundendetails - Kundenadresse
PP - JTL 2 LS One SEITE 13 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
4. Artikel
4.3. Zuordnungen
Folgende Daten werden aus JTL exportiert und in LS One übernommen.
JTL LS One
Art.Nr./SKU ID
EAN Standard-Barcode
Kategorien Einzelhandelsgruppe
Artikelname Beschreibung
Steuerklasse Artikelumsatzsteuergruppe
Verkaufseinheit Verkaufseinheit
Beschreibung Erweiterte Beschreibung
Brutto-VK Preis inklusive Steuern
Netto-VK Preis
Einkaufspreis (netto) Einkaufspreis
Auf Lager Lagerbestand
PP - JTL 2 LS One SEITE 14 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
4.3.1 Allgemein - Allgemein
PP - JTL 2 LS One SEITE 15 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
4.3.2 Beschreibung – Zusätzliche Informationen
PP - JTL 2 LS One SEITE 16 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
4.3.3 Allgemein - Preise
PP - JTL 2 LS One SEITE 17 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
4.3.4 Allgemein - Bestand
PP - JTL 2 LS One SEITE 18 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
5. Transaktionen
5.1. Zuordnungen
Folgende Daten werden aus JTL exportiert und in LS One übernommen.
Allgemeine Ansicht:
JTL LS-ONE
A-Nr Kassenbon-ID
Anrede
Kunde Vorname
Name
Ust. Steuersatz
Bezeichnung Artikelname
Menge Anzahl
VK Brutto Preis
Gesamt (Euro) Gesamt €
Rabatt(%) Zeilenrabatt
Gesamtrabatt
Ansicht Zahlungen:
JTL LS-ONE
Auftragsnummer Kassenbon-ID
Auftragswert Gesamt €
Name Zahlungsart
Datum Datum
Betrag Zahlungsartenbetrag
PP - JTL 2 LS One SEITE 19 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
5.1.1 Normale Transaktionen
PP - JTL 2 LS One SEITE 20 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
PP - JTL 2 LS One SEITE 21 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Anzahl
PP - JTL 2 LS One SEITE 22 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Mehrere Artikelzeilen – mehrere Artikelzeilen:
PP - JTL 2 LS One SEITE 23 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Zahlungen - geteilte Zahlung:
PP - JTL 2 LS One SEITE 24 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Retour:
PP - JTL 2 LS One SEITE 25 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Retour:
PP - JTL 2 LS One SEITE 26 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Zeilenrabatt
PP - JTL 2 LS One SEITE 27 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Zeilenrabatt – Zahlung setzen
PP - JTL 2 LS One SEITE 28 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Gesamtrabatt
PP - JTL 2 LS One SEITE 29 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Gesamtrabatt – Zahlung setzen
PP - JTL 2 LS One SEITE 30 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
6. Optionale Felder
Folgende Felder werden standardmäßig nicht konvertiert, sind aber optional und können bei
Bedarf später implementiert werden:
Kunden JTL LS One
Rabatt Rabatte
Artikel
JTL LS One
Variationen -------
Sonderpreise -------
Kundengruppe (Rabatt) -------
Auf Einkaufsliste -------
In Aufträgen -------
Im Zulauf -------
------- Rabatte
------- Sondergruppen
------- Verkäufer
------- Bestellt
------- Reserviert
------- Nullpreis gültig
Transaktionen LS One JTL
Artikel- / Transaktionskommentar
Sonstiges
Nicht in JTL implementiert:
Die Punkte Währung, Gesamtrabatt und Umtauschbar sind nicht in JTL angegeben.
Standardmäßig wird in LS One deshalb Währung auf „€“ und Gesamtrabatt, sowie Umtauschbar
auf „ja“ gesetzt.
PP - JTL 2 LS One SEITE 31 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7. Synchronisation ausführen
7.1. Installation PP - JTL 2 LS One
Zum Installieren der Anwendung PP - JTL 2 LS One führen Sie das Programm
„Setup PP - JTL 2 LS One_Versionsnummer.exe“ als Administrator aus (Rechtsklick).
Die Installation von PP - JTL 2 LS One wird gestartet.
Wählen Sie Ihre Installationssprache aus und bestätigen Sie mit „OK“.
PP - JTL 2 LS One SEITE 32 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Akzeptieren Sie den Endbenutzer-Lizenzvertrag und bestätigen Sie mit „Weiter“.
Als nächstes können Sie den Ziel-Ordner der Installation auswählen, indem Sie auf
„Durchsuchen …“ klicken.
Sie können auch das Standardverzeichnis behalten.
Bestätigen Sie mit „Weiter“.
PP - JTL 2 LS One SEITE 33 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Danach können Sie den Startmenü-Ordner auswählen, indem Sie auf „Durchsuchen…“ klicken.
Sie können auch das Standardverzeichnis behalten.
Bestätigen Sie mit „Weiter“.
Als nächstes können Sie noch ein Desktop-Symbol erstellen. Dies wird jedoch nicht benötigt, da
PP - JTL 2 LS One aus einer Shell heraus gestartet wird.
Bestätigen Sie mit „Weiter“.
PP - JTL 2 LS One SEITE 34 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Bestätigen Sie die Installation, indem Sie auf „Installieren“ klicken.
PP - JTL 2 LS One wird nun wie gewünscht installiert.
PP - JTL 2 LS One SEITE 35 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Sie können nun die Installation durch „Fertigstellen“ beenden. Da PP - JTL 2 LS One aus einer
Shell heraus gestartet wird, setzen Sie nicht den Haken bei „JTL 2 LS ONE APP starten“.
PP - JTL 2 LS One SEITE 36 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.2. Konfiguration
Um die Datenbankverbindungen einzustellen, öffnen Sie die Datei „settings.conf“ in dem von
Ihnen definierten Installationspfad.
Dort haben Sie dann die Möglichkeit, für JTL und LS One entsprechende
Datenbankverbindungen und Einstellungen vorzunehmen.
7.2.1 JTL Verbindung
# JTL Verbindungseinstellungen
"JTL_CONNECTION": {
# Geben Sie hier den Servernamen des SQL Servers ein. Achten Sie darauf, dass Sie ein „\\“
angeben.
"SERVER": "localhost\\SQLEXPRESS",
# Geben Sie hier den Benutzernamen der SQL Datenbank ein.
"USER": "sa",
# Geben Sie hier das Passwort des SQL Benutzers ein.
"PASSWORD": "Passwort",
# Geben Sie hier den Namen der Datenbank ein.
"DATABASE": "JTL"
},
PP - JTL 2 LS One SEITE 37 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.2.2 LS One Verbindung
# LS One Verbindungseinstellungen
"LSONE_CONNECTION": {
# Geben Sie hier den Servernamen des SQL Servers ein. Achten Sie darauf, dass Sie ein „\\“
angeben.
"SERVER": "localhost\\SQLEXPRESS",
# Geben Sie hier den Benutzernamen der SQL Datenbank ein.
"USER": "sa",
# Geben Sie hier das Passwort des SQL Benutzers ein.
"PASSWORD": "Passwort",
# Geben Sie hier den Namen der Datenbank ein.
"DATABASE": "LS_ONE"
},
PP - JTL 2 LS One SEITE 38 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.2.3 LS One Einstellungen
"LS_ONE": {
# Geben Sie hier die Geschäfts-ID ein. Dieser Wert ist relevant für den Lagerbestand.
"STORE_ID": "S0001",
# Standardwert ist "LSR".
"DATAAREAID": "LSR",
# Standartwert ist "EUR".
"CURRENCY": "EUR",
# Wert zu entnehmen aus der Tabelle "dbo.BARCODESETUP" aus der Spalte
"BARCODESETUPID". Wert kann auch leer sein.
"BARCODESETUPID": "Wert",
# Wert zu entnehmen aus der Tabelle "dbo.REPLICATIONACTIONS" aus der Spalte
"AuditContext".
"AUDITCONTEXT": "AuditContext"
},
PP - JTL 2 LS One SEITE 39 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.2.4 JTL Einstellungen
"JTL": {
# Wert, der in Tabelle "dbo.tBestellung" in Spalte "cAnmerkung" geschrieben wird. Dies ist die
Anmerkung in den Verkäufen, für Transaktionen aus LS One.
"VERKAUF_ANMERKUNG": "LS One Verkauf",
# Wert aus Tabelle "dbo.tSteuerzone" in Spalte "kSteuerzone". Standard in JTL: 1 = Zone-EU und
2 = Zone-Nicht-EU.
"STEUERZONE": 1,
# Wert aus Tabelle "dbo.tSpracheUsed" in Spalte "kSprache". Standard in JTL: 1 = German.
"SPRACHE": 1,
# Standardwert ist 0.
"SHOP": 0,
# Wert aus Tabelle "dbo.tFirma" in Spalte "kFirma".
"FIRMA": 1,
# Standardwert ist 1.
"PLATTFORM": 1,
# Kundennummer in JTL für einen Dummy-Kunden. Wenn in einer Kassentransaktion kein Kunde
hinterlegt ist, dann wird die Transaktion auf diesen Kunden in JTL gebucht.
"DEFAULT_CUSTOMER": "10001"
}
Speichern Sie die Datei, nachdem Sie die Einstellungen vorgenommen haben.
PP - JTL 2 LS One SEITE 40 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.3. Ausführung in der Shell
Öffnen Sie zunächst ein Shell, um mit dem Schnittstellenprogramm PP - JTL 2 LS One zu
arbeiten. In dieser Dokumentation wird die Windows PowerShell verwendet.
Wechseln Sie in das Verzeichnis, wo Sie PP - JTL 2 LS One installiert haben.
BEFEHL: cd 'C:\Program Files (x86)\PLAN PRO\JTL 2 LS ONE APP\'
Sie können sich mit der Hilfe die Parameter anzeigen lassen, die für die Synchronisation möglich
sind.
BEFEHL: .\ConnectorApp.exe help
PP - JTL 2 LS One SEITE 41 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Zuerst wird eine Hilfstabelle (JTL_Mapping) für die Artikelnummern benötigt.
Dazu führen Sie den „Init-Befehl“ aus.
BEFEHL: .\ConnectorApp.exe init
Sie haben jetzt die Möglichkeit zwischen LS One und JTL zu synchronisieren.
Dazu gibt es zwei Parameter:
PUSH: Artikeldaten und Kundendaten von JTL an LS One
PULL: Transaktionsdaten von LS One an JTL
Auch hier haben Sie jeweils die Möglichkeit, sich eine Hilfe anzeigen zu lassen.
BEFEHL: .\ConnectorApp.exe push --help oder .\ConnectorApp.exe pull --help
PP - JTL 2 LS One SEITE 42 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.3.1 PUSH
Mit dem PUSH-Befehl werden Artikeldaten und Kundendaten von JTL an LS One synchronisiert.
Paramater:
ohne Es wird ein Delta-Sync durchgeführt - nur unterschiedliche Daten
werden synchronisiert.
Beispiel: .\ConnectorApp.exe push
-j oder --jobs Geben Sie den gewünschten Job an, der durchgeführt werden
soll. Vorhandene Jobs sind: Units, Tax, Groups, Items,
Inventory, Customers und Customergroups.
Es können auch mehrere Jobs ausgeführt werden, dazu müssen
diese hintereinander mit einem Leerzeichen eingegeben
werden.
Beispiel: .\ConnectorApp.exe push -j Customers Customergroups
-f oder --full Es wird ein vollständiger Sync durchgeführt. Alle Daten werden
neu geschrieben.
Beispiel: .\ConnectorApp.exe push –f
PP - JTL 2 LS One SEITE 43 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
7.3.2 PULL
Mit dem PULL-Befehl werden Transaktionsdaten von LS One an JTL synchronisiert.
Paramater:
ohne Es wird ein Delta-Sync durchgeführt - nur unterschiedliche Daten
werden synchronisiert.
Beispiel: .\ConnectorApp.exe pull
-j oder --jobs Geben Sie den gewünschten Job an, der durchgeführt werden
soll. Vorhandene Jobs sind: Sales, SalesLines und Payments.
Es können auch mehrere Jobs ausgeführt werden, dazu müssen
diese hintereinander mit einem Leerzeichen eingegeben
werden.
Beispiel: .\ConnectorApp.exe pull -j Sales SalesLines
-f oder --full Es wird ein vollständiger Sync durchgeführt. Alle Daten werden
neu geschrieben.
Beispiel: .\ConnectorApp.exe pull –f
PP - JTL 2 LS One SEITE 44 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
8. Aufgabenplanung
Die Ausführung von PP - JTL 2 LS One als Windows-Aufgabe hat den Vorteil, dass die
Konvertierung als Task in der Windows-Aufgabenplanung so konfiguriert werden kann, dass
diese automatisch in einem von Ihnen definierten Intervall ausgeführt werden kann.
Grundlagen ist, dass PP - JTL 2 LS One bereits installiert ist.
Diese Dokumentation ist auf Basis einer Windows 10 Installation.
Starten Sie zunächst die Windows-Aufgabenplanung.
Diese finden Sie, indem Sie im Startmenü „Aufgabenplanung“ eingeben.
PP - JTL 2 LS One SEITE 45 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Alternativ unter „Start“, dann „Windows-Verwaltungsprogramme“.
Klicken Sie nun auf Aktion und dann auf „Aufgabe erstellen“.
PP - JTL 2 LS One SEITE 46 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Allgemein
Geben Sie hier einen Namen für die Aufgabe ein. Sie können außerdem noch eine optionale
Beschreibung für diese Aufgabe vergeben.
Unter den Sicherheitsoptionen können Sie die Aufgabe einem bestimmten Windows-Benutzer
zuordnen. Wählen Sie hier „Mit höchsten Privilegien ausführen“, damit die Aufgabe ohne
Windows-Nachfrage ausgeführt wird.
Danach wählen Sie „Konfigurieren für: Windows 10“ und bestätigen mit „OK“.
PP - JTL 2 LS One SEITE 47 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Trigger
Gehen Sie nun zum Tab „Trigger“.
Klicken Sie auf „Neu…“, um einen Plan festzulegen, wann PP - JTL 2 LS One und damit die
Synchronisierung stattfinden soll. Stellen Sie hier Ihr gewünschtes Intervall ein und bestätigen
Sie mit „OK“.
PP - JTL 2 LS One SEITE 48 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Aktionen
Wechseln Sie dann zum Tab „Aktionen“ und klicken Sie auf „Neu…“
Wählen Sie hier bei Aktion „Programm starten“ und klicken Sie dann auf „Durchsuchen…“.
PP - JTL 2 LS One SEITE 49 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Navigieren Sie nun zum Installationsverzeichnis von PP - JTL 2 LS One und wählen Sie die Datei
„ConnectorApp.exe“ aus.
Das Standardverzeichnis liegt unter: C:\Program Files (x86)\PLAN PRO\JTL 2 LS ONE APP.
Bestätigen Sie dann mit „Öffnen“
PP - JTL 2 LS One SEITE 50 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Danach müssen Sie noch Argumente für PP - JTL 2 LS One festlegen.
Siehe dazu Parameter unter:
PUSH bzw. PULL. Für jeden Job muss eine Aufgabe angelegt werden. Alternativ kann eine Batch-
Datei erstellt werden, die die Jobs nacheinander aufruft.
PP - JTL 2 LS One SEITE 51 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Nach Eingabe der gewünschten Argumente, bestätigen Sie mit „OK“ und wechseln Sie zum Tab
„Bedingungen“
PP - JTL 2 LS One SEITE 52 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Bedingungen
Hier können Sie noch zusätzliche Einstellungen vornehmen, unter welchen Bedingungen die
Aufgabe PP - JTL 2 LS One gestartet werden soll.
PP - JTL 2 LS One SEITE 53 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Einstellungen
Im letzten Tab „Einstellungen“ können Sie weitere Einstellungen für das Verhalten der Aufgabe
angeben.
Bestätigen Sie mit „OK“ und die Aufgabenplanung ist abgeschlossen.
PP - JTL 2 LS One SEITE 54 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
9. Aufgabenplanung ändern
Die erstellte Aufgabe kann jederzeit geändert werden. Sie finden die Aufgabe in der
Aufgabenplanung unter Aufgabenbibliothek.
Hier haben Sie per Rechtsklick auf die Aufgabe oder nach Auswahl der Aufgabe, rechts die
Möglichkeit, verschiedene Aktionen durchzuführen:
Ausführen: Sie können die Aufgabe PP - JTL 2 LS One auch vor oder nach der geplanten
Ausführung manuell starten. Sie müssen über die entsprechenden Berechtigungen
verfügen und die Aufgabe muss aktiviert sein.
Beenden: Sie können die aktive Aufgabe PP - JTL 2 LS One beenden, sodass die Aufgabe
nicht mehr ausführt wird. Dadurch wird die Aufgabe beendet, während sie ausführt
wird.
Deaktivieren: Wenn Sie verhindern möchten, dass die Aufgabe PP - JTL 2 LS One
während eines bestimmten Zeitraums ausgeführt wird, können Sie die Aufgabe
deaktivieren.
Die Aufgabe kann zu einem späteren Zeitpunkt wieder aktiviert werden.
PP - JTL 2 LS One SEITE 55 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
Exportieren: Sie können die Aufgabe PP - JTL 2 LS One exportieren, sodass diese in einer
XML-Datei gespeichert wird. Diese XML-Datei kann dann von anderen Benutzern und
Computern importiert werden.
Eigenschaften: Sie können die Aufgabe PP - JTL 2 LS One ändern, indem auf
Eigenschaften klicken.
Löschen: Sie können die Aufgabe PP - JTL 2 LS One löschen, wenn Sie sie nicht mehr
dauerhaft ausführen möchten.
PP - JTL 2 LS One SEITE 56 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
10. Datenbankfelder-Mapping
Nachfolgend finden Sie eine Zuordnung der Felder zwischen JTL und LS One.
JTL LS One Anmerkungen
tEinheit.kEinheit UNIT.UNITID Format: JTL{0,17:D17}
tEinheitSprache.cName UNIT.TXT Substring: 10
tKategorie.kKategorie RETAILGROUP.GROUPID Format: JTL{0,17:D17}
tKategorieSprache.cName RETAILGROUP.NAME Substring: 60
tSteuersatz.kSteuersatz TAXDATA.TAXCODE Format: JTL{0,17:D17}
tSteuersatz.fSteuersatz TAXDATA.TAXVALUE
tSteuersatz.kSteuersatz TAXTABLE.TAXCODE Format: JTL{0,17:D17}
tSteuerklasse.cName TAXTABLE.TAXNAME Substring: 30
tSteuersatz.kSteuersatz TAXGROUPHEADING.TAXITEMGROUP Format: TGJTL{0,15:D15}
tSteuerklasse.cName TAXGROUPHEADING.NAME Substring: 30
tSteuersatz.kSteuersatz TAXGROUPDATA.TAXGROUP Format: TGJTL{0,15:D15}
tSteuersatz.kSteuersatz TAXGROUPDATA.TAXCODE Format: JTL{0,17:D17}
tSteuersatz.kSteuersatz TAXONITEM.TAXITEMGROUP Format: TGJTL{0,15:D15}
tSteuersatz.kSteuersatz TAXONITEM.TAXCODE Format: JTL{0,17:D17}
tArtikel.cArtNr RETAILITEM.ITEMID Siehe Mapping
tArtikel.fVKNetto RETAILITEM.SALESPRICE
tArtikel.nDelete RETAILITEM.DELETED 0 = false, 1 = true
tSteuersatz.fSteuersatz RETAILITEM.SALESPRICEINCLTAX Math.Round(src.FVkNetto * (1 + (src.FSteuersatz / 100)), 2))
tArtikelBeschreibung.cName RETAILITEM.ITEMNAME Substring: 60
tArtikel.kVerkaufsEinheit RETAILITEM.SALESUNITID Format: JTL{0,17:D17}
tArtikel.kVerkaufsEinheit RETAILITEM.PURCHASEUNITID Format: JTL{0,17:D17}
tArtikel.kVerkaufsEinheit RETAILITEM.INVENTORYUNITID Format: JTL{0,17:D17}
tArtikel.cBeschreibung RETAILITEM.EXTENDEDDESCRIPTION
tArtikel.fEKNetto RETAILITEM.PURCHASEPRICE
tSteuersatz.kSteuersatz RETAILITEM.SALESTAXITEMGROUPID Format: TGJTL{0,15:D15}
0 RETAILITEM.ITEMTYPE
1.1.1900 RETAILITEM.DATETOBEBLOCKED
1.1.1900 RETAILITEM:DATETOACTIVATEITEM
1 RETAILITEM.SALESALLOWTOTALDISCOUNT
tArtikel.cArtNr INVENTITEMBARCODE.ITEMID Siehe Tabelle „JTL_Mapping“
tArtikel.cBarcode INVENTITEMBARCODE.ITEMBARCODE
1 INVENTITEMBARCODE.QTY
Config.LS_ONE.BARCODESETUPID INVENTITEMBARCODE.BARCODESETUPID
tArtikel.kVerkaufsEinheit INVENTITEMBARCODE.UNITID Format: JTL{0,17:D17}
1 INVENTITEMBARCODE.RBOSHOWFORITEM
Config.LS_ONE.DATAAREAID INVENTITEMBARCODE.DATAAREAID
PP - JTL 2 LS One SEITE 57 VON 56
PLAN PRO Rosenweg 5 24245 Kirchbarkau/ Kiel [email protected] www.planprosaas.com
Titel: PP – JTL 2 LS One
Ausgabedatum: 16.04.2018 Version V 1.3
Copyright © PLAN PRO
-kein kopieren- - keine Weitergabe -
DateTime.Now INVENTITEMBARCODE.MODIFIEDDATE
tArtikel.cArtNr INVENTSUM.ITEMID
Config.LS_ONE.STORE_ID INVENTSUM.STOREID
tLagerbestand.fVerfuegbar INVENTSUM.QUANTITY fVerfuegbar + (VINVENTSUM.QUANTITY – INVENTSUM.QUANTITY)
tKundenGruppe.kKundenGruppe RETAILGROUP.ID
tKundenGruppe.cName RETAILGROUP.NAME
tkunde.cKundenNr CUSTOMERADDRESS.ACCOUNTNUM
tkunde.cStrasse CUSTOMERADDRESS.STREET
tkunde.cAdressZusatz CUSTOMERADDRESS.ADDRESS
tkunde.cOrt CUSTOMERADDRESS.CITY
tkunde.cBundesland CUSTOMERADDRESS.STATE
tkunde. cISO CUSTOMERADDRESS.COUNTRY
tkunde cPLZ CUSTOMERADDRESS.ZIPCODE
tkunde cMobil CUSTOMERADDRESS.CELLULARPHONE
tkunde cTel CUSTOMERADDRESS.PHONE
tkunde cZHaenden CUSTOMERADDRESS.CONATACTNAME
tkunde cEMail CUSTOMERADDRESS.EMAIL
Config.LS_ONE.DATAAREAID CUSTOMERADDRESS.DATAAREAID
0 CUSTOMERADDRESS.ADDRESSTYPE
tkunde.cKundenNr CUSTTABLE.ACCOUNTNUM
CUSTTABLE.NAME cAnrede, cTitel, cVorname, cName
tkunde.cTel CUSTTABLE.PHONE
tkunde.cFax CUSTTABLE.TELEFAX
tkunde.nKreditlimit CUSTTABLE.CREDITMAX
tkunde.cISO CUSTTABLE.COUNTRY
tkunde.cPLZ CUSTTABLE.ZIPCODE
tkunde.cBundesland CUSTTABLE.STATE
tkunde.cEMail CUSTTABLE.EMAIL
tkunde.cMobil CUSTTABLE.CELLULARPHONE
tkunde.cOrt CUSTTABLE.CITY
tkunde.cStrasse CUSTTABLE.STREET
tkunde.cSteuerNr CUSTTABLE.VATNUM
tkunde.cUSTID CUSTTABLE.ORGID
tkunde.cVorname CUSTTABLE.FIRSTNAME
tkunde.cName CUSTTABLE.LASTNAME
tkunde.cAnrede CUSTTABLE.NAMEPREFIX
tkunde.cGeburtstag CUSTTABLE.DATEOFBIRTH
Config.LS_ONE.DATAAREAID CUSTTABLE.DATAAREAID
Config.LS_ONE.CURRENCY CUSTTABLE.CURRENCY
0 CUSTTABLE.BLOCKED
tkunde.kZahlungsart CUSTTABLE.NONCHARGABLEACCOUNT KZahlungsart == 1 ? 1 : 0
tkunde.cKundenNr CUSTINGROUP.ACCOUNTNUM
tkunde.kKundenGruppe CUSTINGROUP.GROUPID
1 CUSTINGROUP.DEFAULTGROUP
Config.LS_ONE.DATAAREAID CUSTINGROUP.DATAREAID