Aller au contenu

GetBills

Liste les factures fournisseurs du fournisseur de la clé d’API à la société de la clé : les mêmes factures que l’utilisateur externe du fournisseur voit dans le portail, y compris celles que la société a saisies elle-même. Utilisez-le pour suivre le statut, les dates d’échéance et les paiements de vos factures. Le fonctionnement des clés, des réponses et des statuts est décrit dans API des factures fournisseurs.

GET /api/public/getbills?FromDate=2026-10-01&ToDate=2026-10-31&Status=Outstanding
APIKey: your-api-key
Paramètre Signification
FromDate, ToDate La période des dates de facture, au format yyyy-MM-dd, les deux jours compris. 366 jours d’écart au plus. Obligatoires sauf si BillNumber est indiqué.
BillNumber Un numéro de facture. Les majuscules et les espaces n’ont pas d’importance.
Status Seulement les factures ayant ce statut : Draft, Submitted, Received, Approved, Rejected, Disputed, ou Outstanding pour les factures avec un montant restant dû.
Page La page à renvoyer. La première page est 1, la valeur par défaut.
PageSize Le nombre de factures par page, de 1 à 500. 100 par défaut.

Les factures sont classées de la date de facture la plus récente à la plus ancienne.

RetInfo contient la page et le nombre total de factures correspondantes, ce qui permet de savoir combien de pages il y a :

{
"Code": 1,
"Info": "",
"RetInfo": {
"Page": 1,
"PageSize": 100,
"Total": 2,
"Bills": [
{ "BillID": 109827, "BillNumber": "INV-2026-0042", "Status": "Approved", "...": "..." },
{ "BillID": 109790, "BillNumber": "INV-2026-0038", "Status": "Rejected", "...": "..." }
]
},
"RowsAffected": 2,
"Scalar": null,
"Identity": 0
}

Chaque élément de Bills est une facture fournisseur. RowsAffected est le nombre de factures sur cette page. Une page au-delà de la dernière ne renvoie aucune facture.

Règle Info en cas d’échec
Une période ou un numéro de facture est indiqué. FromDate and ToDate are required (yyyy-MM-dd) unless BillNumber is given
Les deux dates sont indiquées, au format yyyy-MM-dd. FromDate and ToDate must both be dates as yyyy-MM-dd
ToDate n’est pas antérieure à FromDate. ToDate cannot be earlier than FromDate
Les dates sont espacées de 366 jours au plus. FromDate and ToDate cannot be more than 366 days apart
Status est l’une des valeurs ci-dessus. Status must be one of: ...
PageSize est compris entre 1 et 500. PageSize must be between 1 and 500