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.

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. Settings Impots.gouv provider:

(PUT) /api/v6/providers/impots_gouv/settings

{
  "auto_connect": true
}

3. 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",
    "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.

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

{
  "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:

• 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}
• GET /api/v6/users/{userId}/tax-clearance-certificate
• GET /api/v6/users/{userId}/tax-accounts