Configurar cuestionarios de resultado de acción

Un cuestionario de resultado de acción es el conjunto de preguntas que responde un conductor al completar una tarea, como una descarga. Las respuestas se convierten en el resultado de la acción: si la tarea se hizo, por qué no, observaciones, fotos y firmas. Las respuestas también pueden actualizar la orden, por ejemplo con el número de palés cargados realmente o una nueva fecha de entrega.

Cómo funcionan los cuestionarios

• Tu plataforma tiene como máximo un cuestionario por tipo de acción, por ejemplo uno para la carga y otro para la descarga. Para variar las preguntas dentro de un tipo, usa condiciones (más abajo).
• Cuando un conductor completa una tarea en OpenMove, el cuestionario de su tipo sustituye a la pantalla de resultado estándar. Consulta Responde a los cuestionarios de las acciones.
• El mismo cuestionario se abre en la vista de ejecución compartida de un viaje, cuando alguien completa una tarea allí desde un navegador.
• Las respuestas que un conductor da en un ordenador de a bordo, por ejemplo Transics o Webfleet, se asocian a las mismas preguntas (consulta Respuestas del ordenador de a bordo más abajo).
• Sin cuestionario, los conductores eligen Realizado, Parcialmente realizado o No se pudo realizar y escriben un motivo y observaciones.

Abrir los cuestionarios

1. Abre el menú lateral (☰, arriba a la derecha) y elige Configuración.
2. Haz clic en la pestaña Entorno.
3. Abre la sección Cuestionarios de resultado de acción, entre Planificación y Tarifas.

La sección muestra el botón Generar con IA y un editor con los cuestionarios como texto JSON. Si aún no hay nada configurado, el editor contiene {}.

Crear o cambiar cuestionarios con IA

La forma más rápida de empezar es describir lo que necesitas o subir la hoja informativa de tu ordenador de a bordo.

1. Haz clic en Generar con IA.
2. Si quieres, añade archivos en Hoja de información o documentos (opcional): haz clic en el clip o arrastra los archivos encima. Se aceptan PDF, Word, Excel, CSV, imágenes y otros formatos habituales.
3. En Instrucción, describe lo que quieres, por ejemplo «Añade a la descarga una pregunta sobre daños con una foto» o «Crea los cuestionarios a partir de esta hoja informativa de Transics».
4. Haz clic en Generar. Puede tardar unos minutos.
5. Lee el resumen que aparece. Actualizado: enumera los tipos de acción que se han creado o cambiado; los demás tipos de acción quedan exactamente como estaban.
6. Revisa los cuestionarios nuevos en el editor de abajo.
7. Haz clic en Guardar al final de la página para conservarlos.

Si haces clic en Generar sin instrucción y sin archivos, ves Introduce una instrucción o sube un documento. Si no había nada que cambiar, ves La IA no hizo cambios.

Editar los cuestionarios tú mismo

1. Escribe o pega en el editor. Usa los botones de la parte superior del editor para dar formato al texto o deshacer un cambio.
2. Fíjate en el margen del editor: un error en el JSON, como una coma o unas comillas que faltan, se marca en su línea. Mientras el texto no sea válido, Guardar está desactivado.
3. Haz clic en Guardar al final de la página.
4. Prueba el cuestionario completando una tarea de ese tipo en un viaje de prueba (consulta Probar un cuestionario más abajo).

El texto es un objeto con una entrada por tipo de acción. Cada entrada tiene enabled (solo se usan los cuestionarios con true), una lista de questions y una lista de resultMappings. Este ejemplo pregunta si una descarga ha ido bien, pide un motivo cuando no ha sido así y recoge una firma cuando sí:

{
  "unload": {
    "enabled": true,
    "questions": [
      {
        "id": "delivered",
        "label": "Were all goods delivered?",
        "type": "select",
        "order": 1,
        "options": [
          { "value": "yes", "label": "Yes", "setsResultStatus": "succeeded" },
          { "value": "partly", "label": "Partly", "setsResultStatus": "partiallySucceeded" },
          { "value": "no", "label": "No", "setsResultStatus": "failed" }
        ]
      },
      {
        "id": "why",
        "label": "What went wrong?",
        "type": "text",
        "order": 2,
        "conditions": [{ "questionId": "delivered", "operator": "notEquals", "value": "yes" }],
        "fieldMapping": { "target": "actionResult", "fieldPath": "reason" }
      },
      {
        "id": "signature",
        "label": "Signature of the receiver",
        "type": "signature",
        "required": false,
        "order": 3,
        "conditions": [{ "questionId": "delivered", "operator": "equals", "value": "yes" }]
      }
    ],
    "resultMappings": []
  }
}

Tipos de acción

La clave de cada entrada es el tipo de acción al que se aplica:

Clave	Tarea
load	Carga
unload	Descarga
attachTransportEquipment	Enganchar un remolque o contenedor
detachTransportEquipment	Desenganchar un remolque o contenedor
genericAction	Acción general
refuel, customs, weighing, wait, break	Repostaje, aduana, pesaje, espera y pausas

