Lister l'âge des comptes des clients

GET

/api/customers/aging

Retourne l'âge des comptes de tous les clients qui ont des transactions ouvertes, avec les totaux de l'entreprise par tranche d'ancienneté. Par défaut (brief=true), chaque client est résumé ; brief=false ajoute le détail de ses factures ouvertes. L'âge des comptes reproduit l'état de compte d'Acomba : le solde ouvert de chaque client à 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 reçus 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/customers/by-id/{customer_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: ********************

Query Params

Responses

🟢200

application/json

Âge des comptes de l'ensemble des clients

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Résumé par client (brief=true, défaut)

{
    "as_of_date": "2026-04-28",
    "total_customers": 42,
    "total_balance": 62500,
    "bucket_type": "standard",
    "aging_summary": {
        "days_0_30": 45000,
        "days_30_60": 12000,
        "days_60_90": 3500,
        "days_over_90": 2000
    },
    "aging_percentages": {
        "days_0_30": 72,
        "days_30_60": 19.2,
        "days_60_90": 5.6,
        "days_over_90": 3.2
    },
    "items": [
        {
            "customer": {
                "id": 105,
                "code": "C-1005",
                "name": "Construction Exemple inc."
            },
            "as_of_date": "2026-04-28",
            "gl_account": "1200",
            "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
            },
            "_links": {
                "self": "/api/customers/aging/by-id/105?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:12:31

Présentation

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