Merge branch 'master' of vc.linet-services.de:public/lx-office-erp
[kivitendo-erp.git] / xtcom / readme.first
1 Shop - Schnittstelle Lx-ERP <-> xt:Commerce
2
3
4 Info:
5         Die Zusammenarbeit mit der Version 2.6.x wurde nicht getestet!
6
7         Die Anmeldung der Benutzer an LxO hat sich geändert. Auch wurde  Lagerwesen eingeführt.
8         Damit die Schnittstelle mit Version 2.6.0 und neuer funktioniert, sollten hier Anpassungen
9         durchgeführt werden.
10
11 Update:
12         Die Schnittstelle meldet sich unabhängig mit den hinterlegten Daten an.
13         Da nicht auf Läger gebucht (Auftrag ohne Lagerbewegung) wird, ist auch hier i
14         nichts zu berüchsichtigen. 
15         Warenbestand in "parts" ist der Gesamtbestand. Nicht unbedingt der Bestand für 
16         den Shop. Sollte vielleicht noch angepasst werden.
17
18 Vorraussetzungen:
19         Lx-ERP Version >= 2.4.0 
20         xt:Commerce 3.04
21         Pear DB, PHP-ImageMagick
22
23 Installation:
24 Das tar-File unterhalb vom Webserververzeichnis oder vom ERP-Verzeichnis entpacken.
25
26         $ cd /var/www/html
27         $ tar xzf /pfad/zu/xtcomm.tgz
28
29 In das Verzeichnis oscomm wechseln und Schreibrechte auf die Datei conf.php und 
30 die Verzeichnisse xtcom und tmp für den Webbenutzer (apache,www-data,httpd) vergeben.
31
32         $ chown apache xtcom
33         $ chown apache xtcom/conf.php
34         $ chmod 600 xtcom/conf.php
35         $ chown apache xtcom/tmp
36
37 Bitte zuerst einen Benutzer für die ERP anlegen, der mit der Schnittstelle benutzt 
38 werden soll. Dann noch die Artikel 'Diverse 16%', 'Versandkosten' und 'Nachname' anlegen.
39 Sollen 'PayPal','Mindermengenzuschlag' und '7%'-Artikel extra verwendet werden, legen Sie
40 auch diese Artikel zunächst an.
41
42 Im Browser dann folgende URL aufrufen:
43
44         http://webserver/pfad/xtcomm/confedit.php
45
46         z.B.: http://localhost/xtcomm/confedit.php
47
48 Benutzer und Kennwort für die Erstinstallation sind:
49
50         xtcom / xtcom
51
52 Die Maske sogfälltig ausfüllen.
53
54         db-Host         db-Server für die jeweilige Anwendung
55         Database        Namen der Datenbankinstanzen
56         db-User         Username und Kennwort für die jeweilige Instanz
57         User-ID         Mit dieser ID soll in die ERP geschrieben werden
58         CSV-Dir         hier wird die csv-Datei erwartet (Schreibrechte!)
59         Image-Dir       hier liegen die Bilder
60         ftp-Host        Webserver der jeweiligen Anwendung
61         ftp-User        Name und Kennwort für ftp-Zugang
62         ID-xxxx         Interne ID der Waren. Lx-ERP:
63         Shopsprache     Die Id der Voreingestellten Sprache. Nur für diese 
64                                 werden die Artikel eingestellt.
65         Bildergröße     in Byte
66
67 Das Formular abschicken. 
68
69 Sollen später Änderungen durchgeführt werden, so muß bei der Anmeldung 
70 der ERP-ftp-User als Benutzer verwendet werden.
71
72 In der Shopinstanz muß noch eine Tabelle angelegt werden. Das wird 
73 normalerweise durch das Programm condedit.php erledigt. Sollte das aus 
74 irgend einem Grund nicht funktionieren, führen Sie dazu die
75 Datei oscom.sql als Datenbankbenutzer auf die Shopinstanz aus.
76
77         $ mysql -p -u dbuser dbinstanz < xtcom.sql
78         Enter password:
79
80 Ist diese Tabelle nicht angelegt, werden Kunden in der ERP immer wieder neu 
81 angelegt.
82
83 Fehlerquellen:
84 Befinden sich ERP und Shop nicht auf dem gleichen Server, achten Sie darauf, das
85 die entsprechende Datenbank von Aussen erreichbar ist. Dazu müssen folgende Ports 
86 freigeschaltet werden:
87
88         MySQL           3306
89         PostgreSQL      5432
90
91 Auch muß auf dem Shopserver ein ftp-Dienst eingerichtet werden, wenn Bilder über-
92 tragen werden sollen. Die Firewal ist entsprechend anzupassen.
93
94 Arbeiten:
95 In der ERP kann nun bei den Artikeln das Häckchen Shop gesetzt werden.
96 Bitte auch eine Warengruppe vergeben, da sonst alle Artikel in Default landen.
97 Da die ERP nur eine Kategorieebene verwalten kann, muß der ganze Kategorienpfad
98 hintelegt werden. Die einzelnen Kategorien werden durch Ausrufezeichen (!) getrennt.
99
100         Hardware -> Monitore -> LCD = Hardware!Monitore!LCD
101
102 Die URL für die Shopschnittstelle lautet:
103
104         http://webservername/pfad/xtcom/trans.php
105
106
107 Die Schnittstelle kann auch in die ERP integriert werden. Dazu installieren Sie
108 die Schnittstelle wie beschrieben unterhalb der ERP. 
109 Erweitern Sie die menu.ini um die Einträge im xtcom-Verzeichnis. z.B.:
110
111         $ cat /pfad/zu/xtcom/menu.ini >> /pfad/zu/lx-erp/menu.ini
112
113 Unter dem Menüpunkt Shop stehen Ihnen nun die Module shopimport_db und xtcomexport 
114 zur Verfügung.
115
116 Copyright:
117 Die Schnittstelle mit ihren einzelnen Bestandteilen steht unter Copyright der
118 Lx-System. Die Schnittstelle und auch einzelne Programmabschnitte unterliegen 
119 dem Urheberrecht sowie auch anderer Gesetze zum Schutz des geistigen Eigentums. 
120 Sie dürfen weder für kommerzielle Zwecke noch zur bloßen Weitergabe kopiert, 
121 verändert oder Dritten zugänglich gemacht werden.
122
123                                 info@lx-system.de