Lire une obligation de taxes à remettre par ID

GET

/api/cashflow/taxes-owed/{obligation_id}

Retourne une obligation fiscale avec le détail des 13 périodes de l'exercice : variation des taxes perçues, des taxes récupérables et de l'obligation nette. L'identifiant est l'obligation_id retourné par /taxes-owed, soit l'identifiant interne du compte de taxes perçues. Les taxes configurées sont regroupées en obligations par paire de comptes (taxes perçues et taxes récupérables) : deux taxes qui partagent les mêmes comptes, comme la TPS et une TPS à 50 %, forment une seule obligation. net_owed combine les soldes courants des 2 comptes selon leur catégorie (voir calculation_note) : positif = montant à remettre, négatif = remboursement attendu. Seules les écritures transférées au grand livre sont comptées, et Acomba ne conserve ni la fréquence ni la date des remises : aucune échéance n'est calculée. Conventions communes (cache de 1 h, 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: ********************

Path Params

Query Params

Responses

🟢200

application/json

Obligation fiscale, avec le détail par période

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://relay.exostack.cloud//api/cashflow/taxes-owed/?force_refresh=' \
--header 'x-api-key: <api-key>'

Response Example

{
    "_links": {
        "collected_account_balances": "/api/organisation/charters/by-id/234/balances",
        "collected_account_charter": "/api/organisation/charters/by-id/234",
        "list": "/api/cashflow/taxes-owed",
        "reclaimable_account_balances": "/api/organisation/charters/by-id/235/balances",
        "reclaimable_account_charter": "/api/organisation/charters/by-id/235",
        "self": "/api/cashflow/taxes-owed/234"
    },
    "as_of": "2026-10-07T09:12:00-04:00",
    "cache": {
        "age_seconds": 0,
        "cached_at": "2026-10-07T09:12:00-04:00",
        "expires_at": "2026-10-07T10:12:00-04:00",
        "force_refreshed": false,
        "key_hash": "sha1:9c2e7d41b0a3f5e8c6d2b1a0f9e8d7c6b5a4f3e2",
        "status": "miss",
        "ttl_policy": "current_period_1h",
        "ttl_remaining_seconds": 3600
    },
    "calculation_note": "Les 2 comptes sont catégorisés Passif. Le compte réclamable agit comme contra-passif (réduit le passif net). Formule : net = balance(collect) + balance(claim).",
    "collected_account": {
        "category": {
            "code": "Cat_Liabilities",
            "id": 3,
            "label": "Compte de catégorie Passif"
        },
        "code": "2301",
        "current_balance": 8412.65,
        "description": "TPS à payer",
        "id": 234,
        "opening_balance": 6120.4,
        "ytd_movement": 2292.25
    },
    "currency": "CAD",
    "is_refund_expected": false,
    "label": "TPS",
    "metadata": {
        "data_freshness": "Seules les écritures transférées au grand livre sont comptées ; les écritures non transférées sont exclues.",
        "extracted_at": "2026-10-07T09:12:00-04:00",
        "limitations": [
            "Acomba ne conserve ni la fréquence ni la date des remises : la prochaine remise n'est pas calculée.",
            "Les taxes qui partagent la même paire de comptes forment une seule obligation (ex. TPS et TPS 50 %).",
            "Le signe de net_owed dépend de la catégorie des 2 comptes (voir calculation_note)."
        ],
        "organisation_id": "entreprise_exemple",
        "sdk_indexes_used": {
            "charter": 0,
            "tax": 1
        },
        "semantic_version": "v1-net",
        "skipped_obligations": []
    },
    "monthly_trend": [
        {
            "collected_movement": 1405.3,
            "is_empty": false,
            "net_period": 593.15,
            "period": 1,
            "reclaimed_movement": -812.15
        },
        {
            "collected_movement": 886.95,
            "is_empty": false,
            "net_period": 374.65,
            "period": 2,
            "reclaimed_movement": -512.3
        },
        {
            "collected_movement": 0,
            "is_empty": true,
            "net_period": 0,
            "period": 3,
            "reclaimed_movement": 0
        }
    ],
    "net_owed": 3102.45,
    "obligation_id": 234,
    "reclaimable_account": {
        "category": {
            "code": "Cat_Liabilities",
            "id": 3,
            "label": "Compte de catégorie Passif"
        },
        "code": "2302",
        "current_balance": -5310.2,
        "description": "TPS payée à récupérer",
        "id": 235,
        "opening_balance": -3985.75,
        "ytd_movement": -1324.45
    },
    "tax_registration_numbers": [
        "123456789RT0001"
    ],
    "taxes_contributing": [
        {
            "abbreviation": "TPS",
            "code": "T.P.S.",
            "credit_type": "all_accounts",
            "id": 1,
            "name": "Taxe sur les produits et services",
            "rate_pct": 5
        },
        {
            "abbreviation": "TPS 50",
            "code": "TPS 50%",
            "credit_type": "all_accounts",
            "id": 3,
            "name": "TPS — repas et représentation (50 %)",
            "rate_pct": 5
        }
    ]
}

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

Lister les taxes à remettre

Calculer les encaissements clients d'une période