DHL Intraship Schnittstelle

Thema wurde von marone22, 12. Januar 2014 erstellt.

  1. marone22

    marone22 Mitglied

    Registriert seit:
    10. Januar 2014
    Beiträge:
    5
    Danke erhalten:
    0
    Hi Leute,

    leider komme ich nicht ganz mit der Installationsanleitung klar:

    Im Text :" Zeile 260

    Ersetzen Sie

    $addresses_query = xtc_db_query("select address_book_id, entry_firstname as firstname........."

    Diese stelle finde ich gar nicht in meinen Orders.php

    Hat jemand diese selbst schon erfolgreich installiert?

    Grüße

    Richard
     
  2. Senior

    Senior Erfahrener Benutzer

    Registriert seit:
    17. April 2013
    Beiträge:
    816
    Danke erhalten:
    178
    Danke vergeben:
    241
    Was für eine Intraship Schnittstelle ist das?
    In der, die ich vom Gambio-Support installieren hab lassen, findet sich keine solche Installationsanweisung.
     
  3. marone22

    marone22 Mitglied

    Registriert seit:
    10. Januar 2014
    Beiträge:
    5
    Danke erhalten:
    0
    DHL Intraship Schnittstelle

    Das vorliegende Paket erweitert ein Gambio GX2 Shopsystem um die folgenden Features:

    - Erstellung von Versandetiketten über den Intraship-Dienst von DHL
    - optional: Paketankündigung an den Kunden senden (Tracking-Link)
    - verwendete Produkte (Paket national, international, ...) abhängig vom Empfängerland konfigurierbar
    - Auslandsversand wahlweise als "Economy" oder "Premium"

    - Unterstützung von Packstation- und Postfilial-Adressen
    - Integration des Postfinder-Dienstes zum Auffinden der nächsten Packstationen und Postfilialen um Umkreis einer Adresse mit Möglichkeit der Übernahme ins Adressbuch des Kunden
    - Filter zur Verhinderung der Eingabe von Packstation-/Postfilial-Adressen als Rechnungsadresse

    Bitte beachten Sie die enthaltene Installationsanleitung! Beginnen Sie die Installation keinesfalls ohne zuvor eine komplette Datensicherung (Dateien und Datenbank) vorzunehmen.

    Schwierigkeitsgrad der Installation: mittel
    87.52 KB | (09.01.2014)



    Folgende Anleitung liegt bei:

    DHL Intraship- und Postfinder-Integration
    -===========================================-

    Das vorliegende Paket erweitert ein Gambio GX2 Shopsystem um die folgenden
    Features:

    - Erstellung von Versandetiketten über den Intraship-Dienst von DHL
    - optional: Paketankündigung an den Kunden senden (Tracking-Link)
    - verwendete Produkte (Paket national, international, ...) abhängig vom
    Empfängerland konfigurierbar
    - Auslandsversand wahlweise als "Economy" oder "Premium"

    - Unterstützung von Packstation- und Postfilial-Adressen
    - Integration des Postfinder-Dienstes zum Auffinden der nächsten Packstationen
    und Postfilialen um Umkreis einer Adresse mit Möglichkeit der Übernahme
    ins Adressbuch des Kunden
    - Filter zur Verhinderung der Eingabe von Packstation-/Postfilial-Adressen als
    Rechnungsadresse


    Adressformat
    ------------

    Bei Packstation- und Filialadressen wird die Postnummer als Teil des Nachnamens-
    feldes gespeichert. Beispiele:

    Packstation:

    Vorname: Max
    Nachname: Mustermann/123823471
    Straße: Packstation 101
    Postleitzahl: 28217
    Ort: Bremen

    Postfiliale:

    Vorname: Max
    Nachname: Mustermann/123823471
    Straße: Postfiliale 536
    Postleitzahl: 28215
    Ort: Bremen

    In dieser Form eingegebene Adressen werden beim Druck von Versandetiketten
    entsprechend behandelt, unabhängig von der Nutzung des Postfinder-Dienstes.

    .......................................................................................................................................................................
    Installation
    ------------

    Bitte legen Sie vor der Installation eine vollständige Sicherung (Dateien und
    Datenbank) Ihres Shops an!

    Kopieren Sie alle Dateien und Verzeichnisse aus dem Vorzeichnis "neu" ins
    Stammverzeichnis Ihres Shops. Hierbei sollten (bei einer Neuinstallation
    des Moduls) keine Dateien überschrieben werden.

    Das Verzeichnis "angepasst" enthält Dateien, die in einer Standardinstallation
    eines Gambio-GX-Shops bereits vorhanden sind und für die Installation dieses
    Moduls verändert werden müssen. Bitte kopieren Sie die Dateien aus dem
    Verzeichnis "angepasst" NICHT in Ihren Shop, die Dateien dienen nur als
    Referenz.

    Führen Sie folgende manuelle Anpassungen an den Dateien in Ihrem Shop durch:

    ## Datei admin/orders.php
    ca. Zeile 427

    Fügen Sie nach

    <?php if (($_GET['action'] == 'edit') && ($order_exists)) { ?>
    <td class="boxCenter" width="100%" valign="top">

    folgendes ein:

    <?php /* BEGIN INTRASHIP */ if(isset($_SESSION['intraship_warning_not_codeable']) && $_SESSION['intraship_warning_not_codeable'] == true): ?>
    <p style="margin: 1em auto; width: 80%; background: #ffe; border: 1px solid #f00; padding: 1ex 1em; font-family: sans-serif;">
    <strong>WARNUNG:</strong> Das Versandlabel wurde f&uuml;r eine nicht leitcodierbare Empf&auml;ngeradresse erstellt!
    </p>
    <?php unset($_SESSION['intraship_warning_not_codeable']); endif /* END INTRASHIP */ ?>


    ca. Zeile 436

    Fügen Sie nach

    <?php echo '<a class="button float_right" href="' . xtc_href_link(FILENAME_ORDERS, xtc_get_all_get_params(array('action'))) . '">' . BUTTON_BACK . '</a>'; ?>
    <a class="button float_right" href="<?php echo xtc_href_link(FILENAME_ORDERS_EDIT, 'oID='.$_GET['oID'].'&cID=' . $order->customer['ID']);?>"><?php echo BUTTON_EDIT ?></a>

    bzw. nach

    <?php // BEGIN HERMES
    if($hermes->getUsername() != '')
    {
    echo '<a class="button float_right" href="' . xtc_href_link('hermes_order.php', 'orders_id=' . $_GET['oID']) . '">Hermes-Versand</a>';
    }
    // END HERMES ?>

    folgendes ein:

    <?php // Intraship
    $intraship = new GMIntraship();
    if($intraship->active == true):
    $label_url = $intraship->getLabelURL((int)$_GET['oID']);
    ?>
    <?php if(!empty($label_url)): ?>
    <a class="button float_right" href="<?php echo $label_url ?>">DHL Label zeigen</a>
    <?php else: ?>
    <a class="button float_right" href="<?php echo xtc_href_link('print_intraship_label.php','oID='.(int)$_GET['oID']) ?>">DHL Label abrufen</a>
    <?php endif; ?>
    <?php endif; // END Intraship ?>

    ca. Zeile 1390

    Fügen Sie VOR

    $contents[] = array ('text' => '<br />'.TEXT_DATE_ORDER_CREATED.' '.xtc_date_short($oInfo->date_purchased));

    folgendes ein:

    // begin intraship
    $intraship = new GMIntraship();
    if($intraship->active == true) {
    $contents[] = array ('align' => 'left', 'text' => '<div align="center"><a class="button" href="'.xtc_href_link('print_intraship_label.php','oID='.$oInfo->orders_id).'">DHL Label</a></div>');
    }
    // end intraship


    ## Datei checkout_shipping.php
    ca. Zeile 236

    Fügen Sie nach

    $smarty->assign('FORM_END', '</form>');

    folgendes ein:

    // BEGIN Postfinder
    $intraship = new GMIntraship();
    if($intraship->isPostfinderActive() && !$intraship->isPackstationAddress($_SESSION['sendto'])) {
    $smarty->assign('url_pfinder', xtc_href_link('postfinder.php', 'ab='.$_SESSION['sendto'], 'SSL').'&checkout_started=1');
    }
    // END Postfinder


    ## Datei checkout_payment_address.php
    ca. Zeile 102

    Fügen Sie nach

    if (strlen($street_address) < ENTRY_STREET_ADDRESS_MIN_LENGTH) {
    $error = true;
    $process = false;

    $messageStack->add('checkout_address', ENTRY_STREET_ADDRESS_ERROR);
    }

    folgendes ein:

    if(preg_match('/.*(packstation|postfiliale|filiale).*/i', $street_address) == 1) {
    $error = true;
    $process = false;
    $messageStack->add('checkout_address', ENTRY_STREET_ADDRESS_NOT_STREET);
    }


    ca. Zeile 260

    Ersetzen Sie

    $addresses_query = xtc_db_query("select address_book_id, entry_firstname as firstname, entry_lastname as lastname, entry_company as company, entry_street_address as street_address, entry_suburb as suburb, entry_city as city, entry_postcode as postcode, entry_state as state, entry_zone_id as zone_id, entry_country_id as country_id from ".TABLE_ADDRESS_BOOK." where customers_id = '".$_SESSION['customer_id']."'");

    durch


    $addresses_query = xtc_db_query("select address_class, address_book_id, entry_firstname as firstname, entry_lastname as lastname, entry_company as company, entry_street_address as street_address, entry_suburb as suburb, entry_city as city, entry_postcode as postcode, entry_state as state, entry_zone_id as zone_id, entry_country_id as country_id from ".TABLE_ADDRESS_BOOK." where customers_id = '".$_SESSION['customer_id']."'");
    $unallowed_classes = array('packstation', 'postfiliale');


    Fügen Sie nach

    while ($addresses = xtc_db_fetch_array($addresses_query)) {

    das folgende ein:

    if(in_array($addresses['address_class'], $unallowed_classes)) {
    continue;
    }
    if(preg_match('/.*(packstation|postfiliale).*/i', $addresses['street_address']) == 1) {
    continue;
    }



    Nach der Installation aller Dateien führen Sie bitte den Installer aus, indem
    Sie sich als Admin in Ihren Shop einloggen und dann folgenden URL aufrufen:

    http://www.ihr-shop.tld/intraship_installer.php

    (Ersetzen Sie hierbei "http://www.ihr-shop.tld/" durch die Adresse Ihres
    Shops.)

    Die Datei intraship_installer.php sollte nach erfolgreicher Ausführung
    gelöscht werden.

    Bitte leeren Sie die Caches für Seitenausgabe und Modulinformationen
    (Toolbox -> Cache leeren) im Admin-Bereich Ihres Shops.

    Die Konfiguration der Intraship-Schnittstelle finden Sie unter Module ->
    Intraship im Admin-Bereich Ihres Shops.

    Bitte beachten Sie, dass für die korrekte Funktion der Schnittstelle ALLE
    Felder der Konfiguration ausgefüllt werden müssen. Achten Sie insbesondere
    darauf, im Bereich Versandzonen die richtigen Produkte und Partner-IDs
    einzutragen.

    Mit der Eintragung des "API-Key für Postfinder" wird im Shop-Frontend die
    Integration des Packstation-Finders aktiviert. Lassen Sie dieses Feld leer,
    wenn Sie den Packstation-Finder nicht verwenden wollen.

    .....................................................................................................................................................



    Die ersten sind leicht zu finden, aber leider nicht die gesuchte Stelle

    Grüße

    MarOne
     
  4. Senior

    Senior Erfahrener Benutzer

    Registriert seit:
    17. April 2013
    Beiträge:
    816
    Danke erhalten:
    178
    Danke vergeben:
    241
    Das bezieht sich aber auf die checkout_payment_address.php
     
  5. marone22

    marone22 Mitglied

    Registriert seit:
    10. Januar 2014
    Beiträge:
    5
    Danke erhalten:
    0
    Oh mann.......lesen sollte man schon können ;)


    Danke
     
  6. marone22

    marone22 Mitglied

    Registriert seit:
    10. Januar 2014
    Beiträge:
    5
    Danke erhalten:
    0
  7. Avenger

    Avenger G-WARD 2012/13/14/15

    Registriert seit:
    26. April 2011
    Beiträge:
    4.771
    Danke erhalten:
    1.478
    Danke vergeben:
    89
    Wieder so ein "Gambio GX2"-Machwerk, das auch nicht ansatzweise die Möglichkeiten der updatesicheren Implementierung nutzt.

    Man sollte solchen Entwicklern verbiten, zu behaupten, dass ihr Produkt "Gambio GX2"-kompatibel sei.
     
  8. Dennis (MotivMonster.de)

    Dennis (MotivMonster.de) G-WARD 2013/14/15/16

    Registriert seit:
    22. September 2011
    Beiträge:
    31.203
    Danke erhalten:
    6.208
    Danke vergeben:
    1.107
    Beruf:
    Mann für alles :)
    Ort:
    Weilburg
    entwickelt vor 1-2 Jahren und nie aktualisiert :)
     
  9. Senior

    Senior Erfahrener Benutzer

    Registriert seit:
    17. April 2013
    Beiträge:
    816
    Danke erhalten:
    178
    Danke vergeben:
    241
    Der Gambio-Support hat mir am 30.10.2013 geschrieben:


    "Hinsichtlich Anpassungen an den Spezifikationen der DHL und die damit verbundene Kompatibilität können wir leider keine Gewährleistung übernehmen.
    Bei der aktuellen Version beispielsweise war eine Anpassung notwendig. Da das Modul jedoch erst eine Woche alt ist, sind zumindest zeitnah keine Anpassungen seitens der DHL zu erwarten."
     
  10. nicomalassa

    nicomalassa Mitglied

    Registriert seit:
    18. Dezember 2013
    Beiträge:
    8
    Danke erhalten:
    1
    Hallo Ich habe das Modul installiert und hat alles soweit geklappt. Ich frage mich nur wo finde ich die ApiKey für den Postfinder? ich habe gegoolet aber irgendwie nichts gefunden.

    Vielen Dank
    Nico
     
  11. Dennis (MotivMonster.de)

    Dennis (MotivMonster.de) G-WARD 2013/14/15/16

    Registriert seit:
    22. September 2011
    Beiträge:
    31.203
    Danke erhalten:
    6.208
    Danke vergeben:
    1.107
    Beruf:
    Mann für alles :)
    Ort:
    Weilburg
    Naja API wird vom anbieter vergeben daher würd ich da mal anfragen.
     
  12. Senior

    Senior Erfahrener Benutzer

    Registriert seit:
    17. April 2013
    Beiträge:
    816
    Danke erhalten:
    178
    Danke vergeben:
    241
    Gambio-Support hatte mir mitgeteilt:
    "Der API-Key für Postfinder ist nur nötig, wenn "Postfinder" auch verwendet wird. Das Feld darf also leer sein, auch wenn der Hinweis ganz unten etwas anderes sagt. Dieser wurde bei der letzten Umprogrammierung des Modules leider nicht entfernt. Mit dem Postfinder ist es möglich, bei der Eingabe einer Versandadresse automatisch eine Packstation in der Nähe ausfindig zu machen und diese mit Knopfdruck zu übernehmen. Die Adresse wird über diese Funktion automatisch so formatiert, dass das Modul diese verarbeiten kann."
     
  13. Anonymous

    Anonymous Erfahrener Benutzer

    Registriert seit:
    20. Juni 2012
    Beiträge:
    90
    Danke erhalten:
    6
    Danke vergeben:
    6
    Äh sorry, bezieht sich dies auf das Intraship Modul von Gambio ? Irgendwie blick ich jetzt nicht mehr durch. Wir suchen schon lange ein intraship modul und hab gesehen in Downloadbereich bei Gambio gibt es eins. Ist das was altes ?
     
  14. Anonymous

    Anonymous Erfahrener Benutzer
    Mitarbeiter

    Registriert seit:
    22. Juni 2011
    Beiträge:
    4.760
    Danke erhalten:
    1.749
    Danke vergeben:
    137
    Nein, das Modul im Downloadbereich ist aktuell.

    Es handelt sich um ein ursprünglich für xt:Commerce 3.x geschriebenes Modul, das wir angepasst und um die Postfinder-Funktionen erweitert haben. Die Anpassungen beziehen sich größtenteils auf den Postfinder-Teil; wer das nicht will, kann theoretisch auch nur den Admin-Anteil installieren, der die Intraship-Anbindung realisiert.
     
  15. Anonymous

    Anonymous Erfahrener Benutzer
    Mitarbeiter

    Registriert seit:
    22. Juni 2011
    Beiträge:
    4.760
    Danke erhalten:
    1.749
    Danke vergeben:
    137
    Fühle dich eingeladen, das Modul updatesicher zu machen.
     
  16. Anonymous

    Anonymous Erfahrener Benutzer

    Registriert seit:
    20. Juni 2012
    Beiträge:
    90
    Danke erhalten:
    6
    Danke vergeben:
    6
    Dank Marco für die Aufklärung d.h. es kann bei updates Probleme geben da nicht updatesicher, Ja ?
     
  17. marone22

    marone22 Mitglied

    Registriert seit:
    10. Januar 2014
    Beiträge:
    5
    Danke erhalten:
    0
    Hi,

    unser Shop ist erst im Aufbau, daher habe ich das hier schon mal installiert. Gibt es was besseres was man auch ohne große Kenntnisse installieren kann?

    Grüße

    MarOne
     
  18. Senior

    Senior Erfahrener Benutzer

    Registriert seit:
    17. April 2013
    Beiträge:
    816
    Danke erhalten:
    178
    Danke vergeben:
    241
    @Marco
    Mal andersrum gefragt:
    Ist die aktuell im Downloadbereich verfügbare Version aktueller/anders als die Variante die am 25.10.2013 vom Support integriert wurde?
    Und falls ja - welche Unterschiede gibt es?
     
  19. Anonymous

    Anonymous Erfahrener Benutzer
    Mitarbeiter

    Registriert seit:
    22. Juni 2011
    Beiträge:
    4.760
    Danke erhalten:
    1.749
    Danke vergeben:
    137
    Ich weiß nicht genau, welche Versionen wann installiert wurden, aber der wesentliche Unterschied der aktuellen Versionen zu den früheren besteht darin, dass DHL das Login-Verfahren vor ein paar Wochen geändert hat. Das heißt, ältere Versionen werden dann nicht mehr funktionieren; davon sind vor allem alle Versionen unseres Moduls betroffen, die noch ohne Postfinder-Unterstützung kamen. (Zwischen Postfinder und Intraship-Login gibt’s keinen Zusammenhang, das korreliert nur.)
     
  20. Anonymous

    Anonymous Erfahrener Benutzer
    Mitarbeiter

    Registriert seit:
    22. Juni 2011
    Beiträge:
    4.760
    Danke erhalten:
    1.749
    Danke vergeben:
    137
    Das Modul muss leider in Bereiche eingreifen, die nicht so einfach updatesicher anpassbar sind. Also: Ja, die Anpassungen müssen bei Updates berücksichtigt und ggf. erneuert werden.