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

# Obtenir une liste de transactions

> Obtenez une liste des transactions actives ou terminées à l’aide de l’API Vantage d’ABBYY pour suivre l’état de la relecture manuelle, récupérer des liens de relecture et télécharger des fichiers de résultats.

export const VantageRegion = ({children}) => {
  const STORAGE_KEY = "abbyy.vantage.region";
  const REGIONS = [{
    code: "eu",
    label: "Europe"
  }, {
    code: "us",
    label: "North America"
  }, {
    code: "au",
    label: "Australia / Asia-Pacific"
  }];
  const [region, setRegion] = useState("eu");
  const [open, setOpen] = useState(false);
  const containerRef = useRef(null);
  const dropdownRef = useRef(null);
  function safeGetSavedRegion() {
    try {
      const saved = typeof window !== "undefined" ? window.localStorage.getItem(STORAGE_KEY) : null;
      const valid = new Set(REGIONS.map(r => r.code));
      return saved && valid.has(saved) ? saved : "eu";
    } catch {
      return "eu";
    }
  }
  function safeSetSavedRegion(code) {
    try {
      if (typeof window !== "undefined") {
        window.localStorage.setItem(STORAGE_KEY, code);
      }
    } catch {}
  }
  function dispatchRegionChanged(code) {
    try {
      if (typeof window !== "undefined") {
        window.dispatchEvent(new CustomEvent("abbyy:region-changed", {
          detail: {
            code
          }
        }));
      }
    } catch {}
  }
  function replaceRegionInString(text, currentRegion) {
    if (typeof text !== "string") return text;
    const hostRegex = /https:\/\/vantage-(eu|us|au)\.abbyy\.com/gi;
    const tokenRegex = /https:\/\/vantage-\[region\]\.abbyy\.com/gi;
    const bareHostRegex = /vantage-(eu|us|au)\.abbyy\.com/gi;
    const bareTokenRegex = /vantage-\[region\]\.abbyy\.com/gi;
    return text.replace(hostRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(tokenRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(bareHostRegex, `vantage-${currentRegion}.abbyy.com`).replace(bareTokenRegex, `vantage-${currentRegion}.abbyy.com`);
  }
  useEffect(() => {
    setRegion(safeGetSavedRegion());
  }, []);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      const href = a.getAttribute("href");
      if (href) {
        const next = replaceRegionInString(href, region);
        if (next !== href) {
          a.setAttribute("href", next);
        }
      }
    });
    const walker = typeof document !== "undefined" ? document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null) : null;
    if (walker) {
      const toUpdate = [];
      let node = walker.nextNode();
      while (node) {
        const updated = replaceRegionInString(node.nodeValue, region);
        if (updated !== node.nodeValue) {
          toUpdate.push([node, updated]);
        }
        node = walker.nextNode();
      }
      toUpdate.forEach(([textNode, value]) => {
        textNode.nodeValue = value;
      });
    }
  }, [region, children]);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      a.style.fontWeight = "600";
      a.style.textDecoration = "underline";
      a.style.textUnderlineOffset = "2px";
    });
  }, [region, children]);
  useEffect(() => {
    const onRegionChanged = evt => {
      const code = evt && evt.detail && evt.detail.code;
      if (!code || code === region) return;
      setRegion(code);
    };
    if (typeof window !== "undefined") {
      window.addEventListener("abbyy:region-changed", onRegionChanged);
    }
    return () => {
      if (typeof window !== "undefined") {
        window.removeEventListener("abbyy:region-changed", onRegionChanged);
      }
    };
  }, [region]);
  useEffect(() => {
    const onClickAway = e => {
      if (!dropdownRef.current) return;
      if (!dropdownRef.current.contains(e.target)) {
        setOpen(false);
      }
    };
    document.addEventListener("click", onClickAway, true);
    return () => document.removeEventListener("click", onClickAway, true);
  }, []);
  const onSelect = code => {
    setRegion(code);
    safeSetSavedRegion(code);
    dispatchRegionChanged(code);
    setOpen(false);
  };
  const current = REGIONS.find(r => r.code === region) || REGIONS[0];
  return <div className="not-prose">
      <div className="mb-4 inline-flex items-center gap-2" ref={dropdownRef}>
        <span className="text-sm text-zinc-950/80 dark:text-white/80">Tenant Region:</span>
        <div className="relative">
          <button type="button" aria-haspopup="listbox" aria-expanded={open ? "true" : "false"} onClick={() => setOpen(v => !v)} className="h-8 px-3 rounded-md bg-zinc-900/5 dark:bg-white/5 border border-zinc-950/20 dark:border-white/20 text-sm inline-flex items-center gap-2">
            <span className="text-zinc-950 dark:text-white">{current.label}</span>
            <svg width="8" height="24" viewBox="0 -9 3 24" className="transition-transform text-gray-400 overflow-visible dark:text-gray-600 ml-auto" style={{
    transform: open ? "rotate(270deg)" : "rotate(90deg)"
  }}>
              <path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"></path>
            </svg>
          </button>
          {open ? <div role="listbox" className="absolute z-50 left-full top-0 ml-2 w-56 rounded-xl border border-zinc-950/20 dark:border-white/20 bg-white dark:bg-zinc-900 shadow-lg p-2">
              {REGIONS.map(r => {
    const selected = r.code === region;
    return <button key={r.code} type="button" role="option" aria-selected={selected ? "true" : "false"} onClick={() => onSelect(r.code)} className={"w-full flex items-center justify-between px-3 py-2 rounded-lg text-sm hover:bg-zinc-950/5 dark:hover:bg-white/10 text-zinc-950 dark:text-white" + (selected ? " font-medium" : "")}>
                    <span style={selected ? {
      color: "#ff2038"
    } : undefined}>{r.label}</span>
                    <span className={selected ? "ml-3" : "ml-3 invisible"} style={selected ? {
      color: "#ff2038"
    } : undefined}>✓</span>
                  </button>;
  })}
            </div> : null}
        </div>
      </div>
      <div ref={containerRef} className="prose dark:prose-invert max-w-none">{children}</div>
    </div>;
};

