Lire l'âge des comptes d'un fournisseur par code

GET

/api/suppliers/aging/{code}

Retourne l'âge des comptes d'un fournisseur à partir de son code : solde par tranche d'ancienneté et détail de chaque transaction ouverte (échéance, jours de retard, tranche). Disponible aussi par identifiant interne via /by-id/{supplier_id}. L'âge des comptes reproduit l'état de compte d'Acomba : le solde ouvert de chaque fournisseur à la date as_of (aujourd'hui par défaut), réparti par tranches d'ancienneté calculées sur la date de facture. Le solde est net : les crédits non appliqués réduisent le total. Seules les transactions encore ouvertes sont lues ; une date passée compte les paiements émis jusqu'à cette date, mais ne réintègre pas les factures soldées depuis. Pour la liste des transactions d'une période (factures, paiements, crédits), utilisez le relevé de transactions /api/suppliers/by-id/{supplier_id}/statement. Conventions communes (cache de 4 h pour la date du jour et de 24 h pour une date passée, force_refresh, _links) : voir la présentation de la section Tableaux de bord.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Responses

🟢200

application/json

Âge des comptes du fournisseur

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://relay.exostack.cloud//api/suppliers/aging/?as_of=&bucket_type=&force_refresh=' \
--header 'x-api-key: <api-key>'

Response Example

{
    "supplier": {
        "id": 211,
        "code": "F-0045",
        "name": "Quincaillerie Fictive ltée"
    },
    "as_of_date": "2026-04-28",
    "gl_account": "2100",
    "balance_total": 2450,
    "is_past_due": true,
    "days_most_overdue": 47,
    "aging": {
        "days_0_30": 1500,
        "days_30_60": 750,
        "days_60_90": 200,
        "days_over_90": 0
    },
    "aging_percentages": {
        "days_0_30": 61.2,
        "days_30_60": 30.6,
        "days_60_90": 8.2,
        "days_over_90": 0
    },
    "open_invoices": [
        {
            "invoice_id": 8340,
            "code": "F-2026-00152",
            "date": "2026-04-10",
            "due_date": "2026-05-10",
            "transaction_type": "invoice",
            "reference": "BL-77304",
            "amount_original": 1500,
            "amount_paid": 0,
            "amount_remaining": 1500,
            "days_since_invoice": 18,
            "days_past_due": -12,
            "is_current_day": false,
            "bucket": "days_0_30"
        },
        {
            "invoice_id": 8312,
            "code": "F-2026-00128",
            "date": "2026-03-20",
            "due_date": "2026-04-19",
            "transaction_type": "invoice",
            "reference": "BL-77231",
            "amount_original": 1000,
            "amount_paid": 250,
            "amount_remaining": 750,
            "days_since_invoice": 39,
            "days_past_due": 9,
            "is_current_day": false,
            "bucket": "days_30_60"
        },
        {
            "invoice_id": 8277,
            "code": "F-2026-00093",
            "date": "2026-02-10",
            "due_date": "2026-03-12",
            "transaction_type": "invoice",
            "amount_original": 200,
            "amount_paid": 0,
            "amount_remaining": 200,
            "days_since_invoice": 77,
            "days_past_due": 47,
            "is_current_day": false,
            "bucket": "days_60_90"
        }
    ],
    "_links": {
        "self": "/api/suppliers/aging/by-id/211?as_of=2026-04-28"
    },
    "cache": {
        "status": "hit",
        "ttl_policy": "adaptive_4h_current",
        "force_refreshed": false,
        "cached_at": "2026-04-28T09:15:00-04:00",
        "expires_at": "2026-04-28T13:15:00-04:00",
        "age_seconds": 720,
        "ttl_remaining_seconds": 13680
    }
}

Modified at 2026-10-09 20:11:45

Lire l'âge des comptes d'un fournisseur par ID

Lire le relevé de transactions d'un fournisseur par ID