Création et mise à jour du dossier fiscal d'une société (dossier de production)

Avec ce guide, vous allez être accompagné afin de créer et/ou mettre à jour le dossier fiscal d'une société.

Dans MyUnisoft, la gestion du dossier fiscal s'effectue avec le module CRM : Ecosystème > CRM > Entreprises.

Sélectionnez le dossier de production sur lequel vous souhaitez intervenir (une option de recherche rapide est disponible).

Vous obtenez les différents onglets de l'entreprise interrogée. Cliquez sur Dossier fiscal pour accéder à celui-ci.

API

La route https://api.myunisoft.fr/api/v1/society/fiscal_file permet d'ajouter et/ou mettre à jour des informations au dossier fiscal via l'API partenaire.

IMPORTANT

🔹 Accès cabinet : L'accès cabinet nécessitera la présence de l'en-tête HTTP society-id avec l'id du dossier de production.

curl --location 'https://api.myunisoft.fr/api/v1/society/fiscal_file' \
--header 'X-Third-Party-Secret: nompartenaire-L8vlKfjJ5y7zwFj2J49xo53V' \
--header 'Society-id: 1;' \
--header 'Authorization: Bearer {{API_TOKEN}}' \
--data '{
  "rof_tva": "TVA1",
  "rof_tdfc": "IS1",
  "rof_cfe": "CFE1",
  "rof_cvae": "CVAE1",
  "rof_rcm": "RCM1",
  ...
}'

En fonction des éléments que vous aurez renseigné dans le body de la requête, l'API vous retournera une réponse au format JSON :

Exemple de retour JSON de l'API

{
  "rof_tva": "TVA1",
  "rof_tdfc": "IS1",
  "rof_cfe": "CFE1",
  "rof_cvae": "CVAE1",
  "rof_rcm": "RCM1",
  "rof_groupe": "",
  "acompte_pro_mens": false,
  "exercice_declaration": false,
  "efi_declaration": false,
  "is_agricole": false,
  "tva_intraco": "FR45530514157",
  "due_date_tva": 21,
  "adherent_code": "",
  "mono_etab": false,
  "close_entries_VAT": false,
  "mail_liasse": "",
  "fiscal_integration": false,
  "head_group_if": false,
  "start_date_if": "",
  "end_date_if": "",
  "adv_legal_form_id": "SARL",
  "adv_name": "Groupe conseil",
  "adv_name_2": "",
  "adv_phone_number": "+33112134567",
  "adv_address_number": "10",
  "adv_street_name": "du Boulevard",
  "adv_postal_code": "75000",
  "adv_city": "PARIS",
  "adv_country": "FRANCE",
  "ecf_legal_form_id": "EURL",
  "ecf_siren": "",
  "ecf_name": "Prestataire",
  "ecf_name_2": "",
  "ecf_address_number": "",
  "ecf_street_name": "de la corniche",
  "ecf_postal_code": "75000",
  "ecf_city": "PARIS",
  "ecf_country": "FRANCE",
  "sie_address_number": "8",
  "sie_street_name": "de l'impasse",
  "sie_name": "SIE de Paris",
  "sie_postal_code": "75000",
  "sie_city": "PARIS",
  "sie_country": "FRANCE",
  "vis_name": "",
  "vis_agreement_number": "",
  "vis_viseur": true,
  "vis_state": "VIS",
  "vis_address_number": "",
  "vis_street_name": "",
  "vis_postal_code": "",
  "vis_city": "",
  "vis_country": "",
  "id_pers_physique": null,
  "id_societe_signataire": null,
  "id_societe_comptable": null,
  "fiscal_decl_by_firm": true,
  "id_comptable": 0,
  "assujetti_unique": false,
  "siren_assujetti_unique": "",
  "rof_ts": "",
  "periodicity_ts": 0,
  "holding_name": "",
  "adv_forme_juridique": {
    "id": 1,
    "code": "SARL",
    "label": "Société à Responsabilité Limitée",
    "code_edi": "SRL"
  },
  "ecf_forme_juridique": {
    "id": 4,
    "code": "EURL",
    "label": "Entreprise Unipersonnelle à Responsabilité Limitée",
    "code_edi": "ERL"
  },
  "adv_road_type": {
    "id": 1,
    "label": "Allée",
    "value": "Allée"
  },
  "ecf_road_type": {
    "id": 3,
    "label": "Boulevard",
    "value": "Boulevard"
  },
  "sie_road_type": {
    "id": 2,
    "label": "Avenue",
    "value": "Avenue"
  },
  "sheet_group": {
    "id": 2,
    "label": "IS-BIC-Normal",
    "value": "ISBICN",
    "id_bilan": 1,
    "regime_impot": true,
    "id_regime_impot": 1
  },
  "vat_regime": {
    "id": 4,
    "label": "Réel Normal Mensuel",
    "value": "M"
  },
  "gestion_center": {
    "id": 7,
    "label": "CGA83",
    "value": "CGA83"
  },
  "info_bnc": {
    "info_bnc_id": 1982,
    "membership_year": null,
    "activity_code_pm": null
  },
  "society_status": {
    "id": 1,
    "label": "En activité",
    "value": "En activité",
    "effective_date": "2023-09-14"
  }
}

