Lister les clients inactifs depuis N jours

GET

/api/customers/inactive

Liste les clients qui n'ont reçu aucune facture depuis plus de days_since_last_invoice jours à la date as_of, avec la date et le montant de leur dernière facture et la proportion de clients inactifs. Ce n'est pas le statut « inactif » de la fiche client (filtre is_active de /api/customers) : seuls les clients dont la fiche est active et non supprimée sont analysés, et leur inactivité est déduite de leurs factures du module Facturation (les commandes et soumissions ne comptent pas). L'historique des ventes se limite aux 2 ans (730 jours) précédant as_of : un client sans facture sur cette fenêtre a last_invoice_date à null, et un seuil de 730 jours ou plus ne retient que ces clients. Conventions communes (cache de 4 h si as_of est aujourd'hui, 24 h sinon, force_refresh, _links, metadata) : 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

Clients inactifs, avec le sommaire

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://relay.exostack.cloud//api/customers/inactive?as_of=&days_since_last_invoice=&limit=&sort_by=&force_refresh=' \
--header 'x-api-key: <api-key>'

Response Example

{
    "_links": {
        "all_customers": "/api/customers",
        "self": "/api/customers/inactive?as_of=2026-10-07&days_since_last_invoice=180&limit=2&sort_by=days_since_last_desc"
    },
    "as_of_date": "2026-10-07",
    "cache": {
        "age_seconds": 0,
        "cached_at": "2026-10-07T09:20:00-04:00",
        "expires_at": "2026-10-07T13:20:00-04:00",
        "force_refreshed": false,
        "key_hash": "sha1:5e0a9c3b71f2d84e6a1b0c97d3f25e48a6c1b092",
        "status": "miss",
        "ttl_policy": "current_period_4h",
        "ttl_remaining_seconds": 14400
    },
    "cutoff_date": "2026-04-10",
    "filter": {
        "days_since_last_invoice": 180,
        "limit": 2,
        "sort_by": "days_since_last_desc"
    },
    "items": [
        {
            "_links": {
                "customer_overview": "/api/customers/by-id/512/overview",
                "customer_statement": "/api/customers/by-id/512/statement?from=2024-10-07&to=2026-10-07"
            },
            "customer": {
                "code": "PAYS-FIC",
                "id": 512,
                "name": "Paysagement Fictif inc."
            },
            "lifetime_invoices_count": 0,
            "rank": 1
        },
        {
            "_links": {
                "customer_overview": "/api/customers/by-id/211/overview",
                "customer_statement": "/api/customers/by-id/211/statement?from=2024-10-07&to=2026-10-07"
            },
            "customer": {
                "code": "CONST-EX",
                "id": 211,
                "name": "Construction Exemple inc."
            },
            "days_since_last_invoice": 572,
            "last_invoice_amount": 4312.5,
            "last_invoice_date": "2025-03-14",
            "lifetime_invoices_count": 6,
            "rank": 2
        }
    ],
    "lookback_start_date": "2024-10-07",
    "metadata": {
        "active_customers_scanned": 140,
        "extracted_at": "2026-10-07T09:20:00-04:00",
        "lookback_horizon_days": 730,
        "organisation_id": "entreprise_exemple",
        "scope": "invoicing_only_type_1",
        "scope_note": "Historique de ventes limité aux 2 ans précédant as_of_date. Un client sans facture sur cette fenêtre a last_invoice_date null et est considéré inactif.",
        "sdk_indexes_used": {
            "invoicing": 6
        },
        "truncated": true
    },
    "summary": {
        "inactive_customers_count": 52,
        "inactive_ratio_pct": 37.14,
        "total_active_customers": 140
    }
}

Modified at 2026-10-10 14:01:59

Calculer les décaissements fournisseurs d'une période

Calculer la synthèse des ventes d'une période