---
title: Commander des articles
description: "Nous abordons ici en détail la recherche, la création, la mise à jour et la suppression des éléments de la commande. Les éléments de la commande sont accessibles à partir du point de terminaison /phaser-order-rows. #### Récupération des éléments de…"
url: "https://skyplanner.ai/fr/docs/commander-des-articles/"
updated: "2025-10-08"
category: Intégrations
tags:
  - API
  - Intégration
---

# Commander des articles

Nous abordons ici en détail la recherche, la création, la mise à jour et la suppression des éléments de la commande.

Les éléments de la commande sont accessibles à partir du point de terminaison /phaser-order-rows.

#### Récupération des éléments de la commande

Vous récupérez les éléments de la commande en envoyant une demande GET au point de terminaison /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Fig. 1.** Récupération des éléments de la commande

Vous pouvez rechercher des postes de commande en fonction de différents paramètres :

- **phaser_order_id**
  - l'identifiant interne de la **commande**Skyplanner, peut être trouvé à partir du point de terminaison /phaser-orders
- **external_id**
  - Identifiant externe du poste de commande
  - Par exemple, l'identifiant unique de votre système externe (ERP, etc.)
- **production_planning_product_id**
  - Identifiant interne du produit Skyplanner
  - Peut être trouvé à partir du point de terminaison /products-endpoint
- **parent_id**
  - Si un article de commande a des sous-articles (par exemple, des sous-produits), les sous-articles ont l'identifiant de l'article de commande parent dans le champ parent_id.
- **index_ligne**
  - Numéro d'index du poste de commande

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Fig. 2.** Commander les indices des lignes d'articles

- **numéro de travail**
  - La valeur du numéro de travail du poste de commande
- **statut**
  - Statut du poste de commande
  - Valeurs autorisées : **nouveau**, **commencé** ou **terminé**
- **position**
  - La valeur de la position de l'élément de la commande

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Fig. 3. Valeurs de position des postes de commande

- **date_de_livraison**
  - La date de livraison du poste de commande
  - Format : **2025-06-05T22:00:00+00:00**
- **condition_date_de_livraison**
  - Condition facultative de recherche de la date de livraison
  - Options : >, =, <=, =, !=
  - Si aucune valeur n'est indiquée, la condition **>= sera utilisée.**
- **est_prospect**
  - Retournez uniquement les articles de la commande qui sont des prospects
- **include_archived**
  - Inclure les commandes archivées (supprimées) dans la recherche.
  - Indiqué par la valeur **is_archive**
- **modifié**
  - Retourner les articles de la commande qui ont été modifiés après la date donnée
  - Format : **2025-06-05T22:00:00+00:00**
- **condition modifiée**
  - Condition facultative de la recherche de valeurs modifiées
  - Options : >, =, <=, =, !=
  - Si aucune valeur n'est indiquée, la condition **>= sera utilisée.**

Vous pouvez également combiner les paramètres de recherche comme suit :

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Fig. 4.**Récupération des éléments de la commande par **phaser_order_id**et **row_index**

Pour récupérer un élément de commande spécifique avec son identifiant interne Skyplanner, vous pouvez effectuer une requête comme celle-ci :

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Fig. 5.** Recherche d'un élément de commande avec l'identifiant Skyplanner 4

#### Création de postes de commande

Notez que vous devez créer une **commande** avant de créer le poste de commande !

Pour créer un élément de commande, envoyez une requête POST au point de terminaison /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Fig.** **6.** Création d'un poste de commande

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Fig. 7.** Poste de commande créé

Voici un aperçu des champs que vous pouvez utiliser lors de la création d'un poste de commande :

- **phaser_order_id**
  - Identifiant Skyplanner interne pour la **commande** à laquelle l'élément de commande est rattaché
  - **Champ obligatoire**
