Tax Return

Tax returns for the purposes of this api are the annual accounts filled for the sake of tax declarations, and numerical data about its contents is available.

The tax return history is independent of the current month history setting, except when synchronization is triggered using the Infogreffe or impots-gouv providers.

Tax Return

Field	Type	Description
id	uuid	Unique identifier (UUID)
type	string	Different annual accounts types ("C" for Complete, "K" for Consolidated, "S" for Simplified, ...)
closing_year	year	Year on which the fiscal year ended
closing_date	date	Date on which the fiscal year ended
millesime	year	The tax return vintage refers to the reference year for which tax data is reported or processed.
duration	int	Duration, in months, of the fiscal year
submitted_date	date	Date on which the tax return was submitted
revenue	int	Revenues recorded on the declaration
net_profit	int	Net profit recorded on the declaration
file_id	string	see Download
provider_name	string	Provider from which this tax return was obtained
data_connection_id	uuid	Data connection from which this tax return was obtained
warnings	array of Tax return values	List of completeness and consistency tests that failed.
tax_return_values	array of Tax return values	Tax return values object

Tax return values

Field	Type	Description
code	string	Code of the cell(s) in the tax return
values	array of ints	Value of the cell(s) in the tax return

Please find below the doc organising the data according to the type of the tax return and the code of the cells. The doc is according to the INPI version, for the tax values please check from page 9 to 29. Document Technique Comptes annuels

Tax return warnings

note

Tax return warnings are applied to tax returns with a closing year from 2022 onward.

Field	Type	Description
code	string	Error test(completeness/consistency) code
message	string	Error test(completeness/consistency) message

List of completeness tests

Code	Message
01	Absence BILAN- Actif - 2050-SD
02	Absence BILAN-Passif - 2051-SD
03	Absence COMPTE DE RESULTAT - 2052-SD
04	Absence COMPTE DE RESULTAT - 2053-SD
05	Absence tableaux des immobilisations - 2054 SD
06	Absence tableaux des amortissements - 2055 SD

Code	Message
07	Absence de BILAN - 2033-A-SD
08	Absence de compte de résultat - 2033-B-SD
09	Absence d'immobilisations 2033-C-SD

List of consistency tests

Code	Message
11	Controle total actif immobilisé Brut - BILAN- Actif - 2050-SD
12	Controle total actif immobilisé Amortissements, provisions - BILAN- Actif - 2050-SD
13	Controle total actif immobilisé Net - BILAN- Actif - 2050-SD
15	Controle total actif circulant Brut - BILAN- Actif - 2050-SD
16	Controle total actif circulant Amortissements, provisions - BILAN- Actif - 2050-SD
17	Controle total actif circulant Net - BILAN- Actif - 2050-SD
18	Controle total général Bilan Brut - BILAN- Actif - 2050-SD
19	Controle total général Bilan Amortissement, provisions - BILAN- Actif - 2050-SD
20	Controle total général Bilan Net - BILAN- Actif - 2050-SD
21	Controle total capitaux propres - BILAN-Passif - 2051-SD
22	Controle total autres fonds propres - BILAN-Passif - 2051-SD
24	Controle total dettes - BILAN-Passif - 2051-SD
25	Controle total general - BILAN-Passif - 2051-SD
26	Controle ACTIF= PASSIF
27	Controle chiffre d'affaire 1 - COMPTE DE RESULTAT - 2052-SD
29	Controle total produits d'exploitation - COMPTE DE RESULTAT - 2052-SD
30	Controle total charges d'exploitation - COMPTE DE RESULTAT - 2052-SD
31	Controle resultat d'exploitation - COMPTE DE RESULTAT - 2052-SD
32	Controle total produits financiers - COMPTE DE RESULTAT - 2052-SD
33	Controle total charges financieres - COMPTE DE RESULTAT - 2052-SD
34	Controle resultat financier - COMPTE DE RESULTAT - 2052-SD
35	Controle total resultat - COMPTE DE RESULTAT - 2052-SD
36	Controle total produits exceptionnels - COMPTE DE RESULTAT - 2053-SD
37	Controle total charges exceptionnels - COMPTE DE RESULTAT - 2053-SD
38	Controle résultat exceptionnel - COMPTE DE RESULTAT - 2053-SD
39	Controle total des produits - COMPTE DE RESULTAT - 2053-SD
40	Controle total des charges - COMPTE DE RESULTAT - 2053-SD
41	Controle bénéfice ou perte - COMPTE DE RESULTAT - 2053-SD
56	Controle total general immobilisation valeur brute début d'exercice - IMMOBLISATIONS - 2054-SD
57	Controle total general immobilisation augmentation - réécal/mise en équival - IMMOBLISATIONS - 2054-SD
58	Controle total general immobilisation augmentation - acquisitions, création etc. - IMMOBLISATIONS - 2054-SD
60	Controle total general immobilisation diminutions - virement de p à p - IMMOBLISATIONS - 2054-SD
61	Controle total general immobilisation diminutions - cessation riers/ mise HS… - IMMOBLISATIONS - 2054-SD

Code	Message
75	Controle Total Actif immobilisé BRUT - Bilan simplifié - 2033-A-SD
76	Controle Total Amortissement - Provisions Actif immobilisé - Bilan simplifié - 2033-A-SD
77	Controle Total actif circulant BRUT - Bilan simplifié - 2033-A-SD
78	Controle Total amortissement actif circulant - Bilan simplifié - 2033-A-SD
79	Controle total Actif immobilisé + Actif circulant - Bilan simplifié - 2033-A-SD
80	Controle total amortissement Actif immobilisé + actif circulant - Bilan simplifié - 2033-A-SD
81	Controle total diff actif Brut - Net - Bilan simplifié - 2033-A-SD
82	Controle totaux capitaux propre, provision pour risques et chages, dettes - Bilan simplifié - 2033-A-SD
84	Controle total produit d'exploitation - Comptes de résultat 2033-B-SD
85	Controle total charges d'exploitation - Comptes de résultat 2033-B-SD
86	Controle resultat d'exploitation - Comptes de résultat 2033-B-SD
87	Controle bénéfices ou pertes - Comptes de résultat 2033-B-SD