Hola ! Tienes que integrar tu aplicación o servicio a QuadMinds, pero...sabes qué es QuadMinds ?
Somos una plataforma de optimización logística que le permite a las empresas mejorar sus procesos de distribución y entregas. Antes de comenzar tu integración, te invitamos a leer una breve descripción de la plataforma y lo que podrás lograr con nuestra API.
Procesos de negocio soportados
La plataforma QuadMinds soporta principalmente 3 procesos de negocio diferentes:
- Planificación, optimización y certificación de entregas
- Despliegue y monitoreo de fuerzas de trabajo
- Monitoreo de flotas en general
Por lo tanto, para poder realizar una integración exitosa, es importante entender en primer lugar cuál es el objetivo de uso de la plataforma, pues el uso de la API puede variar en función al proceso de negocio soportado.
En estos 3 escenarios de uso de QuadMinds, existe un denominador común. Para saber dónde hay que entregar un paquete, a dónde hay que enviar un técnico a resolver una pérdida de gas o determinar si un vehículo estuvo detenido en cierto lugar, se requieren como mínimo un par de coordenadas geográficas. En QuadMinds, este par de coordenadas de latitud y longitud que representa el “dónde” y sus datos asociados se denomina PoI - Point of Interest.
Clientes Flash
Si eres un cliente Flash, el proceso de negocio soportado es Planificación, optimización y certificación de entregas.
Un punto en el mapa
Por lo tanto, el PoI puede tener un significado diferente según el uso que nuestros clientes le den a la plataforma. Para una empresa que distribuye diariamente alimentos o bebidas a almacenes y kioskos, el PoI seguramente será un “cliente” mientras que para un correo privado que no tiene relación comercial con el destinatario, el PoI será un “punto de entrega” o “destinatario”. Es por esta diversidad de uso que la estructura de un PoI en la API puede contener información que es crítica para un caso mientras no es relevante para otro. En la referencia de la API vas a encontrar qué datos son comunes a todos los escenarios de uso y cuáles aplican a uno u otro.
El primer paso en toda integración entonces, es identificar cuál es la entidad de tu aplicación o servicio que representa el “dónde” y asociarlo en QuadMinds a un PoI.
Por ejemplo, todos los PoIs poseen:
- Un nombre de fantasía
- Una dirección normalizada
- Un par de coordenadas de latitud y longitud
- El código de este sitio en tu aplicación o sistema
- Un identificador único en QuadMinds
Por otro lado, cuando se trate del escenario de Planificación, optimización y certificación de entregas (POCE), será necesario completar información adicional como:
- Ventana horaria de atención del cliente
- Tiempo medio de permanencia en el cliente
- Email del cliente
Primera interacción con la API
Ahora que presentamos el concepto de PoI, te invitamos a leer la sección PoI de la referencia de la API y ejecutar el endpoint POST para crear tu primer PoI y luego acceder al mismo mediante el endpoint /GET