GetInvoice

Renvoie une facture, une note de débit ou un avoir : son en-tête, les postes facturés avec leurs taxes, et son journal des actions. Utilisez-le après GetInvoiceList pour lire chaque facture en détail, par exemple pour la comptabiliser dans votre système comptable une fois qu’elle est approuvée. Les champs sont ceux de la page Facture.

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

GET /api/v1/GetInvoice?ID=48211
Token: your-token

Paramètre	Obligatoire	Signification
ID	Oui	L’identifiant de la facture, un nombre entier, comme ID dans GetInvoiceList. Il peut s’agir d’une facture 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, une note de débit ou un avoir a cet identifiant.	Not found

Réponse

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

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "ID": 48211,
    "InvNum": "INV-2026-0042",
    "InvDate": "2026-10-05T00:00:00",
    "Type": "I",
    "Status": "Approved",
    "EntID": 1187,
    "EntCode": "EXTRADE",
    "CreditDays": 30,
    "PFCount": 2,
    "TaxExempt": null,
    "Currency": "USD",
    "Total": 2360.00,
    "JobIDs": [31877],
    "DocID": 90412,
    "CreatedBy": "jsmith",
    "CreatedOn": "2026-10-02T08:41:12.5",
    "ApprovedBy": "jsmith",
    "ApprovedOn": "2026-10-05T07:15:03.18",
    "RefInvID": 0,
    "Accounts": [
      {
        "AccID": 772305,
        "Name": "Ocean Freight 40HC",
        "LocalName": null,
        "Code": "OFRT",
        "JobID": 31877,
        "Rate": 2000.0000,
        "Qty": 1.0000,
        "Total": 2000.00,
        "Taxes": [
          { "TaxCode": "VAT", "FinCode": "VAT18", "Rate": 18.00 }
        ],
        "WOID": 205114,
        "IntRemarks": null,
        "ExtRemarks": "Shanghai to Mombasa",
        "Updated": "2026-10-02T08:40:51.27"
      }
    ],
    "Actions": [
      { "LogTime": "2026-10-04T14:02:10.43", "Action": "Proforma Generated", "Data": "...", "UserID": "jsmith" }
    ]
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Champ	Signification
ID	L’identifiant de la facture dans TrakIT.
InvNum	Le numéro de la facture. Un brouillon a un numéro pro forma, comme PF00123-1, jusqu’à son approbation.
InvDate	La date de la facture, sous forme de date et heure à minuit.
Type	I pour une facture, D pour une note de débit, C pour un avoir.
Status	Draft, Approved, Finalised, Cancelled ou Written Off : voir Statuts. Une facture que TrakIT affiche comme Reversed garde ici son statut Approved ou Finalised.
EntID, EntCode	L’identifiant et le code de l’entité facturée. Voir GetEntity.
CreditDays	Le nombre de jours dont le client dispose pour payer, le Credit Period de la facture, ou null.
PFCount	Le nombre de factures pro forma générées.
TaxExempt	Les codes financiers des taxes dont la facture est exonérée, séparés par des virgules, ou null.
Currency	La devise de la facture.
Total	Le total de la facture, taxes comprises.
JobIDs	Les identifiants des dossiers facturés : le dossier de la facture ou, pour une facture qui ne concerne pas un seul dossier, les dossiers de ses postes. Voir GetJob.
DocID	L’identifiant du PDF de la facture parmi les documents financiers, ou 0 si elle n’en a pas.
CreatedBy, CreatedOn	L’identifiant utilisateur de la personne qui a créé la facture, et le moment, en UTC.
ApprovedBy, ApprovedOn	L’identifiant utilisateur de la personne qui a approuvé la facture, et le moment, en UTC. null jusqu’à son approbation.
RefInvID	Pour un avoir émis contre une facture, l’identifiant de cette facture. Sinon 0.
Accounts	Les postes facturés, dans leur ordre sur la facture : voir Postes.
Actions	Le journal des actions de la facture, 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 :

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 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.
WOID	L’identifiant de l’ordre de travail du poste, ou null. Voir GetWO.
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 et la date d’un brouillon peuvent encore changer : sa date passe à la date du jour à chaque ouverture, et il reçoit son numéro définitif lors de son approbation.
• Les ajustements et les encaissements reçus ne font pas partie de la réponse.