GetBillList

Liste les factures fournisseurs d’une période : les factures que vos fournisseurs et d’autres entités vous ont envoyées, avec leur numéro, leur statut, leurs montants et leurs dossiers. Utilisez-le pour récupérer les factures fournisseurs saisies, validées ou finalisées depuis votre dernier appel, puis lisez chacune en détail avec GetBill. Pour la signification de chaque statut, voir Les étapes d’une facture fournisseur dans TrakIT.

La liste contient les factures fournisseurs d’une seule société : la Company de l’utilisateur TrakIT qui s’est connecté (voir Champs de l’utilisateur).

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

GET /api/v1/GetBillList?DateType=Validated&FromDate=2026-10-01&ToDate=2026-10-08
Token: your-token

Paramètre	Obligatoire	Signification
DateType	Oui	La date à laquelle s’applique la période : BillDate, Added, Validated ou Finalised. Les majuscules n’ont pas d’importance. Voir Période.
FromDate	Oui	Le début de la période, au format yyyy-MM-dd, ou yyyy-MM-ddTHH:mm:ss pour une heure. Inclus.
ToDate	Oui	La fin de la période, sous la même forme. Incluse. 365 jours au plus après FromDate.

Envoyez les dates au format yyyy-MM-dd ou yyyy-MM-ddTHH:mm:ss : les autres formes dépendent des paramètres régionaux du serveur. Voir Dates.

Période

DateType	La période s’applique à
BillDate	La date de la facture fournisseur, celle qui figure sur la facture.
Added	Le moment où la facture fournisseur a été saisie dans TrakIT, en UTC.
Validated	Le moment où la facture fournisseur a été validée, en UTC. Les factures fournisseurs non validées sont exclues.
Finalised	Le moment où la facture fournisseur a été finalisée, en UTC. Les factures fournisseurs non finalisées sont exclues.

Added, Validated et Finalised sont des dates avec une heure. Une date sans heure correspond au début de ce jour : ToDate=2026-10-08 s’arrête donc à minuit, au début du 8 octobre. Pour inclure toute la journée, envoyez ToDate=2026-10-08T23:59:59 ou le jour suivant.

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 avec l’accès à l’API.	API User must be SysAdmin with API Access
DateType a une valeur.	DateType is required
FromDate a une valeur.	FromDate is required
ToDate a une valeur.	ToDate is required
DateType est l’une des quatre valeurs.	Invalid Date Type. Date Type must be one of the following: BillDate, Added, Validated, Finalised
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

TrakIT supprime les espaces des dates avant de les lire ; écrivez donc une heure avec le T : 2026-10-08 23:59:59 est refusé.

Réponse

En cas de succès, Code vaut 1, RetInfo est la liste, de la date de facture la plus ancienne à la plus récente, et RowsAffected est le nombre de factures fournisseurs qu’elle contient. Quand aucune facture fournisseur ne correspond, la liste est vide : Code vaut toujours 1 et RowsAffected vaut 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "ID": 109827,
      "BillNumber": "INV-2026-0042",
      "BillDate": "2026-10-01",
      "Received": "2026-10-02",
      "DueDate": "2026-10-31",
      "BillSeq": "HQ-2610-0042",
      "Status": "Validated",
      "EntID": 2214,
      "EntCode": "EXSHIP",
      "Currency": "USD",
      "Total": 1150.00,
      "BillActual": 1150.00,
      "TaxDeduct": null,
      "Disputed": false,
      "JobIDs": [31877, 31902],
      "AddedBy": "jsmith",
      "AddedOn": "2026-10-02T09:12:44.31",
      "ValidatedBy": "jsmith",
      "ValidatedOn": "2026-10-06T11:03:27.9"
    }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Champ	Signification
ID	L’identifiant de la facture fournisseur dans TrakIT. Utilisez-le avec GetBill.
BillNumber	Le numéro de facture du fournisseur, en majuscules et sans espaces.
BillDate	La date de la facture, au format yyyy-MM-dd.
Received	La date de réception de la facture fournisseur, au format yyyy-MM-dd.
DueDate	La date d’échéance du paiement, au format yyyy-MM-dd, ou null.
BillSeq	Le numéro de séquence de la facture fournisseur, que TrakIT lui attribue lors de sa validation, ou null avant.
Status	Submitted, Received, Validated, Finalised, Disputed ou Rejected.
EntID, EntCode	L’identifiant et le code de l’entité qui a envoyé la facture fournisseur. Voir GetEntity.
Currency	La devise de la facture fournisseur.
Total	Le total des postes affectés à la facture fournisseur, taxes comprises, dans la devise de la facture.
BillActual	Le montant facturé par le fournisseur, taxe comprise.
TaxDeduct	La retenue à la source : la taxe retenue sur le paiement du fournisseur, ou null s’il n’y en a pas.
Disputed	true lorsque la facture fournisseur est marquée comme contestée.
JobIDs	Les identifiants des dossiers des postes affectés à la facture fournisseur. Vide tant qu’aucun poste n’est affecté. Voir GetJob.
AddedBy, AddedOn	L’identifiant utilisateur de la personne qui a saisi la facture fournisseur, et le moment, en UTC.
ValidatedBy, ValidatedOn	L’identifiant utilisateur de la personne qui a validé la facture fournisseur, et le moment, en UTC. null jusqu’à sa validation.

BillActual et Total sont les totaux Billed et Allocated des encadrés Montants de la facture fournisseur.

Notes

• Envoyez tous les 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).