Analyses fournisseurs

Listez depenses agregees, nombre de factures, montant moyen et derniere activite par fournisseur.

GET/v1/analytics/vendorsPro

Les analyses fournisseurs sont disponibles sur Pro et Business. L'endpoint renvoie la liste agregee des fournisseurs pour le workspace authentifie.

Requete

Utilisez GET /v1/analytics/vendors pour recuperer la liste agregee actuelle.

curl https://api.parsurai.com/v1/analytics/vendors \
  -H "X-API-Key: $PARSURAI_API_KEY"

L'endpoint public actuel n'accepte pas de parametres sort, order, cursor ni de chemin detail fournisseur. Il n'existe pas d'endpoint public de detail par vendor_profile_id.

Reponse

{
  "items": [
    {
      "vendor_profile_id": "6d1f95cd-8d8e-4ee1-a2ab-7f81413c7a9f",
      "display_name": "Supplier Inc.",
      "invoice_count": 14,
      "total_spend": {
        "amount": "14200.00",
        "currency": "EUR"
      },
      "avg_amount": {
        "amount": "1014.28",
        "currency": "EUR"
      },
      "last_seen_at": "2026-06-12T14:20:00Z"
    }
  ]
}

Reference des champs

Champ	Type	Description
`items`	array	Agregats fournisseur
`items[].vendor_profile_id`	UUID string	Identifiant de profil fournisseur
`items[].display_name`	string	Meilleur nom d'affichage du fournisseur
`items[].invoice_count`	integer	Nombre de factures associees
`items[].total_spend.amount`	string	Depense cumulee sous forme de chaine decimale
`items[].total_spend.currency`	string	Code devise
`items[].avg_amount`	object	Montant moyen de facture
`items[].last_seen_at`	ISO datetime	Horodatage de la facture la plus recente