Integraciones y API

¿Qué integraciones ofrece OptiRoutes?

Cargar pedidos desde un archivo, FTP o SFTP

La integración más sencilla es el archivo que su sistema ya exporta. En la pantalla de pedidos, Cargar entregas lee un archivo Excel o CSV; usted asigna una sola vez cada campo del sistema (dirección, nombre del cliente, número de pedido, cantidad, etc.) al nombre de su columna, y cada archivo posterior se carga de la misma forma. Para un archivo TXT de ancho fijo se indican posiciones de caracteres en lugar de nombres de columna. Pueden omitirse filas mediante una palabra marcadora en las observaciones, un segundo marcador puede sustituir la dirección, y usted decide si un número de pedido existente se actualiza o se añade como nuevo.

Para que nadie tenga que intervenir, elija un método de carga automática en la configuración:

• El servidor de archivos de OptiRoutes: su sistema deposita el archivo diario, nombrado con la fecha, en la carpeta de su empresa en el servidor FTP o en el servidor SFTP cifrado.
• Su propio servidor FTP: OptiRoutes se conecta con el usuario que usted le facilita y carga el archivo nombrado con la fecha de hoy o el archivo actualizado más recientemente.
• Importación y exportación automáticas: los pedidos se cargan solos y las rutas también se planifican, sin necesidad de hacer clic.
• La API de archivos: su software carga el archivo de pedidos por HTTPS, como se describe más abajo.

En la pantalla de clientes, un archivo Excel o CSV con número de cliente, nombre, dirección, tiempo de parada y horas de apertura y cierre crea o actualiza los clientes y sus ventanas de tiempo.

La API de archivos: entran pedidos, salen POD e informes

Cada empresa en OptiRoutes tiene su propia carpeta privada de archivos: los pedidos que carga, las notas de entrega firmadas con sus fotos y firmas, las exportaciones de rutas y los informes de fin de jornada. La API de archivos permite que sus sistemas lean y escriban directamente en esa carpeta por HTTPS, sin un servidor FTP de por medio. El responsable de la empresa cambia entre FTP y la API en Configuración → API y archivos y crea allí las claves; no hace falta solicitarlo a soporte, y las empresas nuevas empiezan con la API.

Las llamadas permiten comprobar la clave, listar una carpeta, descargar, cargar (hasta 50 MB por archivo) y eliminar los archivos que usted cargó, listar los archivos POD de un día por pedido y tipo, y descargar todos los archivos POD de un día en un único ZIP. La guía incluye ejemplos de código en Python, C# y Node.js, y un script de PowerShell que mantiene sincronizada una carpeta de su servidor con la carpeta de la empresa, de modo que un equipo acostumbrado al FTP puede seguir trabajando igual. Léala en la guía de la API de archivos.

¿Cómo se protegen las claves de API?

• Privilegio mínimo: cada clave recibe solo los permisos que necesita: solo POD firmadas, lectura de todos los archivos, o carga de pedidos y de archivos a la bandeja de entrada.
• Direcciones autorizadas: una clave puede limitarse a las direcciones IP fijas de su servidor.
• Caducidad y rotación: una clave puede caducar al cabo de un número de días; cree una clave nueva, cambie a ella y revoque después la antigua, sin interrupciones.
• Revocación inmediata: una clave revocada deja de funcionar en 30 segundos.
• Auditoría: cada llamada se registra con la hora, la dirección, el archivo y la respuesta, y se muestra al responsable.
• Almacenamiento seguro: OptiRoutes guarda solo una huella SHA-256 de cada clave; las conexiones son HTTPS con TLS 1.2 o superior, y una clave solo accede a la carpeta de su propia empresa.

Límites: 300 solicitudes por minuto por clave, 50 MB por archivo, 20 claves activas por empresa y hasta 5.000 entradas en un listado de carpeta.

La API de informes y envío de datos

Para herramientas de informes y conectores de ERP, una API independiente en api-users.optiroutes.com sirve los datos de su empresa como informes y acepta datos enviados. Una sola dirección y un solo token, emitidos por OptiRoutes para su empresa, cubren todas las llamadas. La página de documentación le permite pegar su token y ver qué informes tiene disponibles y la asignación de columnas de su cuenta: lea la documentación de la API.

Dos llamadas de envío funcionan en sentido contrario: enviar pedidos escribe el archivo de pedidos del día e inicia la carga automática, y enviar conductores, líneas y vehículos sustituye toda la flota, como un archivo de flota. Como la lista de conductores enviada cuenta como la flota completa, envíe siempre todos los conductores, no solo los cambios.

Exportación de rutas y webhooks

La exportación de rutas escribe las rutas marcadas en CSV, XLSX, XML, JSON o TXT de ancho fijo. Una tabla de columnas decide qué campos salen y con qué encabezado, pueden añadirse columnas originales de su archivo de pedidos y, con la gestión de artículos, un segundo archivo enumera todos los artículos. Las exportaciones pueden ir a su ordenador, a su servidor FTP o a la carpeta de la empresa y, en JSON, también pueden enviarse a una dirección web; si el envío falla, el sistema lo intenta una vez más.

Para recibir cada entrega en el momento en que se produce, rellene la dirección de informes de entrega en la configuración de la aplicación del conductor: cada informe de entrega de los conductores se envía también allí, de modo que otro sistema suyo se actualiza solo.

Correo electrónico, pagos, mapas y mensajería

• Correo electrónico: las notas de entrega firmadas se envían desde su propia cuenta de Gmail con una contraseña de aplicación de Google; informes como el de palets de fin de jornada van a su correo de informes; los clientes que pagan reciben recibos y los conductores, confirmaciones de depósito desde la caja.
• Pagos: las recargas se pagan en una página de pago segura de Stripe, con la opción de guardar la tarjeta para la recarga automática.
• Direcciones y mapas: las direcciones se eligen entre las sugerencias de Google y se verifican en el mapa antes de planificar.
• Navegación: la aplicación del conductor pasa cada parada a Waze, o a Apple Maps en el iPhone, por dirección o por coordenadas exactas.
• SMS y WhatsApp: avisos de llegada y enlaces de seguimiento a los clientes, alertas a los responsables, líneas a los subcontratistas e imágenes de las rutas a los conductores por WhatsApp.

Preguntas frecuentes