GetWOListByUpdated

Lista los identificadores de las órdenes de trabajo cuyo evento o campo de datos con un código dado se guardó en un periodo. Una integración lo llama de forma programada para recoger lo que ha cambiado en TrakIT, por ejemplo cada orden de trabajo cuyo evento de salida del patio se ha registrado desde la última llamada, y después lee cada una con GetWO o lee solo los valores que necesita con GetSeqData.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

GET /api/v1/GetWOListByUpdated?Code=GATEOUT&FromDate=2026-10-27&ToDate=2026-10-27T23:59:59&WFID=12
Token: your-token

Parámetro	Obligatorio	Significado
Code	Sí	El código de un evento o campo de datos, por ejemplo GATEOUT. Las mayúsculas no importan. Show Codes, en la pestaña Events de una orden de trabajo, muestra los códigos.
FromDate	Sí	El inicio del periodo, en UTC: una fecha, yyyy-MM-dd, o una fecha y hora, yyyy-MM-ddTHH:mm:ss.
ToDate	Sí	El final del periodo, en UTC, con la misma forma. Como máximo 365 días después de FromDate.
WFID	No	Solo las órdenes de trabajo de este flujo de trabajo: su identificador, un número entero, como en la columna ID de Definiciones de flujos de trabajo. El valor predeterminado, 0, son todos los flujos de trabajo.
JobType	No	Solo las órdenes de trabajo cuyo expediente tiene este tipo de expediente, entre otros: el identificador del tipo de expediente, un número entero. El soporte de TrakIT puede facilitarle los identificadores. El valor predeterminado, 0, son todos los tipos de expediente.

• Envíe Code, FromDate y ToDate. Sin uno de ellos, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).
• Ambos extremos están incluidos. Una fecha sin hora significa la medianoche al inicio de ese día, por lo que ToDate=2026-10-27 deja fuera lo que se guardó más tarde el 27 de octubre. Para incluir ese día entero, envíe 2026-10-27T23:59:59 o 2026-10-28.
• Escriba la hora con la T, como arriba. TrakIT quita los espacios de las fechas, por lo que 2026-10-27 23:59:59 se rechaza. Consulte Fechas y horas.

Qué cuenta como cambio

Una orden de trabajo se lista cuando el valor de su evento o campo de datos con ese código se guardó por última vez dentro del periodo: su hora Updated en GetWO. Solo cuenta el último guardado: un valor guardado en su periodo y de nuevo después solo se lista en el periodo posterior. Pida periodos consecutivos, cada uno empezando donde terminó el anterior, y cada orden de trabajo cuyo valor se guarde se listará al menos una vez.

Se listan las órdenes de trabajo de todos los estados, incluidas las cerradas y las canceladas. Una orden de trabajo cuyo flujo de trabajo no tiene ningún evento ni campo de datos con ese código nunca se lista.

Reglas

Regla	Info si no se cumple
El encabezado Token contiene un token válido.	Token missing in header, Token invalid or expired, u otra respuesta indicada en Token de inicio de sesión
El usuario es un administrador del sistema con acceso a la API.	API User must be SysAdmin with API Access
Code no está vacío.	Code is required
FromDate no está vacío.	FromDate is required
ToDate no está vacío.	ToDate is required
FromDate es una fecha.	FromDate is not valid
ToDate es una fecha.	ToDate is not valid
ToDate no es anterior a FromDate.	ToDate must be later than FromDate
Las fechas tienen como máximo 365 días de diferencia.	Days between FromDate and ToDate cannot exceed 365

Respuesta

Si tiene éxito, RetInfo lista los identificadores de las órdenes de trabajo, en orden ascendente, cada uno una sola vez, y RowsAffected es cuántos hay.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [48211, 48212, 48305],
  "RowsAffected": 3,
  "Scalar": null,
  "Identity": 0
}

Cuando no se ha guardado ningún valor con ese código en el periodo, la respuesta tiene Code 0 e Info No data found.