📚 Documentación y Ayuda
Todo lo que necesitas saber para usar AgroConnect de manera efectiva. ¡Encuentra respuestas rápidas a tus preguntas!
👥 Para Compradores
¿Cómo me registro como comprador?
Ve a "Registrarse" y completa el formulario básico. No necesitas información de finca, solo tus datos personales y ubicación.
¿Qué puedo hacer como comprador?
Puedes: explorar el marketplace, buscar productos por ubicación, hacer pedidos, comunicarte con vendedores, seguir el estado de tus compras y calificar vendedores.
¿Cómo encuentro productos?
Usa el Marketplace para buscar productos por tipo, ubicación o precio. Puedes filtrar por departamento y ciudad para encontrar productos locales.
¿Cómo hago un pedido?
Selecciona el producto que deseas, especifica la cantidad y haz clic en "Agregar al Carrito". Luego procede al checkout y completa tu pedido.
¿Cómo me comunico con vendedores?
Puedes iniciar conversaciones desde las publicaciones o desde tus pedidos. Ve a "Mensajes" para ver todas tus conversaciones activas.
¿Cómo funciona el sistema de conversión de unidades?
Si un vendedor publica en arrobas y tú quieres comprar en kilogramos, el sistema convierte automáticamente el precio y la cantidad disponible. Solo funciona con medidas de peso (kg, libras, arrobas, toneladas).
🏪 Para Vendedores
¿Cómo me convierto en vendedor?
Si eres comprador, ve al sidebar y haz clic en "¿Quieres ser vendedor?". Completa el formulario de tu primera finca y automáticamente te convertirás en vendedor.
¿Por qué necesito fincas para vender?
Las fincas son OBLIGATORIAS para vender. Garantizan trazabilidad, permiten a los compradores conocer el origen de los productos y generan confianza en la calidad.
¿Cómo gestiono mis fincas?
Ve a "Mis Fincas" en el sidebar (primera opción). Desde ahí puedes: agregar nuevas fincas, editar información, agregar cultivos y ver estadísticas por finca.
¿Cómo publico mis productos?
Ve a "Mis Publicaciones" y haz clic en "Nueva Publicación". Selecciona la finca, el cultivo de esa finca, cantidad disponible y precio. La ubicación se toma automáticamente de la finca.
¿Cómo manejo mis ventas?
Ve a "Ventas" para ver todas tus transacciones, confirmar pedidos, gestionar el estado de tus ventas y ver estadísticas por finca.
¿Qué debo saber sobre las unidades de medida?
Si publicas en medidas de peso (kg, libras, arrobas, etc.), los compradores podrán elegir su unidad preferida. Si publicas en Unidades, Cajas o Bultos, los compradores SOLO podrán comprar en esa unidad fija.
🏡 Las Fincas: El Centro de Todo
¿Por qué las fincas son el corazón de AgroConnect?
Las fincas son OBLIGATORIAS para vender. Todo gira alrededor de ellas: cultivos, publicaciones, ubicación y trazabilidad. Sin finca, NO puedes vender productos.
¿Cómo creo mi primera finca?
Si eres comprador: ve a "¿Quieres ser vendedor?" en el sidebar. Si ya eres vendedor: ve a "Mis Fincas" y haz clic en "Agregar Finca".
¿Qué información necesito para una finca?
Necesitas: nombre de la finca, departamento, ciudad, dirección, área total, área cultivable, tipo de suelo y tipo de riego. Esta información es crucial para la trazabilidad.
¿Qué puedo hacer desde mis fincas?
Desde "Mis Fincas" puedes: agregar cultivos, crear publicaciones, ver la ubicación en el mapa, gestionar inventario, hacer seguimiento de ventas por finca y agregar más fincas.
¿Puedo tener múltiples fincas?
¡Sí! Puedes registrar y gestionar múltiples fincas. Cada finca puede tener diferentes cultivos y ubicaciones. Esto es ideal si tienes terrenos en diferentes lugares.
¿Cómo organizo mis productos por finca?
Cada finca tiene sus propios cultivos. Al crear publicaciones, seleccionas la finca y luego el cultivo específico de esa finca. Así mantienes todo organizado.
🌾 Gestión de Cultivos
¿Cómo agrego cultivos a mi finca?
Ve a "Mis Fincas", selecciona una finca y haz clic en "Agregar Cultivo". Los cultivos están directamente vinculados a la finca donde se producen.
¿Por qué los cultivos están vinculados a fincas?
Para garantizar trazabilidad y transparencia. Los compradores saben exactamente de qué finca viene cada producto, su ubicación y características del terreno.
¿Cómo gestiono mis cultivos?
Desde "Mis Fincas" puedes ver todos los cultivos de cada finca, editarlos, agregar nuevos y hacer seguimiento de su estado y producción.
¿Puedo tener diferentes cultivos en cada finca?
¡Sí! Cada finca puede tener sus propios cultivos. Esto te permite organizar mejor tu producción y mostrar a los compradores la diversidad de tus productos.
¿Qué estados pueden tener mis cultivos?
Los cultivos pueden estar en: Sembrado, En Crecimiento, Listo para Cosecha, o Cosechado. Esto ayuda a planificar cuándo estarán disponibles para la venta.
¿Cómo controlo el área ocupada?
El sistema te permite especificar cuánta área de tu finca está ocupada por cada cultivo, ayudándote a gestionar mejor el espacio disponible.
⚖️ Sistema de Conversión de Unidades
¿Qué es el sistema de conversión de unidades?
Es un sistema que permite a los compradores elegir su unidad de compra preferida cuando el vendedor publica productos en medidas de peso. Si un vendedor publica en arrobas, puedes comprar en kilogramos, libras o cualquier otra medida de peso.
¿Qué unidades son convertibles?
Las medidas de PESO son convertibles: Kilogramos (kg), Libras (lb), Arrobas (@) y Toneladas (t). Puedes comprar en cualquiera si el vendedor publicó en alguna de estas.
¿Qué unidades NO son convertibles?
Las unidades discretas NO son convertibles: Unidades, Cajas y Bultos. Si el vendedor publica en estas unidades, SOLO puedes comprar en esa unidad específica, sin opción de conversión.
¿Cómo funciona la conversión de precios?
El sistema convierte automáticamente el precio. Ejemplo: Si el vendedor publica 3 arrobas de tomate a $50,000/arroba, y quieres comprar 5 kg, el sistema calcula automáticamente que el precio es $4,346/kg (porque 1 arroba = 11.502 kg).
¿Puedo exceder la cantidad disponible?
No. El sistema valida automáticamente la cantidad disponible convirtiendo tu solicitud a la unidad del vendedor. Si pides más de lo disponible, el botón de compra se desactiva y recibes una advertencia.
Como vendedor, ¿qué debo saber sobre las unidades?
Si publicas en medidas de peso (kg, libras, arrobas, etc.), los compradores podrán elegir su unidad preferida. Si publicas en Unidades, Cajas o Bultos, los compradores SOLO podrán comprar en esa unidad fija. El sistema te muestra un aviso naranja al seleccionar unidades no convertibles.
🔐 Autenticación y Seguridad
¿Qué métodos de autenticación están disponibles?
Puedes registrarte con email y contraseña, usar Google Sign-In, o recuperar tu contraseña por SMS. Todos los métodos son seguros y están integrados.
¿Cómo funciona el inicio de sesión con Google?
Haz clic en "Iniciar sesión con Google" en la página de login. Si es tu primera vez, se creará automáticamente una cuenta como comprador. Luego puedes completar tu perfil.
¿Cómo recupero mi contraseña por SMS?
En la página de login, haz clic en "¿Olvidaste tu contraseña? Recuperar por SMS". Ingresa tu número de teléfono registrado y recibirás un código de 6 dígitos para restablecer tu contraseña.
¿Es seguro usar Firebase Authentication?
Sí, Firebase es una plataforma de Google con altos estándares de seguridad. Tus datos están protegidos y no se almacenan contraseñas en nuestros servidores cuando usas Google Sign-In.
¿Qué pasa si no tengo acceso a mi teléfono?
Si no puedes recibir SMS, puedes contactar al soporte técnico para recuperar tu cuenta. También puedes usar Google Sign-In si lo configuraste previamente.
¿Puedo cambiar mi método de autenticación?
Sí, puedes agregar una contraseña a tu cuenta de Google o viceversa. Ve a tu perfil para gestionar tus métodos de autenticación.
🤖 Asistente IA y Sugerencias
¿Qué es el asistente IA?
Es un asistente inteligente que puede responder preguntas sobre agricultura, precios de mercado, y darte consejos para mejorar tus publicaciones. Está alimentado por Google Gemini.
¿Cómo uso el asistente IA?
Haz clic en el ícono del chatbot en la esquina inferior derecha de la pantalla. Puedes hacer preguntas sobre agricultura, precios, o cualquier duda que tengas sobre la plataforma.
¿Qué tipo de sugerencias puedo obtener?
El asistente puede sugerir títulos atractivos para tus publicaciones, precios competitivos basados en el mercado local, descripciones optimizadas, y consejos agrícolas específicos para Colombia.
¿El asistente IA es gratuito?
Sí, el asistente IA es completamente gratuito para todos los usuarios. No hay límites en el número de consultas que puedes hacer.
¿Qué pasa si el asistente IA no está disponible?
Si hay problemas con el servicio de IA, el sistema automáticamente usa sugerencias predeterminadas basadas en mejores prácticas agrícolas y de marketing.
¿El asistente conoce el contexto colombiano?
Sí, el asistente está configurado para entender el contexto agrícola colombiano, incluyendo precios en COP, ubicaciones geográficas, y prácticas agrícolas locales.
💰 Pagos y Transacciones
¿Qué métodos de pago aceptan?
Aceptamos tarjetas de crédito y débito (Visa, MasterCard, AmEx, Diners), transferencias bancarias PSE, y pagos en efectivo a través de MercadoPago (Baloto, Efecty, Gana, etc.).
¿Es seguro pagar en AgroConnect?
Sí, usamos MercadoPago que es una plataforma de pagos certificada y segura. Tus datos financieros están protegidos y no se almacenan en nuestros servidores.
¿Cuándo recibo mi dinero como vendedor?
El dinero se libera automáticamente cuando el comprador confirma la recepción del producto. Esto garantiza que ambos estén satisfechos con la transacción.
¿Qué pasa si el pago falla?
Si hay problemas con el pago, el sistema automáticamente simula el pago para proyectos universitarios. En producción, MercadoPago maneja los reintentos y notificaciones.
¿Puedo ver el historial de mis pagos?
Sí, puedes ver el historial completo de tus pagos en la sección "Historial de Pagos" de tu perfil. Incluye todos los detalles de cada transacción.
¿Hay comisiones por usar la plataforma?
Para proyectos universitarios, no hay comisiones. En producción, las comisiones son manejadas por MercadoPago según sus tarifas estándar.
💬 Comunicación y Mensajería
¿Cómo me comunico con otros usuarios?
Usa el sistema de mensajes integrado. Puedes iniciar conversaciones desde las publicaciones o desde tus pedidos. Ve a "Mensajes" para ver todas tus conversaciones activas.
¿Recibo notificaciones?
Sí, recibirás notificaciones por nuevos pedidos, mensajes, cambios de estado y pagos procesados. Puedes gestionarlas desde la sección "Notificaciones".
¿Cómo gestiono mis notificaciones?
Ve a "Notificaciones" para ver todas tus alertas. Puedes marcarlas como leídas, eliminarlas, o filtrarlas por categoría (Pedido, Pago, Sistema).
¿Las conversaciones se guardan?
Sí, todas las conversaciones se guardan para que puedas revisar el historial completo. Esto es útil para resolver disputas o recordar acuerdos previos.
¿Puedo enviar archivos en los mensajes?
Actualmente el sistema de mensajes es de texto. Para compartir imágenes o documentos, puedes usar enlaces o contactar al soporte técnico.
¿Cómo reporto problemas con otros usuarios?
Si tienes problemas con otro usuario, puedes usar el sistema de calificaciones para dejar comentarios o contactar al soporte técnico para casos más serios.
⭐ Sistema de Calificaciones
¿Cómo funciona el sistema de calificaciones?
Es un sistema bidireccional donde tanto compradores como vendedores pueden calificarse mutuamente después de completar una transacción.
¿Qué aspectos puedo calificar?
Puedes calificar: comunicación, puntualidad, calidad del producto, y dar una calificación general. También puedes dejar comentarios y recomendar al usuario.
¿Cuándo puedo calificar a alguien?
Solo puedes calificar después de que el pedido esté marcado como "Completado". Esto asegura que ambos hayan tenido la experiencia completa.
¿Puedo ver las calificaciones de otros usuarios?
Sí, puedes ver las calificaciones públicas de otros usuarios en sus perfiles. Esto te ayuda a tomar decisiones informadas sobre con quién hacer negocios.
¿Qué pasa si recibo una calificación injusta?
Si crees que recibiste una calificación injusta, puedes contactar al soporte técnico. Revisamos casos especiales y podemos ayudar a resolver disputas.
¿Las calificaciones afectan mi ranking?
Sí, las calificaciones contribuyen a tu ranking público. Los usuarios con mejores calificaciones aparecen en los rankings de "Top Productores" y "Top Compradores".
🔄 Flujo de Trabajo Completo
¿Cuál es el flujo correcto para empezar a vender?
1) Registrarse como comprador → 2) "¿Quieres ser vendedor?" → 3) Crear primera finca → 4) Agregar cultivos → 5) Crear publicaciones → 6) Gestionar ventas
¿Cuál es el flujo para comprar?
1) Registrarse como comprador → 2) Explorar marketplace → 3) Agregar al carrito → 4) Hacer pedido → 5) Comunicarse con vendedor → 6) Recibir producto
¿Por qué no puedo publicar sin finca?
Las fincas son OBLIGATORIAS porque garantizan trazabilidad. Los compradores necesitan saber de dónde viene el producto para confiar en la calidad y frescura.
¿Cómo organizo mis productos por finca?
Cada finca tiene sus propios cultivos. Al crear publicaciones, seleccionas la finca y luego el cultivo específico de esa finca. Así mantienes todo organizado.
¿Qué estados puede tener un pedido?
Los pedidos pasan por: Pendiente → Confirmado → En Preparación → Enviado → En Tránsito → Recibido → Completado. Cada estado tiene acciones específicas para compradores y vendedores.
¿Cómo cancelo un pedido?
Los pedidos se pueden cancelar en estados tempranos (Pendiente, Confirmado). Al cancelar, el stock se devuelve automáticamente a la publicación.
🛠️ Soporte y Ayuda Técnica
¿Cómo contacto soporte técnico?
Puedes contactarnos a través del sistema de mensajes integrado, enviando un email a soporte@agroconnect.com, o usando el asistente IA para consultas generales.
¿Qué hago si tengo problemas técnicos?
Primero intenta cerrar sesión y volver a entrar. Si el problema persiste, contacta al soporte técnico con detalles específicos del error.
¿Hay tutoriales disponibles?
Esta documentación incluye guías paso a paso. También puedes explorar la plataforma usando las funciones de ayuda integradas y el asistente IA.
¿Cómo reporto un bug?
Si encuentras un bug, puedes reportarlo a través de GitHub Issues o contactar al soporte técnico con detalles específicos sobre cómo reproducir el problema.
¿Ofrecen capacitación para usuarios?
Para proyectos universitarios, ofrecemos sesiones de capacitación. Contacta al soporte técnico para coordinar una sesión de entrenamiento.
¿Qué información necesito para reportar un problema?
Incluye: descripción del problema, pasos para reproducirlo, navegador usado, capturas de pantalla si aplica, y cualquier mensaje de error que hayas visto.
¿Necesitas más ayuda?
Si no encuentras la respuesta que buscas, nuestro equipo de soporte está aquí para ayudarte. ¡No dudes en contactarnos!