- **Production_planning_order_row_id**
  - Une fois la commande exportée vers le module de planification de la production de Skyplanner, une entité distincte appelée **ligne de commande de planification de la production** est créée et son identifiant est défini dans ce champ.
  - **Il n'est pas recommandé d'utiliser** ce champ (laissez-le nul ou n'envoyez pas du tout ce champ dans le champ de la demande).
- **production_planning_product_id**
  - Identifiant du produit Skyplanner pour le produit que l'article de la commande est en train de produire
  - Requis si vous voulez apporter des étapes de processus par défaut à partir d'un produit
- **external_id**
  - Identifiant unique de l'élément de la commande
  - Utilisez cette option pour lier le poste de commande Skyplanner à votre poste de commande provenant d'un système externe (ERP, etc.).
  - **Doit être unique**
- **parent_id**
  - Si l'élément de commande est un sous-élément d'un autre élément de commande, indiquez ici la valeur de l'identifiant du parent.
- **index_ligne**
  - Où se trouve cet article dans la liste des articles de la commande ?
- **numéro de travail**
  - Utilisé uniquement comme valeur informative du numéro de travail pour le poste de commande.
  - Non visible dans l'interface utilisateur de Skyplanner
- **statut**
  - Statut du poste de commande
  - Valeurs autorisées : **nouveau, commencé, prêt, échelonné**
- **is_archive**
  - Le poste de commande est-il archivé (supprimé) ?
- **position**
  - Valeur de l'identifiant de l'article de commande (voir Fig. 3.)
- **montant**
  - Quantité totale de produits fabriqués
- **montant_commandé**
  - Quantité de produit commandée
- **prix**
  - Prix unitaire du produit
- **utiliser des matériaux personnalisés**
  - Si vous ne souhaitez pas utiliser la configuration par défaut du matériau à partir des données du produit, réglez cette valeur sur true (vrai).
  - Valeur par défaut : **false**
- **utiliser_des_matériaux_customisés_calculés**
  - Les quantités d'articles sur mesure sont calculées sur la base de la quantité de produits fabriqués.
  - Si la valeur est fixée à false, les quantités de matériaux sont fixes
  - Valeur par défaut : **false**
- **get_default_steps**
  - Créez des étapes de processus pour l'article de commande en vous basant sur les étapes de processus par défaut du produit.
  - Valeur par défaut : **false**
- **use_calculated_job_durations**
  - Calculer les durées des étapes du processus sur la base des données de l'historique.
  - Si les données disponibles ne sont pas suffisantes pour effectuer le calcul, les durées par défaut sont utilisées.
  - Valeur par défaut : **false**
- **sous-éléments**
  - Créez également les sous-articles du produit s'ils sont disponibles
  - Valeur par défaut : **false**
- **date_de_livraison**
  - Format : 2022-01-01 10:30:11
- **date_d'admissibilité_de_début**
  - Format : 2022-01-01 10:30:11
- **identifiant_dessin**
  - Identificateur de dessin/bleu/instructions
- **description**
  - Description de l'article de la commande
- **description_supplémentaire**
  - Description supplémentaire du poste de commande
- **est_prospect**
  - Le poste de commande est-il un prospect ?
  - Valeur par défaut : **false**

#### Mise à jour des postes de commande

Pour mettre à jour les données relatives aux éléments de la commande, vous pouvez envoyer une requête PUT au point de terminaison /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Fig. 8.**Mise à jour d'un poste de commande

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Fig. 9.**Mise à jour du poste de commande

#### Suppression de postes de commande

La suppression des éléments d'une commande s'effectue par une méthode de "suppression douce". En effet, la suppression d'un élément de commande fait passer sa valeur **is_archive** à true. Cela signifie que vous pouvez restaurer les éléments de commande supprimés en mettant à jour la valeur is_archive à false.

Lors de la suppression d'un poste de commande, le système supprime également les étapes du processus qui y sont associées.

Vous supprimez des éléments de commande en envoyant une demande DELETE au point de terminaison /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Fig. 10.**Suppression de postes de commande

Vous pouvez supprimer des éléments de commande en indiquant les identifiants internes de Skyplanner dans le tableau **"ids"** ou les identifiants externes dans le tableau **"external_ids"**.