Manual de Marketplace Abbante

Version: 1.1
Fecha: 2026-07-13
Dirigido a: administradores globales, operadores de marketplace, proveedores, soporte y personal que necesita entender el ciclo completo de asistencia vial.
Portales relacionados: AdminWeb, portal publico /marketplace, /alta-proveedor, Abbante, Abbante A y Abbante M.

Novedades en v1.1 (2026-07-13): - Comisiones separadas por metodo de pago: tarjeta por la app (hoy 15%) y pago directo al proveedor (hoy 0%, sin comision), configurables en AdminWeb. - Alta publica con varias categorias, campos opcionales, direccion automatica desde el mapa y reconocimiento de negocios ya existentes. - Boton unico Activar e invitar (AdminWeb) / Activar proveedor e invitar (MonitorWeb) con invitacion por correo o WhatsApp. - Push de solicitudes cercanas al proveedor y chat integrado por servicio.

1. Objetivo del marketplace

El marketplace Abbante resuelve asistencia vial en ruta conectando clientes con proveedores cercanos. El cliente puede ser:

Chofer de empresa transportista usando Abbante.
Ciudadano o conductor externo usando Abbante A.

El proveedor opera en Abbante M. El equipo interno administra altas, solicitudes, soporte, comision y seguimiento desde AdminWeb.

El objetivo operativo es que una emergencia tenga trazabilidad:

Cliente solicita asistencia.
Proveedores cercanos reciben la solicitud.
Proveedores ofertan.
Cliente acepta.
Proveedor atiende.
El servicio se completa con evidencia.
Se registra pago, reputacion y liquidacion.

Flujo operativo del marketplace en Abbante M

2. Portales y aplicaciones

Portal/App	Usuario principal	Funcion
`/marketplace` publico	Transportistas, proveedores y aliados	Explica el ecosistema y dirige a alta/manuales.
`/alta-proveedor`	Negocios candidatos	Captura solicitud de inscripcion.
AdminWeb Marketplace	AdminGlobal y capturadores	Gestiona prospectos, solicitudes, soporte y autorizaciones.
Abbante	Chofer de empresa	Solicita asistencia y acepta ofertas.
Abbante A	Ciudadano/conductor externo	Busca proveedores o solicita asistencia.
Abbante M	Proveedor	Recibe solicitudes, oferta, atiende, factura y ve reputacion.

3. Ciclo operativo completo

El ciclo tiene dos capas: alta de oferta de proveedores y ejecucion de servicios.

Capa 1 - Construir red de proveedores

El proveedor entra a /alta-proveedor o se registra desde Abbante M.
AdminWeb recibe el prospecto.
Un operador toma, contacta o reasigna el prospecto.
Si procede, se usa Activar e invitar (convierte, crea acceso y envia la invitacion en un paso) o se autoriza la cuenta existente.
El proveedor configura categorias, cobertura, tarifas y disponibilidad en Abbante M, guiado por el wizard de primera sesion.

Capa 2 - Resolver asistencia

Cliente solicita asistencia con categoria, ubicacion y urgencia.
La plataforma calcula proveedores visibles por radio/categoria.
Proveedores ofertan precio y ETA.
Cliente acepta una oferta.
Proveedor marca llegada, completa servicio y sube evidencia.
Se registra pago y reputacion.

4. Alta de proveedores

Hay dos caminos de inscripcion:

Camino	Ventaja	Uso recomendado
Formulario publico	Rapido, sin usuario previo	Captura comercial, proveedor nuevo, campaña publica.
Abbante M	Crea usuario desde el inicio	Proveedor listo para operar desde app.

Formulario publico

Ruta:

https://transporte.abbante.com/alta-proveedor

El proveedor captura negocio, una o varias categorias (la primera es la principal), ubicacion en mapa, telefono, correo, foto opcional y confirmacion de datos. Tambien puede agregar sitio web o red social y horario de atencion opcionales. Al fijar el punto en el mapa, la direccion se llena automaticamente y puede editarse.

