Descripción

Este módulo te permite automatizar todo el proceso de envío de un paquete, el cliente escoge la agencia por la que quiere que le envíen el paquete en el momento de realizar la compra (los précios se consultan contra bidobido directamente). Una vez realizado el pedido, desde tu administración podrás generar el envío y la recogida automaticamente. Para que el módulo funcione, necesitas un usuario y clave específicos para el API, podras solicitarnolos a traves de email.

Instalación del módulo de envíos de bidobido

MÓDULO bidoenvios.php

subir los archivos:

  • /includes/languages/espanol/modules/shipping/bidoenvios.php
  • /includes/languages/english/modules/shipping/bidoenvios.php
  • /includes/languages/german/modules/shipping/bidoenvios.php
  • /includes/modules/shipping/bidoenvios.php
  • /includes/classes/bidobidoConect.php
  • /includes/classes/enviosBidobido.php
  • /admin/includes/modules/shipping/bidoenvios.php
  • /admin/includes/classes/bidobidoConect.php
  • /admin/bidoenvios.php
  • /admin/includes/configuracion_bidoenvios.php
  • /admin/js/ajax_bido.js (la carpeta js no existe, hay que crearla)

modificaciones:

base de datos:
ALTER TABLE `orders` ADD `shipping` VARCHAR(20 ) NOT NULL DEFAULT '0';
ALTER TABLE `orders` ADD `shipping_method` VARCHAR( 20 ) NOT NULL DEFAULT '0';
ALTER TABLE `orders` ADD `enviado` INT NOT NULL DEFAULT '0';
ALTER TABLE `orders` ADD INDEX ( `shipping` ) ;
CREATE TABLE IF NOT EXISTS `orders_envios` (
 `id` int(11) NOT NULL AUTO_INCREMENT,
 `orders_id` int(11) NOT NULL,
 `tracking` varchar(20) collate utf8_unicode_ci NOT NULL,
 `estado` int(11) NOT NULL,
 `etiqueta` varchar(100) collate utf8_unicode_ci NOT NULL,
 PRIMARY KEY  (`id`),
 KEY `orders_id` (`orders_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=1 ;

en el archivo checkout_process.php

sustituir:

Linea 80: // load the before_process function from the payment modules
Linea 81:  $payment_modules->before_process();
Linea 83:  $sql_data_array = array('customers_id' => $customer_id,

por:

// load the before_process function from the payment modules
 $payment_modules->before_process();
 $shipping_method=explode('_',$shipping['id']);
 $sql_data_array = array('customers_id' => $customer_id,

sustituir:

Linea 120:                          'currency' => $order->info['currency'],
Linea 121:                        'currency_value' => order->info['currency_value']);
Linea 122:  tep_db_perform(TABLE_ORDERS, $sql_data_array);

por:

                       'currency' => $order->info['currency'],
                       'currency_value' => $order->info['currency_value'],
                       'shipping' => $shipping_method[0],
                       'shipping_method' => $shipping_method[1]);
tep_db_perform(TABLE_ORDERS, $sql_data_array);

en el archivo /admin/includes/database_tables.php añadir:

define('TABLE_ORDERS_ENVIOS','orders_envios');

en el archivo /admin/includes/filenames.php añadir:

define('FILENAME_BIDOENVIOS', 'bidoenvios.php');

en el archivo /admin/includes/boxes/tools.php sustituir:

Linea 24: $contents[] = array('text'  =>
Linea 25:           '<a href="' . tep_href_link(FILENAME_BACKUP) . '" class="menuBoxContentLink">' . BOX_TOOLS_BACKUP . '</a><br>' .

por:

$contents[] = array('text'  =>
                                  '<a href="' . tep_href_link(FILENAME_BIDOENVIOS) . '" class="menuBoxContentLink">' . BOX_TOOLS_ENVIOS_BIDOBIDO . '</a><br>' .
                                     '<a href="' . tep_href_link(FILENAME_BACKUP) . '" class="menuBoxContentLink">' . BOX_TOOLS_BACKUP . '</a><br>' .

en los archivos /admin/includes/languages/english.php /admin/includes/languages/espanol.php /admin/includes/languages/german.php añadir:

define('BOX_TOOLS_ENVIOS_BIDOBIDO', 'Envios bidobido');

en el archivo /admin/orders.php sustituir:

Linea  320: <tr>
Linea  321: <td colspan="2" align="right"><?php echo '<a href="' . tep_href_link(FILENAME_ORDERS_INVOICE, 'oID=' . $HTTP_GET_VARS['oID']) . '" TARGET="_blank">' . tep_image_button('button_invoice.gif', IMAGE_ORDERS_INVOICE) . '</a> <a href="' . tep_href_link(FILENAME_ORDERS_PACKINGSLIP, 'oID=' . $HTTP_GET_VARS['oID']) . '" TARGET="_blank">' . tep_image_button('button_packingslip.gif', IMAGE_ORDERS_PACKINGSLIP) . '</a> <a href="' . tep_href_link(FILENAME_ORDERS, tep_get_all_get_params(array('action'))) . '">' . tep_image_button('button_back.gif', IMAGE_BACK) . '</a>'; ?></td>
Linea  322:</tr>
Linea  323:<?php
Linea  324:  } else {

por:

<tr>
       <td colspan="2" align="right"><?php echo '<a href="' . tep_href_link(FILENAME_ORDERS_INVOICE, 'oID=' . $HTTP_GET_VARS['oID']) . '" TARGET="_blank">' . tep_image_button('button_invoice.gif', IMAGE_ORDERS_INVOICE) . '</a> <a href="' . tep_href_link(FILENAME_ORDERS_PACKINGSLIP, 'oID=' . $HTTP_GET_VARS['oID']) . '" TARGET="_blank">' . tep_image_button('button_packingslip.gif', IMAGE_ORDERS_PACKINGSLIP) . '</a> <a href="' . tep_href_link(FILENAME_ORDERS, tep_get_all_get_params(array('action'))) . '">' . tep_image_button('button_back.gif', IMAGE_BACK) . '</a>'; ?></td>
     </tr>
     <?php include DIR_WS_MODULES.'gestionEnvioBidobido.php';?>
<?php
 } else {

Instalación:

una vez hechas las modificaciones y subidos los archivos a tu oscommerce tendrás que abrir la administración de tu tienda, entrar en modulos → envío , seleccionar BidoEnvios, y pulsar en instalar. Una vez instalado, edita el modulo introduciendo el precio de manipulación, tu dirección origen (nombre), tu dirección origen (dirección), dirección origen (población), dirección origen (código postal), dirección origen (país), dirección origen (teléfono), todos estos campos son obligatórios, para poder realizar un envío.

una vez configurado el modulo, hay que configurar el acceso al API de bidobido, para poder realizar peticiones de precio, creaciones de envío y tracking de pedidos, para esto en tu administración entra en Configuración → Envios BidoBido , en esta configuración podrás editar los campos que acabas de configurar, y los nuevos campos que aparecen: URL API, Usuario API, Contraseña API, Imprimir etiqueta, estado inicial del pedido a enviar y estado final de los pedidos enviados.

con todo esto configurado, no tienes mas que habilitar el método de envío, en la opción de configuración “Habilitar método de envío“ estableciendola a true.

Utilización:

Después de tener el módulo instalado completamente, un cliente de tu página podrá seleccionar el método de envío bidobido, con la agencia especifica que va a realizar el envío.

Una vez completado el pedido, entrarás en tu admin, y seleccionarás Herraminetas → Envíos Bidobido, y se desplegará un listado de los pedidos con el método de envío bidobido seleccionado (con el detalle de lo que cuesta realmente el envío, descontando los gastos de manipulación que hallas establecido en la configuración), y podrás escoger los pedidos a enviar, una vez escogidos, pulsando en enviar, los envíos estarán creados y la empresa de transportes pasará a recogerlos (dependiendo de la agencia tendrás que comunicar por teléfono o no la recogida).

Dentro del propio detalle de pedido en tu administración podrás realizar el tracking del pedido.

Errores:

Existen varios errores con los que te puedes encontrar al utilizar el modulo de envío de bidobido.

- error en la dirección del cliente. Existe una cierta tolerancia a errores en la dirección, ya que si un cliente con el codigo postal 28001 (Madrid), escribe en el apartado población “madrif“ el sistema de bidobido entiende que la población es madrid, si el sistema no lo entiende, la solución es corregir la dirección del cliente ( puedes corregir cualquier campo de la dirección del cliente clicando sobre ella, aparecerá un formulario para corregir la dirección).

- error por falta de saldo. La solución a este problema es entrar en bidobido e ingresar dinero de alguna de las formas de las que dispone.

-errores de aplicación, si encuentras algún error en la aplicación, te agradeceríamos que nos lo notificaras, para solucionarlo, y de paso enviarte la solución.

Descarga

Filename Version Date
moduloenvios.zip (25.03 KiB, 10M ago, 50 downloads) 20100127 14.06.2010