Impots.gouv
You can use Impots.gouv provider to fetch financial information (tax returns, tax return analysis, vat declaration and tax clearance certificate) from your users financial accounts.
This provider supports these data types:
- Tax return: to retrieve a list of user tax returns.
- Tax return analysis (Insight): to retrieve a tax return analysis.
- Vat declaration: to retrieve a list of user vat declarations.
- Corporate tax: to retrieve a list of user corporate taxes.
- Tax clearance certificate: to retrieve a tax clearance certificate.
- Tax account: to retrieve a list of user tax accounts.
This provider is available only for French users
impots.gouv also lists the result declarations a company files for less than a month, typically on the day it sells
or closes a business during the year. They are kept as
partial-period tax returns, returned by GET /tax-returns only
with ?include_partial_periods=true.
Link your user Impots.gouv account to Qard API:
To retrieve your user financial data, you will have to:
1. Enable Impots.gouv provider:
{
"enable": true
}
2. Settings Impots.gouv provider:
{
"auto_connect": true
}
3. Create a data connection:
{
"provider_name": "impots_gouv",
"requested_data_types": [
"TAX_RETURN",
"TAX_RETURN_ANALYSIS",
"VAT_DECLARATION",
"CORPORATE_TAX",
"TAX_CLEARANCE_CERTIFICATE",
"TAX_ACCOUNT"
]
}
3. Create a synchronization
After finishing the connecting process by your user, and after validating that the data connection status is CONNECTED, you can run a new synchronization.
{
"data_types": ["TAX_RETURN", "TAX_RETURN_ANALYSIS", "VAT_DECLARATION", "CORPORATE_TAX", "TAX_CLEARANCE_CERTIFICATE", "TAX_ACCOUNT"]
}
To verify that you are receiving your user's financial data, check out these endpoints:
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v6/users/{userId}/tax-returns | Tax returns |
| GET | /api/v6/users/{userId}/tax-returns/{taxReturnId} | Single tax return |
| GET | /api/v6/users/{userId}/tax-return-analysis | Tax return analysis |
| GET | /api/v6/users/{userId}/vat-declarations | VAT declarations |
| GET | /api/v6/users/{userId}/vat-declarations/{vatDeclarationId} | Specific VAT declaration |
| GET | /api/v6/users/{userId}/corporate-taxes | Corporate taxes |
| GET | /api/v6/users/{userId}/corporate-taxes/{corporateTaxId} | Specific corporate tax filing |
| GET | /api/v6/users/{userId}/tax-clearance-certificate | Tax clearance certificate |
| GET | /api/v6/users/{userId}/tax-accounts | Tax accounts |