Si el telefono coincide con un negocio que ya existe en el directorio (por ejemplo, importado de Google), el sistema lo reconoce ("Ya te conociamos!") y actualiza esa ficha en lugar de duplicarla.

El flujo actual no usa captcha visible. La seguridad vive en servidor con rate limit por IP/correo, validacion de datos y validacion de imagen.

Registro desde Abbante M

El proveedor entra a la app, cambia a Registrarme y envia su solicitud. La app queda en En proceso de autorizacion hasta que AdminWeb lo autoriza.

5. Operacion interna en AdminWeb

AdminWeb es la consola interna del marketplace.

Accesos

Rol	Acceso
AdminGlobal	Ve proveedores, solicitudes, soporte, comision, importacion y carga de operadores.
Capturador marketplace	Entra restringido a proveedores asignados o disponibles.

Bloques principales

Bloque	Funcion
Comisiones de la plataforma	Configura dos porcentajes: pagos con tarjeta por la app (hoy 15%) y pagos directos al proveedor (hoy 0%). Solo AdminGlobal.
Importar proveedores por ruta	Busca/proyecta prospectos por ruta activa.
Carga de operadores	Revisa carga por capturador y reparte sin asignar. Solo AdminGlobal.
Proveedores	Trabaja prospectos, solicitudes de alta, aceptados y descartados.
Solicitudes	Supervisa asistencia abierta, estados, ofertas y proveedor asignado.
Soporte	Atiende tickets relacionados.

Estados de proveedor

Vista	Significado
Agregando	Prospectos importados o capturados por el equipo.
Solicitudes de alta	Registros enviados desde `/alta-proveedor` o Abbante M.
Aceptados	Proveedores integrados o autorizados.
Descartados	Rechazados, no contactables o cerrados.

Acciones frecuentes

Tomar lote: asigna prospectos sin operador.
Tomar prospecto: el operador se queda con un registro.
Soltar/Reasignar: libera o mueve un prospecto.
Registrar contacto: guarda llamada, resultado, proxima fecha y notas.
Editar contacto: corrige correo o telefono antes de invitar.
Activar e invitar: boton unico que convierte el prospecto, crea el acceso y envia la invitacion a Abbante M en un solo paso; la invitacion puede mandarse por correo o por WhatsApp. En MonitorWeb > Captura de proveedores el boton equivalente se llama Activar proveedor e invitar.
Autorizar proveedor: habilita una cuenta creada desde Abbante M.
Reenviar invitacion: envia correo o prepara WhatsApp.

6. Solicitud de asistencia

El cliente puede iniciar asistencia desde Abbante o Abbante A.

Datos tipicos:

Categoria.
Urgencia.
Ubicacion.
Descripcion.
Datos de vehiculo cuando aplica.
Metodo de pago disponible.

El marketplace muestra la solicitud solo a proveedores que cumplen:

Categoria activa.
Cobertura por radio.
Disponibilidad activa.
Reglas de visibilidad y estado del proveedor.

Los proveedores que cumplen estos filtros reciben una notificacion push de la solicitud; al tocarla, Abbante M abre directamente el detalle.

7. Operacion del proveedor en Abbante M

El proveedor usa Abbante M para:

Configurarse con el wizard de primera sesion (categorias, cobertura, tarifas y prueba de notificacion).
Ver solicitudes cercanas y recibirlas por push.
Abrir mapa.
Enviar oferta con precio y ETA, o en un toque con Mis tarifas (oferta prellenada por categoria).
Revisar Mis ofertas.
Atender Servicio activo.
Avisar que va en camino con ETA (el cliente recibe push).
Chatear con el cliente por servicio (durante el servicio y hasta 24 h despues de completarlo).
Marcar En sitio.
Completar con precio final, resumen y hasta 6 fotos.
Cancelar si el estado lo permite.
Consultar historial y Mis pagos (estado de cuenta).
Revisar Por que no recibo solicitudes? cuando no llega trabajo.
Calificar al cliente.
Revisar dashboard y reputacion.

