GetWO

Devuelve una orden de trabajo por su identificador: su cabecera, sus servicios, sus eventos y campos de datos con sus valores, sus KPI (indicadores clave de rendimiento) y sus activos. Utilícelo para leer las órdenes de trabajo que ha creado CreateJob, o las que GetWOListByUpdated lista como modificadas. Para leer a la vez todas las órdenes de trabajo de un expediente, use GetJob; para leer solo algunos eventos y campos de datos, use GetSeqData.

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

GET /api/v1/GetWO?ID=48211
Token: your-token

Parámetro	Obligatorio	Significado
ID	Sí	El identificador de la orden de trabajo, un número entero.

Sin ID, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404. Un ID que no es un número entero también recibe un estado de error HTTP en lugar de la respuesta habitual. Consulte Errores.

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

Respuesta

Si tiene éxito, RetInfo es la orden de trabajo. RowsAffected e Identity son 0.

Compruebe RetInfo antes de leerlo: es null cuando ninguna orden de trabajo tiene ese identificador.

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "WorkOrderID": 48211,
    "Workflow": "Import Sea Freight",
    "WFType": "Import",
    "JobID": 10457,
    "Job": "EXBL2610045",
    "JobType": "Door to Door",
    "ContNum": "ABCU1234560",
    "TypeCode": "22G1",
    "ContLength": 20,
    "SealNum": "SL778812",
    "Commodity": "Ceramic tiles",
    "LocationList": "Example Port - Container Terminal; Example City - Customer Warehouse",
    "ParentWO": null,
    "Resp": "JSMITH",
    "CarrierID": 1187,
    "CustomerID": 3021,
    "ShipperID": 3022,
    "ReceiverID": 3021,
    "AgentID": null,
    "ClAgentID": 2304,
    "TransID": 2210,
    "RetTransID": null,
    "Weight": 21450.500,
    "Volume": null,
    "Status": 0,
    "Responsible": "John Smith",
    "Trans": "Example Haulage Ltd",
    "RetTrans": null,
    "Services": [
      { "ServiceID": 4, "ServiceName": "Customs Clearance" },
      { "ServiceID": 6, "ServiceName": "Delivery" }
    ],
    "Events": [
      { "Name": "Vessel Arrival", "Code": "VSLARR", "Value": "2026-10-20 06:30", "Remarks": null, "Updated": "2026-10-20T07:02:11.483", "UpdatedBy": "JSMITH" },
      { "Name": "Gate Out", "Code": "GATEOUT", "Value": "", "Remarks": null, "Updated": null, "UpdatedBy": null }
    ],
    "Data": [
      { "Name": "Delivery Order No", "Code": "DONUM", "Value": "DO-55120", "Remarks": null, "Updated": "2026-10-20T09:15:40.12", "UpdatedBy": "JSMITH" }
    ],
    "KPIs": [
      { "KPI": "Arrival to Gate Out", "FromDate": "2026-10-20T06:30:00", "ToDate": null, "Target": 72, "Actual": 30 }
    ],
    "Assets": []
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Objeto orden de trabajo

GetJob devuelve sus órdenes de trabajo con la misma forma. Las etiquetas en negrita son las de los campos de cabecera.

Campo	Significado
WorkOrderID	El identificador de la orden de trabajo.
Workflow, WFType	El nombre y el tipo del flujo de trabajo: Import, Export, RoundTrip o NonShipment.
JobID, Job	El identificador y la referencia del expediente.
JobType	Los nombres de los tipos de expediente del expediente, separados por una coma y un espacio. Vacío si no tiene ninguno.
ContNum	Container No., o una cadena vacía.
TypeCode	Load Type: el código del tipo de carga, o null.
ContLength	La longitud en pies que indica el código del tipo de carga, por ejemplo 20 para 22G1 y 45 para L5G1. 0 sin tipo de carga, o cuando el código no indica ninguna longitud.
SealNum	Seal Number, o una cadena vacía.
Commodity	Commodity, o una cadena vacía.
LocationList	La lista de ubicaciones como texto: cada ubicación precedida de la zona geográfica de la que depende, Parent - Location, separadas por ; . Vacío si la orden de trabajo no tiene ninguna.
ParentWO	El identificador de la orden de trabajo a partir de la cual se creó esta, su orden de trabajo padre, o null.
Resp, Responsible	Responsible Person: el identificador de usuario y el nombre del usuario.
CarrierID	Carrier: el identificador de la entidad, o 0 si no hay ninguna.
CustomerID, ShipperID, ReceiverID	Customer, Shipper y Receiver del expediente: identificadores de entidades, o null.
AgentID, ClAgentID	Bond Agent y Clearing Agent: identificadores de entidades, o null.
TransID, Trans	Transporter: el identificador y el nombre de la entidad, o null.
RetTransID, RetTrans	Return Transporter: el identificador y el nombre de la entidad, o null.
Weight	Weight, en kilogramos.
Volume	Volume, en metros cúbicos, o null.
Status	El estado de la orden de trabajo en la página de la orden de trabajo, como número: 0 Active, 1 Abandoned, 2 Cancelled, 3 Closed por un usuario, una integración o una acción, 4 Closed por el propio TrakIT, una vez rellenados los eventos y los datos obligatorios o después de que la orden de trabajo quedara abandonada.
Services	Los servicios de la orden de trabajo: ServiceID y ServiceName. Una lista vacía si no tiene ninguno.
Events	Todos los eventos de la orden de trabajo, registrados o no, en el orden del flujo de trabajo. Véase más abajo.
Data	Todos los campos de datos de la orden de trabajo, rellenos o no, en el orden del flujo de trabajo, con los mismos campos que Events.
KPIs	Los KPI de la orden de trabajo. Véase más abajo.
Assets	Los activos asignados a la orden de trabajo, en el orden en que se asignaron: AssetID, AssetName, AssetSerial y TypeID, el identificador del tipo de activo. Una lista vacía si no tiene ninguno.

Cada elemento de Events y Data:

Campo	Significado
Name	El nombre del evento o del campo de datos.
Code	Su código. GetSeqData y SaveSeqData usan este código.
Value	El valor, como texto, o una cadena vacía. Para un evento, la fecha y la hora tal como se registraron, por ejemplo 2026-10-20 06:30, o NA (no aplicable) o TBA (pendiente de confirmar).
Remarks	Las observaciones, o null.
Updated	Cuándo se guardó el valor por última vez, en UTC, o null si nunca se guardó.
UpdatedBy	El identificador de usuario del usuario que lo guardó, o null.

Cada elemento de KPIs:

Campo	Significado
KPI	El nombre del KPI.
FromDate, ToDate	Los momentos entre los que corre el KPI, como en la pestaña KPIs de la orden de trabajo, o null mientras no se conocen.
Target	El tiempo permitido, en horas, o null. Para un KPI en horario laboral, un día cuenta como 8 horas.
Actual	El tiempo empleado hasta ahora, en horas, o null.