> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/efalia-capture/installation/gestion-des-etiquettes-e-gov.md).

# Gestion des étiquettes pour Efalia Capture Server / e-gov

## À qui s'adresse ce document ?

Ce document est destiné aux **chefs de projet** en charge du déploiement d'Efalia Capture Server chez un client utilisant **e-gov**. Il explique comment fonctionne la numérisation automatique par étiquettes, et comment configurer correctement le serveur pour que les documents scannés arrivent automatiquement au bon endroit dans e-gov.

Aucune compétence de développeur n'est requise pour lire ce document. Les exemples techniques (API, JSON) sont fournis à titre de référence pour les équipes d'intégration.

## 1. Vue d'ensemble fonctionnelle

### Le problème que l'on résout

Dans un service courrier ou de numérisation, les agents reçoivent des documents papier qu'ils doivent scanner puis classer manuellement dans e-gov. Ce processus est répétitif et source d'erreurs.

**Efalia Capture Server** automatise cette étape : il surveille un dossier sur le serveur, analyse les documents scannés qui y arrivent, et les envoie automatiquement au bon dossier dans e-gov — sans intervention humaine après la numérisation.

### Comment cela fonctionne-t-il concrètement ?

Il existe **deux grandes méthodes** pour dire à Capture Server « ce document va dans tel dossier e-gov » :

| Méthode                        | Comment ça marche                                                                 | Qui fait le découpage |
| ------------------------------ | --------------------------------------------------------------------------------- | --------------------- |
| **Étiquettes** (Labels)        | On colle une étiquette physique sur la première page du document avant de scanner | Capture Server        |
| **Intercalaires** (Separators) | On insère une page spéciale entre les documents dans le bac du scanner            | e-gov                 |

{% hint style="info" %}
Dans la pratique, la méthode par étiquettes est la plus courante car elle ne nécessite pas de préparer le scanner d'une façon particulière. L'agent colle simplement une étiquette sur son document avant de le déposer dans le bac.
{% endhint %}

## 2. La méthode par étiquettes — Fonctionnement détaillé

### 2.1 Principe général

Une **étiquette** est un autocollant apposé sur la première page du document. Elle contient un code-barres ou un QR code que Capture Server sait lire. Ce code contient l'identifiant du dossier e-gov dans lequel le document doit être classé.

Lorsque Capture Server détecte une étiquette :

