Saltar al contenido principal

Exportación de Datos vía XML e Integración

La aplicación admite la exportación de datos en formato XML (products.xml), lo que permite integrar los productos y lotes registrados con sistemas ERP de terceros, WMS, software de control de inventario o scripts automatizados personalizados.

Requisitos de Acceso​

Suscripción PRO Requerida en la App Individual
  • Control de Vencimientos (Aplicación Individual): Las funciones de exportación de datos (incluidas XML y Excel) son exclusivas para suscriptores PRO. Si intenta acceder a la pantalla de exportación en el plan gratuito, se le solicitará que se suscriba.
  • Control de Vencimientos para Equipos (Aplicación Colaborativa): Esta función está disponible directamente en la pantalla de exportación según los permisos asignados a su rol dentro del Espacio de Trabajo.

Cómo Exportar el Archivo XML​

Puede generar y exportar el archivo XML directamente desde ambas aplicaciones móviles:

  1. Abra la aplicación (Control de Vencimientos o Control de Vencimientos para Equipos).
  2. Abra el menú lateral de navegación y seleccione Importar y Exportar (o Exportar).
  3. En la pantalla de exportación, desplácese hasta la sección XML.
  4. Toque el botón Exportar en XML.
  5. La aplicación procesará los productos, lotes, marcas, categorías y tiendas registrados para generar el archivo products.xml.
  6. Aparecerá la ventana emergente nativa de uso compartido de su dispositivo (Android/iOS), lo que le permitirá guardar el archivo localmente, enviarlo por correo electrónico, WhatsApp o subirlo a un servicio en la nube (Google Drive, iCloud, OneDrive, etc.).

Estructura del Archivo XML Exportado​

El archivo XML exportado sigue una estructura jerárquica estandarizada. A continuación se muestra un ejemplo del contenido XML generado:

<data>
    <total>
        <products>5</products>
        <brands>2</brands>
        <categories>3</categories>
        <stores>2</stores>
    </total>

    <brands>
        <brand>
            <id>1</id>
            <name>Marca A</name>
        </brand>
        <brand>
            <id>2</id>
            <name>Marca B</name>
        </brand>
    </brands>

    <categories>
        <category>
            <id>1</id>
            <name>Categoría X</name>
        </category>
        <category>
            <id>2</id>
            <name>Categoría Y</name>
        </category>
        <category>
            <id>3</id>
            <name>Categoría Z</name>
        </category>
    </categories>

    <stores>
        <store>
            <id>1</id>
            <name>Tienda 1</name>
        </store>
        <store>
            <id>2</id>
            <name>Tienda 2</name>
        </store>
    </stores>

    <products>
        <product>
            <name>Producto A</name>
            <code>7891000100100</code>
            <photo>producto_a.jpg</photo>
            <daysToBeNext>10</daysToBeNext>
            <created_at>2024-12-01</created_at>
            <updated_at>2025-01-01</updated_at>

            <batches>
                <batch>
                    <name>Lote 1</name>
                    <expDate>2025-06-30</expDate>
                    <amount>100</amount>
                    <price>10.50</price>
                    <price_tmp>9.50</price_tmp>
                    <status>checked</status>
                    <created_at>2024-12-01</created_at>
                    <updated_at>2024-12-15</updated_at>
                </batch>
                <batch>
                    <name>Lote 2</name>
                    <expDate>2025-08-31</expDate>
                    <amount>50</amount>
                    <price></price>
                    <price_tmp></price_tmp>
                    <status>unchecked</status>
                    <created_at>2024-12-10</created_at>
                    <updated_at>2024-12-20</updated_at>
                </batch>
            </batches>

            <brand>
                <id>1</id>
            </brand>
            <category>
                <id>1</id>
            </category>
            <store>
                <id>1</id>
                <name>Tienda 1</name>
            </store>
        </product>
    </products>
</data>

Mapeo de Campos y Diccionario de Datos​

Etiqueta XMLDescripciónNotas
<total>Conteo general de elementos en el XML.Contiene recuentos de <products>, <brands>, <categories> y <stores>.
<brands> / <brand>Lista de marcas vinculadas a los productos.Contiene <id> y <name>.
<categories> / <category>Lista de categorías de productos.Contiene <id> y <name>.
<stores> / <store>Lista de tiendas o sucursales.Contiene <id> y <name>.
<product>Elemento principal del producto.Contiene los datos del producto y la lista de lotes asociados.
<name> (Producto)Nombre del producto.Campo de texto que representa el nombre o descripción del artículo.
<code>Código de barras, EAN, GTIN o SKU.Identificador único del producto.
<photo>Nombre o ruta de la foto del producto.Referencia de la imagen guardada localmente o en la nube.
<daysToBeNext>Umbral de alerta en días.Días previos al vencimiento para activar la notificación.
<batches> / <batch>Lista de lotes del producto.Contiene detalles individuales de cada lote.
<expDate> / <exp_date>Fecha de vencimiento del lote.Formato AAAA-MM-DD.
<amount>Cantidad en stock.Valor numérico entero o decimal.
<price>Precio de venta.Precio unitario para el lote.
<price_tmp>Precio promocional o temporal.Precio de oferta o descuento.
<status>Estado de verificación del lote.Devuelve checked (Tratado/Verificado) o unchecked (Pendiente).
<brand> / <category> / <store> (dentro de <product>)Enlaces relacionales del producto.Hace referencia al <id> correspondiente definido en las secciones superiores.

Paso a Paso para la Integración con Otros Sistemas​

  1. Verifique la Compatibilidad: Asegúrese de que su ERP o sistema receptor admita la lectura de archivos XML.
  2. Mapee los Campos: Relacione las etiquetas XML exportadas con la estructura de la base de datos de su sistema de destino (ej.: <name> a nombre_producto, <expDate> a fecha_vencimiento).
  3. Cree o Utilice Scripts de Importación: Si su sistema no cuenta con un importador XML nativo, desarrolle un script (en Python, Node.js, PHP, C#, etc.) para analizar el árbol XML e insertar registros vía base de datos o API REST.
  4. Realice una Copia de Seguridad: Realice siempre un backup completo de la base de datos de su sistema de destino antes de ejecutar importaciones masivas.
  5. Pruebe la Importación: Pruebe primero el proceso con un pequeño conjunto de datos de muestra para verificar que las fechas, precios y cantidades se importen correctamente.