> 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/configuration-liens-numerisation-qg.md).

# Configuration des liens de numérisation dans Efalia Doc (via le QG)

{% hint style="info" %}
Cette page décrit la configuration de Capture Front (client de numérisation) dans Efalia Doc. À utiliser par les équipes d'intégration lors d'un déploiement chez un client, après avoir déployé le client Efalia Capture Front (voir [Installation d'Efalia Capture module Front](https://documentation.efalia.com/produit/efalia-capture/installation/installation-capture-front.md) et [Choisir le bon module](https://documentation.efalia.com/produit/efalia-capture/vue-densemble/choisir-le-bon-module.md) pour le choix ClickOnce/MSI).
{% endhint %}

Après déploiement du client Efalia Capture Front, il faut configurer les liens de numérisation dans le **QG (General Quarter)** — le back-office Efalia. Efalia Doc propose deux boutons configurables :

* **Bouton « Numériser »** : numérisation simple, envoi direct en bannette
* **Bouton « Numériser avec code-barres »** : numérisation avec détection de QR codes pour séparation et classement automatique

## Procédure dans le QG

{% stepper %}
{% step %}

### Se connecter au QG

<https://qg.efalia.com/login>

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-3c2fbda631d8ac0ce577d8b95d8c6c95925cbdf6%2Fefcapture-qg-01.png?alt=media" alt=""><figcaption><p>Connexion au QG</p></figcaption></figure>
{% endstep %}

{% step %}

### Cliquer sur « Efalia Doc »

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-eaa39b2dce38a9c6d5c2c91a2bc752064d053b71%2Fefcapture-qg-02.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Sélectionner la plateforme concernée et cliquer sur « Éditer »

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-988e31c179e25bba878d05a7dd8218647646fb01%2Fefcapture-qg-03.webp?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Renseigner les liens Efalia Capture pour chaque bouton

Voir les sections suivantes pour le format de chaque lien.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-e0af21cb78f2624035dc51024381ff7dbbb21d3c%2Fefcapture-qg-04.webp?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Base URL selon le mode de déploiement

Le format de la Base URL dépend du mode d'installation du client :

* **ClickOnce** : lien HTTPS vers le fichier d'application hébergé sur un serveur accessible depuis les postes clients. Ex : `https://ecm-trial.efalia.net/efalia.capture.application`

{% hint style="info" %}
Le fichier ClickOnce doit être accessible depuis le poste client (vérifier les règles de pare-feu et proxy). Une option courante est de l'héberger directement sur le serveur Efalia Capture via IIS (voir [Installation d'Efalia Capture module Front](https://documentation.efalia.com/produit/efalia-capture/installation/installation-capture-front.md)). À valider avec l'équipe technique.
{% endhint %}

* **MSI** : URI propriétaire commençant obligatoirement par `efc://./&`

## Query params

Les query params sont ajoutés à la suite de la Base URL. Certains sont renseignés automatiquement par Efalia Doc au moment où l'utilisateur clique sur le bouton.

**Params obligatoires :**

* `trayId` : bannette cible. Renseigné automatiquement par Efalia Doc via `[id-bannette]`.
* `useBarcode` : active la détection de QR codes. Valeurs : `true` ou `false` (voir ci-dessous).
* `token` : jeton utilisateur. Renseigné automatiquement par Efalia Doc via `[jeton-utilisateur]`.
* `baseUrl` : URL de l'API Efalia Doc, encodée URL. Ex : `https%3A%2F%2Fintegration.efalia.cloud%3A1202`

**Params optionnels :**

* `certdoctypeid` : UUID du gabarit d'attestation de numérisation. Si vide, aucune attestation n'est générée (voir [Certificat de numérisation](https://documentation.efalia.com/produit/efalia-capture/utilisation/certificat-de-numerisation.md)).
* `certaskphysicalref` : `true` ou `false`. Si `true`, une popup invite l'utilisateur à saisir un ID de lot physique imprimé sur l'attestation.

## Exemples complets

**Exemple ClickOnce — numérisation simple sans code-barres :**

```
https://ecm-trial.efalia.net/efalia.capture.application?trayId=[id-bannette]&useBarcode=false&token=[jeton-utilisateur]&baseUrl=https%3A%2F%2Fintegration.efalia.cloud%3A1202
```

**Exemple MSI — numérisation avec code-barres + attestation avec référence physique :**

```
efc://./&trayId=[id-bannette]&useBarcode=true&token=[jeton-utilisateur]&baseUrl=https%3A%2F%2Fintegration.efalia.cloud%3A1202&certaskphysicalref=true&certdoctypeid=a474fecc-6079-4d1b-8535-a5ef64c191d
```

## Comportement de useBarcode

* **`useBarcode=false`** : le document numérisé est envoyé dans la bannette `trayId` définie dans le lien.
* **`useBarcode=true`** : le document est envoyé dans la bannette définie par le QR code (fiche séparatrice). Le `trayId` sert de **bannette de secours** : utilisé si aucune fiche séparatrice n'est présente, ou si le QR code n'est pas détecté dans le PDF.


---

# 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/configuration-liens-numerisation-qg.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.