La route attend un body au format JSON composé de propriétés de l'interface suivante :

Interface TypeScript FiscalFile

export interface FiscalFile {
  rof_tva: string,
  rof_tdfc: string,
  rof_cfe: string,
  rof_cvae: string,
  rof_rcm: string,
  rof_groupe: string,
  acompte_pro_mens: boolean,
  exercice_declaration: boolean,
  efi_declaration: boolean,
  is_agricole: boolean,
  tva_intraco: string,
  due_date_tva: number,
  adherent_code: string,
  mono_etab: boolean,
  close_entries_VAT: boolean,
  mail_liasse: string,
  fiscal_integration: boolean,
  head_group_if: boolean,
  start_date_if: string,
  end_date_if: string,
  adv_forme_juridique_id: number,
  adv_name: string,
  adv_name_2: string,
  adv_phone_number: string,
  adv_address_number: string,
  adv_street_name: string,
  adv_postal_code: string,
  adv_city: string,
  adv_country: string,
  ecf_forme_juridique_id: number,
  ecf_siren: string,
  ecf_name: string,
  ecf_name_2: string,
  ecf_address_number: string,
  ecf_street_name: string,
  ecf_postal_code: string,
  ecf_city: string,
  ecf_country: string,
  sie_address_number: string,
  sie_street_name: string,
  sie_name: string,
  sie_postal_code: string,
  sie_city: string,
  sie_country: string,
  vis_name: string,
  vis_agreement_number: string,
  vis_viseur: boolean,
  vis_state: "OG" | "VIS" | null,
  vis_address_number: string,
  vis_street_name: string,
  vis_postal_code: string,
  vis_city: string,
  vis_country: string,
  id_pers_physique: number,
  id_societe_signataire: number,
  id_societe_comptable: number,
  fiscal_decl_by_firm: boolean,
  id_comptable: number,
  assujetti_unique: boolean,
  siren_assujetti_unique: string,
  rof_ts: string,
  periodicity_ts: number,
  holding_name: string,
  adv_road_type_id: number,
  sie_road_type_id: number,
  ecf_road_type_id: number,
  vis_road_type_id: number,
  id_sheet_group: number,
  vat_regime_id: number,
  gestion_center_id: number,
  account_edi_id: number,
  info_bnc: {
    membership_year: string,
    activity_code_pm: string,
    comptability_held_id: number
  },
  society_status: {
    id: number,
    effective_date: string
  }
}

Voici quelques détails concernant certaines propriétés spécifiques et les moyens pour récupérer leurs valeurs applicables :

• id_pers_physique / id_comptable : dans le dossier fiscal la personne physique est nécessaire pour définir le signataire ou le comptable. Pour récupérer la liste des personnes physiques et leur id, vous pouvez consulter la section de la page Récupérer les utilisateurs et personnes physiques d'un schema.

• id_societe_signataire / id_societe_comptable : il s'agit des id du signataire et/ou comptable mais étant des personnes morales. Pour récupérer la liste des sociétés et leur id, vous pouvez consulter la page Récupérer les dossiers de productions (entreprises).

• gestion_center_id : la liste des centres de gestion est récupérable via l'API sur la page Récupérer la liste des centre de gestion.

• account_edi_id : il est nécessaire de préciser l'id du compte d'envoi EDI. Pour récupérer cette liste, vous trouverez un guide sur cette page.