Une liste de toutes les transactions actives ou terminées peut servir à :

* Suivre les transactions actives actuellement à l’étape de relecture manuelle.
* Obtenir un lien de relecture manuelle pour les transactions actives.
* Télécharger les fichiers de résultats des transactions terminées.

Vous pouvez obtenir une liste de transactions avec leurs identifiants à l’aide de l’API Vantage. Vous pouvez utiliser [Skill Monitor](/fr/vantage/documentation/runtime/skill-monitor/skill-monitor) pour appliquer des filtres plus avancés.

<div id="list-of-active-transactions">
  ### Liste des transactions actives
</div>

Pour obtenir une liste des transactions actives, envoyez une requête GET à la ressource `transactions/active`.

Dans le corps de la requête, indiquez les paramètres suivants :

| Parameter             | Description                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| StageType             | L’étape de la transaction.<br />Les valeurs possibles sont :<br />- ManuaReview<br />- CustomActivity<br />- Automatic (toutes les étapes pour lesquelles l’intervention de l’utilisateur n’est pas requise, par exemple l’extraction de champs)                                                                                                                                   |
| StageName             | Le nom de l’action spécifique (uniquement pour l’étape ManualReview).                                                                                                                                                                                                                                                                                                              |
| SkillId               | L’identifiant du Skill.<br />Si aucune valeur n’est spécifiée, tous les Skills disponibles seront pris en compte.                                                                                                                                                                                                                                                                  |
| SkillVersion          | La version du Skill.<br />Si aucune valeur n’est spécifiée, toutes les versions des Skills disponibles seront prises en compte.                                                                                                                                                                                                                                                    |
| StartDate             | L’horodatage de création de la transaction la plus ancienne (doit être spécifié au format UTC).                                                                                                                                                                                                                                                                                    |
| EndDate               | L’horodatage de création de la transaction la plus récente (doit être spécifié au format UTC).<br />Si cette valeur n’est pas spécifiée, l’heure UTC actuelle sera utilisée à la place.                                                                                                                                                                                            |
| TransactionParameters | La liste des paramètres de transaction composée de paires clé-valeur de type string. Ces paramètres fournissent des informations utilisateur supplémentaires (par exemple, le nom du client).<br />Les paramètres doivent être fournis au format suivant : `TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}` |
| DocumentParameters    | La liste des paramètres de document composée de paires clé-valeur de type string. Ces paramètres fournissent des informations supplémentaires sur le document (par exemple, le nom du fichier).<br />Les paramètres doivent être fournis au format suivant : `DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}`     |
| Offset                | Le décalage de pagination.<br />La valeur par défaut du paramètre est **0**.                                                                                                                                                                                                                                                                                                       |
| Limit                 | La limite de pagination. Ce paramètre est obligatoire.<br />La valeur par défaut du paramètre est **0**.                                                                                                                                                                                                                                                                           |

Exemple de requête :

<VantageRegion>
  ```shell theme={null}
  curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/active"
  -H "Authorization: Bearer token"
  ```
</VantageRegion>

La réponse à une requête pour laquelle un identifiant de compétence est spécifié contiendra un fichier JSON similaire au suivant :

```json expandable theme={null}
{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "Review",
      "seqId": 13758,
      "transactionId": "56a50415-fe1d-4493-81ba-97ff07e3ffce",
      "createTimeUtc": "2023-09-11T13:53:30.633Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "skillId": "workspace.default.processing",
      "skillVersion": 18,
      "documentCount": 1
    }
  ],
  "totalItemCount": 7
}
```

La réponse à une requête pour laquelle une étape et une action sont spécifiées contiendra un fichier JSON contenant toutes les transactions actives, similaire à ce qui suit :

```json expandable theme={null}
{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "Review2",
      "seqId": 13852,
      "transactionId": "e646754e-d854-4b21-af91-58cb63ead7a6",
      "createTimeUtc": "2023-09-11T14:04:37.97Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "documentCount": 1
    }
  ],
  "totalItemCount": 2
}
```

