View Categories

Commander des articles

Sami
Updated on octobre 8, 2025

6 min read

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:

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
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
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 :

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 :

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:

Fig. 6. Création d’un poste de commande
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:

Fig. 8. Mise à jour d’un poste de commande
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:

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

Updated on octobre 8, 2025
API, Intégration