> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chift.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# DATEV (LocalAgent)

Ce guide explique comment activer votre connexion à DATEV en utilisant l'API DATEVConnect locale via un agent local installé sur votre machine. Cette méthode ne nécessite pas d'exposer d'URL, ce qui est une opération que seul votre intégrateur peut techniquement réaliser — et qu'il peut dans certains cas refuser.

Si vous préférez ne pas utiliser l'installation du Local Agent, et que votre intégrateur accepte d'exposer l'URL, vous pouvez procéder à la configuration alternative. Dans ce cas, veuillez contacter votre fournisseur de logiciel afin d'être orienté vers les instructions appropriées.

La méthode alternative est expliquée dans un article distinct [**ici**](/fr/help/connectors/8019)

***

## 📋 Vue d'ensemble

Cette intégration se connecte à deux composants DATEV :

* **DATEV Rechnungswesen** – Logiciel de comptabilité on-premise (source de données principale)
* **DATEV Unternehmen Online (DUO)** – Portail cloud utilisé uniquement pour envoyer des pièces jointes telles que des documents, factures ou reçus

  Si vous ne prévoyez pas d'envoyer de pièces jointes, DUO n'est pas nécessaire.

**Cette connexion nécessite l'installation d'un Local Agent** sur le serveur où DATEV est exécuté.

⏱ **Temps estimé** : 5 minutes pour une installation complète.

> (*Assurez-vous de vérifier que votre système remplit toutes les conditions listées dans la section* ***Prérequis*** *ci-dessous* 👇 *)*

***

# 🚨PRÉREQUIS **(conditions à remplir** avant la connexion\*\*)\*\*

### 1. Licences

| | |
| - | - |
| Licences | Description des exigences |
| **Licence DATEV Rechnungswesen** | Obligatoire. Détenue soit par votre entreprise, soit fournie par votre comptable/conseiller fiscal. |
| **Licence DATEVConnect** | Obligatoire. Permet l'accès à l'API. Généralement déjà incluse dans les installations DATEV, mais doit être activée. Si elle est absente, vous pouvez la commander (gratuitement) via la boutique DATEV. |
| **Licence DATEV Unternehmen Online (DUO)** | Requise uniquement si des pièces jointes (PDF, factures, reçus) doivent être envoyées à DATEV. |

**Comment vérifier les licences :**

* Dans DATEV Arbeitsplatz, allez dans **Gestion des licences (Lizenzverwaltung)** pour consulter les licences installées.
* Ou demandez confirmation à votre administrateur DATEV, votre comptable (Steuerberater) ou votre partenaire de service DATEV.

***

### 2. Exigences relatives au compte utilisateur

Vous devez fournir le **nom d'utilisateur et le mot de passe Windows** d'un compte utilisateur Windows qui est **lié à un utilisateur DATEV** disposant des autorisations suivantes :