1. Il **découpe** le lot scanné en documents individuels (chaque étiquette = début d'un nouveau document)
2. Il **envoie** chaque document au bon dossier e-gov via l'API correspondante
3. La page portant l'étiquette est **conservée** dans le document final

### 2.2 Les deux types d'étiquettes

Depuis la version 1.2.0.11, Capture Server supporte **deux types d'étiquettes**, identifiés par le premier chiffre du code imprimé.

#### 🏷️ Type 3 — Ajout de pièce jointe à un dossier (`addAttachment`)

C'est le type historique. Le document scanné est **attaché à un dossier e-gov existant**.

Format du code : `3;XXX;ZZZZZZ`

| Composant | Signification                             | Exemple                  |
| --------- | ----------------------------------------- | ------------------------ |
| `3`       | Type d'étiquette (toujours 3 pour ce cas) | `3`                      |
| `XXX`     | Code environnement                        | `PROD`, `DEV`, `PREPROD` |
| `ZZZZZZ`  | Référence du dossier e-gov                | `2023-0000142`           |

Exemple d'étiquette valide : `3;PROD;2023-0000142` → le document sera attaché au dossier `2023-0000142` dans l'environnement de production.

#### 🏷️ Type 1 — Fusion avec un document existant (`mergeAttachment`)

Ce type est nouveau. Le document scanné vient **compléter un document déjà existant** dans e-gov (fusion de contenu).

Format du code : `1;XXX;YYYYY;ZZZZZZ`

| Composant | Signification                              | Exemple       |
| --------- | ------------------------------------------ | ------------- |
| `1`       | Type d'étiquette (toujours 1 pour ce cas)  | `1`           |
| `XXX`     | Code environnement (ignoré pour l'instant) | `PROD`        |
| `YYYYY`   | Identifiant du contenu cible dans e-gov    | `CNT-0042`    |
| `ZZZZZZ`  | Identifiant du dossier e-gov               | `DOSS-456789` |

Exemple d'étiquette valide : `1;PROD;CNT-0042;DOSS-456789` → le document sera fusionné avec le contenu `CNT-0042` dans le dossier `DOSS-456789`.

### 2.3 Règles de découpage

Capture Server analyse le lot scanné de haut en bas et applique les règles suivantes :

* **Une étiquette valide = début d'un nouveau document.** Toutes les pages qui suivent une étiquette appartiennent à ce document, jusqu'à la prochaine étiquette. La page portant l'étiquette est **incluse** dans le document envoyé.
* **Pages sans étiquette en début de lot** : si les premières pages du lot ne portent pas d'étiquette, elles ne sont pas envoyées (ou envoyées vers un dossier par défaut — à confirmer avec votre configuration).
* **Étiquette invalide ou illisible** : elle est **ignorée**, pas de découpage à cet endroit, la page est incorporée au document en cours, et un avertissement est enregistré dans les logs.

Illustration :

```mermaid
flowchart TB
    P1["Page 1<br/>3;PROD;DOSS-001"] --> DA["Début Document A"]
    P2["Page 2<br/>Suite du Document A"] --> DA
    P3["Page 3<br/>1;PROD;CNT-99;DOSS-002"] --> DB["Début Document B"]
    P4["Page 4<br/>Suite du Document B"] --> DB
    P5["Page 5<br/>ÉTIQUETTE INVALIDE"] -.->|Ignorée| DB
    P6["Page 6<br/>Suite du Document B"] --> DB
    P7["Page 7<br/>3;PROD;DOSS-003"] --> DC["Début Document C"]
```

Résultat :

* **Document A** (pages 1–2) → `addAttachment` → Dossier DOSS-001
* **Document B** (pages 3–6) → `mergeAttachment` → Contenu CNT-99 dans Dossier DOSS-002
* **Document C** (page 7) → `addAttachment` → Dossier DOSS-003

## 3. La méthode par intercalaires — Fonctionnement détaillé

### 3.1 Principe général

Les **intercalaires** sont des pages spéciales (imprimées à l'avance) insérées entre les documents dans le bac du scanner. Contrairement aux étiquettes, c'est **e-gov lui-même** qui analyse le lot et effectue le découpage. Capture Server se contente d'envoyer le PDF complet sans traitement.

Les pages intercalaires sont **supprimées** du document final par e-gov.

### 3.2 Quand utiliser les intercalaires plutôt que les étiquettes ?

| Situation                                                                 | Méthode recommandée |
| ------------------------------------------------------------------------- | ------------------- |
| Documents avec pages multiples, agents équipés d'imprimantes d'étiquettes | ✅ Étiquettes        |
| Numérisation en masse avec tri géré côté e-gov                            | ✅ Intercalaires     |
| Client déjà équipé avec des intercalaires pré-imprimés                    | ✅ Intercalaires     |

## 4. Configuration de Capture Server

### 4.1 Vue d'ensemble du fichier settings.json

Toute la configuration se fait dans le fichier `settings.json` installé sur le serveur Capture Server (voir [Installation d'Efalia Capture Server](https://documentation.efalia.com/produit/efalia-capture/installation/installation-capture-server.md)).

**Le paramètre `Mode`** indique à Capture Server quel type de système GED il doit piloter :

| Valeur   | Signification                                           |
| -------- | ------------------------------------------------------- |
| `Off`    | Cette section est désactivée                            |
| `Doc`    | Connexion à **Efalia Doc**                              |
| `Gov`    | Connexion à **e-gov**                                   |
| `Folder` | Export des emails dans un dossier Windows au format EML |

{% hint style="warning" %}
Les valeurs ne sont pas sensibles à la casse (`Gov`, `GOV` et `gov` sont équivalents). Plusieurs modes peuvent coexister dans le même fichier de configuration.
{% endhint %}

**Le paramètre `KeepLabels`** fait la différence entre un mode Doc et un mode Gov à l'exécution :

| Valeur  | Comportement                                                                   |
| ------- | ------------------------------------------------------------------------------ |
| `true`  | Mode étiquettes actif — Capture Server analyse et découpe selon les étiquettes |
| `false` | Mode intercalaires — Capture Server envoie le lot complet sans découpage       |

{% hint style="info" %}
Pour la gestion des étiquettes (types 1 et 3), `KeepLabels` doit toujours être à `true`.
{% endhint %}

**Le paramètre `Interval`** : durée en secondes entre deux passages de Capture Server sur les dossiers surveillés. Exemple : `"Interval": 30` → Capture Server vérifie toutes les 30 secondes si de nouveaux documents sont arrivés.

### 4.2 Exemple de configuration complet — Mode étiquettes e-gov

```json
{
  "Mode": "Gov",
  "KeepLabels": true,
  "Interval": 30,
  "labels": {
    "enabled": true,
    "folder_path": "/watch/labels/"
  },
  "api": {
    "base_url": "https://votre-instance.6tzen.fr/votre-collectivite/admimail",
    "addAttachment_endpoint": "/serverSide/api/addAttachment",
    "mergeAttachment_endpoint": "/serverSide/api/mergeAttachment",
    "api_key": "VOTRE_CLE_API",
    "document_code": "_attachment"
  }
}
```

### 4.3 Exemple de configuration complet — Mode intercalaires e-gov

```json
{
  "Mode": "Gov",
  "KeepLabels": false,
  "Interval": 30,
  "separators": {
    "enabled": true,
    "folder_path": "/watch/separators/"
  },
  "api": {
    "base_url": "https://votre-instance.6tzen.fr/votre-collectivite/admimail",
    "massScan_endpoint": "/serverSide/api/massScan",
    "api_key": "VOTRE_CLE_API"
  },
  "egov_config": {
    "defaults": {
      "nature": "INCOMING_MAIL",
      "owner": "GENERAL_SERVICES"
    }
  }
}
```

## 5. Authentification

Capture Server s'authentifie auprès de e-gov via une **clé API** (chaîne de caractères statique transmise dans l'en-tête HTTP de chaque requête).

Ce qu'il faut récupérer auprès de l'équipe e-gov / du client :

* L'URL de base de l'instance e-gov (`base_url`)
* La clé API (`X-API-KEY`) — peut être différente selon l'environnement (DEV / PREPROD / PROD)

{% hint style="info" %}
La clé API est configurée une seule fois dans le fichier `settings.json` et reste statique. Il n'y a pas de mécanisme d'expiration automatique, mais il est recommandé de demander une clé dédiée par environnement.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/efalia-capture/installation/gestion-des-etiquettes-e-gov.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
