- 1-1 COI - CAO<->OXID Interface Interface zur Anbindung von CAO Faktura an OXID eshop Version 1.64 /1.74 29.04.2013 Benutzerhandbuch Seite 1
- 2-2 Vorwort Das vorliegende Interfacescript wurde für die CAO-Version 1.4.4.0 K und 1.4.4.0 F sowie die OXID eshop CE Version 4, bis Version 4.7.4 erstellt und getestet. Das Script selbst ist mit einem Encoder verschlüsselt und läuft nicht mit den PHP- Einstellungen safe_mode=on und enable_dl=off. Die Parameter müssen auf safe_mode=off und enable_dl=on eingestellt sein. Sollte das Script nicht laufen und Fehlermeldungen produzieren, so wenden Sie sich an Ihren Provider um die entsprechenden Einträge abzuändern. Unterhalb der PHP-Version 5.2.0 ist das Script und auch OXID nicht lauffähig. Sollten Sie eine höhere OXID-Version als 4.7.4 einsetzten, so ist das vorliegend Script ebenfalls nicht einsetzbar, da das Script erst mit zukünftigen OXID-Versionen getestet werden muss und dann über ein Update lauffähig sein wird. Dieses verhalten lässt sich in bestimmten Grenzen übersteuern, Dazu erstellen Sie eine Datei Namens version.coi im coi-verzeichnis auf dem Webserver. In die Datei version.coi tragen Sie die Versionsnummer ein, bis der die Schnittstelle arbeiten soll. Beispiel: Oxid-Version ist 4.6.6, dann tragen Sie als Versionsnummer 4660 ein. Des Weiteren benötigt das Modul eine Lizenzdatei, die die jeweilige Version auf Ihren Namen registriert. Ohne die Lizenzdatei ist das Modul nicht lauffähig. In diesem Benutzerhandbuch werden nur die Einstellungen zum Betrieb zwischen CAO- Faktura und OXID eshop erklärt. Desweiteren unterliegt das Script dem Copyright der T.Strunk EDV-Dienstleistung und darf nicht an Dritte weitergegeben bzw. weiterveräußert werden. Die Verfremdung oder Entschlüsselung des Codes sowie Entnahme von Teilen des Codes zur Weiterverwendung ist untersagt. Jegliche Garantie- und oder Haftungsansprüche beim Betreiben des Interfacescripts sind ausgeschlossen. Das Script darf genutzt werden, auf einem Einzelcomputer oder an nur einem Arbeitsplatz in einem Netzwerk, oder zur Nutzung in einem Computer-Netzwerk mit nur einem Netz- Server bzw. Web-Server und von Arbeitsplätzen, die gleichzeitig auf den Datenbestand des Servers Zugriff nehmen. Seite 2
- 3-3 Inhaltsverzeichnis 1. Installation... 4 1.1 Installation des Scripts... 4 2. Einstellungen... 4 2.1 Einstellungen in OXID... 4 2.1.1 Orderstatus... 4 2.1.2 Brutto-/Netto-Preise... 5 2.1.3 Mehrwertsteuer... 5 2.1.4 Emails für Orderstatus... 5 2.1.5 Texte für Zuzahlungen, Geschenke im Bestellimport... 7 2.2 Einstellungen in CAO... 8 2.2.1 Einstellungen Allgemein... 8 2.2.2 Einstellungen URL/Proxy... 8 2.2.3 Einstellungen Orderstatus... 8 2.2.4 Einstellung Lieferarten... 9 2.2.5 Einstellung Zahlart... 10 3. Artikel... 11 3.1 Staffelpreise... 11 3.2 Variantenartikel... 11 3.2.1 Variantenartikel ab CAO-Faktura 1.4.3.9... 13 3.3 Unverbindliche Preisempfehlungen... 13 3.4 Basispreise... 14 3.5 Auswahllisten... 14 3.6 Lieferstatus... 14 3.7 Aktionspreise... 14 4. Hersteller... 15 5. Shop-Kategorien... 15 6. Meta Daten... 15 7. Bilder... 15 8. Kundennummern weiterverwenden... 15 9. Bestellnummer verwenden... 15 10. Mehrsprachigkeit... 16 11. Die Pro-Version... 17 12. Zeichenkodierung... 20 Seite 3
- 4-4 1. Installation 1.1 Installation des Scripts Nachdem Sie die gelieferte Archiv-Datei in ein beliebiges Verzeichnis auf Ihren Rechner entpackt haben, kopieren Sie den Ordner coi auf Ihren Web-Server in das Hauptverzeichnis von OXID, also dort wo sich auch die Verzeichnisse admin, core, out usw. befinden. Das Verzeichnis coi können Sie beliebig umbenennen, nur der Inhalt muss gleich bleiben. Innerhalb der Dokumentation wird immer vom Verzeichnis coi ausgegangen. Die Lizenzdatei license.inc.php, die auf Ihren Namen registriert ist und die key.coi.php ebenfalls in das Verzeichnis coi kopieren. Die eigentliche Installation ist somit schon abgeschlossen. Folgende Dateien müssen in dem Verzeichnis vorhanden sein: - bis Oxid 4.6.x coi.php co_htmlfunc.php co_ox2cao.php co_oxfunc.php co_xmlfunc.php co_paymentfunc.php xmlscheme.inc license.inc.php key.coi.php Verzeichnis ixed - ab Oxid 4.7.x coi.php co_htmlfunc.php co_ox2cao.php co_ofunc.php co_xmlfunc.php co_paymentfunc.php xmlscheme.inc license.inc.php key.coi.php Verzeichnis ixed Seite 4
- 5-5 2. Einstellungen Damit CAO und OXID korrekt zusammenarbeiten, müssen einige Einstellungen vorgenommen werden. 2.1 Einstellungen in OXID Die Einstellungen beziehen sich auf die OXID eshop Version 4, bis Version 4.7.4. Melden Sie sich als erstes in den Adminbereich des Shops an. 2.1.1 Orderstatus Wählen Sie im Adminbereich Stammdaten/Grundeinstellung/Einstell./Administrationsbereich. Im Feld Ordner in der Bestellverwaltung geben Sie den Status der Order ein, den Sie später in CAO nutzen wollen. Die Farbkodierung hinter den Text ist zwingend bei jedem Eintrag anders zu wählen, da diese Kodierung als Verknüpfung für CAO und für die später zu erstellenden Emailtexte genutzt wird. Ab der OXID Version 4.1.2 wurden die Bezeichner als Variablen für die im Adminorder liegende /xx/lang.php eingeführt, damit diese Sprachunabhängig sind. /xx/ steht für das jeweilige Land. Die jeweiligen Bezeichner müssen in der lang.php oder cust_lang.php eingegeben werden, ansonsten wird bei einem Wechsel des Orderstatus der Bezeichner in der Bestelltabelle von OXID eingetragen. 2.1.2 Brutto-/Netto-Preise Wollen Sie in CAO die Shop-Preise als Nettopreise nutzen, so wählen Sie in OXID Stammdaten/Grundeinstellung/Einstell./Mehrwertsteuer und setzten den Haken bei Versandkosten als Nettopreise eingeben (Versandkosten zuzüglich MwSt.) Danach wählen Sie Stammdaten/Grundeinstellung/Einstell./Weitere Einstellungen und setzen einen Haken bei Artikel- und Geschenkverpackungspreise netto eingeben (zuzüglich MwSt.) Sie sollten sich im Anfangsstadium des Shops entscheiden ob Sie die Preise Netto oder Brutto eingeben möchten. Ein späteres Umsteigen birgt sehr große Gefahren in der Falschkalkulierung Ihrer Bestellungen. 2.1.3 Mehrwertsteuer Die Mehrwertsteuereinstellung muss denen von CAO angepasst werden. Dazu Stammdaten/Grundeinstellung/Einstell./Weitere Einstellungen wählen, und in dem Feld MwSt.- Einstellungen für Lexware Faktura die MwSt-Werte denen von CAO anpassen. Dabei ist die linke Zahl die ID und die rechte Zahl der MwSt-Wert, so wie es in den allgemeinen Einstellungen von CAO abzulesen ist. Seite 5
- 6-6 2.1.4 Emails für Orderstatus Damit der Kunde beim bearbeiten der Bestellung aus CAO heraus per Email benachrichtigt werden kann, können in OXID Emailtexte hinterlegt werden, die das Script ausliest und versendet. Dazu wählen Sie Kundeninformation/CMS-Seiten und legen eine neue CMS-Seite an. Geben Sie einen Titel ein. Der Text im Titelfeld wird in der späteren Email als Betreffzeile verwendet. In dem Ident.-Feld geben Sie die entsprechende Farbkodierung des Orderstatus an. Hat z.b. die Order Versand den Farbkodierung #01fd36, so geben Sie diese ohne das Zeichen # in das Ident.-Feld ein. Dadurch wird der Orderstatus mit der Email verknüpft. Ab der OXID Version 4.1.1 wird da s Zeichen # nicht mehr zugelassen. Daher achten Sie darauf nur den reinen Code der Farbkodierung einzugeben. Also anstatt #01fd36, nur 01fd36. In den eigentlichen Emailtext können Platzhalter eingesetzt werden die das Script beim Versenden mit den richtigen Inhalten ersetzt. Folgende Platzhalter sind möglich: <IMAGE> es wird das Bild logo_white.gif eingesetzt (out/basic/img im OXID-Verzeichnis) <NAME> Name des Bestellers, Format: Anrede Vorname Nachname <ORDERNR> Bestellnummer (kann auch in der Titelzeile/Betreff eingesetzt werden) <ORDER> Liste der Bestellten Artikel <ADRESS> Rechnungsadresse <DELADRESS> Lieferadresse <SHOPTEAM> Shopname aus den Stammdaten Setzen Sie einen Editor für die Texte in Oxid ein, wie z.b. fckeditor, so werden die Platzhalter verändert. Daher sind ab COI Version 1.21 neue Platzhalter hinzugekommen. Folgende Platzhalter sind zusätzlich möglich: [#IMAGE#] es wird das Bild logo_white.gif eingesetzt (out/basic/img im OXID-Verzeichnis) Name des Bestellers, Format: Anrede Vorname Nachname Bestellnummer (kann auch in der Titelzeile/Betreff eingesetzt werden) Liste der Bestellten Artikel Rechnungsadresse [#NAME#] [#ORDERNR#] [#ORDER#] [#ADRESS#] [#DELADRESS#] Lieferadresse [#SHOPTEAM#] Shopname aus den Stammdaten Ab der COI-Version 1.40 ist es möglich Smarty-Tags in die Ordermails einzufügen. Dadurch lassen sich die Emails individueller gestalten, und vorgefertigte Texte, wie z.b. AGB s leichter hinzufügen. Seite 6
- 7-7 Folgende Objekte können mit Smarty angesprochen werden: $shop - greift auf oxshop $oviewconf - wie $shop $order - greift auf oxorder Damit können Sie z.b. Bilder mit <img src="[{$oviewconf->getimageurl()}]bildname.jpg"> in die Email einfügen. Auf die Inhalte der Bestellung kann z.b. mit [{$order->oxorder feldname->value}] zugegriffen werden. Und die Inhalte von CMS-Seiten können mit [{ oxcontent ident="id der CMS" }] In die Ordermail eingefügt werden. 2.1.5 Texte für Zuzahlungen im Bestellimport Die Texte die beim Bestellimport für Zuzahlungen, Gutscheine, Geschenke usw. verwendet werden, können individuell angepasst werden. Dazu sind in der cust_lang.php, zu finden in out/basic/de, folgende Einträge hinzuzufügen: 'COI_ORDERGIFTCARD' => 'Geschenkkarte', 'COI_ORDERGIFTPAPER' => 'Geschenkpapier', 'COI_ORDERDISCOUNT' => 'eingelöster Gutschein', 'COI_DISCOUNTMINUS' => 'Rabatt', 'COI_DISCOUNTPLUS' => 'Zuschlag', 'COI_ORDERPAYCOST' => 'Zuzahlung Zahlart', 'COI_ORDERSHIPPINGCOST' => 'Versandkosten', 'COI_ORDERTAX' => 'MwSt', 'COI_ORDERSUBTOTAL' => 'Zwischensumme', 'COI_ORDERTOTAL' => 'Summe', 'COI_ORDERSELVARIANT' => 'Auswahl zu Artikel', 'COI_PERSARAM' => 'Artikelbeschriftung', Sind die Einträge, oder nur bestimmte von ihnen, in der cust_lang.php nicht vorhanden, so werden die Standardtexte genommen, so wie sie oben abgebildet sind. Zusätzlich können noch die Liefertexte in der Sprachdatei angegeben werden, welche bei Neuanlage von Artikeln genutzt werden. Dies ist vor allem für Besitzer der Standard-Version nützlich. Dazu sind folgende Einträge zu ergänzen: 'COI_ORDERTXT' => ' Lieferzeit 1-2 Tage', 'COI_NOORDERTXT' => ' Lieferzeit 1-2 Wochen', Sind die Einträge nicht vorhanden, so werden die Standardtexte, oder die eingestellten Texte der Pro-Version, genutzt. Seite 7
- 8-8 2.2 Einstellungen in CAO Die Einstellungen beziehen sich auf die CAO-Versionen 1.4.4.0 K und 1.4.4.0 F. Wählen sie aus dem CAO-Menü Datei/Shop-Einstellungen 2.2.1 Einstellungen Allgemein Setzen Sie den Haken bei Shopfunktionen aktiv, damit die Shopfunktionen in CAO eingeschaltet werden. Als Software ist oscommerce zu wählen, da ansonsten die Authentifizierung nicht funktioniert. Ab CAO 1.4.2.8 K sollte OXID gewählt werden. Wählen Sie Ihren Shop-Preis, die Debitorennr., sowie die Warengruppe für Shopartikel aus. Alle anderen Einstellungen erklären sich von selbst. Sind alle Einstellungen getätigt, so speichern Sie diese ab. 2.2.2 Einstellungen URL/Proxy Im Feld URL zum Script geben Sie Ihren Pfad zum Interfacescript ein. Als Benutzername und Passwort geben Sie die Zugangsdaten des OXID Shop-Admin an. Die Zugangsdaten werden beim Aufruf des Scripts auf Richtigkeit geprüft. Sollten Sie über einen Proxy-Server auf ihren Web-Server zugreifen, so sind diese Angaben in den Feldern für die Proxy- Einstellungen vorzunehmen. 2.2.3 Einstellungen Orderstatus Damit der Status der Bestellungen aus CAO heraus gepflegt werden kann, müssen die Order-Stadien erfasst werden. Um die Orderstadien von OXID in CAO einzupflegen, müssen diese zuerst aus OXID ausgelesen werden. Dazu rufen Sie das Script in Ihren Web-Browser auf: http://ihrewebshopurl.tld/coi/coi.php Sie erhalten den Anmeldebildschirm des Scripts. Melden Sie sich mit den Daten des OXID-Shop-Admins an. Hinweis: Sie können in OXID einen nicht aktiven Admin anlegen und damit das Script nutzen. Seite 8
- 9-9 Nach erfolgreicher Anmeldung gelangen Sie auf das Auswahlmenü. Hier lassen sich die IDs der Lieferarten, Zahlarten und der Orderstatus auflisten. Wählen Sie den Link Orderstatus. Die Orderstadien werden aufgelistet und können in CAO übernommen werden. Die ID entspricht dabei der CAO-ID. Die Bezeichnungen sind ab der OXID Version 4.1.2 als Variablennamen aufgeführt. Der Text zur Variable wird ausgelesen, falls dieser in der der lang.php oder cust_lang.php im Ordner /out/admin/de/ vorhanden ist. Die Bezeichnungen können abweichend in CAO eingegeben werden, je nach ihrer Bedeutung. Damit in OXID das Versand-, Bezahldatum sowie das Stornierung der Bestellung beim Update des Orderstatus gesetzt werden kann, muss noch die zugehörige Versand-, Bezahl- und Storno-ID ausgewählt werden. Nach dem Auswählen ist die Liste noch mit Speichern abzuspeichern. 2.2.4 Einstellung Lieferarten Um die Lieferarten von OXID in CAO einzupflegen ist die Vorgehensweise dieselbe wie bei den Orderstadien. Wählen Sie im Interfacescript den Link Lieferarten und die Lieferarten von OXID werden aufgelistet. Übernehmen Sie die Shop- Class-ID in das Feld Shop-Class (shipping_class) in den CAO-Lieferarteneinstellungen und wählen Sie die passende Lieferart zur ID. Seite 9
- 10-10 2.2.5 Einstellung Zahlart Auch hier ist die Vorgehensweise dieselbe wie bei dem Orderstatus oder den Lieferarten. Wählen Sie im Interfacescript den Link Zahlungsarten um die Zahlarten von OXID aufzulisten. Wählen Sie die passende Zahlart in CAO und übernehmen Sie die Shop-Class-ID in das Feld Shop-Class (paymentclass) Damit sind die grundsätzlichen Einstellungen zur Verknüpfung von CAO Faktura mit dem OXID eshop abgeschlossen. Seite 10
- 11-11 3. Artikel 3.1 Staffelpreise Die in CAO eingegebenen Staffelpreise zum jeweiligen Shopartikel und Shoppreis sind mit dem Interfacescript übertragbar. Dabei ist zu beachten, dass diese Funktion nur von der CAO K-Version unterstützt wird, und die Staffelpreise nur von CAO in den Shop übertragen werden können, nicht umgekehrt. Ab der CAO-Version 1.4.3.1 K werden auch die Prozentwerte des Staffelpreises übertragen und in Oxid gesetzt. Benutzer der Pro-Version können in den Einstellungen wählen, ob der Preis oder der Prozentwert in der Mengenstaffelung eingetragen werden soll. Wenn mit A-, B- oder C- Preisen in Oxid gearbeitet wird, so wird bei Mengenstaffelung in Prozent der jeweils richtige Staffelpreis zur jeweiligen Preisgruppe berechnet. 3.2 Variantenartikel Über einen Umweg lassen sich in der CAO K-Version (nicht mit der freien Version möglich) auch Variantenartikel verwalten. Dazu ist folgende Vorgehensweise einzuhalten. Der Vaterartikel Einen Vaterartikel legen Sie wie einen normalen Artikel in CAO an. Um diesen nun als Vaterartikel zu Kennzeichnen wir das Feld Meta Titel in der Shop-Beschreibung des Artikels mit dem Schlüssel @VARNAME@::Bezeichnung der Variante versehen. Dabei dient @VARNAME@ als Schlüssel und :: als Trennzeichen hinter der die Bezeichnung der Variante eingegeben wird. Ist der Vaterartikel als kaufbar in OXID eingestellt so kann noch ein zusätzlicher Schlüssel angegeben sein, der den Auswahltext des Vaterartikels angibt. Dieser Schlüssel lautet: @VARTEXT@::Text der Variante. Wobei auch hier wieder gilt, @VARTEXT@ dient als Schlüssel und :: als Trennzeichen hinter der der Variantentext eingegeben wird. Der Komplette Schlüssel hat dann folgendes Format: @VARNAME@::Bezeichnung der Variante::@VARTEXT@::Text der Variante. Beachten Sie hierbei die zusätzlichen Trennzeichen zwischen den Schlüsseln. Variantenartikel Variantenartikel werden ebenfalls wie normale Artikel in CAO eingegeben, mit der Ausnahme, dass die Artikelnummer die des Vaterartikels mit angehängter Nummer entsprechen muss. Lautet die Artikelnummer des Vaters 12345, so lautet die Artikelnummer der Variante z.b. 12345-01. Die weitere Bezeichnung nach dem Trennstrich ist frei wählbar. Somit können auch Artikelnummern für die Variante angegeben werden die mehrere angehängte Nummern besitzen, z.b. 12345-123- 123456-1. Es muss nur der Teil vor dem Trennstrich der Vaterartikelnummer entsprechen, ansonsten werden die Artikel nicht zum Vater zugeordnet. Zusätzlich braucht der Variantenartikel ebenfalls noch eine Variantenbezeichnung die wiederum als Schlüssel im Feld Meta Titel der Shop-Beschreibung eingegeben wird. Der Schlüssel für den Variantenartikel lautet: @VARTEXT@::Text der Variante. Wobei auch hier wieder gilt, @VARTEXT@ dient als Schlüssel und :: als Trennzeichen hinter der der Variantentext eingegeben wird. Seite 11
- 12-12 Um die Variante zu sortieren kann der Schlüssel @VARSORT@::Sortierungszahl angegeben werden, wobei Sortierungszahl eine Zahl größer Null sein muss. Der Lieferstatus der Variante lässt sich mit einem zusätzlich Schlüssel angeben, @VARLIEF@::Lieferstatus. Der Lieferstatus wir als Zahl angegeben, dabei haben die einzelnen Stadien folgende Bedeutung: 1 Standard 2 Wenn ausverkauft, Artikel offline 3 Wenn ausverkauft, Artikel nicht bestellbar 4 Fremdlager Der Komplette Schlüssel hat dann folgendes Format: @VARTEXT@::Text der Variante::@VARSORT@::Sortierungszahl::@VARLIEF@::4 Beachten Sie hierbei die zusätzlichen Trennzeichen zwischen den Schlüsseln. Ab der CAO-Version 1.4.3.6K sind neue Felder vorhanden, mit denen die Sortierung und der Lieferstatus angegeben werden kann. Die Angaben innerhalb des Schlüssels können dann wegfallen. Ab CAO 1.4.3.7K werden diese Informationen auch beim Shoptransfer eingelesen. Multivarianten: Multi-Varianten, so wie ab der Oxid Version 4.2.0 möglich, sind ab der COI Version 1.38 erstellbar. Dazu muss der Text der Variante dem Format von Oxid folgen, also z.b. @VARTEXT@::Größe xl Farbe rot Stoffart Wolle Vaterartikelnummer: Ab der COI-Version 1.40 ist ein neuer Schlüssel für die Vaterartikelnummer vorhanden. Mit @VARART@::Vaterartikelnummer kann die Vaterartikelnummer angegeben werden. Dabei ist darauf zu achten, dass der Schlüssel als erster angegeben wird. Der komplette Schlüssel kann dann z.b so aussehen: @VARART@::1808001::@VARTEXT@::XL Schwarz (050)::@VARLIEF@::1 Besitzer der Pro-Version des Interfacescripts haben die Möglichkeit einzustellen, ob der Schlüssel für den Vaterartikel beim Importieren gesetzt werden soll. Zusätzlich kann auch weiterhin angegeben werden, welches Benutzerfeld die Artikelnummer des Vaterartikels enthält. Tragen Sie die Nummer des Benutzerfelds in den Einstellungen des Scripts ein und Speichern es ab. Zu beachten ist hierbei, dass Benutzerfelder nur mit der CAO K-Version übertragen werden. Sofern nicht auf die Möglichkeit des Schlüssels zurück gegriffen werden soll, können Benutzer der Pro-Version einstellen, wie die Vaterartikelnummer aus der Variantenartikelnummer separiert werden soll. Seite 12
- 13-13 Mit der Einstellung Anzahl Trennstriche in Vaterartikelnummer geben sie an, wie viele Bindestriche in der Vaterartikelnummer enthalten ist. Beispiel: Variantenartikelnummer = 12-1234-123-12 Anzahl Trennstriche = 2 Vaterartikelnummer = 12-1234 Mit der Einstellung Anzahl Trennstriche, von hinten, bis Vaterartikelnummer kann eingestellt werden wie viele Bindestriche von hinten gezählt die Vaterartikelnummer abbildet. Beispiel: Variantenartikelnummer = 12-1234-123-12-123 Anzahl Trennstriche von hinten = 2 Vaterartikelnummer = 12-1234-123 Artikel die aus OXID in CAO importiert werden und als Variantenartikel eingegeben sind, werden mit den entsprechenden Schlüsseln in CAO angelegt. Auch wird das Benutzerfeld entsprechend mit der Artikelnummer des Vaterartikels gefüllt, sofern Sie die Pro-Version nutzen. 3.2.1 Variantenartikel ab CAO-Faktura 1.4.3.9K Ab der CAO-Faktura Version 1.4.3.9 sind Variantenartikel in der Warenwirtschaft bearbeitbar. Dadurch fällt der Umweg über den Schlüssel im Meta-Titel weg. Damit die Varianten in den Shop übertragen werden können, muss man das in den Shop- Einstellungen von CAO-Faktura einstellen. Dazu in den Shop-Einstellungen den Reiter Sonstiges wählen und den Haken bei Varianten in den Shop übertragen setzen. Die Einstellung ist nur verfügbar, wenn das Variantenmodul für CAO-Faktura erworben wurde. In der Schnittstelle muss eingestellt werden, dass man die neue Variantenfunktion von CAO nutzen möchte. Dazu in den COI-Einstellungen die Einstellung Variantengenerierung ab CAO 1.4.3.9 nutzen auf Ja stellen. Ansonsten werden weiterhin die Schlüssel für die Varianten genutzt. Wenn in CAO-Faktura noch keine Varianten zugeordnet wurden, der Artikel über den Schlüssel die Variantenzuordnung enthält und Sie CAO-Faktura ab der Version 1.4.3.9 einsetzen, und eingestellt ist das Sie die neue Variantenfunktion nutzen, dann werden die Varianten in Oxid gelöscht, sobald der Artikel in den Shop übertragen wird. Damit man nicht alle Variantenzuordnungen nochmals setzten muss, kann man die Shop-Artikel in CAO-Faktura einlesen. Dazu im Shoptransfer nach dem Einlesen der Artikel auf alle Artikel aktualisieren klicken. Die Varianten werden dann in CAO- Faktura entsprechend angelegt. 3.3 Unverbindliche Preisempfehlungen Die Pflege des UvP ist ebenfalls nur mit der Pro-Version des Scripts möglich. Hierbei können Sie in den Einstellungen des Scripts eingeben, welches VK-Preisfeld in CAO als UvP genutzt werden soll. Dabei ist darauf zu achten das das gewählte VK-Preisfeld abweichend vom Shop-Preisfeld ist und einen höheren Preis enthält als der des Shoppreises. Seite 13
- 14-14 3.4 Basispreise Die Felder Einheit und Faktor in den erweiterten Einstellungen des CAO-Artikels dienen als Basis für die Berechnung der Shop-Preise in OXID. z.b.: Ein Artikel hat 1,5 Liter. Sie wollen den Grundpreis pro Liter angeben: Geben Sie bei Faktor 1,5 ein. Wählen Sie bei Einheit Liter aus. Dann wird beim OXID-Artikel der Grundpreis pro Liter angezeigt. 3.5 Auswahllisten Artikel, denen in Oxid eine Auswahlliste zugeordnet wurde, können in der Bestellung als freier Artikel Importiert werden, sofern Sie die Pro-Version nutzen. In den Einstellungen der Pro-Version kann das Importieren mit und ohne Preis ein- bzw. ausgeschaltet werden. 3.6 Lieferstatus Ab der CAO-Version 1.4.3.6 ist der Lieferstatus im Artikel wählbar. Somit kann der Lieferstatus bei allen Artikeln gesetzt werden, ohne Umweg über Benutzerfelder. Ab der CAO-Version 1.4.3.7 wird diese Information auch vom Shop nach CAO übertragen. 3.7 Aktionspreise Ab der CAO-Version 1.4.3.8K und COI 1.57 können Aktionspreise zum Artikel in den Shop übertragen werden. Dazu wird für den Artikel ein Rabatt angelegt, der als Titel die Artikelnummer enthält. Der Rabattsatz wird in OXID gelöscht, wenn das Gültigkeitsdatum überschritten ist, und der Artikel in den Shop übertragen wird. 4. Hersteller Das Feld Hersteller-URL wird zur Angabe der Kurzbezeichnung des Herstellers genutzt, da in CAO zurzeit kein passendes Feld zur Verfügung steht und in OXID die URL bei den Herstellern nicht vorhanden ist. 5. Shop-Kategorien In den CAO Shop-Kategorien wird das Feld Meta Titel zur Kurzbeschreibung der Kategorie genutzt, da in CAO zurzeit kein passendes Feld zur Verfügung steht und die Meta Titel in OXID nicht vorhanden sind. 6. Meta Daten In OXID wird eine Seo-Tabelle gepflegt, die die Meta Daten enthält. Diese lässt sich mit den CAO Meta Daten füllen, wobei die Daten aus Meta Titel nicht übertragen werden, da dieses in der Seo-Tabelle anders geregelt ist. Auch ist es bisher nicht möglich bei Neuanlage von Artikeln, Kategorien, usw. die Meta Daten in die Seo- Tabelle einzupflegen, da das Script die Einträge in die Seo-Tabelle bisher nicht vornimmt. Sobald der neue Artikel, neue Kategorie, usw. über den Shop aufgerufen wird, nimmt OXID selbständig den Eintrag in die Seo-Tabelle vor. Bei einem Update aus CAO heraus werden die Meta Daten in die Seo-Tabelle gespeichert, sofern dort schon ein Eintrag besteht. Seite 14
- 15-15 7. Bilder Beim Hochladen der Bilder von CAO zu OXID werden die Größeneinstellungen der Bilder in OXID berücksichtigt. Ist ein Bild also größer als in den Einstellungen angegeben, so wird dieses Bild nicht zu OXID übertragen. Ausnahme ist auch hier wieder die Pro-Version des Scripts. Dort kann eingestellt werden ob die Bilder den Größenangaben von OXID angepasst werden sollen. Zu große Bilder werden dann entsprechend verkleinert. Die Bilder sollten eine Dateigröße von 1 MB nicht überschreiten, da die PHP-Einstellungen einen Dateiupload von mehreren MB meist nicht zulassen. Bei den Artikelbildern sollte man sich an die Größe der Zoombilder von OXID halten, da aus diesem einen Bild mehrere kleinere Bilder erstellt werden. 8. Kundennummern weiterverwenden Haben Sie in den Shopeinstellungen von CAO angegeben, dass die Kundennummer weiterverwendet werden soll, so wird die ID des Kunden als Kundennummer in CAO genutzt. Im Normalfall fängt die ID bei eins an, wobei diese dem Shop-Admin zugeteilt ist, und dieser kann nicht in CAO importiert werden. Sie haben die Möglichkeit die ID zu steuern. Dazu vergeben Sie dem ersten Kunden im OXID eine neue Kundennummer. Alle anderen Kunden, falls schon vorhanden sollten entsprechend durchnumeriert werden. Bei einer Neuinstallation von OXID rufen Sie danach den Kundenimport in CAO auf, und die Kunden-ID entspricht der Kundennummer in OXID. Sollten Sie schon länger mit OXID und CAO arbeiten, so muss die Datentabelle oxuser in der OXID-Datenbank angepaßt werden, indem die Felder OXCAOID und OXUPDATE gelöscht werden. Diese werden beim Import neu angelegt. Schon importierte Kunden in CAO verlieren dabei ihre ID zum Shop. Daher muss jeder Shop-Kunde in der CAO-Datenbank, in der Tabelle adressen angepasst werden. Ab der Oxid-Version 4.4.0 wird die Kundennummer per Autowert weitergezählt und auch als Kundennummer für CAO genutzt. Somit können Sie die Kundennummern für CAO im Backend des Oxid anpassen und müssen nicht mehr direkt in der Datenbank editieren. Achten Sie aber darauf, das Kundennummern nicht doppelt vergeben werden, da sonst die Zuordnung zu CAO nicht mehr gegeben ist. ACHTUNG! Eine Datensicherung ist bei Eingriffen in die Datenbank oberste Pflicht. Haftung für manipulierte Datenbanken werden nicht übernommen. 9. Bestellnummern verwenden Bestellungen in OXID werden von eins angefangen durchnummeriert. Möchten Sie eigene Bestellnummern nutzen, so vergeben Sie der ersten Bestellung in OXID Ihre Bestellnummer. Alle anderen Bestellungen, falls schon vorhanden sollten entsprechend durchnumeriert werden. Die Bestellungen sollten noch nicht in CAO importiert worden sein. Von einer nachträglichen Änderung ist abzuraten, da ansonsten vorhandene Bestellungen in CAO ihre ID zum Shop, den Bestellstatus und die Kundenzuordnung verlieren können. Sollte es dennoch nötig sein die Bestellnummern nachträglich anzupassen, so ändern Sie in der OXID-Tabelle oxorder das Feld OXCAOID entsprechend ab. Seite 15
- 16-16 Das Abändern des Wertes in OXCAOID ist ab der COI-Version 1.49 und der CAO- Version 1.4.3.6 nicht mehr nötig, da die Bestellnummer und die CAO-ID separat übertragen werden. Somit bleiben die Zuordnungen erhalten, auch wenn die Bestellnummer unterschiedlich zu ID ist. ACHTUNG! Eine Datensicherung ist bei Eingriffen in die Datenbank oberste Pflicht. Haftung für manipulierte Datenbanken werden nicht übernommen. 10. Mehrsprachigkeit Ab der CAO-Version 1.4.4.0 K können Artikel, Kategorien und Varianten in mehreren Sprachen angelegt werden. Die Funktionen sind nutzbar, wenn das Zusatzmodul für die Mehrsprachigkeit erworben wurde. Zu beachten ist, dass im Oxid-Shop die zusätzliche Sprache aktiv ist, und in den allgemeinen Einstellungen/Sprache von CAO- Faktura die Shop_Sprach_id und der ISO-Code mit denen der Shopsprache übereinstimmen, da ansonsten falsche Daten übertragen werden könnten. Mehrsprachige Varianten lassen sich zudem nur in Verbindung mit dem Variantenmodul verwalten, da über den Variantenschlüssel keine Sprachen übertragbar sind. Seite 16
- 17-17 11. Die Pro-Version Die grundsätzlichen Funktionen sind in der Pro-Version des Scripts ebenfalls enthalten. Zusätzlich dazu können bestimmte Einstellungen vorgenommen werden, die die Funktionalität des Scripts erweitern. Folgende Einstellungen sind möglich: Kreditlimit: Hier kann der Boni des Kunden bei Kundenneuanlage angegeben werden. Start CAO-User ID: Start CAO-Hersteller ID: Start CAO-Kategorie ID: Start CAO-Artikel ID: Damit lässt sich einstellen mit welcher Start-ID die Kunden, Hersteller, Kategorien und Artikel nach CAO übertragen werden sollen. Damit lässt sich verhindern, dass vorhandene Kunden, Hersteller, Kategorien und Artikel in CAO überschrieben werden, da die ID in CAO schon vorhanden sein könnte. Dieses wird nur beim erstmaligen übertragen der Daten aus dem Shop in ein bereits existierendes CAO benötigt. Werden die Daten aus CAO in den Shop übertragen, so gibt CAO die ID vor. Kunden in Newsletter eintragen: Hiermit stellen Sie ein ob Kunden, die Sie aus CAO in den Shop übertragen, in der Newsletterliste aktiv geschaltet sind, so das diese beim Newsletterversand angeschrieben werden. Alle Kunden die Sie aus CAO in den OXID-Shop übertragen, werden in die Newsletter eingetragen, aber nur in der Pro-Version des Scripts können diese auf Aktiv gesetzt werden. Bilder nach OXID-Vorgabe verkleinern: Beim Hochladen der Bilder von CAO zu OXID werden die Größeneinstellungen der Bilder in OXID berücksichtigt. Ist ein Bild größer als in den Einstellungen angegeben, so wird dieses Bild im Normalfall nicht zu OXID übertragen. Hier können Sie einstellen, dass zu große Bilder automatisch auf den Vorgabewert verkleinert werden. Liefertext: Liefertext kein Bestand: Hier können Sie vorgeben welche Texte für die Lieferzeit beim Neuanlegen von Artikel genutzt werden sollen. Als Alternative, vor allem für Nutzer der COI Standard-Version, können die Liefertexte in der Sprachdatei cust_lang.php, zu finden in out/basic/de, hinzugefügt werden. Dazu sind folgende Einträge in der cust_lang.php hinzuzufügen: 'COI_ORDERTXT' => 'Liefertext für auf Lager', 'COI_NOORDERTXT' => 'Liefertext für nicht lieferbar', Sind die Einträge nicht vorhanden, so werden die Standardtexte, oder die eingestellten Texte der Pro-Version, genutzt. Seite 17
- 18-18 CAO Benutzerfeld für Variantenvaterartikel: Hier stellen Sie ein welches Benutzerfeld, bei den Artikeln, in CAO die Artikelnummer der Vatervariante enthält. Beachten Sie bitte, dass Benutzerfelder nur von der CAO K-Version übertragen werden. CAO VK-Preisfeld für UvP: Hier geben Sie an welches VK-Preisfeld in CAO als UvP genutzt wird. Dabei ist darauf zu achten das das gewählte VK-Preisfeld abweichend vom Shop-Preisfeld ist und einen höheren Preis enthält als der des Shoppreises. Bestätigungsmail bei Orderstatuswechsel Hier können Sie auswählen ob Sie eine Bestätigungsmail erhalten wollen, wenn eine Email an den Kunden, beim Wechsel des Orderstatus, versand wurde. Ist keine Emailvorlage in Oxid für den Orderstatus vorhanden, so wird auch keine Bestätigungsmail versendet. Lesebestätigung für Orderstatusmail: Wenn eine Orderstatusmail versendet wird, können Sie hier angeben ob Sie eine Lesebestätigung anfordern möchten. CAO-Langtext gleich OXID-Artikeltext Hiermit können Sie angeben, ob der OXID Artikeltext in dem Langtextfeld des CAO - Artikels übertragen wird. Stichworte aus Artikelbeschreibung erstellen Hiermit können Sie wählen ob die Stichworte (Tag Cloud) aus der Artikelbeschreibung erstellt werden soll. Zeichenanzahl ab wann Stichworte erstellt werden Hier kann angegeben werden ab wie viel Zeichen in der Artikelbeschreibung die Stichworte erstellt werden sollen. Möglich sind Eingaben von 20 bis 999. Angaben unter 20 werden auf den Standardwert 80 gesetzt. Staffelpreise als Prozentwert Hier kann eingestellt werden, ob die Staffelpreise als fester Preis oder als Prozentwert angelegt werden sollen. Die Übermittlung des Prozentwertes ist erst ab der CAO Version 1.4.3.1 möglich. Auswahl als freier Artikel in Bestellung Damit stellen Sie ein, ob die Oxid-Auswahllisten, als freier Artikel in die Bestellung importiert werden soll. Auswahl mit Preis übertragen Ist Auswahl als freier Artikel in Bestellung ausgewählt, kann hier zusätzlich angegeben werden ob der freie Artikel den Gesamtpreis der Oxid-Auswahl erhalten soll. Seite 18
- 19-19 CAO-KundenId vor OXID-Kundennummer (ab Oxid 4.40) Bei einem update auf Oxid 4.4.0 von einer vorherigen Version kann hier eingestellt werden, dass die CAO-ID als Kundennummer für CAO genommen werden soll, anstatt die Kundennummer von Oxid zu verwenden. Dies verhindert, das alte Kundendaten von CAO nicht mehr gefunden werden, da ab Oxid 4.4.0 auch die Kundennummer als CAO-Id genutzt werden kann. Versanddatum setzten wenn Bestellung bezahlt Hiermit lässt sich einstellen, ob beim Statusupdate das Versanddatum mit gesetzt werden soll, wenn die Bestellung als Bezahlt markiert wird. Standard ist hier, das das Versanddatum gleich dem Bezahldatum ist. Artikelmenge in offenen Rechnungen berücksichtigen Um die tatsächliche Lagermenge in Oxid anzugeben, kann der Parameter auf Ja gesetzt werden. Dann werden die Artikelmengen in offenen Rechnungen und Lieferscheinen für die Lagermenge berücksichtigt und von der Lagermenge des Artikels abgezogen. Dazu muss in CAO-Faktura, beim Upload der Artikel, der Schalter Artikelmengen in unfertigen Belegen (AU,RE,LS) mit einbeziehen angehakt werden Artikelmenge in Aufträgen berücksichtigen Mit diesem Schalter kann zusätzlich die in den Auftragsbestätigungen vorhanden Artikelmengen zur Lagerbestandsberechnung übertragen werden. Dann wird von der Lagermenge des Artikels die benötigte Menge in der Auftragsbestätigung abgezogen. Dazu muss in CAO-Faktura, beim Upload der Artikel, der Schalter Artikelmengen in unfertigen Belegen (AU,RE,LS) mit einbeziehen angehakt werden. Artikelbeschreibung bei Leer überschreiben Wenn diese Einstellung auf Ja steht, dann wird der Artikeltext mit dem Langtext des Artikels überschrieben, wenn der Shop-Text keinen Text enthält. Basispreis über Mengeneinheit berechnen Mit dieser Einstellung kann gewählt werden, ob der Basispreis mit der Mengeneinheit oder mit der Basispreiseinheit bezeichnet werden soll. Artikelsortierfeld in den Kategorien übertragen Hiermit wird eingestellt, ob das Sortierfeld des Artikels den Artikel in den Shop- Kategorien sortieren soll. Artikelsortierfeld nach CAO übertragen als Die Belegung des Suchfelds im CAO-Artikel kann hiermit nach bestimmten Einstellungen belegt werden: Artikelnummer => Artikelnummer eintragen Artikelbezeichnung => Artikelbezeichnung eintragen Artikelnummer,Artikelbezeichnung => Artikelnummer + Bezeichnung eintragen Artikelbezeichnung,Artikelnummer => Artikelbezeichnung + Nummer eintragen Seite 19
- 20-20 Inaktive Artikel in CAO importieren Als Standard werden nur aktive Artikel nach CAO übertragen. Mit diesem Schalter kann gewählt werden, dass auch inaktive Artikel übertragen werden. Variantengenerierung ab CAO 1.4.3.9 nutzen Hiermit wählen Sie, ob die Variantenverwaltung von CAO genutzt wird, oder ob weiterhin mit dem Schlüssel die Varianten angelegt werden sollen. Die Schnittstelle erkennt dabei, ob CAO ab 1.4.3.9 genutzt wird und stellt die entsprechenden Tags zur Variantenverwaltung zusätzlich zu dem Schlüssel bereit, wenn Artikel in CAO importiert werden. Beachten Sie dabei, das Varianten im Shop gelöscht werden, wenn der Schalter auf Ja steht und Sie in CAO ab 1.4.3.9 keine Varianten angelegt haben. Die Variantenverwaltung von CAO kann im übrigen nur genutzt werden, wenn das entsprechende Modul erworben wurde. 12. Zeichenkodierung Bei der Installation des OXID eshops können Sie angeben ob Ihre Datenbank mit der Zeichenkodierung latin oder utf-8 arbeiten soll. Zusätzlich können Sie in der config.inc.php einstellen, ob der Shop ebenfalls die Zeichenkodierung utf-8 verwenden soll. Seit der CAO-Version 1.4.2.5 K kann CAO Daten in utf-8 Zeichenkodierung verarbeiten. Ab der COI-Version 1.17 werden die Daten von und zum Shop je, nach Einstellung in der config.inc.php, in der gewählten Zeichenkodierung übertragen. Seite 20