Preguntas

Ajuste	Qué hace
id	Un nombre único para la pregunta dentro del cuestionario, como delivered. Las condiciones y las asignaciones de resultado hacen referencia a él. No lo cambies una vez que los conductores hayan respondido.
label	La pregunta que ve el conductor.
type	El tipo de respuesta (consulta la tabla siguiente). Sin tipo, la pregunta es de texto.
required	Si el conductor debe responder antes de completar. Una pregunta es obligatoria salvo que indiques "required": false.
order	La posición en el cuestionario, de menor a mayor.
description, placeholder	El texto de ayuda bajo la pregunta y el texto gris de un campo vacío.
options	Las opciones de una pregunta de elección, cada una con un value (se guarda) y un label (se muestra). Una opción también puede fijar el resultado (consulta Fijar el resultado), o convertir otra pregunta en su pregunta de seguimiento con nextQuestionId.
conditions	Cuándo se muestra la pregunta (consulta Mostrar una pregunta solo cuando procede).
validation	Límites de la respuesta: minLength y maxLength (caracteres), min y max (números, ambos incluidos) y decimals (cifras tras el separador decimal).
fieldMapping	Dónde se escribe la respuesta (consulta Escribir respuestas en la orden).
externalIds	Los códigos que usa un ordenador de a bordo para esta pregunta (consulta Respuestas del ordenador de a bordo).

Tipos de pregunta

Tipo	El conductor
text	Escribe texto libre.
number	Escribe un número. Se aceptan tanto 12,5 como 12.5.
select	Elige una opción.
multiSelect	Marca una o varias opciones.
boolean	Usa un interruptor sí/no. La respuesta se guarda como true o false.
date, datetime	Elige una fecha, o una fecha y hora.
photo	Hace una foto o elige una del teléfono.
signature	Deja que alguien firme en la pantalla.
message	Lee una instrucción, como «Haz fotos del precinto». No necesita respuesta. Añade "messageState": "important" para mostrarla como Atención en lugar de Información.

Mostrar una pregunta solo cuando procede

Dale conditions a una pregunta para mostrarla solo en algunos casos. Una pregunta con varias condiciones solo se muestra cuando se cumplen todas. Una pregunta oculta nunca es obligatoria y su respuesta no se usa.

Una condición compara la respuesta a una pregunta anterior con un value:

Operador	Se cumple cuando la respuesta
equals / notEquals	es exactamente / no es el valor. En preguntas de sí/no, usa "true" o "false".
contains	contiene el valor.
greaterThan / lessThan	es un número mayor / menor que el valor. El valor debe ser un número.
isEmpty / isNotEmpty	está vacía / se ha dado. No necesitan valor.

Una condición también puede mirar la orden en lugar de una respuesta. Indica "source": "field", un target (action o consignment) y un fieldPath, con las mismas rutas que en Escribir respuestas en la orden. Por ejemplo, pide la temperatura del remolque solo cuando la primera línea de mercancía del envío tiene matrícula:

"conditions": [{ "source": "field", "target": "consignment", "fieldPath": "goods.0.licensePlate", "operator": "isNotEmpty" }]

Así un solo cuestionario cubre varias variantes de la misma tarea, como distintos departamentos o clientes. Si el campo no se puede leer en absoluto, la pregunta se muestra.

Para «pregunta esto solo después de esa respuesta», da a la opción un nextQuestionId. La pregunta indicada pasa a ser de seguimiento: solo se muestra, y solo es obligatoria, cuando se elige esa opción u otra opción que apunte a ella. Sus propias condiciones siguen aplicándose.

Fijar el resultado

Las respuestas deciden el resultado de la tarea. Transportial mira en este orden y usa lo primero que aplica:

1. Asignaciones de resultado. La primera entrada de resultMappings cuyas conditions se cumplen todas fija su resultStatus y su resultReason. Úsalas para combinaciones, como «entregado parcialmente y más de 5 artículos pendientes».
2. Opciones. Una opción elegida con setsResultStatus fija ese estado, y setsResultReason el motivo.
3. Por defecto. En cualquier otro caso, el resultado es Realizado.

"resultMappings": [
  {
    "conditions": [
      { "questionId": "delivered", "operator": "equals", "value": "partly" },
      { "questionId": "itemsLeft", "operator": "greaterThan", "value": "5" }
    ],
    "resultStatus": "failed",
    "resultReason": "Too many items not delivered"
  }
]

Estado	Se muestra como	Efecto
succeeded	Realizado	Ninguno.
partiallySucceeded	Parcialmente realizado	Cuenta como hecha.
failed	No se pudo realizar	El envío necesita replanificación.
cancelled	Cancelado	Cuenta como hecha.

Lo que pone en marcha una tarea fallida se describe en Estados explicados: órdenes, envíos, viajes y acciones.

Escribir respuestas en la orden

Un fieldMapping escribe la respuesta de una pregunta en un campo. Tiene un target, un fieldPath y, opcionalmente, una strategy y un transform.

