Embed Size (px)
Citation preview
Expertos en PDV, S. de R.L. de C.V. Centro de Negocios Concentro. Av. Vallarta 6503 Local D-21 Col. Cd. Granja, C.P. 45010, Zapopan, Jalisco. (33) 2002-0460 [email protected]
Manual de Usuario
NOVACAJA – Proceso operativo Tienda Virtual
2 / 46
Este manual es continuación del documento de Requerimientos e instalaciones necesarias para Tienda Virtual, partiendo como
último tema, el relacionado con instalación de PrestaShop.
Todos los archivos, configurables, y ejecutables, de los cuales se mencione a continuación, serán proporcionados por personal
de Soporte NOVACAJA.
Configuración relacionada:
1. Archivo product.php y archivos novacajaps
2. Servicios Web relacionados
3. Modificación en Base de Datos de NOVACAJA
4. Interfaz NovacajaPS
5. Tienda Virtual
Archivo product.php
Este archivo deberá ser reemplazado dentro de CPanel – Administrador de archivos donde se encuentra la carpeta con la Base
de Datos del Cliente y relacionada con la Tienda Virtual y dentro de la subcarpeta: classes.
3 / 46
Archivos novacajaps
Los archivos novacajaps (su finalidad es el enlace y envío de datos entre la Base de datos de NOVACAJA, con la base de datos de
PrestaShop para la Tienda Virtual) están conformados por novacajaps.ini y novacajaps.php. Estos archivos deberán ser insertados
también dentro de CPanel – Administrador de archivos donde se encuentra la carpeta con la Base de Datos, como el archivo
anterior.
Como medida de sugerencia: dentro de ésta, se deberá crear una nueva carpeta con un nombre identificable y donde se pueden
insertar esos archivos novacajaps.
En este ejemplo, dentro de la Base de datos, se creó la carpeta novacaja, para insertar esos archivos.
4 / 46
Archivo novacajaps.ini: una vez posicionándose, presione la opción Editar del menú principal de la parte superior, después el
botón Edit de la ventana de confirmación (se muestra a continuación la imagen respectiva).
Este archivo cuenta con 4 variables, mismas que se describen a continuación:
5 / 46
Para este ejemplo, el nombre de la base de datos que se está utilizando es infobene_pres496. La manera de confirmar los datos de la misma y utilizarlos para la configuración, es la siguiente: En la misma pantalla de CPanel, en la parte inferior, se encuentra la opción PrestaShop, como se muestra en la imagen sucesiva. Presione en el ícono:
Con la barra espaciadora, posiciónese hasta la parte inferior de la pantalla principal y busque en el listado, la URL e información de la Base de datos, sobre la cual se está trabajando (para este ejemplo: http://tienda.novacaja.mx/alodent)
6 / 46
Una vez localizada en el listado, presione el ícono de editar (lápiz).
Se habilitará la ventana donde se podrán validar la información, y al presionar la opción de Show (mostrar), quedará visible la contraseña de la Base de datos. Referente a la contraseña: es recomendable que no lleve caracteres especiales como &, (), $, %, etc.; se genera de manera automática y deberá modificarla.
7 / 46
Referente al dato del nombre del servidor, se encuentra señalado con la flecha, y es un dato variable; este depende de aquel que se esté consultando. Verifique la información en: CPanel – Menú principal – phpMyAdmin. El listado de las bases de datos se encuentra del lado izquierdo de la pantalla, habilite presionando el signo +, y mostrará la información correspondiente y sus tablas (para este ejemplo: infobene_pres496)
8 / 46
Y al abrir la base de datos, antes de los nombres de cada tabla, se encuentra especificado el prefijo, (siendo en este caso: ps, de acuerdo a las especificaciones de la instalación de PrestaShop).
Además de mostrar la estructura de la Base de datos:
9 / 46
Una vez habilitada la Base de datos, es necesario ejecutar el siguiente script en la pestaña SQL; presione el botón Continuar, información que se muestra a continuación:
SELECT SUBSTRING_INDEX(USER(), '@', -1) AS ip, @@hostname as hostname, @@port as port, DATABASE() as
current_database
10 / 46
La finalidad de ejecutar este script es para que se consulte/muestre la url (localhost) del servidor, los datos del campo server.
En resumen: server: para este ejemplo, el dato de este campo sería el dominio principal (padre) de toda la estructura, siendo para este proceso infobene, que a su vez tiene sus subdominios como lo muestran las imágenes anteriores database: nombre de la base de datos de Prestashop uid: nombre del usuario de la base de datos de PrestaShop pwd: contraseña registrada de la base de datos de PrestaShop Estos datos, recuerde tomarlos de PrestaShop, de la base de datos con la cual se estará configurando.
Al final se graban los cambios en el botón que se encuentra en la parte superior derecha de CPanel – Administrador de archivos,
llamado Guardar cambios.
11 / 46
Servicios Web relacionados
El siguiente paso es ingresar al Administrador de la página Web (ingresando la información que se crea cuando se da de alta la
Base de datos de PrestaShop)
Para este proceso y ejemplo, están serían las URL a considerar, siendo la primera para la consulta de los clientes y prospectos en
la Tienda Virtual, y la segunda es la URL del Administrador de la página de Prestashop
Ingrese a la URL del Administrador (https://tienda.novacaja.mx/alodent/admin_tienda)
12 / 46
Habilite la ruta (parte inferior izquierda): Configure – Advanced Parameters – Webservice (última opción del submenú) o
Configuración – Parámetros avanzados – Servicios Web.
13 / 46
Cambie a Yes (Sí), la primera opción de la sección de Configuración: Activar el servicio Web de PrestaShop y presione el botón
Save (Guardar).
El siguiente paso es agregar una nueva llave del servicio Web, presionando el botón que se encuentra en la parte superior
derecha de la pantalla
14 / 46
Envía la siguiente ventana, presione el botón de Generate (Generar) y automáticamente se formará dicha llave, dato que se
recomienda sea guardado, ya que necesitará para siguientes pasos de configuración de la interfaz; aunque es posible editarlo y
volver a generar una nueva llave.
Key description: capture cualquier información relacionada a la llave creada.
Status: debe estar en Yes (Sí).
Permissions: habilitará la casilla All (Todo) del listado, (todos los permisos de ver, modificar, agregar, eliminar y vista rápida), de
todos los campos del listado.
Presione el botón Save (Guardar).
La nueva llave quedará guardada con la configuración capturada, misma que puede ser modificada en cualquier momento si así
se requiere.
15 / 46
A continuación, habilite el Administrador de Servicios Web (IIS) desde el buscador de Windows.
Nota: los Servicios Web de NOVACAJA que estarán relacionados serán los de Cuentas abiertas y CxC, mismos que deberán apuntar
y estar localizados donde está la Base de datos de NOVACAJA, funcionando de manera centralizada.
Una vez habilitados los IIS, en la sección de Conexiones (lado izquierdo superior de la pantalla), despliegue del listado en el
nombre del equipo y después en la carpeta de Sitios
16 / 46
Como se podrá observar, se encuentran habilitados los Servicios Web de Cuentas abiertas (CA) y CxC.
Para la instalación de estos Servicios Web de NOVACAJA, consulte los manuales relacionados, ya que deberán estar creados en
primera instancia, y dichos ejecutables para su instalación: proporcionados por personal de Soporte NOVACAJA.
17 / 46
Y al posicionarse en cada uno de ellos, encontrará la opción de Editor de configuración en la sección de Administración, como se
muestra en la imagen siguiente:
Presione en la opción del Editor para continuar.
En el renglón, presione el botón de los tres puntos del lado derecho de la ventana, mismo que se encuentra seleccionado en la
imagen que se muestra a continuación.
Una vez seleccionado, capture en el campo initial catalog, sección Propiedades, el nombre de la base de datos de NOVACAJA y
tendrá el enlace con la base de datos de PrestaShop sobre la cual operará la Tienda Virtual (para este ejemplo es alodent).
18 / 46
Realice los cambios en ambos Servicios Web y guarde la información correspondiente.
Modificación en Base de datos de NOVACAJA
Para este proceso se deberán hacer cambios en Panel de Control de Prestashop (en la URL Administrativa: especificaciones en el
Manual de Requerimientos e Instalación de Tienda Virtual páginas 41 y 42), y en Microsoft SQL Server Management Studio.
En el menú del lado izquierdo de la pantalla, sección Configurar: despliegue la lista y seleccione la opción: Configuración de
Pedidos
19 / 46
Abrirá esta ventana en primera instancia. Presione el ícono Iniciar sesión:
20 / 46
Habilite la segunda pestaña États (estados), como se muestra en la imagen siguiente.
Posteriormente, ingrese a Microsoft SQL Server Management Studio, y de la Base de datos que estará relacionada con la Tienda
Virtual, identifique la tabla con el nombre dbo.PrestaShopOrderState, misma que en ese momento se encuentra sin datos.
21 / 46
Edite (clic derecho del mouse posicionado en la tabla mencionada) para ingresar a los campos que la componen:
Campo Estado se refiere al estatus del pedido y CodigoExterno, al État asignado en el Panel de Control de PrestaShop, esto, con
la finalidad de relacionarlos. Si este proceso no se lleva a cabo, no se sincronizará la información de los pedidos de la Tienda
Virtual a NOVACAJA.
Estado del pedido (coteje información con PrestaShop, imagen de la página anterior):
0 = se crea al momento del pedido en la Tienda Virtual (el código del État puede variar y corresponde al estatus: en espera de
pago por transferencia bancaria, en Panel de Control de PrestaShop, concepto especificado después de un pedido de prueba), y
es la creación de la Cuenta Abierta en el Punto de Venta) Para este ejemplo, generó el código 10, como se muestra en la imagen
anterior.
1 = cuando se finaliza la Cuenta Abierta (État 2, pago aceptado en Panel de Control de PrestaShop)
2 = en caso de que se cancele la Cuenta Abierta (État 6, cancelado en Panel de Control de PrestaShop)
22 / 46
Interfaz NovacajaPS
A continuación, en la ruta que haya elegido para insertar la carpeta de la aplicación, ingrese al ejecutable InterfazNovacajaPS.exe:
Enviara la ventana de configuración, siendo el proceso similar a las aplicaciones de NOVACAJA. El primer paso será
configurar la conexión a la Base de datos de NOVACAJA relacionada con la Tienda Virtual. El servidor será el nombre o la IP en
donde se encuentra la Base de datos, el puerto es que se utiliza por default en el sistema: 1433, el timeout recomendado es 300,
y el nombre y para finalizar: usuario y contraseña de la conexión con Microsoft SQL Server Management Studio.
23 / 46
Presione el botón Actualizar para confirmar que la conexión sea correcta.
En la segunda pestaña: capture la lista de precios a sincronizar, vendedor, tienda y almacén existencia (donde se estará
consultando el inventario para las ventas en la Tienda Virtual), estos cuatro campos deberán estar habilitados en la Base de datos
de NOVACAJA.
El campo: Directorio API, la URL de la Tienda Virtual (consultarla en Softaculous, proceso mencionado en la página 7, primera
imagen) con la terminación “/api/”. Quedando de esta forma y para este ejemplo: https://tienda.novacaja.mx/alodent/api/
Clave API: copie la clave de la llave que fue generada al momento de configurar los Servicios Web en PrestaShop Administración
– Panel de Control – Configurar – Parámetros Avanzados – Servicios Web (páginas 11 a 14 de éste mismo documento).
24 / 46
Directorio WS Php: URL de la Tienda Virtual (consultarla en Softaculous, proceso mencionado en la página 7, primera imagen)
con la terminación “/novacajaps”. Quedando de esta forma y para este ejemplo: https://tienda.novacaja.mx/alodent/novacajaps
API Cuentas abiertas: apunta a la URL local con el puerto correspondiente y /api/, quedando de la siguiente manera:
https://localhost:8080/api/
25 / 46
Como último dato y de acuerdo a la configuración al momento de instalar PrestaShop (consulte el Manual de Requerimientos e
instalación Tienda Virtual, páginas 41 a 43), deberá capturar el ID de idioma, mismo que puede consultar en PrestaShop
Administración – Panel de Control – Mejoras – Internacional – Localisation pestaña Idiomas.
El ID del idioma correspondiente a español de México es 2.
26 / 46
En caso de que aún aparezcan idioma inglés y español de España, es recomendable borrarlos del listado con la opción y
después Borrar, como se muestra en la imagen siguiente; dejando únicamente la opción español de México.
27 / 46
En la pestaña Monedas, es recomendable exclusivamente el peso mexicano, eliminando las demás de la misma manera que en
la pestaña Idiomas.
28 / 46
En la imagen siguiente se muestra, como quedaría esa pestaña con los campos capturados.
Presione el botón Guardar, una vez que finalice.
Los íconos del menú principal de la interfaz son los siguientes:
Configurar conexión: proceso mencionado y se habilita de manera automática una vez que se ejecuta por primera vez la
aplicación. Posteriormente se puede abrir para actualizar o generar cualquier cambio.
Configurar operación: parametrización para llevar a cabo la sincronización de datos.
Activar sincronización: iniciar el proceso para sincronizar la información, según los parámetros.
Detener sincronización: cancelar el proceso.
Salir: cerrar la interfaz.
29 / 46
Configurar operación: segmentada en tres partes,
Ejecución
- Al activar ejecución de procesos: siendo de manera manual, con la opción de Activar sincronización, dentro del mismo
menú principal.
- En una hora específica: proceso automático, donde el usuario define en qué hora específica del día, se llevará acabo la
ejecución de del proceso de la pestaña de la cual se está configurando (fracciones de 15 minutos en el margen de
tiempo).
Días
- Todos los días de la semana: se ejecutará el proceso siempre.
- Días específicos: seleccionando que días de la semana se sincronizará.
Repetir tarea cada: también se puede seleccionar fracciones de 15 minutos en el margen de tiempo, para que se esté repitiendo
dicha tarea, ejemplo: cada 6 horas con 15 minutos.
Habilitar: es el parámetro relevante en este proceso, si no es habilitado, ese Catálogo NO será sincronizando en el proceso y nunca
se intercambiará información de una Base de datos a otra.
30 / 46
Todas las pestañas se configuran exactamente igual. La pestaña de imágenes contiene una sección más llamada Rutas, y de los
catálogos: Categorías (Organizador de mercancías), Marcas, Mercancías, y Mercancías MTC, pueden contener imágenes y es
posible importarlas (hasta 5 imágenes), definiendo una ruta para cada catálogo.
La estructura del nombre del archivo de una imagen es:
Código principal de la mercancía, guion medio y el número de imagen desde 0 en consecutivo máximo al número 5, con extensión
.jpg o .png. Ejemplo: 73564302-1.jpg
Archivos de imágenes que no cuenten con las características mencionadas, al momento de sincronizar, la interfaz les da lectura
a esos archivos, pero no los agrega.
31 / 46
Activar sincronización: iniciará el proceso, con aquellos catálogos que tengan seleccionado el parámetro Habilitar
principalmente y las características de lo que se configuró en esas secciones.
La interfaz exportará/importará aquello en primera instancia, las sincronizaciones subsecuentes, lo que hará es sobrescribir los
datos habilitados.
Es importante recordar que se tomarán en cuenta en este proceso, únicamente aquellas mercancías, paquetes, MTC modelos,
que tengan seleccionado el parámetro Para su venta en línea en el Catálogo respectivo en NOVACAJA – Administrador (en caso
de ser necesario, consulte el Manual en el sitio oficial).
32 / 46
Respecto al tema de los gastos de envío o paquetería, la configuración dependerá de los convenios que se hagan con dichas
empresas, siendo una manera muy particular de cada Organización.
A continuación se muestra una configuración genérica y de ejemplo:
Habilite la ruta: CPanel – Mejoras – Envío – paqueterías
En la parte superior derecha se encuentra la opción para dar de alta un nuevo transportista.
Como se puede validar en la imagen siguiente, se encuentran los ID´s de dos opciones nombradas: Entrega en tienda y Entrega
por paquetería, en esta última se podrá observar que en el campo Envío gratis se encuentra con este ícono : significa que el
envío tiene un costo y no es gratuito.
En la última opción de cada partida, podrá generar cualquier modificación al presionar el botón Editar:
En la primera pestaña habilitará los datos del transportista y su logotipo, al terminar de capturar, presione el botón Siguiente
que se encuentra en la parte inferior derecha de la pantalla general.
33 / 46
Segunda pestaña: en esta pestaña es donde se define si el envío es gratuito o no, cuestiones de facturación, rangos del peso
permitido, y es importante que habilita en la opción All, todos los continentes que aparecen en el listado. Al terminar presione
el botón Siguiente.
34 / 46
En caso de asignar cargos en la paquetería, sería el siguiente proceso: seleccionar la opción Sí en “Añadir costes de manipulación”
y se activarán los rangos de costos por ese rubro.
Nota: esta configuración debe coincidir con los datos de la ruta: Envíos – Preferencias – Manipulación (mencionado en la página
37 de este mismo documento).
Tercera pestaña: relacionada con los datos de los paquetes y accesos de los distintos tipos de usuarios. Presione el botón
Siguiente.
35 / 46
Para finalizar, se mostrará en la última pestaña, el resumen de la configuración y la opción a dejar activado o no ese servicio de
paquetería, una vez finalizado el proceso, presione el botón Terminar.
36 / 46
Para este ejemplo: quedó especificado que el servicio de paquetería es gratuito.
37 / 46
En el mismo menú opción Preferencias, se encuentran otros datos para terminar con la configuración del envío. Si el usuario no
hace ningún cobro por gasto de manipulación queda en ceros ese campo; en el campo “Envío gratuito comienza a las”: ahí se
captura el mismo dato de “Añadir costes de manipulación” (en rangos de costos), explicado en la página 34 de este mismo
documento.
Ejemplo con costo extra:
Solo para el caso que se capture una cantidad distinta a cero en “Gastos de manipulación”, y para este ejemplo: siendo la cantidad
$50.00, deberá dar de alta en NOVACAJA – Administrador en el Catálogo de Mercancías, una mercancía nombrada como Cargo,
con las siguientes características:
- En la primera pestaña de Identificación, NINGÚN parámetro deberá ir habilitado.
38 / 46
- El precio (pestaña de Precios y Costos), para este caso de $50.00 debe ser el mismo y siempre con IVA al 0%.
- En la pestaña Ventas, campo Sufijo PDV, capturar la letra “C”.
Los demás datos obligatorios y campos requeridos, serán a consideración del uso del mismo.
Como última instancia y antes de empezar a operar la Tienda Virtual, en la Base de Datos NOVACAJA en Microsoft SQL: en la
Tabla DiccionarioPrestashop, capture en el campo Tipo el número 15, ya que es el código de Documento asignado en Prestashop
para el Cargo, en Código interno: el código principal de la mercancía Cargo que se dio de alta anteriormente en NOVACAJA -
Administrador - Catálogo de Mercancías; y en Código externo: el mismo valor que en el campo Tipo que es 15, correspondiente
al código de Documento.
39 / 46
Tienda Virtual
A continuación se muestra un ejemplo de una tienda virtual con el URL correspondiente y para la vista de clientes y prospectos
de la web: https://tienda.novacaja.mx/alodent/
En el sitio principal, tendrá la opción de ver las distintas secciones de los Organizadores de mercancías y al presionar en aquel
que se tenga interés, mostrará las mercancías que contenga. Para el siguiente ejemplo, se consultó la sección de Abarrotes.
Una vez que seleccione la cantidad que se comprará de ese producto, presione el botón Añadir al carrito para que continúe con
el proceso de compra. Agregue al pedido tantos artículos como sea necesario.
40 / 46
En la siguiente pantalla podrá validar el total de artículos, y la información de los importes del subtotal, envío, impuestos y total
de la transacción. Presione el botón Ir a la caja, para continuar.
En la parte superior derecha de la pantalla principal, tiene la opción de iniciar sesión. Presione en la opción Da click aquí, para
habilitar su usuario por primera vez, las siguientes compras que realice, podrá ingresar con el correo electrónico y contraseña
que en este proceso genere, como se muestra en la segunda imagen. Este paso lo puede realizar antes o después de agregar
artículos al carrito.
41 / 46
Si quiere recibir notificaciones de ofertas y más: ingrese el correo electrónico al que desee sean recibidos, después presione el
botón Suscribirse.
Capture la información que solicita el formulario, y es obligatorio seleccionar el parámetro (Estoy de acuerdo con los términos,
condiciones y política de privacidad:
42 / 46
Presione en el botón Continuar en caso de que todo este correcto, además de los detalles de la compra.
El primer correo que recibirá, será de confirmación de su nueva cuenta en la Tienda Virtual.
43 / 46
Y el siguiente: relacionado a la referencia/código que genera PrestaShop del pedido, generando una Cuenta abierta en NOVACAJA
– Punto de venta, con el .pdf relacionado y con la información a detalle de la compra.
44 / 46
En la URL del administrador de la tienda, en el menú Ventas – Pedidos – Pedidos, es donde podrá validar la referencia y los datos
de cada uno de ellos:
Para este ejemplo, recordemos el URL:
https://tienda.novacaja.mx/alodent/admin_tienda
45 / 46
Podrá consultar la Cuenta abierta generada, con su detalle en NOVACAJA - Punto de venta:
46 / 46
En caso de que el usuario habilite un Cargo como Gasto de manipulación, aparecerá como última partida, con el prefijo
especificado al momento de darlo de alta en el Catálogo de Mercancías. En caso de facturación, será el mismo tratamiento:
aparecerá como última partida independiente, sólo sin el prefijo como se muestra en NOVACAJA - Punto de Venta.
