FSx Tutorial

FSx-Connector Preparar FactuSOL

Este capítulo cubre las tareas que hay que realizar en FactuSOL para utilizar FSx-Connector eficientemente, incidiendo en los principales aspectos de Configuración.

Preparar la Base de Datos

Los elementos de FactuSOL que puede exportar a su Tienda WooCommerce son:

• Secciones
• Familias
• Artículos
• Formas de Pago

El formulario de datos de cada uno de estos elementos contiene un apartado "Internet" donde deberá activar el campo "Permitir el uso en la web".

Más sobre Artículos

Evite en la medida de lo posible utilizar caracteres especiales (ª, #, $, etc.) en la "Descripción general" del Artículo (Nombre del Artículo) y otros campos de texto, ya que pueden producir errores en la exportación de datos; si necesita utilizar alguno de estos caracteres, pruebe a sustituirlo por la entidad html (o código hexadecimal) que le corresponda.

En FactuSOL, en la Solapa Internet de la Ficha de un Artículo, podrá indicar varios campos que se utilizarán en la Tienda Web:

• Permitir el uso de este artículo en la web: Indique si este artículo será incluido en la base de datos que FactuSOL puede subir a Internet a petición del usuario.


• Control de stock del artículo: Este campo no se utiliza actualmente en la Tienda Web, ya que WooCommerce tiene su propia configuración para el Control de Stock.


• Descripción web del artículo: Indique la descripción detallada que se mostrará en la web. Observe que puede introducir la descripción como HTML. Tenga en cuenta que algunos caracteres especiales pueden producir errores en la exportación de datos: generalmente se trata de la comilla sencilla ( ' ), que debe evitarse; si necesita utilizar este carácter, puede sustituirlo por la entidad html ' o por su código '.


• Mensaje emergente web: Este campo no se utiliza actualmente por FSx-Connector ni en la Tienda Web.

¿Es suficiente "Permitir el uso en la web" a un Artículo? Para que un Artículo se pueda usar en la web: El campo "Permitir el uso en la web" del Artículo debe estar activo. El Artículo debe pertenecer a una Familia cuyo campo "Permitir el uso en la web" debe estar activo. La Familia del Artículo debe pertenecer a una Sección cuyo campo "Permitir el uso en la web" debe estar activo. NOTA: Si una Familia tiene el campo "Permitir el uso en la web" en estado activo, esto NO implica que los Artículos asociados se activan automáticamente. Si una Sección tiene el campo "Permitir el uso en la web" en estado activo, esto NO implica que las Familias asociadas se activan automáticamente. En ambos casos, hay que activar explícitamente el uso en la web.

Asociar imágenes a los Artículos en FactuSOL Los tipos permitidos por WooCommerce son: gif, jpg, jpeg y png. Se recomienda que organice todas las imágenes de sus Artículos en una carpeta del ordenador donde tenga instalado FactuSOL. Ahorrará tiempo y esfuerzo. No utilice espacios o caracteres especiales (letras acentuadas, eñes, o símbolos especiales como ª, #, $, etc.) en el nombre del fichero de la imagen. Estos caracteres suelen ser incompatibles con los servidores web, y si los usa no podrá subir el fichero al servidor, o puede resultar inaccesible.

Más sobre las Formas de Pago

Deberá rellenar el campo "Descripción en la web de la forma de pago" para que FSx-Connector pueda identificar la Forma de Pago:

No es obligatorio usar en la web las Formas de Pago de FactuSOL. Los Pedidos se descargarán, pero el campo "Forma de Pago" del Pedido que se crea en FactuSOL, estará vacío.

Filtrado de Datos

Puede activar o desactivar para usar en la web los elementos anteriores utilizando las herramientas de filtrado de datos, "FactuSOL -> Internet -> Filtrar datos":

Para comprender estas opciones en detalle, consulte el Manual de su versión de FactuSOL.

Preparar la Conexión a Internet

La configuración de la conexión se realiza en: "FactuSOL -> Internet -> Configuración". Esta opción consta de una serie de Solapas; los valores por defecto que aparecen suelen ser adecuados para la mayoría de las situaciones, excepto los correspondientes a "Configuraciones técnicas", que siempre son específicos de cada instalación.

Para comprender todas las opciones en detalle, consulte el Manual de su versión de FactuSOL. No obstante, destacamos algunos puntos.

Solapa Alta de Clientes On Line

En la ventana que aparece, la opción "Activar la posibilidad de creación de cliente On-line" debe estar marcada. Se recomienda desmarcar la opción "Enviar e-mail de confirmación de recepción de datos y clave de acceso".

Solapa Consulta de Artículos

La sección "Datos de los artículos a mostrar en la consulta" contiene los campos de los Artículos que se exportarán a la Tienda WooCommerce. Tenga en cuenta que aunque marque los Campos Programables, FSx-Connector no los tendrá en cuenta (a no ser que se modifique para ello), ya que los Campos Programables pueden contener datos arbitrarios, y no está definida la correspondencia con campos de WooCommerce.

La "Tarifa de precios a mostrar a los clientes sin autenticar" se utiliza para recuperar el Precio (base) de los Artículos, tanto para usuarios no registrados como para clientes registrados en la Tienda WooCommerce. Debe definir también el Almacén del que se obtendrá el stock; las opciones de gestión del stock en la Tienda WooCommerce se definen en el apartado "Ajustes" de WooCommerce.

Solapa Pedidos de Cliente

En la ventana que aparece, la opción "Activar la posibilidad de recibir pedidos de cliente" debe estar marcada. Se recomienda desmarcar la opción "Enviar e-mail de confirmación de recepción de datos".

En el campo "Número de serie para pedidos por Internet" indique la serie que se utilizará para crear los pedidos de cliente que sean recibidos desde Internet.

En el campo "Descargar los pedidos de cliente On-line" indique la frecuencia con la que el programa descargará los nuevos pedidos de clientes desde la web. Utilice el mismo valor que para el mismo campo de la Solapa "Alta de Clientes On Line". La opción recomendada por defecto es 'Siempre que se solicite manualmente'.

Solapa Configuraciones Técnicas

• Dirección del servidor FTP:
  Indique la dirección del servidor FTP al que se realizará la subida de los distintos ficheros. Es la dirección del servidor FTP donde tiene instalada su tienda WooCommerce


• Nombre del usuario FTP:
  Indique el nombre de usuario FTP, que será utilizado para establecer la conexión con el servidor.


• Contraseña del usuario FTP:
  Indique la contraseña del usuario FTP, que será utilizada para establecer la conexión con el servidor.


• Carpeta de subida para fichero de texto ASCII:
  Indique la carpeta en la que FactuSOL debe situar el fichero de texto con la información necesaria para la actualización de la base de datos MySQL de FactuSOLWeb. Poner la ruta relativa a la carpeta raíz del acceso FTP que esté utilizando. Debe empezar y acabar con '/ ', por ejemplo:
  
  /public_html/wp-content/plugins/FSx-Connector/fsweb/BBDD/
  
  En este caso WordPress (y la Tienda WooCommerce) están instalados en la carpeta: /public_html/.
  
  
  
  Cuando se realiza en FactuSOL una "Subida de Datos Genérica" (desde la Solapa "Internet"), en esta carpeta se crea el fichero factusolweb.sql que contiene los datos exportados.

  NOTA: Recuerde añadir '/ ' al final de la ruta.

• Ruta de página de activación de actualización:
  Indique la página que realizará el proceso de actualización de la base de datos de FactuSOLWeb a partir del fichero de texto ASCII generado por FactuSOL. Debe comenzar por 'http://' (o 'https://'). Se recomienda poner aquí la url de acceso a la administración de su Tienda WooCommerce, por ejemplo: http://www.suweb.com/tienda/wp-admin/.


• Carpeta de ejecución del proyecto:
  Ponga aquí el mismo valor que para la Carpeta de subida para fichero de texto ASCII. Sólo debe poner un valor diferente si sabe realmente lo que está haciendo, y bajo su responsabilidad.


• Subcarpeta de imágenes de artículos:
  Indique la carpeta en la que se encuentran almacenadas las imágenes de los artículos que serán utilizadas en las consultas de éstos. Poner la ruta relativa a la Carpeta de Ejecución del Proyecto. Debe acabar con '/ '.


• Subcarpeta de pedidos validados:
  Indique la carpeta de la que FactuSOL deberá descargar los pedidos realizados por clientes de la Tienda WooCommerce. Poner la ruta relativa a la Carpeta de Ejecución del Proyecto. Debe acabar con '/ '.


• Subcarpeta de clientes creados On-line:
  Indique la carpeta de la que FactuSOL deberá descargar los clientes dados de alta en la Tienda WooCommerce. Poner la ruta relativa a la Carpeta de Ejecución del Proyecto. Debe acabar con '/ '.


• Ruta de página de administración:
  El valor de este campo no se utiliza por FSx-Connector. Ponga aquí, por ejemplo, el mismo valor que para la Ruta de página de activación de actualización.

	Configuraciones Técnicas en FactuSOL y en FSx-Connector Lo valores que introduzca en las "Configuraciones Técnicas" de FactuSOL están muy relacionados con la Configuración general de FSx-Connector. Consulte en este Tutorial el apartado correspondiente al componente FSx-Configuración.

Subida de datos genérica

Una vez hecha la Preparación de FactuSOL, ya es posible realizar una Subida de datos genérica. Este proceso confecciona un fichero con los datos de las Secciones, Familias, Artículos, etc., que tengan activada su subida a la web.

Una vez realizado este fichero (factusolweb.sql) y de forma automática, FactuSOL procederá a la subida del fichero al servidor ftp que se haya indicado en las Configuraciones Técnicas de Internet, en la "Carpeta de Ejecución del Proyecto".

La Subida de datos genérica abre un cuadro de diálogo; la selección recomendada se muestra a continuación.

Si no tiene Artículos nuevos, no es necesario marcar la casilla "Subir imágenes de artículos a la web": si lo hace, volverá a subir imágenes que ya tiene en el servidor.

Sintaxis especial de "Descripción web del artículo" en FactuSOL

FSx-Connector reconoce dos etiquetas en el campo "Descripción web del artículo" de FactuSOL: "<--**-->" y "<--data-->".

Puede introducir texto plano o HTML. La imagen siguiente producirá un resultado equivalente al anterior.

Etiqueta   "<--**-->"

El texto por encima de esta etiqueta será considerado como la Descripción Corta del Producto.

El texto a continuación de esta etiqueta, y hasta la etiqueta siguiente, será considerado como la Descripción Larga del Producto.

Etiqueta   "<--data-->"

El texto a continuación de esta etiqueta será considerado como valores de campos del Artículo que, o bien FactuSOL no exporta (como el peso), o bien no tienen correspondencia en WooCommerce (como el EAN, para el que será necesario definir un Atributo en WooCommerce).

El formato de las líneas de datos siempre es: "atributo: valor", independientemente de si lo anterior es texto plano o HTML. Además debe aparecer exclusivamente un solo par "atributo: valor" por línea.

El Nombre del Atributo debe ser exactamente como aparece en WooCommerce, respetando mayúsculas, minúsculas y espacios. Alternativamente al Nombre del Atributo, se puede utilizar el Slug del Atributo tal como aparece en WooComerce.

Si un Atributo tiene un valor numérico con decimales, debe usar el punto como separador de la parte decimal.

Colofón: casos posibles

1. Sólo aparece la etiqueta "<--**-->"
   
   El texto por encima de esta etiqueta será considerado como la Descripción Corta del Producto. El texto a continuación de esta etiqueta será considerado como la Descripción Larga del Producto. La opción "Descripción del Artículo en la Web" (ver aquí) no tiene efecto.
   
   
2. Sólo aparece la etiqueta "<--data-->"
   
   El texto por encima de esta etiqueta será considerado como la Descripción del Producto. FSx-Connector la manejará según el valor de la opción "Descripción del Artículo en la Web" (ver aquí). El texto a continuación de esta etiqueta será considerado como valores de campos para el Producto que se creará e WooCommerce.
   
   
3. No aparece ninguna de las dos etiquetas.
   
   Todo el texto será considerado como la Descripción del Producto. FSx-Connector lo manejará según el valor de la opción "Descripción del Artículo en la Web" (ver aquí).
   
   

	Este documento explica en detalle el campo "Descripción web del artículo" en FactuSOL.

	Puede encontrar un ejemplo en la sección FSx-Catálogo.

	Como las posibilidades de Atributos son infinitas, debería consultar al Servicio de Soporte de FSx-Connector sus requerimientos particulares, ya que es posible que sea necesario hacer algún ajuste a FSx-Connector para que interprete correctamente sus datos específicos.