La interfaz Magento permite la interacción entre los sistemas Lince Indumentaria y Magento* propiamente dicho. Esto se produce por medio de un intercambio de archivos, que permite importar y exportar datos.

Lince Indumentaria admite la posibilidad de importar los pedidos de venta generados desde la aplicación Magento y a su vez exporta dos archivos planos txt, uno de Precios y otro de Stock de los productos.

Para conocer más acerca de la operatoria de Magento deberá contactar a los desarrolladores de dicha plataforma.

Para poder utilizar la Interfaz, debe solicitar los archivos de uso y configuración a su Ejecutivo de Cuentas ya que los mismos no se distribuyen junto con la aplicación y poseen un costo.

Al hacerse de los archivos, se recomienda alojarlos dentro de la carpeta VFP dentro del directorio de instalación, generalmente es C:\Lincev3. El archivo "impRMay.ini" sin embargo, debe ser ubicado directamente en el directorio de instalación, generalmente es C:\Lincev3.

En el siguiente documento se describen tanto los pasos para la configuración de la interfaz como para su uso.

*Magento es una marca de Magento Enterprise.

Configuración

Para realizar la configuración de la interfaz es necesario ejecutar el archivo denominado: ZooLogicSa.Interfaz.LinceMagento.Configuracion.exe.

La configuración cuenta con tres solapas:

•	Datos Generales

•

Rutas

•	Equivalencias de clientes

Solapa Datos generales

•	Sucursal de trabajo: sucursal designada en lince de e-Commerce.

•	Nombre del sitio e-Commerce: nombre de la tienda virtual.

•	Importación de comprobantes

•	Tipo de comprobante: se debe seleccionar el comprobante a importar.

•	Pedir tipo y nro. de documento de Altas de clientes para los que son Consumidor Final: Al tildarlo, se

•	Cliente para remito: código del cliente (de Lince) que se designará al remito una vez importado, solo en el caso de no querer identificar a cada cliente por separado.

•	Vendedor asignado: se indica el código de vendedor que se va a utilizar en la creación del comprobante mediante la importación desde la aplicación Magento.

•	Artículo para costo de envío: se indica el código de vendedor que se va a utilizar en la creación de los comprobantes.

•	Exportación de precios

•	Precios a enviar: precios a exportar, permite seleccionar 2 opciones Precio de lista / Precio de lista y precio de oferta.

•	Lista de precios: se debe seleccionar la lista que se exportara como Precio de lista.

•	Lista de precios de oferta: se debe seleccionar la lista que se exportara como Precio de oferta.

LI_InterfazMagentoConfiguracionDatosGenerales01-2

Solapa Datos generales

Solapa Rutas

•	Ruta de archivos recibidos, se debe definir el nombre de la carpeta donde se van a depositar los archivos recibidos de Magento pendientes de proceso en Lince Indumentaria.

•	Ruta de archivos procesados, se debe definir el nombre de la carpeta donde se van a depositar los archivos de pedidos recibidos de Magento y ya procesados por Lince Indumentaria.

•	Ruta de archivos enviados, se debe definir el nombre de la carpeta donde se van a depositar los archivos que genera Lince Indumentaria.

LI_InterfazMagentoConfiguracionRutas01-2

Solapa Rutas

Es importante destacar que las rutas de carpetas de archivos recibidos y procesados no deben ser la misma. ya que durante el tratamiento del archivo, el sistema intentaría realizar pasos redundantes, teniendo como resultado el no procesamiento del archivo.

Solapa Equivalencia de clientes

•

Cliente Magento / Cliente Lince,aquí se establece la equivalencia entre los clientes de ambas plataformas. Si al momento de importar Pedidos de Venta Mayorista, el cliente declarado en Magento no tiene su equivalente en Lince, dicho cliente se generará de forma automática, asignándole un código de cliente a continuación del último existente.

LI_InterfazMagentoConfiguracionEquivalenciasClientes01-2

Solapa Equivalencia de clientes

Se debe tener en cuenta que la configuración de la Interfaz se genera por sucursal, en caso de necesitar más sucursales con la interfaz Magento se debe crear una nueva carpeta guardando los datos de configuración por cada sucursal que se desea integrar a la interfaz.

Ejecución de Interfaz

Estos archivos se generan ejecutando el archivo ZooLogicSA.Interfaz.LinceMagento.Disparador.exe en la línea de comando, en el ejemplo a continuación se asume que el archivo existe en el directorio c:\lincev3\vfp\.

Para realizar todas las operaciones a la vez, esto es importar los pedidos de Venta Mayorista y exportar tanto el archivo de precios como el de stock se debe ejecutar sin argumentos:

