Integración Onfleet n8nAutomatiza Onfleet con n8n.

Añade un administrador a la organización de Onfleet y devuelve el objeto creado. Los administradores gestionan la organización, a diferencia de los repartidores que ejecutan las tareas.

• Admin ID: el identificador del objeto admin que se usa en la búsqueda.
• Name y Email: el nombre del administrador y su correo, con el formato name@email.com que sugiere el campo.
• Read Only (Additional Fields): si ese administrador puede realizar operaciones de escritura o no.

Elimina un administrador de la organización. La llamada apunta a una sola cuenta y no devuelve nada reutilizable después, así que colócala al final de la rama.

• Admin ID: el identificador del objeto admin, no el nombre de la persona. Pasa {{ $json.id }} desde la operación que localizó la cuenta en vez de un valor escrito a mano.

Lista los administradores de la organización, ya sea para auditarlos o para elegir a quién avisar.

• Admin ID: sigue marcado como obligatorio en esta operación aunque devuelva una lista. Rellénalo antes de ejecutar, o el nodo se detendrá en el campo vacío.
• Return All: activado, n8n recorre todas las páginas de administradores; desactivado, Limit fija el número máximo de elementos devueltos.

Modifica un administrador que ya existe. Solo se tocan los campos que añades, el resto de la cuenta queda igual.

• Admin ID: el identificador del objeto admin que se usa en la búsqueda.
• Name (Update Fields) y Phone: el nombre y el teléfono del administrador.
• Read Only (Update Fields): si ese administrador puede realizar operaciones de escritura o no.

Inserta tareas en un contenedor, la lista ordenada de tareas asociada a una organización, un equipo o un repartidor.

• Container Type y Container ID: organizations, teams o workers, y después el identificador del objeto correspondiente al contenedor elegido.
• Insert Type e Index: -1 para añadir al final, 0 para añadir al principio, 1 para insertar en un índice concreto, siendo el índice la posición de inserción.
• Task IDs: los identificadores de las tareas que se van a usar.
• Consider Dependencies (Options): si la familia de dependencias, tareas padre e hijas, pasa a la asignación.

Lee un contenedor y devuelve las tareas que contiene, en su orden de ejecución. No modifica nada.

• Container Type: organizations, teams o workers, según la lista que quieras consultar.
• Container ID: el identificador del objeto correspondiente al contenedor elegido, a menudo {{ $json.id }} tomado de la operación de repartidor o de equipo anterior.

Sustituye por completo las tareas de un contenedor. Lo que envías pasa a ser la lista entera, de modo que lo que no aparezca ahí sale del contenedor.

• Container ID: el identificador del objeto correspondiente al contenedor elegido.
• Task IDs: las tareas que se van a usar, en el orden en que deben hacerse.
• Consider Dependencies (Options): si se incluye o no la familia de dependencias de la tarea, tareas padre e hijas, en la asignación resultante.

Registra una dirección como objeto destino, al que luego pueden apuntar las tareas y que se mantiene igual en todos los repartos.

• Unparsed Address: indica si la dirección se envía como una sola cadena sin desglosar, lo que cambia la lectura de los demás campos.
• Destination Address, Number, Street, City, Country: el detalle de la vía, el número que también puede llevar letras, el nombre de la calle, el municipio y el país.
• Apartment (Additional Fields) y Address Notes: el piso o la puerta y cualquier dato útil, más las notas sobre el destino.

Recupera un destino y devuelve el detalle de la dirección guardada.

• Destination ID: el identificador del objeto destino, tomado normalmente de la tarea que lo referencia con una expresión del tipo {{ $json.destination }}.

Declara un hub, la instalación física desde la que sale una ruta, y devuelve el objeto creado. Un hub tiene dirección propia y puede asignarse a equipos.

• Name: el nombre que identifica el hub.
• Destination: la dirección del hub, añadida con el bloque Add Destination, con Street, City, State y Country.
• Team Names or IDs (Additional Fields): los equipos a los que se asigna el hub, elegidos de la lista o indicados por identificador mediante una expresión.

Devuelve los hubs declarados en la organización. Aquí no se pide ningún identificador, así que es la vía más corta para tener la foto completa de tus instalaciones.

• Return All: activado, todos los hubs llegan página tras página; desactivado, Limit fija el número máximo de hubs devueltos.

Edita un hub ya creado, campo a campo. Lo que no rellenas conserva su valor actual.

• Hub ID: el identificador del objeto hub que se usa en la búsqueda.
• Name (Update Fields): el nombre que identifica el hub, útil cuando las naves se renombran tras una reorganización.
• Destination (Update Fields) y Team Names or IDs: la dirección mediante Add Destination y los equipos asignados al hub.

