> ## 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.

# Mettre à jour des données client

> Cette fonctionnalité permet de créer ou mettre à jour les informations d'un client gestionnaire ou propriétaire, ainsi que sa liste de contacts associés.

### Endpoint & Authentification

| Méthode | URL                                              |
| :------ | :----------------------------------------------- |
| `POST`  | `https://app.arquos.eu/api/1.1/wf/update_client` |

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

* `x-api-key: [VOTRE_API_KEY]`

<Note>
  La clé API est propre à chaque partenaire et n'est autorisée que sur les agences qui lui ont été attribuées. Un appel avec une clé invalide, ou visant une agence non autorisée, n'est pas exécuté.
</Note>

### Paramètres de la requête (Body)

<ParamField body="agency_id" type="string" required>
  Identifiant unique de l'agence.
</ParamField>

<ParamField body="client_id" type="string">
  Requis si `nom` est vide.<br />Identifiant unique du client.
</ParamField>

<ParamField body="nom" type="string">
  Requis si `client_id` est vide.<br />Raison sociale ou nom du client.
</ParamField>

<ParamField body="statut" type="string">
  Valeurs possibles : `Prospect`, `Client`.
</ParamField>

<ParamField body="type" type="array">
  Liste de catégories. Valeurs : `Propriétaire/exploitant`, `Gestionnaire`.
</ParamField>

<ParamField body="email" type="string">
  Email principal de l'entreprise.
</ParamField>

<ParamField body="telephone" type="string">
  Standard téléphonique.
</ParamField>

<ParamField body="adresse" type="string">
  Adresse du siège social.
</ParamField>

<ParamField body="complement_adresse" type="string">
  Bâtiment, CS, etc.
</ParamField>

<ParamField body="siren" type="string">
  Numéro SIREN (9 chiffres).
</ParamField>

<ParamField body="siret" type="string">
  Numéro SIRET (14 chiffres).
</ParamField>

<ParamField body="supprime" type="boolean">
  Mettre à `true` pour archiver le client.
</ParamField>

<ParamField body="contact" type="object[]">
  Liste des contacts rattachés au client.

  <Expandable title="Détails de l'objet contact">
    <ParamField body="nom" type="string" required>
      Nom complet du contact.
    </ParamField>

    <ParamField body="email" type="string">
      Email du contact.
    </ParamField>

    <ParamField body="telephone" type="string">
      Ligne directe ou mobile du contact.
    </ParamField>

    <ParamField body="fonction" type="string">
      Ex: Gardien(ne), Référent sur site.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json JSON theme={null}
  {
    "agency_id": "test_agency_01",
    "client_id": "CLI-88210",
    "nom": "ImmoGestion Nord",
    "statut": "Client",
    "type": ["Gestionnaire"],
    "email": "contact@immogestion-nord.fr",
    "telephone": "0320123456",
    "adresse": "14 Rue du Vieux Lille, 59000 Lille",
    "siren": "123456789",
    "supprime": false,
    "contact": [
      {
        "nom": "Marie Dupont",
        "email": "m.dupont@immogestion-nord.fr",
        "telephone": "0601020304",
        "fonction": "Référent sur site"
      },
      {
        "nom": "Martin Durand",
        "email": "m.durand@immogestion-nord.fr",
        "telephone": "0605060708",
        "fonction": "Gardien"
      }
    ]
  }
  ```

  ```bash cURL theme={null}
  curl --request POST \
    --url https://app.arquos.eu/api/1.1/wf/update_client \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "agency_id": "test_agency_01",
      "nom": "ImmoGestion Nord",
      "statut": "Client",
      "contact": [
        {
          "nom": "Marie Dupont",
          "email": "test@email.com",
          "fonction": "Référent sur site"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "success",
    "response": {}
  }
  ```
</ResponseExample>