C:\linceV3\Vfp\ZooLogicSA.Interfaz.LinceMagento.Disparador.exe

Para los archivos de precios de producto, el nombre del archivo debe ser price-MISITIO-20120906163208, este nombre contiene el tipo de archivo, el nombre de sitio e-Commerce y la fecha/hora de generación de mismo.

Para exportar el archivo de precios se utiliza el argumento "L", sin las comillas:

C:\LinceV3\vfp\ZooLogicSA.Interfaz.LinceMagento.Disparador.exe L

Exportación de Precios y Stock

Para la exportación de datos hacia Magento, Lince Indumentaria genera los archivos con extensión .CSV (archivos separados por comas)

El sistema exporta los precios y el stock solo de aquellos artículos que se hayan dado de alta con una equivalencia asociada, la equivalencia debe estar completa, debe indicar artículo, color y Talle.

Exportación de Precio de lista

A continuación se muestra un archivo de exportación de ejemplo para la generación de precios de producto, sobre el primer campo se visualiza el código equivalencia del producto, y como segundo campo se visualiza el precio que se le va a asignar al producto correspondiente.

IS_Li_Mag004

Archivo de ejemplo para Precios.

Nombre del Campo	Descripción	Tipo de Dato	Cantidad de Caracteres
SKU	Código de Equivalencia de Lince	CHAR	13
Precio	Precio de la Lista configurada	NUMERICO	13 ENTEROS - 4 DECIMALES

Exportación de Precio de lista y precio de oferta

A continuación se muestra un archivo de exportación de ejemplo para la generación de precios de lista base y precios de lista de oferta.

Línea	Nombre del Campo	Descripción	Tipo de Dato	Cantidad de Caracteres
1_Información de Precios	SKU	Código SKU del artículo, se debe generar una equivalencia en Lince	CHAR	13
	DESCRIPCION	Descripción del artículo	CHAR	40
	PRECIO_BASE	Precio de Lista base	NUMERICO	13 ENTEROS - 4 DECIMALES
	PRECIO_ESPCIAL	Precio de Lista de Oferta	NUMERICO	13 ENTEROS - 4 DECIMALES
	FECHA_DESDE		Campo vacío
	FECHA_HASTA		Campo vacío

Exportación de Stock

Para los archivos de stock de producto, el nombre del archivo debe ser stock-MISITIO-20120906163208, este nombre contiene el tipo de archivo, el nombre de sitio e-Commerce y la fecha/hora de generación de mismo.

El calculo del stock es el siguiente: el stock exportado es el stock declarado en Lince Indumentaria menos los pedidos pendientes de entrega. A modo de ejemplo si tuviera 20 unidades de un producto en stock, pero tengo un pedido de 5 unidades sobre ese mismo producto, el stock declarado en el archivo exportado será de 15 unidades.

Para exportar el archivo de stock se utiliza el argumento "S", sin las comillas:

C:\LinceV3\vfp\ZooLogicSa.Interfaz.LinceMagento.Disparador.exe S

IS_Li_Mag006

Archivo de ejemplo para stock

Nombre del Campo	Descripción	Tipo de Dato	Cantidad de Caracteres
SKU	Código de Equivalencia de Lince	CHAR	13
Cantidad	Cantidad de stock	NUMERICO	7 ENTEROS

Importación de los pedidos de venta mayorista

Para Importar el archivo de pedidos de venta se utiliza el argumento "P", sin las comillas:

C:\LinceV3\vfp\ZooLogicSa.Interfaz.LinceMagento.Disparador.exe P

El archivo de importación que genera el sistema Magento para que se carguen los pedidos en Lince Indumentaria son de extensión .CSV, y su nomenclatura es la siguiente: orders-XXXXXX-YYYYYYYY, donde XXXXXX se reemplaza por el nombre del sitio de e-Commerce y las YYYYYYYY representan un número(timestamp) generado por el sistema Magento.

Si el cliente declarado en Magento no existe en Lince, se dará de alta y se generará la equivalencia de clientes mencionada anteriormente.

Se debe asegurar una correcta configuración en el sistema Magento para que los archivos de pedidos puedan ser recepcionados en Lince Indumentaria.

IS_Li_Mag010

Pedido generado en Magento

Linea	Nombre del campo	Descripción	Tipo de dato	Cantidad de caracteres
1- Datos de medio de pago	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	IDCLI	Código de cliente	CHAR	40 (pero se importa con los 5 seteados en la configuración)
	FECHA	Fecha del comprobante	DATE	AAAA/MM/DD
	IMPORTE	Importe del comprobante	NUMERICO	13 ENTEROS - 2 DECIMALES
	MEDIO_PAGO	Medio de pago del comprobante	CHAR	60
	CUOTAS	Cantidad de cuotas del medio de pago	NUMERICO	2