• adv_road_type_id / sie_road_type_id / ecf_road_type_id / vis_road_type_id : ces propriétés correspondent aux types de voies dans les adresses des "conseils", "SIE", "ECF" et "viseurs conventionnés". La liste des types de voies est consultable sur cette page.

• vat_regime_id correspond à l'id d'un des régimes de tva applicables. La liste des régimes de tva est disponible sur cette page.

• id_sheet_group : il s'agit du régime fiscal d'imposition. La liste complète de ces régimes fiscaux est disponible sur cette page.

• society_status Il s'agit du statut d'activité de la société. Pour le paramétrer il est nécessaire de fournir une date effective_date (format YYYY-MM-DD) ainsi que l'id de l'un des différents statuts disponibles dont la liste est sur cette page.

• comptability_held_id : pour certains régimes d'imposition (ex: BNC) il est nécessaire de spécifier l'id du type de tenue comptable. Leur liste est disponibles sur cette page.

• periodicity_ts est la périodicité choisie pour la taxe sur les salaires lorsque la société est soumise. Il existe 3 valeurs applicables :

  valeur	correspondance
  0	"Non concerné"
  1	"Mensuel"
  2	"Trimestriel"

Intervenants (Organisme de Gestion / Viseur conventionné)

L'état de l'intervenant du dossier fiscal est défini via la propriété vis_state. Les valeurs acceptées sont :

Valeur	Correspondance
null	Non concerné
"OG"	Organisme de Gestion
"VIS"	Viseur conventionné

En fonction de la valeur de vis_state, des champs conditionnels peuvent/doivent être renseignés dans le body :

• Si vis_state est égal à "OG" :

  Propriété	Type	Description
  gestion_center_id	number	Centre de gestion (liste récupérable sur cette page).
  adherent_code	string	Code adhérent.

• Si vis_state est égal à "VIS" :

  Propriété	Type	Description
  vis_name	string	Désignation.
  vis_agreement_number	string	Numéro d'agrément.
  vis_address_number	string	Numéro de voie.
  vis_road_type_id	number	Type de voie (liste récupérable sur cette page).
  vis_street_name	string	Nom de la voie.
  vis_postal_code	string	Code postal.
  vis_city	string	Ville.
  vis_country	string	Pays.

Exemple de payload — Organisme de Gestion (OG)

{
  "vis_state": "OG",
  "gestion_center_id": 105,
  "adherent_code": "ADH-9876"
}

Exemple de payload — Viseur conventionné (VIS)

{
  "vis_state": "VIS",
  "vis_agreement_number": "AGR123456",
  "vis_name": "Cabinet Dupont",
  "vis_address_number": "12",
  "vis_road_type_id": 4,
  "vis_street_name": "Rue de la République",
  "vis_postal_code": "75001",
  "vis_city": "Paris",
  "vis_country": "France"
}

Paramètres spécifiques aux régimes de TVA

Le régime de TVA de la société est défini via la propriété vat_regime_id (voir la liste des régimes sur cette page). En fonction du régime sélectionné, les paramètres suivants peuvent être renseignés dans le body :

• acompte_pro_mens (boolean) : acomptes provisionnels mensuels.
• assujetti_unique (boolean) : assujetti unique.
• close_entries_VAT (boolean) : validation des écritures suite à l'envoi EDI TVA.
• efi_declaration (boolean) : déclarations réalisées en EFI.
• is_agricole (boolean) : régime agricole.
• exercice_declaration (boolean) : déclaration annuelle sur l'exercice comptable.
• tva_intraco (string) : n° de TVA intracommunautaire.
• due_date_tva (number) : jour d'échéance de la TVA.

Le tableau ci-dessous indique les paramètres applicables pour chaque régime de TVA :

Régime de TVA	Paramètres applicables
Réel normal mensuel	acompte_pro_mens, assujetti_unique, close_entries_VAT, efi_declaration, tva_intraco, due_date_tva
Réel normal trimestriel	is_agricole, close_entries_VAT, efi_declaration, tva_intraco, due_date_tva
Réel simplifié	close_entries_VAT, efi_declaration, tva_intraco, due_date_tva
Réel simplifié agricole	exercice_declaration, close_entries_VAT, efi_declaration, tva_intraco, due_date_tva
Franchise	close_entries_VAT, efi_declaration, tva_intraco, due_date_tva
Non assujetti	close_entries_VAT, efi_declaration, tva_intraco, due_date_tva

(retour en haut de page)