/*******************************************************************************************
*                                                                                          *
*  CAO-Faktura fr Windows Version 1.2                                                     *
*  Copyright (C) 2003 Jan Pokrandt / Jan@JP-SOFT.de                                        *
*                                                                                          *
*  This program is free software; you can redistribute it and/or                           *
*  modify it under the terms of the GNU General Public License                             *
*  as published by the Free Software Foundation; either version 2                          *
*  of the License, or any later version.                                                   *
*                                                                                          *
*  This program is distributed in the hope that it will be useful,                         *
*  but WITHOUT ANY WARRANTY; without even the implied warranty of                          *
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                           *
*  GNU General Public License for more details.                                            *
*                                                                                          *
*  You should have received a copy of the GNU General Public License                       *
*  along with this program; if not, write to the Free Software                             *
*  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
*                                                                                          *
*  ******* CAO-Faktura comes with ABSOLUTELY NO WARRANTY ***************                   *
*                                                                                          *
*  Programm     : CAO-Faktura                                                              *
*  Modul        : cao_xtc.php                                                              *
*  Stand        : 26.08.2009                                                               *
*  Version      : 1.56                                                                     *
*  Beschreibung : Script zum Datenaustausch CAO-Faktura <--> xtCommerce-Shop                           *
*                                                                                          *
*  based on:                                                                               *
* (c) 2000 - 2001 The Exchange Project                                                     *
* (c) 2001 - 2003 osCommerce, Open Source E-Commerce Solutions                             *
* (c) 2003 IN-Solution, Henri Schmidhuber                                                  *
* (c) 2003 RV-Design, Raphael Vullriede                                                    *
* Released under the GNU General Public License                                            *
*                                                                                          *
*  History :                                                                               *
*                                                                                          *
*  - 20.07.2003 HS nderungen fr OSC fr                                                  *
*  -    12.2004 RV Erweiterungen fr OSCommerce und CAO 1.2.6.1                            *
*  - 11.12.2004 JP Umgeschrieben fr XTC                                                   *
*  -    06.2004 JP und KL Erweitert fr XTC 3.x                                            *
*  - 20.10.2005 JP Anpassungen fr neue Scripte / XTC bis Version 3.0.4                    *
*  - 21.10.2005 JP nderungen fr Pawortbergabe                                          *
*******************************************************************************************/


Getestet mit Versionen 2x, 3.0.2 und 3.0.3 und 3.0.4

Feedback ist willkommen.


Als erstes sollte der XML-Parser (Microsoft  MSXML 4.0 Service Pack 2 / Deutsch) 
heruntergeladen und installiert werden. 
Wenn dies nicht erfolgt ist erhlt man in CAO die Fehlermeldung "Klasse nicht registriert".

Download unter : 
http://download.microsoft.com/download/5/f/d/5fda3c88-bd50-43cf-a845-73614e974e91/msxmlger.msi


Jetzt sollten die 2 Scripte cao_xtc.php und cao_xtc_functions.php in den Export-Ordner des Shops kopiert werden.


Nun sollte die Funktion des Scriptes festgestellt werden. 
Hierzu im Browser das Script aufrufen :

http://www.deinewebseite.de/shop/export/cao_xtc.php

Es sollte dann folgende Ausgabe folgen :

CAO-Faktura - xt:Commerce Shopanbindung


Aufruf des Scriptes mit
/xtc-shop/export/cao_xtc.php?user=ADMIN-EMAIL&password=ADMIN-PASSWORD-IM-KLARTEXT 


Rufen Sie anschlieend das Script mit der EMail-Adresse des Admins und dem Pawort auf.
Es sollte eine HTML-Seite mit diversen Links angezeigt werden.

Klicken Sie jetzt auf den Link "MySQL-Tabellen aktualisieren".
Jetzt werden die bentigten nderungen an der MySQL-Datenbank des Shops ausgefhrt. 
Diese Aktion kann beliebig oft wiederholt werden, Daten gehen hierbei nicht verloren.

  

Nun sind im CAO die Einstellungen fr den Shop einzutragen bzw. Anzupassen :

Im Men Datei->Shopeinstellungen auf der Seite URL/Proxy ist sowohl bei "URL zum Importscript" als auch bei "URL zum Updatescript" die Datei cao_xtc.php mit vollem Pfad einzutragen.

Also z.b. : http://www.deinewebsite.de/shop/export/cao_xtc.php

Im Feld Benutzername ist die EMail-Adresse des Administrators des Shops einzutragen.
Beim Pawort das Pawort des Admins.

Jetzt noch auf den Button Speichern klicken um die Einstellungen zu speichern.

Prfen Sie auch auf der Seite "Allgemein" das dort der richtige Shop in der Drop-Down-Box "Software" ausgewhlt ist. Auch hier mssen Sie auf Speichern klicken !


Nachdem nun die groben Einstellungen vollstndig sind, knnen Sie in der linken Navigation auf Tools->Shoptransfer wechseln und dort auf der Seite "Transfer-Log" unten links auf den Button "Lese Script-Versionen" klicken. Hier sollte Ihnen jetzt die aktuelle Versin angezeigt werden.



Mgliche Fehlernummern beim Testen bzw. lesen der Scriptversion 

Code 	Beschreibung
------------------------------------------------------------------------------
105	Benutzername (EMail) existiert im Shop nicht 
106	Benutzer ist kein Admin im Shop 
107	Benutzer darf keinen XML-Export ausfhren (siehe Admin-Rechte im Shop) 
108	Pawort stimmt nicht



PS: Danke an imrevo fr den Bugfix bei der SHIPPING_CLASS in der Datei order.php