Reestructuración General Haztuenvio

Conjunto de herramientas y servicios diseñados para que el usuario final pueda cotizar, generar, administrar y dar seguimiento a sus envíos dentro de la plataforma.

Sistema de cotización basado en Fastify + WebSockets que ejecuta solicitudes simultáneas a todas las paqueterías incluidas, evitando la espera secuencial. 

Permite retornar resultados en tiempo real conforme cada proveedor responde, optimizando significativamente la velocidad de cotización y la experiencia del usuario.

Módulo encargado de crear guías a partir de las cotizaciones aprobadas, validando datos del remitente, destinatario y contenido. Gestiona la comunicación directa con cada API de paquetería para generar el envío, obtener la etiqueta, registrar el número de rastreo y almacenar toda la información asociada en el sistema.

Módulo que mantiene la conexión directa con Safelink para asegurar envíos durante su generación. Envía el valor declarado y los datos del paquete, recibe la póliza correspondiente y registra la protección en el sistema, gestionando también validaciones, estatus y cualquier evento relacionado con la cobertura.

También permite realizar pólizas de guías independientes desde una interfaz separada para poder asegurar envíos que no hayan sido generados en la plataforma. 

Cada integración gestiona cotizaciones, generación de guías, recolecciones, rastreo y validaciones siguiendo el estándar interno del sistema. Las conexiones se realizan exclusivamente con los proveedores y APIs actualmente utilizados por HaztuEnvio, detallados a continuación:

-  Paquetexpress : Proveedor: SRS Express
-  FedEx : Proveedor: FedEx Directo
-  ODM : Proveedor: ODM Directo
-  BigSmart : Proveedor: BigSmart Directo
-  Sendex : Proveedor: Sendex Directo
-  IMile : Proveedor: IMile Directo
-  PMM : Proveedor: PMM Directo
-  DHL Nacional : Proveedor: DHL Directo
-  DHL Nacional Alterno : Proveedor: Shipandgo
-  Estafeta : Proveedor: Estafeta Directo
-  JT : Proveedor: J&T Directo
- Fedex Internacional : Proveedor: Fedex Directo
- UPS Internacional : Proveedor: UPS Directo
- DHL Internacional : Proveedor: DHL Directo

Todos bajo una arquitectura unificada para garantizar consistencia y alto rendimiento.

Esto significa que:

Las integraciones listadas se desarrollan únicamente con los proveedores activos del cliente.

En el caso de DHL, se incluyen DHL Directo y DHL Shipandgo como proveedores ya operativos.

Cualquier nuevo proveedor, nueva API, nuevo servicio o cambio de credenciales, ya sea de DHL o de cualquier otra paquetería, se considerará fuera del alcance y requerirá una cotización independiente.

Si una paquetería libera nuevas versiones de su API, nuevas modalidades de conexión o nuevos parámetros obligatorios, estos cambios se cotizarán de manera adicional en caso de ser necesarios para su operación.

Esta aclaración garantiza que la plataforma mantenga compatibilidad con las integraciones actuales sin comprometer la estabilidad ni generar costos ocultos o sorpresas operativas.

Módulo que permite solicitar recolecciones directamente desde la plataforma para cualquiera de las paqueterías integradas siempre y cuando esta lo permita. Gestiona horarios, validaciones de cobertura, número de piezas, direcciones y confirmaciones, enviando la solicitud al proveedor correspondiente y registrando el folio o estatus de programación dentro del sistema para su seguimiento.

Módulo que administra un saldo interno vinculado al usuario, permitiendo recargas, abonos automáticos, uso como método de pago para envíos y registro detallado de movimientos. Incluye historial, cálculo de beneficios, conciliación con facturación y sincronización en tiempo real con las operaciones del sistema.

La integración incluye las siguientes pasarelas de pago: 

- Mercado Pago
- Open Pay
- Coppel Pay

La integración del monedero incluye únicamente las pasarelas de pago especificadas, Cualquier implementación adicional de nuevas pasarelas, métodos de pago, PSPs alternos (Payment Service Providers), licencias especiales o integraciones financieras distintas a las aquí descritas se considerará fuera del alcance y deberá cotizarse de manera independiente.

