Introducción a la API

La API de TrakIT permite que otros sistemas trabajen con sus datos de TrakIT sin que nadie tenga que introducirlos: crear expedientes y actualizar órdenes de trabajo desde sus propios sistemas, llevar las facturas y las facturas de proveedor a su software de contabilidad, permitir que los proveedores envíen sus facturas u obtener informes de forma programada.

Hay dos API. Se diferencian en quién las llama y en cómo se autoriza una llamada.

API	Para	Autorización
API de integración (`/api/v1`)	Los propios sistemas de su empresa.	Un usuario de TrakIT con acceso a la API inicia sesión y envía un token. Consulte Token de inicio de sesión.
API pública (`/api/public`)	Socios: proveedores que envían facturas, clientes que siguen sus contenedores, sistemas que obtienen informes, sistemas de patio.	Una clave de API configurada para ese socio. Consulte Claves de API.

API de integración

La API de integración lee y modifica los datos de TrakIT como un usuario de TrakIT que tiene acceso a la API: un administrador del sistema al que el soporte de TrakIT ha activado el acceso a la API. Todo lo que hace la integración queda registrado a nombre de ese usuario. Inicie sesión con Login (y cierre la sesión del token con Logout cuando ya no lo necesite) y, a continuación, llame a:

Expedientes y órdenes de trabajo: crear un expediente (CreateJob), leer un expediente o una orden de trabajo (GetJob, GetWO), listar las órdenes de trabajo que han cambiado (GetWOListByUpdated), cambiar campos de cabecera (UpdateWOHeader), y cerrar, cancelar o reabrir órdenes de trabajo (CloseWO, CancelWO, ReopenWO).
Eventos, datos y documentos: leer y registrar eventos y campos de datos (GetSeqData, SaveSeqData, SaveSeqDataAsync, SaveDataField), y añadir o listar documentos (UploadDoc, UploadJobDoc, GetJobDocs).
Finanzas: leer facturas y facturas de proveedor (GetInvoiceList, GetInvoice, GetBillList, GetBill), guardar una factura de proveedor (SaveBill), leer pagos y transacciones (GetPaymentsByStatusDate, GetTransaction), y enviar tarifas por canal (SaveRates).
Entidades, activos y ubicaciones: GetEntity, GetEntitiesUpdated, GetAsset, GetAssetsUpdated, GetLocations.

API pública

Cada punto de conexión público atiende a un tipo de socio, con una clave que solo permite ese punto de conexión:

Facturas de proveedor: el propio sistema de un proveedor crea sus facturas, adjunta la factura escaneada, la envía y sigue su estado. Consulte API de facturas de proveedor.
Seguimiento: un cliente sigue sus contenedores (GetShipment, GetAssetLocation, GetList).
Informes: otro sistema obtiene un informe de consulta o una suscripción a un informe avanzado (QueryReport, AdvReport).
Patios: un sistema de patio pregunta dónde está un contenedor y registra sus movimientos (GetContainerPosition, ExecuteMove).

URL base

La API forma parte de su instalación de TrakIT: su dirección es aquella en la que inicia sesión en TrakIT, seguida de /api/. Con https://trakit.example.com como ejemplo:

https://trakit.example.com/api/v1/GetJob
https://trakit.example.com/api/public/getbills

Llame siempre a la API por HTTPS.

Solicitudes

Un punto de conexión GET recibe sus parámetros en la cadena de consulta.
Un punto de conexión POST recibe un cuerpo JSON, enviado con Content-Type: application/json, salvo que su página indique que recibe un archivo (multipart/form-data).
Los nombres de los puntos de conexión y los parámetros de la cadena de consulta no distinguen entre mayúsculas y minúsculas: /api/v1/getjob es lo mismo que /api/v1/GetJob. En los cuerpos JSON, use los nombres de campo exactamente como los escribe la página de cada punto de conexión: algunos puntos de conexión los leen distinguiendo entre mayúsculas y minúsculas.
Todas las respuestas son JSON, salvo los archivos de informe que pueden devolver QueryReport y AdvReport.

Respuestas

Los puntos de conexión responden con el estado HTTP 200 y el mismo sobre JSON, tanto si la solicitud ha tenido éxito como si no:

{
  "Code": 1,
  "Info": "",
  "RetInfo": { },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
`Code`	`1` si la solicitud ha tenido éxito, `0` si TrakIT la ha rechazado, `-1` si un error la ha detenido.
`Info`	Por qué se ha rechazado la solicitud, o el error. Vacío, o una nota breve, si tiene éxito. `Login` devuelve aquí el token.
`RetInfo`	El resultado: un objeto, una lista o `null`. La página de cada punto de conexión lo describe.
`RowsAffected`	En las listas, el número de filas devueltas. Algunos puntos de conexión lo usan para el número de registros modificados.
`Scalar`	Un único valor, en los pocos puntos de conexión que devuelven uno.
`Identity`	El identificador del registro creado o modificado, en los puntos de conexión que crean o modifican uno.

Compruebe siempre Code antes de leer RetInfo. Algunos puntos de conexión responden de otra forma: con un archivo, con los propios datos en lugar del sobre, o con un estado de error HTTP cuando falta su clave. Sus páginas lo indican.

Fechas y horas

Al enviar: escriba las fechas como yyyy-MM-dd (2026-10-20) y las fechas con hora como yyyy-MM-ddTHH:mm:ss (2026-10-20T14:30:00). Algunos puntos de conexión leen las fechas con la configuración regional del servidor de TrakIT, por lo que una fecha como 10/11/2026 puede leerse como 10 de noviembre o como 11 de octubre. Los formatos anteriores se leen igual en todas partes.
Al recibir: las fechas se devuelven en la misma forma ISO 8601, 2026-10-20T14:30:00, con milisegundos cuando no son cero (2026-10-20T14:30:05.437). La mayoría no llevan zona horaria, incluso cuando están en UTC: la página de cada punto de conexión indica si sus horas están en UTC o en hora local.

Errores

Qué recibe	Qué hacer
`Code` 0	Se ha rechazado la solicitud: `Info` indica el motivo, por ejemplo un campo que falta o un registro que no existe. Corrija la solicitud y vuelva a enviarla. La página de cada punto de conexión lista sus mensajes en Reglas.
`Code` -1	Un error ha detenido la solicitud. Vuelva a enviarla más tarde. Si sigue fallando, póngase en contacto con el soporte de TrakIT indicando el punto de conexión, la hora de la llamada y el texto de `Info`.
HTTP 404	La dirección es incorrecta, o falta un parámetro obligatorio de la cadena de consulta: compruebe la parte `/api/v1/` o `/api/public/`, el nombre del punto de conexión y los parámetros.
HTTP 405	El punto de conexión existe, pero admite el otro método: `GET` en lugar de `POST`, o al revés.

Si una llamada que crea algo agota el tiempo de espera y no sabe si se ha completado, compruébelo antes de volver a enviarla: por ejemplo, busque primero el expediente o la factura de proveedor. Si la envía dos veces, puede crearse dos veces o rechazarse por duplicada.