Devuelve el detalle de la organización asociada a la clave de API. No hay nada que configurar: la credencial ya indica qué organización se está leyendo.

Lee el detalle de otra organización con la que estás conectado en Onfleet. La delegación es la manera en que dos empresas se reparten entregas, una envía el trabajo y la otra lo ejecuta.

• Organization ID: el identificador del delegado que se usa en la búsqueda.

Guarda a un cliente como destinatario, el objeto que Onfleet asocia a las tareas y al que manda los SMS.

• Recipient Name: el nombre completo del destinatario.
• Recipient Phone: un número único y válido según el país de la organización si no lleva + delante; con + delante, la configuración de país de la organización se ignora.
• Skip Recipient SMS Notifications (Additional Fields): si el destinatario ha pedido no recibir SMS.

Localiza a un destinatario. Lo particular de esta operación es que eliges el criterio de búsqueda, algo que importa cuando lo único que tienes es un número de teléfono.

• Get By: la variable que se usa para buscar, id, phone o name.
• Recipient ID, Name o Phone: el valor que corresponde al criterio elegido arriba.

Corrige los datos guardados de un destinatario, que después se aplican a sus siguientes tareas.

• Recipient ID: el identificador del objeto destinatario que se usa en la búsqueda.
• Recipient Phone (Update Fields): la misma regla que en la creación, el + inicial decide si se aplica el país de la organización.
• Recipient Notes (Update Fields): las notas generales del destinatario, que no deben ser propias de una tarea ni de un destino.

Duplica una tarea existente y devuelve la copia. Sirve cuando un reparto se repite con la misma dirección y el mismo destinatario.

• Task ID: el identificador del objeto tarea que se usa en la búsqueda.
• Complete After (Override Fields) y Complete Before: la hora más temprana y la más tardía para completarla, que es lo que casi siempre cambia en una copia.
• Include Dependencies (Override Fields), Include Barcodes e Include Metadata: lo que se arrastra a la copia.

Fuerza el cierre de una tarea ya iniciada y deja constancia de si salió bien. Es la salida manual, para los casos que la aplicación del repartidor no cerró.

• Task ID: el identificador del objeto tarea que se usa en la búsqueda.
• Complete as a Success: si el cierre se considera un éxito, lo que separa un paquete entregado de un intento fallido en tus informes.
• Notes (Additional Fields): las notas de cierre.

Es la operación sobre la que se construye la mayoría de los flujos. Crea la entrega o la recogida, con su destino, y devuelve el objeto tarea.

• Destination: la dirección, añadida con el bloque Add Destination, con Street, City y Country como mínimo, o una cadena única cuando Unparsed Address está activado.
• Complete After (Additional Fields) y Complete Before: la franja de entrega.
• Pick Up Task (Additional Fields): si se trata de una recogida en vez de una entrega.
• Service Time (Additional Fields): los minutos que se pasan en el destino, que cuentan para optimizar la ruta.

Borra una tarea de Onfleet. Desaparece de la lista del repartidor, así que esta operación es para las anulaciones, no para los intentos fallidos.

• Task ID: el identificador del objeto tarea, normalmente {{ $json.id }} que llega del nodo que identificó el pedido.

Recupera una tarea y su estado actual, que es la forma habitual de enriquecer un evento antes de actuar sobre él.

• Task ID: el identificador del objeto tarea, a menudo {{ $json.id }} directamente del trigger.

Recorre las tareas de la organización filtradas por periodo y por estado. Es la operación de informes del nodo.

• Task ID: marcado como obligatorio incluso en esta operación de lista, así que dale un valor antes de ejecutar el nodo.
• Return All: activado, llegan todas las tareas que coinciden; desactivado, Limit pone un tope al número de tareas devueltas.
• From (Filters) y To: el inicio y el fin del rango, siendo el fin la hora actual por defecto.
• State (Filters): 0 sin asignar, 1 asignada, 2 activa, 3 completada, o all.

Modifica una tarea que ya existe en Onfleet, sin volver a crearla. Solo se aplican los campos de actualización que rellenas.

• Task ID: el identificador del objeto tarea que se usa en la búsqueda.
• Notes (Update Fields): las notas de la tarea, lo que el repartidor lee en el móvil.
• Quantity (Update Fields) y Service Time: el número de unidades que se dejan y los minutos en el punto de destino, ambos usados para optimizar la ruta.

Onfleet reparte las tareas que esperan en el contenedor sin asignar de un equipo entre los conductores de servicio.

