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

# Valider un relevé (équipe Arquos)

> Réservé à l’équipe Arquos : le moteur IA et le back office. Les valeurs du relevé passent sur l’équipement, la validation se date et se trace, les affaires du relevé avancent, et le releveur est prévenu. Seul un relevé soumis se valide ; rejouée, la validation ne refait rien (`deja`). Tout autre compte reçoit 403.

### Endpoint & Authentification

| Méthode | URL |
| :- | :- |
| `POST` | `https://api.arquos.eu/api/v2/surveys/{id}/validate` |

**En-têtes (Headers) :**

* `Authorization: Bearer [VOTRE_JETON_D_API]`
* `X-Arquos-Agency: [IDENTIFIANT_D_AGENCE]` (facultatif, voir [Agence](/v2/agence))

### Paramètres de la requête

<ParamField path="id" type="string" required>
  L’identifiant de l’objet.
</ParamField>

<ParamField header="X-Arquos-Agency" type="string">
  L’identifiant de l’agence où agir. Absent : l’agence par défaut du compte. Une agence hors de sa portée est refusée (403).
</ParamField>

### Réponse (`201`)

<ResponseField name="alreadyValidated" type="boolean">
  `true` si le relevé était déjà validé : rien n’a été refait.
</ResponseField>

<ResponseField name="values" type="integer">
  Le nombre de valeurs du relevé passées sur l’équipement.
</ResponseField>

<ResponseField name="deals" type="string[]">
  Les affaires du relevé dont le statut a avancé.
</ResponseField>

### Les erreurs

| Code | Quand |
| :- | :- |
| `400` | Requête mal formée ou champ obligatoire manquant. |
| `401` | Jeton absent, inconnu ou révoqué. |
| `403` | Agence hors de votre portée. |
| `404` | Objet introuvable dans vos agences. |
| `422` | Saisie refusée par Arquos (champ obligatoire, valeur hors bornes, choix inconnu). |
| `429` | Trop d’appels : réessayez après le délai de l’en-tête Retry-After. |

Le corps d'une erreur porte `error`, sa raison en français. Voir [Les erreurs](/v2/erreurs).

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request POST \
  --url https://api.arquos.eu/api/v2/surveys/ID_DE_L_OBJET/validate \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={"system"}
  {
  "alreadyValidated": false,
  "values": 42,
  "deals": [
    "879399e6-064d-45ca-9279-3e84364b8a21"
  ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.