Aller au contenu
Documentation TrakIT

UploadBillFile

Joint un fichier à une facture fournisseur du fournisseur et de la société de la clé d’API. Une facture fournisseur doit avoir au moins un fichier avant de pouvoir être soumise. Le fichier est visible par la société et par le fournisseur dans le portail. Le fonctionnement des clés et des réponses est décrit dans API des factures fournisseurs.

Envoyez la requête en multipart/form-data, en deux parties : BillID et le fichier.

POST /api/public/uploadbillfile
APIKey: your-api-key
Content-Type: multipart/form-data; boundary=...

Par exemple, avec curl :

Fenêtre de terminal
curl -H "APIKey: your-api-key" -F "BillID=109827" -F "file=@INV-2026-0042.pdf" https://trakit.example.com/api/public/uploadbillfile

Remplacez https://trakit.example.com par l’adresse de votre TrakIT. Envoyez un fichier par requête ; pour en joindre plusieurs, envoyez plusieurs requêtes.

Règles

Section intitulée « Règles »
Règle Info en cas d’échec
La requête contient le BillID d’une facture fournisseur du fournisseur et de la société de la clé. BillID is required, Bill not found
La requête contient exactement un fichier. Attach one file, Send one file per request
Le fichier fait 20 Mo au plus. File size cannot exceed 20 MB
Le nom du fichier fait 100 caractères au plus. File name cannot exceed 100 characters
Le fichier est d’un type que TrakIT accepte des utilisateurs externes. La liste est définie pour chaque installation de TrakIT ; par défaut, ce sont PDF, PNG et JPG. File type must be ..., suivi des types acceptés
La facture fournisseur est un brouillon, ou a été rejetée. Files can be changed only while the bill is a draft or has been rejected
La facture fournisseur n’a pas encore de fichier de même nom et de même taille. A file of the same name and size already exists

Réponse

Section intitulée « Réponse »

En cas de succès, Identity est l’identifiant du nouveau fichier et RetInfo indique la facture fournisseur et le fichier :

{
  "Code": 1,
  "Info": "",
  "RetInfo": { "BillID": 109827, "AttID": 195285, "FileName": "INV-2026-0042.pdf" },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 195285
}