CreateBill

Crée une facture fournisseur à l’état Draft pour le fournisseur et la société de la clé d’API. Joignez la facture numérisée avec uploadbillfile, puis envoyez-la à la société avec submitbill. Le fonctionnement des clés, des réponses et des statuts est décrit dans API des factures fournisseurs.

POST /api/public/createbill
APIKey: your-api-key
Content-Type: application/json

{
  "BillNumber": "INV-2026-0042",
  "BillDate": "2026-10-20",
  "CurrCode": "XOF",
  "Amount": 655000.00,
  "Tax": 117900.00
}

Champ	Obligatoire	Signification
`BillNumber`	Oui	Le numéro de facture du fournisseur. TrakIT l’enregistre en majuscules, sans espaces.
`BillDate`	Oui	La date de la facture, au format `yyyy-MM-dd`.
`CurrCode`	Oui	La devise de la facture, par exemple `XOF`.
`Amount`	Oui	Le montant hors taxes.
`Tax`	Non	La taxe. Le total de la facture est `Amount` + `Tax`.

Le fournisseur et la société viennent de la clé : la requête ne les indique pas.

Règles

Règle	`Info` en cas d’échec
Un numéro de facture est obligatoire, de 30 caractères au plus.	`Bill Number is required`, `Bill Number cannot exceed 30 characters`
Un numéro de facture ne peut être utilisé qu’une fois par fournisseur.	`Bill Number specified already exists for this entity and office`
La date de la facture est une date au format `yyyy-MM-dd`.	`BillDate must be a date as yyyy-MM-dd`
La date de la facture n’est pas dans le futur.	`Bill Date cannot be in the future`
La date de la facture date de 30 jours au plus.	`Bill Date cannot be older than 30 days`
La devise est l’une de celles dans lesquelles la société facture.	`Select a currency that company bills in`
Le montant est supérieur à zéro.	`Total Amount must be positive`
La taxe n’est pas négative.	`Tax Amount cannot be negative`
La taxe représente au plus un quart du total.	`Tax Amount cannot exceed 25% of Billed Amount`

La société peut avoir ses propres contrôles supplémentaires sur les nouvelles factures fournisseurs. Leurs messages reviennent de la même façon dans Info.

Réponse

En cas de succès, Identity est l’identifiant de la nouvelle facture fournisseur et RetInfo est la facture fournisseur, à l’état Draft.

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "BillID": 109827,
    "BillNumber": "INV-2026-0042",
    "BillDate": "2026-10-20",
    "DueDate": null,
    "CurrCode": "XOF",
    "Amount": 655000.00,
    "TaxAmount": 117900.00,
    "Total": 772900.00,
    "AdjTotal": 0.00,
    "PaidAmount": 0.00,
    "Outstanding": 772900.00,
    "Status": "Draft",
    "Remarks": "",
    "FileCount": 0,
    "Company": "Example Logistics SA"
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 109827
}

Si une requête expire, vérifiez si la facture fournisseur a été créée avant de l’envoyer à nouveau : voir Nouvelles tentatives.