GetEntitiesUpdated

Liste les entités créées ou modifiées sur une période, avec leur identifiant, leur code et leur nom. Une intégration qui tient sa propre copie de vos clients, fournisseurs et autres parties l’appelle à intervalles réguliers, puis lit chaque entité listée avec GetEntity.

Comment se connecter et lire la réponse : Authentification, Réponses.

GET /api/v1/GetEntitiesUpdated?FromDate=2026-10-01&ToDate=2026-10-31T23:59:59
Token: your-token

Paramètre	Obligatoire	Signification
FromDate	Oui	Le début de la période, en UTC : une date, yyyy-MM-dd, ou une date et une heure, yyyy-MM-ddTHH:mm:ss.
ToDate	Oui	La fin de la période, en UTC, sous la même forme. 365 jours au plus après FromDate.

• Envoyez les deux paramètres. Sans l’un d’eux, la requête n’atteint pas le point de terminaison, et TrakIT répond avec le statut HTTP 404 (voir Erreurs).
• Les deux bornes sont incluses. Une date sans heure correspond à minuit au début de ce jour : ToDate=2026-10-31 exclut donc les modifications faites plus tard le 31 octobre. Pour inclure toute cette journée, envoyez 2026-10-31T23:59:59 ou 2026-11-01.
• Écrivez une heure avec le T, comme ci-dessus. TrakIT supprime les espaces des dates : 2026-10-31 23:59:59 est donc refusé. Voir Dates et heures.

Ce qui compte comme une modification

Une entité est listée quand elle a été créée, ou quand ses détails ont été enregistrés pour la dernière fois, au cours de la période : avec Edit Entity sur la page de l’entité ou par une importation. Désactiver une entité est une telle modification.

Ne comptent pas : l’approbation de l’entité, et les modifications de ses champs de données d’entité, documents, contacts, autres types ou paramètres par société.

Seule la dernière modification compte : une entité modifiée pendant votre période puis de nouveau après n’est listée que dans la période ultérieure. Demandez des périodes consécutives, chacune commençant là où la précédente s’est terminée, et chaque entité dont les détails changent est listée au moins une fois.

Règles

Règle	Info en cas d’échec
L’en-tête Token contient un jeton valide.	Token missing in header, Token invalid or expired, ou une autre réponse listée dans Jeton de connexion
L’utilisateur est un administrateur système disposant de l’accès à l’API.	API User must be SysAdmin with API Access
FromDate n’est pas vide.	FromDate is required
ToDate n’est pas vide.	ToDate is required
FromDate est une date.	FromDate is not valid
ToDate est une date.	ToDate is not valid
ToDate n’est pas antérieure à FromDate.	ToDate must be later than FromDate
Les dates sont espacées de 365 jours au plus.	Days between FromDate and ToDate cannot exceed 365

Réponse

En cas de succès, RetInfo liste les entités, par ordre d’identifiant, et RowsAffected indique leur nombre. La liste contient les entités de tous les types et de toutes les sociétés, y compris celles qui sont désactivées.

{
  "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
}

Champ	Signification
EntID	L’identifiant de l’entité. Lisez l’entité avec GetEntity.
EntCode	Le code de l’entité (Entity Code).
EntName	Le nom de l’entité (Entity Name).

Quand aucune entité n’a été créée ni modifiée pendant la période, la réponse a Code 0 et Info No data found.