Módulo que genera reportes detallados del movimiento financiero del usuario, incluyendo recargas, deducciones por envíos, cargos adicionales, bonificaciones y facturación asociada. Permite filtrar por fechas, exportar información y visualizar saldos anteriores, movimientos del periodo y saldo final con total transparencia.

Módulo que permite cargar múltiples envíos en un solo proceso mediante plantillas o layouts predefinidos de excel. Realiza una cotización masiva previa para cada registro, mostrando resultados por paquetería antes de generar las guías. Permite el uso de multiples paqueterías en el mismo archivo. 

Facilita operaciones de alto volumen mediante validaciones automáticas, previsualización de costos y optimización del tiempo de carga.

También permite la gestión de errores del proveedor sin cerrar el layout final, entregando un excel idéntico a la entrada pero colocando la guía y el link de cada registro. 

El correcto funcionamiento depende del archivo cargado por el usuario. Errores de formato no son atribuibles al sistema.

Módulo que integra Facturama para generar facturas de forma automática y precisa. Permite vincular movimientos del monedero a comprobantes fiscales, realizar timbrado inmediato, recuperar facturas emitidas y mantener un historial fiscal completo dentro de la plataforma.

Las funcionalidades de facturación dependen de PACs externos.
Cambios fiscales, actualizaciones de PAC, nuevas reglas del SAT o incompatibilidades deben cotizarse por separado

Módulo que permite a cada usuario gestionar su información personal y operativa dentro de la plataforma. Incluye actualización de datos de contacto, preferencias de notificación, ajustes de seguridad para optimizar su experiencia en el sistema y personalización de los datos fiscales para las facturas. También le permitirá realizar facturación automática para todas sus recargas si así lo desea. 

Módulo que muestra el saldo del monedero actualizado al instante utilizando eventos en tiempo real. Refleja cambios por recargas, generación de envíos, cargos adicionales o bonificaciones sin necesidad de recargar la página, garantizando precisión en cada operación financiera. Se usarán websockets para tener el saldo siempre actualizado en tiempo real incluso si alguien mas está compartiendo el usuario o si se cobran sobre pesos en ese instante. 

Módulo que centraliza todas las integraciones e-commerce en un panel visual donde el usuario puede conectar su tienda, consultar manuales, ver videos de configuración, administrar integraciones activas y acceder a documentación API. Permite sincronizar pedidos y generar envíos desde:

- Tiendanube (Licencia Especial accesible)
- WooCommerce
- Shopify (Este requiere una licencia especial)
- PrestaShop
- Magento 

Todo bajo un mismo estándar operativo.

La integración cubre únicamente la versión estable del plugin o API disponible al momento del desarrollo. Actualizaciones mayores, cambios obligatorios, nuevas APIs o nuevas versiones de tiendas se cotizan por separado.

En caso de que, por políticas del proveedor de la tienda en línea, por restricciones técnicas, por cambios en su API o por cualquier otra causa directamente atribuible a dicho proveedor, no sea posible concluir el desarrollo de alguno de los plugins, se evaluará la situación de manera interna. Únicamente si el módulo correspondiente no ha sido concluido, se considerará un reembolso proporcional al grado de avance.

La aprobación de dicho reembolso no es automática y quedará sujeta al análisis técnico que determine la imposibilidad real de continuar.

Funcionalidad que permite a cada usuario almacenar múltiples direcciones frecuentes (origen o destino), facilitando el llenado de formularios al generar nuevas guías y reduciendo errores o repeticiones manuales.

Conjunto de herramientas para controlar la operación global de la plataforma. Permite gestionar clientes, administrar listas de costos mediante Google Sheets, supervisar finanzas y operaciones en tiempo real, configurar permisos, atender incidencias, gestionar códigos de descuento, verificar documentos oficiales y mantener una vista completa del desempeño del sistema.

Módulo que permite administrar toda la información de los usuarios registrados: datos generales, estatus, saldos, historial de movimientos, integraciones activas y configuraciones personalizadas. Optimizada para no volverse lenta con el paso del tiempo Incluye herramientas de búsqueda, filtros avanzados y acciones administrativas para soporte y control operativo.

