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

GET

/api/customers/aging/{code}

Retourne l'âge des comptes d'un client à 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/{customer_id}. 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: ********************

Path Params

Query Params

Responses

🟢200

application/json

Âge des comptes du client

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/?as_of=&bucket_type=&force_refresh=' \
--header 'x-api-key: <api-key>'

Response Example

{
    "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
    },
    "open_invoices": [
        {
            "invoice_id": 2231,
            "code": "FAC-2026-00452",
            "date": "2026-04-10",
            "due_date": "2026-05-10",
            "transaction_type": "invoice",
            "reference": "BC-90112",
            "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": 2214,
            "code": "FAC-2026-00418",
            "date": "2026-03-20",
            "due_date": "2026-04-19",
            "transaction_type": "invoice",
            "reference": "BC-88931",
            "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": 2187,
            "code": "FAC-2026-00377",
            "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/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:13:10

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

Lister les factures réglées par un paiement fournisseur