• Team ID: el identificador del equipo, normalmente {{ $json.id }} heredado del nodo anterior.
• Max Allowed Delay: el retraso máximo tolerado, en minutos, para una tarea.
• Max Number Of Tasks Per Route: el número total de tareas permitidas en una ruta, para que un conductor no cargue con toda la mañana.
• Service Time: el tiempo de servicio por defecto, en minutos, que se aplica a las tareas que no traen el suyo.

Un equipo nuevo aparece en la organización de Onfleet con sus conductores y sus administradores ya vinculados.

• Name: un nombre único para el equipo, para no confundir dos almacenes.
• Worker Names or IDs: la lista de conductores, elegidos en el desplegable o pasados por identificador con una expresión, la fórmula de n8n que lee un valor del item que entra.
• Administrator Names or IDs: los administradores que gestionan el equipo.
• Self Assignment: en Additional Fields, permite o no que los conductores tomen ellos mismos las tareas sin asignar del equipo.

El equipo desaparece de la organización de Onfleet. Conviene reservar esta operación a un flujo que alguien lanza a propósito, no a una rutina programada.

• Team ID: el identificador del equipo que se elimina, mejor guardado al crearlo que buscado semanas después.

Con un identificador de equipo el nodo devuelve su ficha, lista para que los nodos siguientes la lean con expresiones.

• Team ID: el identificador del equipo, muchas veces {{ $json.id }} que llega de un Get many teams.

Todos los equipos de la organización vuelven como lista, un item por equipo.

• Return All: activado, n8n recorre las páginas de la API hasta el último equipo; desactivado, se detiene en Limit.
• Limit: el número máximo de equipos devueltos, útil mientras el flujo sigue en pruebas.

Los tiempos estimados de las próximas tareas de un equipo vuelven junto con el conductor que Onfleet elegiría para el trabajo.

• Team ID: el equipo consultado.
• Pick Up y Drop Off: en Filters, los dos extremos del trayecto que se estima.
• Restricted Vehicle Types: los tipos de vehículo que se ignoran en la consulta, entre CAR, MOTORCYCLE, BICYCLE y TRUCK.
• Service Time: el tiempo previsto en el punto de recogida, en el de entrega o en ambos, en segundos.

La ficha de un equipo existente cambia. Lo que pongas en Update Fields es lo que se modifica, nada más sale del nodo.

• Team ID: el equipo que se edita.
• Worker Names or IDs: los conductores que componen el equipo tras el cambio.
• Hub Name or ID: el hub al que se vincula, elegido en la lista o pasado por identificador.
• Self Assignment: cambia si los conductores pueden tomar solos las tareas sin asignar del equipo.

Un conductor recibe su cuenta de Onfleet y entra en un equipo en el mismo paso, que es lo que pide casi cualquier alta.

• Name: el nombre del conductor.
• Phone: sus números de teléfono.
• Team Names or IDs: uno o varios equipos a los que pertenece.
• Capacity: en Additional Fields, el número máximo de unidades que puede transportar, que se usa para optimizar rutas.

La salida de un conductor termina con su ficha fuera de Onfleet. Un aviso en un canal interno evita que el equipo de reparto busque a alguien que ya no está.

• Worker ID: el identificador del conductor, no su nombre visible.

Un conductor, un item de vuelta. La colección Options decide cuánta información viaja con él.

• Worker ID: el identificador del conductor buscado.
• Analytics: activado, la respuesta añade los eventos básicos de servicio, la distancia recorrida en metros y el análisis de tiempos.
• Fields to Return: la lista de campos que quieres ver cuando la ficha completa sobra, como onDuty, location o activeTask.

La lista de conductores se filtra por su posición actual, que es la forma de responder a «¿quién está cerca de esta dirección?».

• Search by Location: deja solo a los conductores que están dentro de una zona objetivo.
• Longitude y Latitude: el par de coordenadas que marca el centro de esa zona.
• Radius: en Filters, el radio en metros de la zona esférica donde se busca. Por defecto 1000, con un máximo de 10000.
• Return All: activado, vuelven todos los conductores que coinciden; desactivado, Limit corta la lista.

Pedir el horario de un conductor le da al flujo con qué razonar sobre su disponibilidad antes de comprometer nada.

• Worker ID: el identificador del conductor, sacado de un Get many workers o guardado en tu propia base.

Editar la ficha de un conductor cubre el día a día: una capacidad revisada, un nombre corregido, un traslado a otro equipo.

• Worker ID: el conductor que se edita.
• Capacity: el número máximo de unidades que puede transportar, para optimizar las rutas.
• Display Name: el nombre que se usa en lugar del real en los SMS, en las páginas de seguimiento de entrega y frente a otras organizaciones.
• Team Names or IDs: los equipos a los que pertenece tras el cambio.