Ir al contenido

GetEntitiesUpdated

Lista las entidades que se crearon o modificaron en un periodo, con su identificador, su código y su nombre. Una integración que mantiene su propia copia de sus clientes, proveedores y demás partes lo llama de forma programada y, después, lee cada entidad de la lista con GetEntity.

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

GET /api/v1/GetEntitiesUpdated?FromDate=2026-10-01&ToDate=2026-10-31T23:59:59
Token: your-token
Parámetro Obligatorio Significado
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, en la misma forma. Como máximo 365 días después de FromDate.
  • Envíe los dos parámetros. Sin uno de ellos, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).
  • Los dos extremos están incluidos. Una fecha sin hora significa la medianoche al inicio de ese día, por lo que ToDate=2026-10-31 deja fuera los cambios hechos más tarde el 31 de octubre. Para incluir ese día entero, envíe 2026-10-31T23:59:59 o 2026-11-01.
  • Escriba la hora con la T, como arriba. TrakIT elimina los espacios de las fechas, por lo que 2026-10-31 23:59:59 se rechaza. Consulte Fechas y horas.

Una entidad aparece en la lista cuando se creó, o cuando sus detalles se guardaron por última vez, dentro del periodo: con Edit Entity en la página de la entidad o mediante una importación. Desactivar una entidad es uno de esos cambios.

No cuentan: aprobar la entidad, ni los cambios en sus campos de datos de entidad, documentos, contactos, otros tipos o configuración por empresa.

Solo cuenta el último cambio: una entidad modificada en su periodo y de nuevo después solo aparece en el periodo posterior. Pida periodos consecutivos, cada uno empezando donde terminó el anterior, y cada entidad cuyos detalles cambien aparecerá al menos una vez.

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
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

Si tiene éxito, RetInfo lista las entidades, por orden de identificador, y RowsAffected indica cuántas hay. La lista incluye las entidades de todos los tipos y de todas las empresas, también las desactivadas.

{
"Code": 1,
"Info": "",
"RetInfo": [
{ "EntID": 48211, "EntCode": "EXSHIP", "EntName": "Example Shipping Co" },
{ "EntID": 48230, "EntCode": "EXLOG", "EntName": "Example Logistics Ltd" }
],
"RowsAffected": 2,
"Scalar": null,
"Identity": 0
}
Campo Significado
EntID El identificador de la entidad. Lea la entidad con GetEntity.
EntCode El código de la entidad (Entity Code).
EntName El nombre de la entidad (Entity Name).

Cuando no se creó ni modificó ninguna entidad en el periodo, la respuesta tiene Code 0 e Info No data found.