Impots.gouv

You can use Impots.gouv provider to fetch financial information (tax returns, tax return analysis and vat declaration) 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.

info

This provider is available only for French users

Link your user Impots.gouv account to Qard API:

To retrieve your user financial data, you will have to:

1. Enable Impots.gouv provider:

(PUT) /api/v6/providers/impots_gouv

{
  "enable": true
}

2. Create a data connection:

(POST) /api/v6/users/{userId}/data-connections

{
  "provider_name": "impots_gouv",
  "requested_data_types": [
    "TAX_RETURN",
    "TAX_RETURN_ANALYSIS",
    "VAT_DECLARATION"
    "CORPORATE_TAX"
  ]
}

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.

(POST) /api/v6/users/{userId}/sync

{
  "data_types": ["TAX_RETURN", "TAX_RETURN_ANALYSIS", "VAT_DECLARATION", "CORPORATE_TAX"]
}

To verify that you are receiving your user's financial data, check out these endpoints:

• GET /api/v6/users/{userId}/tax-returns
• GET /api/v6/users/{userId}/tax-returns/{taxReturnId}
• GET /api/v6/users/{userId}/tax-return-analysis
• GET /api/v6/users/{userId}/vat-declarations
• GET /api/v6/users/{userId}/vat-declarations/{vatDeclarationId}
• GET /api/v6/users/{userId}/corporate-taxes
• GET /api/v6/users/{userId}/corporate-taxes/{corporateTaxId}