Vous pouvez également obtenir un lien client de relecture manuelle pour les transactions en cours. Pour ce faire, envoyez une requête GET à la ressource `transactions/<transaction_id>` avec l’identifiant de la transaction dans l’URI de la requête.

Exemple de requête :

<VantageRegion>
  ```shell theme={null}
  curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/transaction-id" \
    -H "Authorization: Bearer token"
  ```
</VantageRegion>

La réponse contiendra un code semblable à ce qui suit :

<VantageRegion>
  ```json theme={null}
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "Processing",
    "manualReviewLink": "https://vantage-eu.abbyy.com/api/publicapi/v1/verify?documentIds=9838448d-72ae-4e9a-b071-2bb16f732e46",
    "sourceFiles": [
      {
        "id": "7b2eed6f-3fdd-43b9-a178-7211d0a8d5bb",
        "name": "Invoice07.JPG"
      }
    ]
  }
  ```
</VantageRegion>

La clé `manualReviewLink` contiendra un lien vers l’interface Web du client de relecture manuelle ainsi qu’un jeton d’accès Vantage, si une relecture manuelle est requise. Ce lien et ce jeton peuvent être utilisés pour vérifier et corriger les résultats de classification et d’extraction des champs d’une transaction spécifique. Le lien fourni est valide pendant 168 heures, après quoi un nouveau lien doit être créé et récupéré pour une nouvelle période de 168 heures en utilisant la même méthode. Pour plus d’informations, voir [Intégration de la relecture manuelle](/fr/vantage/developer/integrating-manual-review).

<Info>
  Les utilisateurs autorisés via ce lien ne pourront pas afficher ni modifier d’autres documents ou transactions.
</Info>

<div id="list-of-completed-transactions">
  ### Liste des transactions terminées
</div>

Pour obtenir une liste des transactions terminées, envoyez une requête GET à la ressource `transactions/completed`.

Dans le corps de la requête, spécifiez les paramètres suivants :

| Parameter             | Description                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TransactionStatus     | Le statut de la transaction.<br />Les valeurs possibles sont :<br />- Processed<br />- Canceled<br />- Failed                                                                                                                                                                                                                                                                             |
| SkillId               | L'identifiant de la compétence.<br />Si aucune valeur n'est spécifiée, toutes les compétences disponibles seront prises en compte.                                                                                                                                                                                                                                                        |
| SkillVersion          | La version de la compétence.<br />Si aucune valeur n'est spécifiée, toutes les versions des compétences disponibles seront prises en compte.                                                                                                                                                                                                                                              |
| StartDate             | La date et l'heure de création de la première transaction (doit être spécifiée au format UTC).                                                                                                                                                                                                                                                                                            |
| EndDate               | La date et l'heure de création de la dernière transaction (doit être spécifiée au format UTC).<br />Si cette valeur n'est pas spécifiée, l'heure UTC actuelle sera utilisée à la place.                                                                                                                                                                                                   |
| TransactionParameters | La liste des paramètres de transaction, composée de paires clé-valeur de type string. Ces paramètres fournissent des informations supplémentaires sur l'utilisateur (par exemple, le nom du client).<br />Les paramètres doivent être fournis au format suivant : `TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}` |
| DocumentParameters    | La liste des paramètres de document, composée de paires clé-valeur de type string. Ces paramètres fournissent des informations supplémentaires sur le document (par exemple, le nom du fichier).<br />Les paramètres doivent être fournis au format suivant : `DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}`           |
| Offset                | Le décalage de pagination.<br />La valeur par défaut de ce paramètre est **0**.                                                                                                                                                                                                                                                                                                           |
| Limit                 | La limite de pagination. Ce paramètre est obligatoire.<br />La valeur par défaut de ce paramètre est **0**.                                                                                                                                                                                                                                                                               |

La réponse contiendra un fichier JSON avec toutes les transactions terminées et un nombre de pages traitées similaire à ce qui suit :

```json expandable theme={null}
{
  "items": [
    {
      "status": "FinishedSuccessfully",
      "pageCount": 1,
      "seqId": 13705,
      "transactionId": "fc9920fe-f788-47f8-9972-b767493faed9",
      "createTimeUtc": "2023-09-11T13:47:50.273Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 29842,
      "transactionId": "c0dd3e08-f295-4c6c-b919-31eaa67817cc",
      "createTimeUtc": "2023-09-12T19:28:01.27Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed _1_.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 36254,
      "transactionId": "8391871e-abf5-41bc-8a66-1059418a3843",
      "createTimeUtc": "2023-09-13T08:53:41.9Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed _1_.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 36632,
      "transactionId": "7f7cd557-a03e-42e3-a454-e7981e8e9fc0",
      "createTimeUtc": "2023-09-13T09:35:27.48Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 36663,
      "transactionId": "c9b3cd4d-d90f-48be-adc2-99985ece4e11",
      "createTimeUtc": "2023-09-13T09:38:29.573Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    }
  ],
  "totalItemCount": 5
}
```