Integración automática Mercado Libre Flex → SimpliRoute
Busco un desarrollador para construir un script/servicio que integre la API de Mercado Libre con la API de SimpliRoute, automatizando el registro de pedidos Flex como visitas en SimpliRoute sin intervención manual.
Contexto del negocio:
Procesamos aproximadamente 600 pedidos Flex por día. Hoy la carga a SimpliRoute se hace manual y necesitamos eliminar ese paso.
Funcionalidades requeridas:
Conexión con API de Mercado Libre: el servicio debe consultar periódicamente los pedidos nuevos con envío Flex en estado confirmado desde la última ejecución exitosa, usando OAuth 2.0 con manejo automático de refresh tokens.
Transformación de datos: mapear los campos de ML al formato que espera SimpliRoute (destinatario, dirección, teléfono, productos, referencias, ventana horaria si aplica). Debe contemplar casos borde: direcciones incompletas, caracteres especiales, datos faltantes.
Registro en Simpliroute: crear las visitas vía api rest con todos los datos relevantes, sin duplicados.
Control de duplicados con persistencia real: los IDs de pedidos ya procesados deben guardarse en una base de datos (PostgreSQL o Redis), no en memoria. El sistema debe ser tolerante a reinicios sin duplicar visitas.
Manejo de errores robusto: retries con backoff exponencial, logging estructurado, alertas automáticas por Telegram o email ante fallos (token expirado, API caída, datos inválidos, cuota excedida, etc.).
Scheduling: ejecución automática cada 15-30 minutos (a definir), con monitoreo del estado del cron.
Stack y condiciones técnicas:
Lenguaje: Python (FastAPI) o
Node.js. Sin frameworks "no-code" ni generadores tipo Lovable.
Deploy: Railway, en mi cuenta (me agregás como owner, vos como colaborador si hace falta).
Repositorio: GitHub, en mi cuenta desde el día uno, con commits progresivos durante el desarrollo (no un solo dump al final).
Credenciales: en variables de entorno, nunca hardcodeadas.
Archivo .env.example con todas las variables documentadas.
README claro con instrucciones de ejecución, mantenimiento, rotación de tokens y troubleshooting.
Entregables:
Código fuente completo en mi repo de GitHub.
Deploy funcionando en mi Railway.
README técnico.
Demostración en vivo por videollamada con pantalla compartida, mostrando el flujo end-to-end con pedidos reales de mi cuenta.
Criterio de aceptación: procesamiento correcto de al menos 3 pedidos Flex reales pasando a SimpliRoute sin duplicados ni errores, incluyendo una reejecución del cron para verificar idempotencia.
Lo que NO incluye el proyecto:
Interfaz gráfica o dashboard.
Optimización de rutas (lo hace SimpliRoute).
Reportes o analítica.
Mantenimiento posterior (el código queda en mi repo y lo mantengo yo o quien yo decida). No hay cobro mensual recurrente. Los únicos costos corrientes son servidor (~USD 5/mes) y APIs, cubiertos por mí.
Para aplicar, por favor incluí en tu propuesta:
Experiencia concreta con la API de Mercado Libre (qué proyectos, qué endpoints usaste, cómo manejaste OAuth).
Experiencia con SimpliRoute o integraciones de logística similares.
Respuestas cortas a estas tres preguntas técnicas:
¿Dónde persistís los IDs de pedidos procesados para evitar duplicados, y por qué?
¿Cómo manejás la expiración del refresh token de ML (que dura 6 meses)?
¿Qué hacés si un pedido llega con dirección incompleta o mal formateada para SimpliRoute?
Estimación de tiempo y presupuesto.
Link a repos de GitHub o proyectos similares que puedas mostrar.
Forma de trabajo:
Toda la comunicación por Workana.
Pagos solo vía Workana Pay, por hitos.
No se liberan fondos hasta cumplir el criterio de aceptación con datos reales.
Propuestas que no respondan las tres preguntas técnicas no van a ser consideradas.
Plazo de Entrega: No definido