✔ Accès au **mandat/à l'entreprise** concerné(e) dans DATEV Rechnungswesen\
✔ Droits d'utilisation du **service DATEVConnect**\
✔ Droits suffisants pour lire/écrire les données comptables (selon le périmètre de l'intégration)

DATEV exige que l'authentification à l'API soit réalisée via une connexion Windows associée à un compte utilisateur DATEV. Cette association se configure dans DATEV Benutzerverwaltung (Gestion des utilisateurs).

# ⚡️ CONNEXION

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-1.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=d2221c6f2449dfc1e1b24f42ed735618" alt="image.png" width="938" height="1224" data-path="images/help/datev-localagent/datev-localagent-1.png" />

**Étape 1 :** Choisissez un nom pour votre connexion (si le champ du nom de connexion n'est pas visible, passez simplement cette étape et continuez)

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-2.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=77fa7e0477e2671b13c55f8378923423" alt="image.png" width="878" height="172" data-path="images/help/datev-localagent/datev-localagent-2.png" />

**Étape 2 :** Choisissez si vous souhaitez envoyer des pièces jointes

Si vous ne voyez pas cette option, cela signifie que votre fournisseur de logiciel a préconfiguré ce paramètre pour vous.

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-3.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=3b8e7ad53b427fbb8c081193a182702e" alt="image.png" width="866" height="356" data-path="images/help/datev-localagent/datev-localagent-3.png" />

* Si votre intégration doit envoyer des factures PDF, des reçus ou des documents justificatifs à DATEV, sélectionnez **Oui** pour activer les pièces jointes.
* Cela nécessite une licence **DATEV Unternehmen Online** valide (voir ci-dessus dans la section prérequis)

**Étape 3** : Saisissez votre **numéro de conseiller** et votre **numéro de client**.

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-4.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=7c0b82e74315103516aff701ac751d1c" alt="image.png" width="848" height="266" data-path="images/help/datev-localagent/datev-localagent-4.png" />

Saisissez votre **numéro de conseiller** et votre **numéro de client**.

Où les trouver ? 👇

* Rendez-vous sur la page de connexion DUO
* Cliquez sur **Afficher l'aperçu des documents**
* Les numéros sont affichés à droite, sous *Paramètres* :

  * Premier numéro = Numéro de conseiller (5696507 dans l'exemple)
  * Deuxième numéro = Numéro de client (55003 dans l'exemple)

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-5.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=7d7df38def8968e96fa54474a3e5323f" alt="image.png" width="1497" height="292" data-path="images/help/datev-localagent/datev-localagent-5.png" />

**Étape 4** : Renseignez votre utilisateur et mot de passe Windows liés au compte DATEV

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-6.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=c1f72dc3b0e32f91b7b5247377ad7cd1" alt="image.png" width="842" height="328" data-path="images/help/datev-localagent/datev-localagent-6.png" />

Saisissez le nom d'utilisateur et le mot de passe Windows **de l'utilisateur lié au compte DATEV**, comme décrit dans les prérequis.

**Étape 5 :** Cliquez sur « Autoriser » pour finaliser la connexion.

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-7.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=7ec09aff0c07090fe38cb52a1279c89b" alt="" width="118" height="47" data-path="images/help/datev-localagent/datev-localagent-7.png" />

Une fois que vous avez cliqué, une nouvelle fenêtre s'ouvrira pour choisir comment vous souhaitez recevoir l'installateur à installer sur votre machine DATEV. L'installation prend 1 min et est expliquée dans la section suivante

# 💿 INSTALLATION

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-8.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=69456b4c46230c7caeb263719ce3faee" alt="image.png" width="920" height="580" data-path="images/help/datev-localagent/datev-localagent-8.png" />

Vous avez deux options pour télécharger et installer l'agent local sur le même serveur que votre instance DATEV :

* Si DATEV est hébergé sur votre ordinateur, vous pouvez télécharger directement le programme en cliquant sur **Télécharger**.
* Si DATEV est hébergé sur un autre serveur, vous avez la possibilité d'envoyer le programme par e-mail (par exemple à la personne ou à l'entreprise qui héberge DATEV afin qu'elle puisse le télécharger et l'installer).

**Étape 1 :** Vous disposez du fichier nommé : « Setup.zip ». Extrayez le fichier dans un dossier « Setup » (clic droit, puis Extraire tout). Il est important d'extraire d'abord le zip avant de double-cliquer dessus.

**Étape 2 :** Ouvrez le dossier « Setup ». Le dossier doit contenir deux fichiers :

* settings.json : vous n'avez pas besoin de modifier ce fichier, il contient les identifiants nécessaires pour établir le pont avec DATEV
* SetupLocalAPIService.exe : c'est le fichier dont nous avons besoin pour réaliser l'installation

**Étape 3 :** Double-cliquez sur « SetupLocalAPIService.exe » pour démarrer l'installation. Pour terminer l'installation, vous devez suivre chaque étape :

* Sélectionnez la langue de l'écran d'installation

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-9.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=ee8c35302953a34cc40a97f2d3c8dedd" alt="" width="352" height="216" data-path="images/help/datev-localagent/datev-localagent-9.png" />

* Sélectionnez le type d'installation : l'« installation standard » est recommandée

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-10.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=2dbfbdefb51f5085b7d489bbe7bddc30" alt="" width="591" height="493" data-path="images/help/datev-localagent/datev-localagent-10.png" />

* À cette étape, il est important de sélectionner le settings.json extrait du fichier téléchargé. Par défaut, ce fichier devrait déjà être sélectionné.

<img src="https://mintcdn.com/chift/mXkRBMOfb3yzCUyf/images/help/datev-localagent/datev-localagent-11.png?fit=max&auto=format&n=mXkRBMOfb3yzCUyf&q=85&s=41e96a546a94691121da82243183da02" alt="" width="592" height="501" data-path="images/help/datev-localagent/datev-localagent-11.png" />

Poursuivez les différentes étapes jusqu'à obtenir un message indiquant que l'installation a réussi

Une fois terminé, **votre connexion à DATEV sera pleinement active**. 🎉 🕺

# VÉRIFICATION

Comment vérifier que le service a été correctement installé ?

**Étape 1 :** Ouvrez le menu de l'explorateur et recherchez « Services »

**Étape 2 :** Ouvrez « Services »

**Étape 3 :** Une nouvelle fenêtre s'ouvrira avec une liste de services. Vous devriez trouver dans cette liste un service appelé « LocalAPIService » avec le statut « En cours d'exécution ». Si c'est le cas, vous avez réussi la connexion avec DATEV.