Módulo que permite administrar las tarifas de todas las paqueterías a través de hojas de cálculo en Google Sheets. Sincroniza automáticamente los cambios, valida estructuras, actualiza listas activas y garantiza que la plataforma utilice siempre los costos más recientes sin necesidad de despliegues técnicos.

La sincronización con Google Sheets depende del acceso, estructura y permisos proporcionados por el cliente.
Cambios no controlados en el archivo producirán errores fuera del alcance del soporte.

Módulo centralizado que concentra toda la información económica del sistema: movimientos de monederos, recargas, consumos por paquetería, comisiones, facturación, saldos globales y proyecciones. Ofrece gráficas, filtros avanzados, exportación de datos y herramientas de auditoría para una gestión financiera precisa y transparente, similar al instalado actualmente pero basado en python para analítica avanzada. 

Módulo que permite monitorear en tiempo real la actividad del sistema: generación de guías, estatus de recolecciones, desempeño de paqueterías, tiempos de respuesta, errores detectados y alertas operativas. Facilita la toma de decisiones mediante tableros, métricas y reportes que muestran la salud completa de los procesos logísticos.

Módulo que administra los niveles de acceso para todo el personal. Permite crear roles, asignar permisos específicos a cada módulo, limitar funciones sensibles, registrar actividad administrativa y garantizar que cada usuario opere únicamente dentro del alcance autorizado, manteniendo la seguridad y el orden operativo del sistema.

Módulo que centraliza la recepción, seguimiento y resolución de problemas operativos reportados por clientes o personal interno. Permite registrar incidencias, asignarlas a agentes, monitorear su progreso, adjuntar evidencia y mantener un historial completo. Incluye herramientas internas como chat tipo callcenter y formularios de apertura de tickets para garantizar una atención ordenada y oportuna.

Módulo de comunicación interna que permite a los agentes atender incidencias mediante un chat en tiempo real. Ofrece asignación automática, conversaciones por ticket, historial centralizado, transferencia entre agentes y soporte multigrupo, optimizando la atención y reduciendo tiempos de respuesta.

Módulo que permite a usuarios y personal interno registrar incidencias mediante un formulario estructurado. Captura categoría, descripción, evidencia y datos del usuario, generando un ticket con folio único y enviándolo a la cola correspondiente para su seguimiento dentro del sistema de soporte.

Módulo que permite crear, administrar y aplicar códigos promocionales dentro de la plataforma. Controla parámetros como tipo de descuento, vigencia, límite de usos y condiciones de aplicación, además de ofrecer herramientas para supervisar su impacto y monitorear resultados en tiempo real.

Define la palabra o código que el usuario ingresará para activar un descuento. Permite establecer identificadores únicos, diferenciarlos por campañas y asegurarse de que no se repitan dentro del sistema.

Permite configurar cuántas veces puede utilizarse un código de descuento.

Determina el tipo de descuento que aplicará cada código. Permite seleccionar entre un porcentaje sobre el total o un monto fijo de reducción.

Módulo que registra cada utilización de los códigos de descuento, mostrando fecha, usuario, monto aplicado, campaña asociada y estado de la operación. 

Permite auditoría completa, análisis de desempeño y control preciso de todas las promociones ejecutadas.

Automatiza la validación de documentos oficiales del cliente (INE y Constancia de Situación Fiscal). Conecta con servicios externos autorizados para verificar autenticidad, coincidencia de datos, vigencia y estructura fiscal, registrando el resultado en el perfil del usuario y habilitando o restringiendo funciones según el estatus validado.

Esta funcionalidad se conectará con el servicio de https://verificamex.com/ o similar a elección del propietario del sistema. 

La validación INE/CSF depende del proveedor externo elegido (por ejemplo, Verificamex).
Cambios en costos, reglas, métodos o APIs son responsabilidad del proveedor.

El soporte técnico incluído durante 6 meses junto con el precio de la app incluye lo siguiente: 
- Atención a fallas o errores operativos. 
- Mantenimiento preventivo y correctivo. 
- Actualizaciones de seguridad. 
- Acompañamiento en la evolución del sistema y mejoras futuras. 

Posterior a eso se empleará una póliza bajo demanda como la utilizada actualmente.


