GetJobDocs

Lista los documentos de un expediente: los de todo el expediente y los de cada una de sus órdenes de trabajo, como en la pestaña Documents de la orden de trabajo. Cada uno viene con un enlace para descargarlo. Puede pedir solo los documentos vinculados a algunos elementos de la lista de comprobación de documentos del expediente, por ejemplo los conocimientos de embarque. Para añadir un documento, use UploadJobDoc.

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

GET /api/v1/GetJobDocs?JobID=30512&ChecklistType=Bill%20of%20Lading~Packing%20List
Token: your-token

Parámetro	Obligatorio	Significado
JobID	Sí	El identificador del expediente, un número entero.
ChecklistType	No	Solo los documentos vinculados a un elemento de la lista de comprobación cuyo nombre contiene uno de estos textos, separados por ~. No distingue entre mayúsculas y minúsculas. Los documentos que no están vinculados a la lista de comprobación se omiten entonces. Sin él, se listan todos los documentos del expediente.

Incluya JobID en la cadena de consulta: sin él, la solicitud no llega al punto de conexión y TrakIT responde con HTTP 404.

Reglas

Regla	Info si no se cumple
JobID es un número entero mayor que 0.	Invalid JobID
El expediente existe.	Job not found

Respuesta

Si tiene éxito, Code es 1, RetInfo es la lista de documentos, del más antiguo al más reciente, y RowsAffected es su número. Identity y Scalar no se utilizan. Si el expediente no tiene documentos, o ninguno vinculado a los elementos de la lista de comprobación pedidos, Code es 0 e Info es No documents found.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "DocID": 304931,
      "Title": "Bill of Lading",
      "FileName": "EXSHIP-BL-2026-1187.pdf",
      "FileSize": 248113,
      "WorkOrderID": null,
      "UploadedBy": "Jane Smith",
      "UploadedOn": "2026-10-19T07:52:31.27",
      "Cancelled": false,
      "IsPublic": true,
      "Latitude": null,
      "Longitude": null,
      "ChecklistItems": [ "Bill of Lading" ],
      "Url": "https://trakit.example.com/getfile?preview=true&id=...&exp=..."
    },
    {
      "DocID": 304977,
      "Title": "Packing List",
      "FileName": "packing-list-48211.pdf",
      "FileSize": 96402,
      "WorkOrderID": 48211,
      "UploadedBy": "Jane Smith",
      "UploadedOn": "2026-10-20T10:05:12.4",
      "Cancelled": false,
      "IsPublic": false,
      "Latitude": null,
      "Longitude": null,
      "ChecklistItems": [ "Packing List" ],
      "Url": "https://trakit.example.com/getfile?preview=true&id=...&exp=..."
    }
  ],
  "RowsAffected": 2,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
DocID	El identificador del documento.
Title, FileName	El título del documento y el nombre de su archivo.
FileSize	El tamaño del archivo en bytes, tal como se subió.
WorkOrderID	La orden de trabajo a la que corresponde el documento, o null para un documento de todo el expediente.
UploadedBy	El nombre completo del usuario que lo subió, o null.
UploadedOn	Cuándo se subió, en UTC. Consulte Fechas.
Cancelled	true si el documento se ha cancelado. Los documentos cancelados también se listan.
IsPublic	true si los usuarios externos, como el cliente, pueden verlo (Ext en la pestaña Documents).
Latitude, Longitude	Dónde se capturó el documento, si se tomó con una ubicación, o null.
ChecklistItems	Los nombres de los elementos de la lista de comprobación a los que está vinculado, o null.
Url	Un enlace que abre el documento sin iniciar sesión en TrakIT, durante 7 días.

Notas

• Cualquiera que tenga una Url puede abrir el documento hasta que caduque el enlace, sin iniciar sesión. Trate los enlaces con la misma confidencialidad que los documentos. Cada llamada devuelve enlaces nuevos, válidos durante 7 días desde la llamada.
• Se listan todos los documentos del expediente, incluidos los limitados a algunos roles en TrakIT.