Installationsanleitung für CAO-FAKTURA Connector.

Transkript

1 Installationsanleitung für CAO-FAKTURA Connector. Folgende Schritte müssen beachtet werden, damit CAO-Faktura mit Ihrem Shop kommunizieren und Daten austauschen kann. Server-Konfiguration Wenn Sie PHP als FastCGI-Modul betreiben (z.b. bei Domainfactory) müssen Sie in die.htaccess Datei im Wurzelverzeichnisses des Shops folgende Zeilen einfügen: RewriteCond %{ ^Basic.* RewriteRule ^.*$ - [E=HTTP_AUTHORIZATION:%{ Andernfalls wird jeder Versuch den Shoptransfer in CAO-Faktura zu verwenden mit einem Fehler abgebrochen, dass Sie nicht autorisiert sind. Plugin installieren: Kontrollieren Sie bitte, ob im Shop unter Einstellungen Grundeinstellungen Shopeinstellungen Shops im Hauptshop unter Host Ihre Domain eingetragen ist (ohne Laden Sie das Plugin entweder direkt über den Plugin- Manager oder laden Sie sich die Zip-Datei herunter und nutzen Sie den Plugin- Manager um CAO-FAKTURA Connector zu installieren und zu konfigurieren. Sobald man auf Plugin editieren klickt, wird das Plugin automatisch aktiviert.

2 Einen Benutzer für die Schnittstelle generieren. Legen Sie sich im Backend von Shopware unter "Einstellungen - Benutzerverwaltung" einen neuen Benutzer an und generieren Sie einen Api- Key zur Authentifizierung. Hier im Beispiel ist der neue Benutzer CaoConnect.

3 Shopware konfigurieren. Zur ordnungsgemäßen Funktion müssen unter Artikel - Kategorien (für jede Kategorie und Unterkategorie) ganz unten bei "zusätzliche Freitextfelder" im Freitextfeld 6 die System ID der aktuellen Kategorie, welche Sie oben sehen können, eintragen werden. Lediglich bei einem neuen Shop werden nur die Kategorien Deutsch und Englisch angepasst und in Faktura eingelesen.

4 CAO- Faktura Shopeinstellungen konfigurieren. Unter Datei Shopeinstellungen im Reiter "Allgemeines" bitte oscommerce als Software auswählen. Wir empfehlen alle Haken zu setzen und den neuen Orderstatus auf in Bearbeitung zu setzen. Unter Url/Proxy die Adresse ihres Shops einfügen. Als Benutzer bitte CAOConnect eingeben und als Passwort den soeben angelegten API-Key aus dem Backend verwenden. Als URL verwenden Sie nur die Domain (z.b. und nicht wie im Hilfetext beschrieben, den kompletten Pfad zum Modul.

5 Bei "Order-Status" die Stadien genau so zuordnen, wie sie hier vorgegeben sind. Weitere Stadien sind jedoch möglich. 1 - Offen 2 - Bearbeitung (wartet) 3 - Storniert 4 - Abgelehnt 5 - zur Lieferung bereit 6 - komplett abgeschlossen

6 Anschließend importieren Sie bitte bei "Katalog" die drei Grundkategorien "Root", "Deutsch" und "Englisch". Sollte Englisch noch nicht vorhanden sein (Root und Deutsch wird immer von Shopware angelegt), so erstellen Sie diese Kategorie bitte im Backend des Online- Shops. Für Shopware sind Deutsch und Englisch als Kategorien wichtig und dürfen nicht deinstalliert oder gelöscht werden. Die Kategorien müssen zugewiesen werden. Sofern ein bestehender Shop importiert wird, kann es unter Umständen notwendig sein, den Import (ggfs auch mehrfach) zu wiederholen, bis alles vollständig importiert worden ist.

7 Nun können Sie Ihre Artikel in CAO einpflegen. Als Hinweis sei noch erwähnt, das es notwendig ist, einen Hersteller für die Artikel anzugeben da Shopware Artikel ohne Hersteller nicht annimmt..

8 Wenn Sie Ihre Artikel in CAO eingepflegt haben, transferieren Sie sie per Knopfdruck in den Onlineshop. Dazu wählen Sie den Reiter Update CAO > Shop (ebenfalls unter Shoptransfer) und klicken auf Update ausführen. Sollte wie im Screenshot der Knopf Update Ausführen deaktiviert sein, so sind bereits alle Aktualisierungen erfolgt.

9 Lieferart und Zahlart einrichten. Am einfachsten ist es, eine Bestellung durchzuführen. Anschließend importiert man die Bestellung. Taucht nun in der Rechnung (Aufträge - Rechnung)bei Lieferart und/oder Zahlart ein false auf, so muss man das entsprechende Feld anpassen. Diese Zuweisung geschieht unter Datei ShopEinstellungen im Reiter Lieferart oder Zahlart. Hier korrigiert man den mit false bezeichneten Wert entsprechend.

10 Genau so funktioniert es bei Zahlart... Anschließend die Bestellung löschen (unter Aufträge Rechnung) und neu importieren, damit das Mapping für diese Bestellung übernommen wird. Erfahrene Nutzer können diese Änderungen auch direkt in der Registry von CAO vornehmen, ohne den Umweg über eine Bestellung zu gehen.

11 Manuelle Vorgehensweise: Um das Mapping anzulegen, müssen Sie in der Datenbank nachsehen. Die Lieferarten stehen in der Tabelle s_premium_dispatch. Die von Ihnen im Shop angelegten Versand / Lieferarten werden dort aufgeführt. Sie benötigen die Ids der jeweiligen Versand / Lieferarten. Erstellen Sie unter CAO-FAKTURA im Reiter Lieferart jeweils neue Lieferarten. Wählen Sie aus der linken DropDown-Box eine Lieferart aus und weisen Sie im rechten Feld die dazugehörige Shop-ID der Versand / Lieferart zu. Hinweis: Sie können weitere Lieferarten anlegen. Gehen Sie in CAO über Modul Registrierungseditor. Dort navigieren Sie nach MAIN LIEFART und erstellen dort eine neue Lieferart. Weisen Sie jedem neuen Eintrag einen fortlaufenden Wert zu. Damit Sie die neuen Einträge in Shopeinstellungen finden, müssen Sie sich neu in CAO-FAKTURA anmelden. Im Reiter Zahlungsarten erfolgt das Mapping zwischen Shopware und CAO-FAKTURA.

12 Für Lastschrift ersetzen Sie banktransfer durch debit. Für Post Nachnahme ersetzten Sie cod durch cash. Für Vorkasse ersetzten Sie moneyorder durch prepayment Für Rechnung erstellen Sie einen neuen Eintrag: Klicken Sie auf das +, wählen aus der linken DropDown-Box Banküberweisung aus und tragen in die rechte Box invoice ein. Der Eintrag für Paypal bleibt unverändert. IMPORT von Shopware Bevor Sie nun Ihre Artikel importieren, testen Sie bitte zunächst unter "Shoptransfer - TransferLog" die Skript- Version mit dem Knopf "Lese Skript-Versionen". Sollte hier ein Fehler auftreten, so ist zu überprüfen ob alle nötigen Komponenten (z.b. ob der MSxml Parser) installiert sind. Folgende Vorarbeiten sind noch zu erledigen, wenn Sie schon Daten im Shop haben: Update der Kategorien: update s_categories_attributes set attributes6 = categorieid Update der Hersteller: insert into s_articles_supplier_attributes (id, supplierid, tadora_caoid) select id, id, id from s_articles_suppliers Achten Sie bitte auch darauf, dass die Steuersätze in Faktura mit dem Shop übereinstimmen. Beim Importieren halten Sie bitte folgende Reihenfolge ein: 1) Hersteller 2) Artikel 3) Kategorien 4) Kunden Fertig.