2- Dirección de facturación	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	NOMBRE	Nombre del cliente	CHAR	60
	APELLIDO	Apellido del cliente	CHAR	60
	DOMICILIO	Dirección de entrega	CHAR	60
	C_POSTAL	Código postal del cliente	CHAR	8
	CIUDAD	Ciudad de entrega	CHAR	40
	PROVINCIA	Provincia del cliente	CHAR	2 (Código)
	PAIS	País del cliente	CHAR	3 (Código)
	FAX	Fax del cliente	CHAR	60
	TELEFONO	Teléfono del cliente	CHAR	60
	E_MAIL	E-mail del cliente	CHAR	60
	TIPO_DOC	Tipo de documento del cliente	CHAR	10
	NRO_DOC	Número del documento del cliente	CHAR	40
3- Dirección de envío	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	NOMBRE	Nombre del cliente	CHAR	60 (para nombre y apellido)
	APELLIDO	Apellido del cliente	CHAR	60 (para nombre y apellido)
	DOMICILIO	Dirección del cliente	CHAR	60
	C_POSTAL	Código postal del cliente	CHAR	8
	CIUDAD	Ciudad del cliente	CHAR	40
	PROVINCIA	Provincia del cliente	CHAR	2 (Código)
	PAIS	País del cliente	CHAR	3 (Código)
4- Costo de envío	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	DIR_ENVIO	Dirección de envío	CHAR	60
	VALOR_ENVIO	Valor de envío	NUMERICO	13 ENTEROS - 2 DECIMALES
5- Descuento a la orden	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	VALOR_DESC	Valor del descuento, si se aplica	NUMERICO	13 ENTEROS - 2 DECIMALES
6- Interés a la orden	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	VALOR_INTERES	Valor de los intereses	NUMERICO	13 ENTEROS - 2 DECIMALES
7- Detalle de la orden	NORDEN	Número de orden	NUMERICO	9 ENTEROS
	SKU	Código SKU del artículo, se debe generar una equivalencia en Lince	CHAR	13
	CANTIDAD	Cantidad del artículo	NUMERICO	7 ENTEROS - 2 DECIMALES
	PRECIO	Precio del artículo	NUMERICO	13 ENTEROS - 4 DECIMALES

IS_Li_Mag009

Detalle del pedido ingresado de forma automática en Lince Indumentaria

IS_Li_mag11

Pedido Importado en Lince Indumentaria

Importación de remitos de venta mayorista

Para Importar el archivo de remitos de venta mayorista se utiliza el argumento "R", sin las comillas:
C:\linceV3\Vfp\ZooLogicSa.Interfaz.LinceMagento.Disparador.exe R

Linea	Nombre del campo	Descripción	Tipo de dato	Cantidad de caracteres
1- Datos de medio de pago	NORDEN	Número de orden	NUMÉRICO	9
	IDCLI	Código de cliente	CARÁCTER	40 (pero se importa con los 5 seteados en la configuración)
	DNI	Número de documento	CARÁCTER	15
	E_MAIL	Mail del cliente	CARÁCTER	60
	FECHA	Fecha de la operación	FECHA	AAAA/MM/DD
	IMPORTE	Importe del comprobante	NUMÉRICO	13 ENTEROS - 2 DECIMALES
	MEDIO_PAGO	Medio de pago del comprobante	-	-
	TARJETA	Vacío	-	-
	BANCO	Vacío	-	-
	CUOTAS	Cantidad de cuotas	NUMÉRICO	2
	BIN	Vacío	-	-
	CUPON	Número de cupón	-	-
	AUTH	Número de autorización	CARÁCTER	20
2- Dirección de facturación	NORDEN	Número de orden	NUMÉRICO	9
	NOMBRE	Nombre del cliente	CARÁCTER	60 (para nombre y apellido)
	APELLIDO	Apellido del cliente	CARÁCTER	60 (para nombre y apellido)
	DOMICILIO	Dirección para facturación	CARÁCTER	60
	C_POSTAL	Código postal del cliente	CARÁCTER	8
	CIUDAD	Ciudad de entrega	CARÁCTER	40
	PROVINCIA	Provincia del cliente	CARÁCTER	2 (Código)
	PAIS	País del cliente	CARÁCTER	3 (Código)
	TELEFONO	Teléfono del cliente	CARÁCTER	60
	FAX	Fax del cliente	CARÁCTER	60
