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

# Déclarer un défaut qualité

> Remontez une non-conformité depuis un poste ou une machine.

Connectez un poste de contrôle ou une machine à Bonx pour déclarer les défauts au
fil de l'eau. Chaque défaut est rattaché à un article et à un type de défaut.

<CodeGroup>
  ```js JavaScript theme={null}
  async function declareDefect({ articleId, defectTypeId, quantity }) {
    const res = await fetch(`${process.env.BONX_API_URL}/quality/defects`, {
      method: 'POST',
      headers: { 'x-api-key': process.env.BONX_API_KEY, 'Content-Type': 'application/json' },
      body: JSON.stringify({ articleId, defectTypeId, quantity }),
    });
    return res.json();
  }

  // Trois pièces hors cote détectées au contrôle
  await declareDefect({ articleId: 11, defectTypeId: 1, quantity: 3 });
  ```

  ```bash cURL theme={null}
  curl -X POST "$BONX_API_URL/quality/defects" \
    -H "x-api-key: $BONX_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "articleId": 11, "defectTypeId": 1, "quantity": 3 }'
  ```
</CodeGroup>

<Tip>Récupérez d'abord vos articles et vos types de défauts pour connaître les identifiants à utiliser.</Tip>