> For the complete documentation index, see [llms.txt](https://iflow21.gitbook.io/ecommerce/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://iflow21.gitbook.io/ecommerce/integracion-con-plataformas/magento.md).

# Magento

**Versión**: 1.1\
**Fecha**: 13/03/2025

¡Hola! En esta guía te vamos a mostrar cómo configurar nuestro plugin en tu tienda Magento para que puedas empezar a gestionar tus envíos con iFLOW ecommerce.

***

### Índice de Contenidos

1. [Requisitos para los productos](#id-1.-requisitos-adicionales-para-los-productos)
2. [Configuración de la información de la tienda](#id-2.-configuracion-de-la-informacion-de-la-tienda)
3. [Configuración de métodos de envío](#id-3.-configuracion-de-metodos-de-envio)
4. [Configuración del entorno de pruebas](#id-4.-configuracion-del-entorno-de-pruebas)
5. [Configuración del entorno de producción](#id-5.-configuracion-del-entorno-de-produccion)
6. [Generación de envíos masivos](#id-6.-generacion-de-envios-masivos)
7. [Impresión de etiquetas masivas](#id-7.-impresion-de-etiquetas-masivas)

***

#### 1. Requisitos para los productos

Para que el módulo iFlow funcione correctamente, asegúrate de que todos los productos en tu tienda tengan definidos los siguientes valores:

* **Length** (Largo)
* **Width** (Ancho)
* **Height** (Alto)
* **Weight** (Peso)
* **Price** (Precio)

***

#### 2. Configuración de la información de la tienda

1. En el menú de administración de Magento, navega a **Stores > Settings > Configuration**.
2. En el panel izquierdo, selecciona **General > Store Information**.
3. Completa los siguientes campos:
   * **Store Name**: Nombre de la tienda.
   * **Store Phone Number**: Número de teléfono de la tienda (en el formato deseado).
   * **Store Hours of Operation**: Horario de atención (ejemplo: Lun - Vie, 9-17, Sab 9-15).
   * **Country**: País donde se encuentra la tienda.
   * **Region/State**: Provincia o estado.
   * **Store Address**: Ingrese la dirección física de la tienda.
   * **Store Address Line 2**: Ingrese el numero la dirección física de la tienda.
4. Haz clic en **Save Config** para guardar los cambios.

Ejemplo:

<figure><img src="/files/OaIvU0zxDb18Zvy75gze" alt=""><figcaption></figcaption></figure>

***

#### 3. Configuración de métodos de envío

1. Asegúrate de que la información de la tienda esté completa (como se explica en el paso anterior).
2. En el menú de administración, navega a **Stores > Settings > Configuration**.
3. En el panel izquierdo, expande la sección **Sales** y selecciona **Shipping Settings**.
4. En la sección **Origin**, configura la dirección de origen de los envíos.
5. Haz clic en **Save Config** para guardar los cambios.

Ejemplo:

<figure><img src="/files/Rs9wceLBWIoE3Hdbev8x" alt=""><figcaption></figcaption></figure>

***

#### 4. Configuración del entorno de pruebas

Para configurar iFlow en el entorno de pruebas:

1. Navega a la configuración de envíos dentro de **Stores > Settings > Configuration**.

<figure><img src="/files/oyrJV8w4JM4AwQvt65VQ" alt="" width="375"><figcaption></figcaption></figure>

2. Clic en **Sales > Shipping Methods.**

<figure><img src="/files/8VSprB3SUegXgOvQWPIf" alt="" width="149"><figcaption></figcaption></figure>

La configuración por defecto se verá similar a la siguiente imagen:

<figure><img src="/files/XPCV4VZl0aDvt4jdleus" alt=""><figcaption></figcaption></figure>

3. En el campo **Sandbox Mode**, desmarca la opción "Use system defaults" y selecciona **Yes**.
4. En el campo **Web-Services URL (Production)**, ingresa la siguiente URL del entorno de pruebas: `https://qa-apimods.iflow21.com/`.
5. Completa los campos con las credenciales proporcionadas:
   * **Softlight User**: Usuario del entorno de pruebas.
   * **Softlight Password**: Contraseña del entorno de pruebas.
6. Activa la configuración seleccionando **Enabled > Yes**.

Ejemplo de como quedaria configurado:

<figure><img src="/files/dyY4bk34G3IdSbsDyUo5" alt=""><figcaption></figcaption></figure>

7. Haz clic en **Save Config** para guardar los cambios.

<figure><img src="/files/fMAaGjVD07qQLfEooUXq" alt=""><figcaption></figcaption></figure>

8. Dirígete a **Cache Management.**

<figure><img src="/files/RvzaamIsgeafIG5t7hot" alt=""><figcaption></figcaption></figure>

9. Selecciona los registros resaltados y haz clic en **Submit**.

<figure><img src="/files/qEHJxbQkLjrQ91Vr5wV5" alt=""><figcaption></figcaption></figure>

***

#### 5. Configuración del entorno de producción

Una vez que hayas validado el funcionamiento en el entorno de pruebas, sigue estos pasos para configurar el entorno de producción:

1. Navega nuevamente a la configuración de envíos dentro de **Stores > Settings > Configuration**.
2. En el campo **Sandbox Mode**, selecciona **No** para desactivar el modo de pruebas.
3. En el campo **Web-Services URL (Production)**, ingresa la URL del entorno de producción: `http://apimods.iflow21.com/`.
4. Introduce las credenciales proporcionadas para producción:
   * **Softlight User**: Usuario del entorno de producción.
   * **Softlight Password**: Contraseña del entorno de producción.
5. Haz clic en **Save Config** para guardar los cambios.

***

#### 6. Generación de envíos masivos

1. En el panel de administración, dirígete a **Sales > iFlow Shipping > Generación masiva de envíos**.
2. Aparecerá una lista con las órdenes que no tienen un envío generado y que no están en estado "canceled".
3. Selecciona las órdenes que deseas procesar.
4. En el menú desplegable **Actions**, selecciona la opción **Generar envíos**.

<figure><img src="/files/4uxAV06QE6J70LvwWpSK" alt=""><figcaption></figcaption></figure>

5. Un mensaje confirmará cuántos envíos fueron generados exitosamente y, en caso de errores, te mostrará detalles en los archivos de logs.

Ejemplo envíos generados con éxito:

<figure><img src="/files/NTQP6FrJqS58FBLximmt" alt=""><figcaption></figcaption></figure>

Ejemplo envíos generados sin éxito (parcial):

<figure><img src="/files/U183PyPiSK5x2kIIkFJK" alt=""><figcaption></figcaption></figure>

Si entramos a uno de los pedidos a los que les generamos el envío, observamos que el status del pedido es “Complete”, es decir, tiene un pago y un envío generado.

<figure><img src="/files/XowrvJtkb5POpnNGFMiJ" alt=""><figcaption></figcaption></figure>

Si vamos a la opción de Shipments podremos ver que esta orden tiene creado un shipment y podemos ver el detalle apretando la palabra View que lo vemos en la columna de Action.

<figure><img src="/files/z16Gxxpj5boXyQf8oZdb" alt=""><figcaption></figcaption></figure>

&#x20;

Finalmente, si bajamos hasta la sección de Shipping and Tracking Information veremos el número de tracking del pedido, como mostramos en la siguiente captura:

<figure><img src="/files/S7iQawfYiJCfksjpmHml" alt="" width="375"><figcaption></figcaption></figure>

***

#### 7. Impresión de etiquetas masivas

1. Dirígete a **Sales > Orders** en el panel de administración.

<figure><img src="/files/yrbmOdok4TSiALx5y2H5" alt="" width="275"><figcaption></figcaption></figure>

2. Filtra las órdenes que utilizan el método de envío de iFlow.

<figure><img src="/files/LNXb0aM0WnmCXmALYOz9" alt=""><figcaption></figcaption></figure>

3. Selecciona las órdenes para las que deseas imprimir las etiquetas.
4. En el menú desplegable **Actions**, selecciona **Print Shipping Labels**.
5. Se generará un archivo PDF con las etiquetas correspondientes (si seleccionas múltiples órdenes, cada etiqueta aparecerá en una página separada).

<figure><img src="/files/7ENYXogyLDQLe8Bplx8l" alt="" width="300"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://iflow21.gitbook.io/ecommerce/integracion-con-plataformas/magento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.