3- Dirección de envío	NORDEN	Número de orden	NUMÉRICO	9
	NOMBRE	Nombre del cliente	CARÁCTER	60 (para nombre y apellido)
	APELLIDO	Apellido del cliente	CARÁCTER	60 (para nombre y apellido)
	DOMICILIO	Dirección de entrega	CARÁCTER	60
	C_POSTAL	Código postal del cliente	CARÁCTER	8
	CIUDAD	Ciudad de entrega	CARÁCTER	40
	PROVINCIA	Provincia para entrega	CARÁCTER	2 (Código)
	PAIS	País de entrega	CARÁCTER	3 (Código)
	TELEFONO	Teléfono de contacto	CARÁCTER	60
	FAX	Fax de contacto	CARÁCTER	60
4- Costo de envío	NORDEN	Número de orden	NUMÉRICO	9
	METODO_ENVIO	Forma de envío	-	-
	VALOR_ENVIO	Valor del envío	NUMÉRICO	13 ENTEROS - 2 DECIMALES
5- Descuento a la orden	NORDEN	Número de orden	NUMÉRICO	9
	VALOR_DESC	Valor del descuento, si se aplica	NUMÉRICO	13 ENTEROS - 2 DECIMALES
6- Interés a la orden	NORDEN	Número de orden	NUMÉRICO	9
	VALOR_INTERES	Vacío	-	-
7- Crédito en la tienda	NORDEN	Número de orden	NUMÉRICO	9
	STORE_CREDIT	Vacío	-	-
8- Detalle de la orden	NORDEN	Número de orden	NUMÉRICO	9
	SKU	Código SKU del artículo, se debe generar una equivalencia en Lince	CARÁCTER	13
	NAME	Descripción del artículo	CARÁCTER	40
	CANTIDAD	Cantidad del artículo	NUMÉRICO	7 ENTEROS - 2 DECIMALES
	PRECIO	Precio del artículo	NUMÉRICO	13 ENTEROS - 4 DECIMALES

El campo NORDEN es obligatorio en cada línea y sirve para identificar el remito. En Lince se guarda en las observaciones del remito y se seguirá generando un remito por cada número de orden. El cliente utilizado seguirá siendo genérico y, tanto este último dato como el código de vendedor, se customizan en la configuración de la interfaz.

Importante

Al realizar la importación de pedidos o remitos, por cuestiones de operatoria interna, durante el proceso, el sistema genera archivos de texto al convertir el documento generado en Magento a un formato conocido para Lince Indumentaria.

Dentro del archivo impRMay.ini ubicado en C:\Lincev3\ se debe establecer la ruta donde debe crearlo, en el apartado:

Para Pedidos:

[PEDMAYIMPORTACION]

ARCHIVO = Ubicación del archivo

Para Remitos:

[REMMAYIMPORTACION]

ARCHIVO = Ubicación del archivo

IS_Li_Mag007

Ubicación del archivo intermedio

El primer archivo que genera es IMPRMAY (más la fecha en que se ejecuta la interfaz) en la carpeta C:\linceV3\AUTO\

(ej.: C:\linceV3\AUTO\IMPRMAY\20160516).

Luego genera un archivo con la siguiente nomenclatura: PIRM (más la hora, minutos y segundos que se ejecuta la interfaz) el cual contiene todos los pedidos que proceso la interfaz (ej.: pirm163148.txt).

Por ultimo, se genera el archivo InterfazMagento.log el cual contiene la lista con los errores que se encontraron y su posición en el archivo.

Nota: al ejecutarse la interfaz, esta verificará que el archivo no exista para crearlo, caso contrario agregara los datos nuevos al final de este.

Consideraciones

Para poder realizar el intercambio de información a nivel productos por el lado de Magento deben estar dadas de alta las claves SKU y en Lince Indumentaria es necesario que los productos tengan asociado un código de equivalencia. Esta entidad se genera desde Altas - Equivalencias.

IS_Li_Mag005

Alta de equivalencias

Control de stock

Se recomienda revisar la parametrización definida en el sistema. Se debe prestar especial atención a los controles que se realicen sobre el stock. Si se intenta ingresar un pedido al sistema y este, controlando stock valida que no hay existencias disponibles, no ingresará el pedido.

IS_Li_Mag008-1

Control del stock en parámetros del sistema

Automatización de las tareas

Para la ejecución de procesos de intercambio de archivos es recomendado generar Tareas Programadas en el sistema operativo Microsoft Windows. A cada tarea programada se le debe configurar la ejecución de cada línea de comando para que la operatoria sea de manera automática en el rango de tiempo/fecha deseado.

magent003

Pantalla de configuración de tarea programada de Windows

Build: 20240826

Volver al Comienzo Anterior Siguiente