Introducción

Esta guía te ayudará a configurar tu primera integración en FlexiPaaS mediante un caso práctico: la automatización de facturación desde Mercado Libre hacia un sistema interno.

Caso de Uso

La empresa Insumos Pepito vende en Mercado Libre y necesita que cada compra genere una factura en su sistema interno automáticamente.

Flujo de Integración

1. Un cliente compra en Mercado Libre.
2. Mercado Libre envía un JSON con los detalles de la compra. En FlexiPaaS se deberá cargar el JSON modelo
3. En FlexiPaaS se mapean los datos al formato de factura del sistema de Insumos Pepito.
4. FlexiPaaS envía la factura generada a la API del sistema interno.

Pasos para Configurar la Integración

1. Acceder a la Consola de Integraciones

1. Ir a la consola de FlexiPaaS
2. Iniciar sesión con las credenciales correspondientes.

2. Crear una nueva integración

1. En la consola, ir a Integraciones y hacer clic en Nueva Integración.
2. Asignar un nombre: Generar Factura - [TuNombre].
3. Descripción: Genera Factura de ML a Ins_Pep.
4. Asignar al grupo: Todas.

3. Configurar el Servidor de Origen (Mercado Libre)

1. Seleccionar Agregar Servidor de Origen REST.
2. Ingresar las credenciales:
   • Usuario: test123
   • Contraseña: test123
3. Agregar el nodo "Archivo de Entrada JSON":
   • Cargar el JSON modelo con la información de la compra de Mercado Libre.
4. Seleccionar las variables que se utilizarán en la factura:
   • Nombre del cliente
   • Teléfono del cliente
   • CUIT
   • Lista de productos
   • Precio total

4. Configurar el Mapeo de Datos

1. Agregar el nodo "Archivo de Salida JSON":
   • Cargar el JSON modelo con el formato de factura de Insumos Pepito.
2. Realizar el mapeo de datos de Mercado Libre a la Factura:
   • Nombre del cliente → Campo "Cliente" en la factura.
   • Teléfono del cliente → Campo "Teléfono" en la factura.
   • CUIT → Campo "CUIT" en la factura.
   • Lista de productos → Detalles de productos en la factura.
   • Total → Total de la factura.
3. Agregar productos en la lista:
   • Arrastrar la variable iterable al sector correspondiente.
   • Hacer clic derecho sobre cada campo donde se desea agregar los datos y seleccionar el ítem correspondiente.

5. Configurar el Servidor de Destino (Sistema Insumos Pepito)

1. Agregar el nodo "Servidor Destino REST".
2. Configurar los datos de envío:
   • URL del servidor destino: Pipedream Endpoint.
   • Este endpoint no requiere headers ni autenticación.

6. Publicar la Integración

1. Revisar que todos los pasos estén correctamente configurados.
2. Hacer clic en Publicar Integración.
3. Confirmar la activación.

Recursos

• JSON de Entrada: Datos de compra de Mercado Libre.
• JSON de Salida: Formato de factura de Insumos Pepito.
• Servidor de Origen: REST API Mercado Libre.
• Servidor de Destino: API del sistema de Insumos Pepito (sin headers ni autenticación).