GetBill

Renvoie une facture fournisseur : son en-tête, les dossiers et les ordres de travail qu’elle couvre, les postes qui lui sont affectés avec leurs taxes, et son journal des actions. Utilisez-le après GetBillList pour lire chaque facture fournisseur en détail, par exemple pour la comptabiliser dans votre système comptable une fois qu’elle est validée. Les champs sont ceux de la page Facture fournisseur. Pour créer une facture fournisseur, utilisez SaveBill.

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

GET /api/v1/GetBill?ID=109827
Token: your-token

Paramètre	Obligatoire	Signification
ID	Oui	L’identifiant de la facture fournisseur, un nombre entier, comme ID dans GetBillList. Il peut s’agir d’une facture fournisseur de n’importe quelle société.

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
Une facture fournisseur a cet identifiant.	Not found

Réponse

En cas de succès, Code vaut 1 et RetInfo est la facture fournisseur. RowsAffected et Identity valent 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "ID": 109827,
    "BillNumber": "INV-2026-0042",
    "BillDate": "2026-10-01",
    "Received": "2026-10-02",
    "Status": "Validated",
    "EntID": 2214,
    "EntCode": "EXSHIP",
    "DueDate": "2026-10-31",
    "TaxDeduct": 0.0,
    "Currency": "USD",
    "Total": 1150.00,
    "Actual": 1150.00,
    "JobIDs": [31877, 31902],
    "WorkOrders": [205114, 205131],
    "AddedBy": "jsmith",
    "AddedOn": "2026-10-02T09:12:44.31",
    "ValidatedBy": "jsmith",
    "ValidatedOn": "2026-10-06T11:03:27.9",
    "Accounts": [
      {
        "AccID": 772318,
        "Name": "Trucking Mombasa to Nairobi",
        "LocalName": null,
        "Code": "TRK",
        "JobID": 31877,
        "Rate": 500.0000,
        "Qty": 2.0000,
        "Total": 1000.00,
        "Taxes": [
          { "TaxCode": "VAT", "FinCode": "VAT15", "Rate": 15.00 }
        ],
        "IntRemarks": null,
        "ExtRemarks": null,
        "Updated": "2026-10-03T10:21:05.6"
      }
    ],
    "Actions": [
      { "LogTime": "2026-10-02T09:12:44.47", "Action": "Bill Created", "Data": "...", "UserID": "jsmith" }
    ]
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Champ	Signification
ID	L’identifiant de la facture fournisseur dans TrakIT.
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.
Status	Submitted, Received, Validated, Finalised, Disputed ou Rejected : voir Les étapes d’une facture fournisseur dans TrakIT.
EntID, EntCode	L’identifiant et le code de l’entité qui a envoyé la facture fournisseur. Voir GetEntity.
DueDate	La date d’échéance du paiement, au format yyyy-MM-dd, ou null.
TaxDeduct	La retenue à la source : la taxe retenue sur le paiement du fournisseur. 0 s’il n’y en a pas.
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 : le total Allocated des Montants de la facture fournisseur.
Actual	Le montant facturé par le fournisseur, taxe comprise : le total Billed.
JobIDs	Les identifiants des dossiers des postes affectés. Voir GetJob.
WorkOrders	Les identifiants des ordres de travail de ces dossiers, sauf ceux qui sont annulés. Voir GetWO.
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.
Accounts	Les postes affectés à la facture fournisseur, dans l’ordre : voir Postes.
Actions	Le journal des actions de la facture fournisseur, du plus ancien au plus récent : LogTime (UTC), Action, Data et le UserID de la personne qui a effectué l’action.

Postes

Chaque élément de Accounts est une ligne de l’onglet Accounts de la facture fournisseur :

Champ	Signification
AccID	L’identifiant du poste.
Name	Le nom du poste, suivi du détail de la ligne.
LocalName	Le Local Name du poste, ou null.
Code	L’Account Code du poste.
JobID	L’identifiant du dossier du poste, ou 0.
Rate	Le montant unitaire. Il est dans la devise de la facture fournisseur lorsque le poste a un montant dans cette devise ; sinon, c’est le montant du poste dans la devise de son dossier.
Qty	La quantité.
Total	Qty multiplié par Rate, arrondi à 2 décimales, hors taxes.
Taxes	Les taxes du poste, chacune avec son TaxCode, son FinCode (code financier) et son Rate en pourcentage. Voir Country Taxes.
IntRemarks, ExtRemarks	Les remarques internes et externes, ou null.
Updated	Le moment de la dernière modification du poste, en UTC.

Notes

• Le numéro de séquence, le centre de profit, les remarques, les ajustements et les paiements de la facture fournisseur ne font pas partie de la réponse. Le numéro de séquence de la facture fournisseur figure dans GetBillList. GetPaymentsByStatusDate liste les paiements, et GetTransaction indique les factures fournisseurs que règle chaque paiement.