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

# Importer une commande de vente

> Créez une commande de vente depuis un système externe.

Créez une commande de vente dans Bonx depuis une source externe, par exemple une
boutique en ligne ou un ERP client. La référence est attribuée automatiquement.

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

  const created = await importSalesOrder({
    clientOrganizationId: 3,
    siteId: 1,
    dueDate: '2026-08-26',
    customerReference: 'WEB-10432',
  });
  console.log('Créée:', created.insertSalesOrdersOne.reference);
  ```

  ```bash cURL theme={null}
  curl -X POST "$BONX_API_URL/sales-orders" \
    -H "x-api-key: $BONX_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "clientOrganizationId": 3, "siteId": 1, "dueDate": "2026-08-26", "customerReference": "WEB-10432" }'
  ```
</CodeGroup>

<Tip>
  Réutilisez `customerReference` pour tracer la commande d'origine côté client et éviter les doublons à l'import.
</Tip>