El propietario de la aplicación cuenta con un desarrollo de chatbot con Inteligencia Artificial (IA) para ofrecer atención automatizada y dar seguimiento a las solicitudes y dudas de los usuarios dentro de la plataforma. 

Asumiremos la gestión, mantenimiento y soporte operativo diario de este chatbot, asegurando su correcto funcionamiento, actualización constante y respuesta eficiente. 

El mantenimiento incluirá: 
- Supervisión del rendimiento y disponibilidad del bot. 
- Actualización de prompts, flujos conversacionales y base de conocimiento. 
- Monitoreo de logs y métricas de interacción. 
- Coordinación con el área de soporte para la mejora continua de respuestas. El chatbot deberá mantenerse activo durante el horario laboral establecido en esta licitación, ofreciendo soporte en tiempo real a los usuarios y redirigiendo los casos complejos al equipo humano correspondiente. 

El soporte del chatbot incluye mantenimiento operativo básico y ajustes menores.
Cambios funcionales, nuevos flujos conversacionales, integraciones adicionales o nuevas lógicas de negocio se cotizan por separado.

Se le entregará al propietario de la aplicación al concluír el desarrollo los siguientes elementos: - Documento con la arquitectura y estructura técnica propuesta. - Diseño visual (UI/UX) de la plataforma. - Desarrollo funcional completo y pruebas de rendimiento. - Manual de uso y capacitación al equipo de HazTuEnvio. - Documentación técnica del sistema. - Contrato de soporte y mantenimiento. La garantía cubre defectos del software, no cambios solicitados. Todo lo no especificado explícitamente en esta propuesta se considera fuera del alcance y podrá ser cotizado de manera independiente según las necesidades del cliente.

La capacitación incluida en la presente propuesta corresponde a una sola sesión remota, dirigida exclusivamente al equipo designado por el cliente al momento de la entrega del sistema.
Esta capacitación cubre:
- Uso general de los módulos incluidos en esta propuesta.
- Flujo operativo básico del sistema.
- Resolución de dudas relacionadas con la operación normal de la plataforma.
No incluye:
- Sesiones adicionales.
- Capacitación a nuevo personal ingresado posteriormente.
- Entrenamiento sobre funcionalidades no contempladas en esta propuesta.
- Consultoría operativa, cambios de procesos o redefinición de flujos internos.

Cualquier requerimiento adicional podrá cotizarse de manera independiente según las necesidades del cliente.

Se propone un sistema basado en un conjunto de tecnologías especializadas, optimizadas para alto rendimiento, seguridad y escalabilidad: - Backend con Node.js y Fastify para garantizar alta concurrencia y tiempos de respuesta reducidos. - Uso de WebSockets para comunicación en tiempo real y ejecución paralela de peticiones hacia los diferentes proveedores. - Frontend desarrollado en React para ofrecer una interfaz de usuario dinámica, moderna y eficiente. - Integración de servicios en Python para analítica avanzada y procesamiento de datos. - Gestor de base de datos PostgreSQL o MySQL con cifrado AES-256, uso de Vault para la gestión segura de secretos y políticas de Row Level Security (RLS) para el control granular de acceso a la información. Se empleará una transación atómica por cada guía/factura/cargo, de esta manera nunca habrá descuadres.

Todo el desarrollo, programación, módulos, integraciones, componentes técnicos y configuraciones realizadas como parte de esta propuesta deberán ser cubiertos en su totalidad por el cliente, independientemente de que dichos elementos lleguen a utilizarse o no en la operación final del sistema. Esto incluye módulos que: - El cliente decida no habilitar. - El cliente decida no operar. - Se vean reemplazados por decisiones internas o cambios estratégicos. - Dependan de proveedores externos que modifiquen políticas o condiciones de uso. - Existan retrasos por parte del cliente o del proveedor externo que impidan avanzar. - El cliente o un tercero no realicen las pruebas solicitadas para validar la operación. - El proveedor externo (paquetería, pasarela de pago, tienda, PAC, API) no brinde seguimiento, soporte o aprobación para completar el proceso. Una vez iniciado el desarrollo de un módulo y registrado su avance técnico, existirá la obligación de cubrir el costo correspondiente, ya que su realización implica tiempo, investigación, arquitectura, pruebas, programación y esfuerzo técnico independiente de su adopción posterior.