Destino	Rutas de campo
actionResult	reason y remark del resultado. requestedRescheduleAt registra una nueva fecha que pidió el destinatario, lo que inicia la replanificación. Cualquier otro nombre se guarda con el resultado bajo ese nombre.
action	startTime, endTime, eta, etd, remark, duration (segundos) y externalAttributes.<name>. En una pregunta de foto, documents añade la foto a los documentos de la tarea, donde los planificadores la ven en la tarjeta de acción.
consignment	remark, description, constraints.delivery.startingDateTime, constraints.delivery.endingDateTime y externalAttributes.<name>. Mercancía: goods.<field> (todas las líneas de mercancía), goods.0.<field> (la primera línea, contando desde 0) o goods.0.containedGoods.1.<field> (el segundo artículo del primer remolque o contenedor). Campos de mercancía: quantity, name, description, remark, barCode, weight, grossWeight, loadMeters y, para remolques y contenedores, licensePlate, seal y equipmentId.

La strategy decide qué pasa con la respuesta:

Estrategia	Efecto
overwrite (por defecto)	Sustituye el campo por la respuesta.
recordDifference	No toca el campo. Si la respuesta es distinta, el resultado registra una diferencia, por ejemplo 33 palés declarados donde la orden dice 32. Úsala para comprobar la orden en lugar de cambiarla.
appendComment	Añade una línea «pregunta: respuesta» a la observación del destino.

Las respuestas se escriben tal como se dan. Para escribir una fecha en otro formato, añade "transform": { "type": "dateParse", "format": "dd-MM-yyyy HH:mm" }; "type": "addDuration" convierte un número de segundos en ese tiempo a partir de ahora.

Respuestas del ordenador de a bordo

Los conductores con ordenador de a bordo responden las preguntas en ese dispositivo. Transportial asocia esas respuestas a tu cuestionario mediante externalIds: por sistema (transics o webfleet), el código que envía el ordenador de a bordo. Las respuestas a preguntas sin correspondencia no se aplican al cuestionario.

• Transics. Usa el código de las «Info columns» de tu hoja informativa, como SNR para un número de precinto. Si una pregunta no tiene código, usa su descripción exacta de la hoja. Da a las opciones las dos codificaciones: el texto de la respuesta como value y el código de la respuesta en sus propios externalIds.
• Webfleet. Usa el nombre del campo del mensaje de orden.

{
  "id": "seal",
  "label": "Seal number?",
  "type": "text",
  "required": false,
  "externalIds": { "transics": "SNR" },
  "fieldMapping": { "target": "consignment", "fieldPath": "goods.0.seal", "strategy": "recordDifference" }
}

Las respuestas del ordenador de a bordo llegan de una en una, así que las preguntas obligatorias pueden quedar sin responder y una respuesta no válida se omite en lugar de rechazar las demás. El resultado solo cambia cuando una respuesta lo fija.

Por defecto, todas las respuestas que dio el conductor también se muestran en la tarea, incluidas las respuestas a preguntas que no tienes en el cuestionario. Para registrar solo las respuestas asociadas, desactiva Registrar todas las respuestas del ordenador de a bordo en la integración del ordenador de a bordo. Consulta Registrar ordenadores de a bordo.

Reaccionar a las diferencias

Cuando una respuesta registra una diferencia, o una respuesta del ordenador de a bordo se omite por no ser válida, Transportial genera el evento Tras un conflicto de cuestionario. Elígelo como disparador de un flujo de trabajo, una regla de alerta o una automatización de mensajes, por ejemplo para avisar al planificador o al equipo de atención al cliente. Consulta Automatiza el trabajo con flujos de trabajo y Configura alertas y reglas de alerta.

Probar un cuestionario

1. Crea un viaje de prueba con una tarea del tipo de acción e inicia el viaje.
2. En el viaje, haz clic en el icono Compartir vista de ejecución para copiar el enlace y ábrelo en una pestaña nueva del navegador.
3. Haz clic en Iniciar en la tarea y después en Completar.
4. Responde a las preguntas y comprueba que las preguntas de seguimiento aparecen cuando deben.
5. Haz clic en Completar y comprueba el resultado en la tarea del viaje. Consulta Consultar los resultados de las acciones.

Solución de problemas

• El cuestionario no aparece. Comprueba que enabled es true, que la clave coincide con el tipo de acción de la tarea y que has guardado la configuración.
• Una pregunta nunca aparece. Revisa sus condiciones: el questionId debe ser una pregunta anterior y el value debe coincidir exactamente con el value de la opción, no con su etiqueta.
• El conductor no puede completar. Una pregunta es obligatoria salvo que tenga "required": false. Las preguntas ocultas nunca son obligatorias.
• Se fija un resultado incorrecto. Las asignaciones de resultado van antes que las opciones, y gana la primera asignación que coincide. Pon primero la más específica.
• Un campo no se actualiza. Comprueba el fieldPath con las listas de arriba, que la estrategia es overwrite y que la tarea pertenece a un envío cuando el destino es consignment.