El manual detallado esta en:

/manuales/proveedorapp.html

8. Pagos, comision y liquidacion

Hay dos comisiones, una por metodo de pago, configurables por el administrador en AdminWeb > Marketplace > Comisiones de la plataforma (dos campos):

Tarjeta (app):  Total cliente = precio proveedor + % de servicio (hoy 15%)
Pago directo:   Total cliente = precio proveedor (hoy 0%, sin comision)

Cada oferta congela los porcentajes vigentes al momento de emitirse: cambiar la comision no afecta ofertas ya enviadas.

Metodo	Flujo
Tarjeta	La plataforma cobra al cliente precio + % de servicio; el proveedor factura B2B su neto y AdminWeb liquida.
Efectivo / transferencia (pago directo)	El proveedor cobra en sitio exactamente el precio ofertado; hoy sin comision. Si la comision configurada fuera mayor a 0%, quedaria pendiente y se descontaria de futuras liquidaciones.

En Abbante M, Mis pagos muestra:

Por facturar.
Mis facturas.
Estado de cuenta.
Comision de efectivo pendiente.
Saldo a favor.

En AdminWeb, Liquidaciones permite aprobar, rechazar y liquidar facturas de proveedor.

9. Reputacion bilateral

La reputacion ayuda a sostener calidad:

Cliente califica proveedor.
Proveedor califica cliente.
Abbante M muestra promedio, distribucion y resenas.
Abbante/Abbante A usan la reputacion como senal de confianza.

Buenas practicas:

Completar servicios con evidencia.
Evitar cancelaciones tardias.
Mantener ETA realista.
Responder solo si tienes disponibilidad.
Registrar comentarios utiles, no ofensivos.

10. Soporte y privacidad

Canales y casos:

Caso	Ruta
Correccion de alta	`/reportar-correccion`
Soporte tecnico proveedor	`soporte@tecnoai.mx`
Alta y seguimiento comercial	`Alta.servicios@abbante.mobile`
Eliminacion de datos	Manual de privacidad/eliminacion de datos

Los datos de proveedores se usan para alta, contacto, operacion, pagos, reputacion y auditoria. Mientras estan en revision solo los ve el equipo autorizado. Al activarse, datos como nombre, categoria, telefono, foto y zona pueden mostrarse a clientes cercanos.

11. Checklist QA

Portal publico

/marketplace carga y muestra CTA a alta/manuales.
/alta-proveedor carga sin login.
El wizard permite avanzar por los tres pasos.
La foto acepta JPG/PNG/WEBP menor a 5 MB.
El formulario envia y muestra codigo.
El rate limit responde sin romper la pagina.

AdminWeb

AdminGlobal entra a /marketplace.
Capturador entra restringido a proveedores.
Proveedores muestra sub-vistas: agregando, solicitudes de alta, aceptados, descartados.
Tomar lote, tomar prospecto y registrar contacto responden correctamente.
Crear acceso genera invitacion.
Autorizar proveedor desde Abbante M desbloquea la app.
Solicitudes y Soporte cargan para AdminGlobal.

Abbante M

Login autorizado entra a la bandeja.
Usuario pendiente ve pantalla de autorizacion.
Mis servicios, cobertura y disponibilidad guardan cambios.
Solicitudes, mapa y ofertas cargan.
Servicio activo permite en sitio, completar, fotos y cancelar.
Mis pagos y subir factura muestran datos esperados.
Reputacion e historial cargan.

12. Manuales relacionados

Manual	Ruta
Alta de proveedor	`/manuales/alta-proveedor.html`
Abbante M / ProveedorApp	`/manuales/proveedorapp.html`
AdminWeb	`/manuales/adminweb.html#marketplace`
Abbante chofer	`/manuales/puertosapp.html`
Abbante A ciudadano	`/manuales/ciudadanoapp.html`
Privacidad	`/manuales/privacidad.html`

Version documento: 1.1 - Ultima actualizacion: 2026-07-13.