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

GET

/api/suppliers/{code}/statement

Retourne le relevé de transactions d'un fournisseur entre les dates from et to, à partir de son code. Disponible aussi par identifiant interne via /by-id/{supplier_id}/statement. Le relevé part du solde d'ouverture (cumul des transactions avant from), puis liste chaque facture, crédit du fournisseur et paiement émis de la période dans l'ordre chronologique avec le solde courant après chaque ligne, et se termine par les totaux de la période. Les paiements archivés et les paiements en attente ne sont pas inclus ; le montant payé d'une facture n'est connu que si elle est entièrement payée. Pour le solde ouvert par tranche d'ancienneté (l'état de compte d'Acomba), utilisez l'âge des comptes /api/suppliers/aging/by-id/{supplier_id}. Conventions communes (cache de 4 h si la période inclut aujourd'hui, 24 h sinon, 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

Relevé de transactions 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//statement?from=&to=&force_refresh=' \
--header 'x-api-key: <api-key>'

Response Example

{
    "supplier": {
        "id": 211,
        "code": "F-0045",
        "name": "Quincaillerie Fictive ltée"
    },
    "period": {
        "from": "2026-01-01",
        "to": "2026-05-31"
    },
    "opening_balance": 1250,
    "closing_balance": 2450,
    "totals": {
        "debits": 5800,
        "credits": 4600,
        "net_change": 1200,
        "invoices_count": 2,
        "payments_count": 1,
        "credits_count": 1,
        "other_count": 0
    },
    "lines": [
        {
            "line_index": 1,
            "date": "2026-01-08",
            "transaction_type": {
                "id": 2,
                "code": "invoice",
                "label": "Facture"
            },
            "source": {
                "kind": "invoice_ap",
                "id": 4501,
                "code": "F-2026-0091"
            },
            "reference": "BL-22011",
            "description": "Quincaillerie de chantier",
            "due_date": "2026-02-07",
            "debit": 3200,
            "credit": 0,
            "amount_paid": 3200,
            "amount_remaining": 0,
            "running_balance": 4450,
            "is_current_day": false,
            "is_paid_in_full": true,
            "_links": {
                "detail": "/api/suppliers/invoices-ap/by-id/4501"
            }
        },
        {
            "line_index": 2,
            "date": "2026-01-22",
            "transaction_type": {
                "id": 1,
                "code": "cheque",
                "label": "Chèque"
            },
            "source": {
                "kind": "payment_ap",
                "id": 1102,
                "code": "001245"
            },
            "reference": "CHQ-001245",
            "debit": 0,
            "credit": 4450,
            "running_balance": 0,
            "is_current_day": false,
            "_links": {
                "detail": "/api/suppliers/payments/by-id/1102"
            }
        },
        {
            "line_index": 3,
            "date": "2026-03-15",
            "transaction_type": {
                "id": 2,
                "code": "invoice",
                "label": "Facture"
            },
            "source": {
                "kind": "invoice_ap",
                "id": 4562,
                "code": "F-2026-0148"
            },
            "reference": "BL-22307",
            "description": "Matériaux de mars",
            "due_date": "2026-04-14",
            "debit": 2600,
            "credit": 0,
            "amount_remaining": 2600,
            "running_balance": 2600,
            "is_current_day": false,
            "is_paid_in_full": false,
            "_links": {
                "detail": "/api/suppliers/invoices-ap/by-id/4562"
            }
        },
        {
            "line_index": 4,
            "date": "2026-03-20",
            "transaction_type": {
                "id": 1,
                "code": "credit",
                "label": "Crédit"
            },
            "source": {
                "kind": "invoice_ap",
                "id": 4570,
                "code": "F-2026-0155"
            },
            "reference": "BL-22307",
            "description": "Crédit pour retour de matériel",
            "debit": 0,
            "credit": 150,
            "amount_paid": 150,
            "amount_remaining": 0,
            "running_balance": 2450,
            "is_current_day": false,
            "is_paid_in_full": true,
            "_links": {
                "detail": "/api/suppliers/invoices-ap/by-id/4570"
            }
        }
    ],
    "metadata": {
        "organisation_id": "construction_exemple",
        "extracted_at": "2026-05-12T09:12:00-04:00",
        "sdk_indexes_used": {
            "invoice_ap": 6,
            "payment_ap": 1
        },
        "scope": "non_archived_only"
    },
    "cache": {
        "status": "miss",
        "key_hash": "sha1:3f7a1c9e5b2d8f4a6c0e1b3d5f7a9c2e4b6d8f0a",
        "cached_at": "2026-05-12T09:12:00-04:00",
        "expires_at": "2026-05-12T13:12:00-04:00",
        "age_seconds": 0,
        "ttl_remaining_seconds": 14400,
        "ttl_policy": "current_period_4h",
        "force_refreshed": false
    },
    "_links": {
        "self": "/api/suppliers/by-id/211/statement?from=2026-01-01&to=2026-05-31",
        "overview": "/api/suppliers/by-id/211/overview",
        "aging": "/api/suppliers/aging/by-id/211"
    }
}

Modified at 2026-10-09 19:59:12

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

Consulter la vue 360° d'un fournisseur par ID