Obtenir et Lister
Obtenir une commande
Utiliser le numéro de commande de vente
Cet exemple montre comment récupérer une commande de pièces basée sur le sales_order_no trouvé dans le Créer réponse.
Le sales_order_no est l'identifiant unique pour la commande de pièces utilisé par SAP et relie la commande de pièces aux factures et livraisons associées pour mettre en œuvre un processus de réception de pièces.
Voir la section Commande, Facture et Livraison : L'Histoire Complète pour des informations sur le processus de réception des pièces.
curl --location 'https://cloud-api.brp.com/dcp/v4/parts/order/1030383061?dealer_no=0000702933' \
--header 'Authorization-Dealer: DEALER_TOKEN' \
--header 'Authorization: Bearer REPLACE_ME' Utiliser l'ID de commande PAC
Cet exemple montre comment récupérer une commande de pièces basée sur le pac_order_id trouvé dans le Créer réponse.
Le pac_order_id est l'identifiant unique pour la commande de pièces utilisé par SAP.
Dans la version V3 la valeur GUID fournie par votre DMS dans le pac_order_id propriété est utilisée par SAP et renvoyée dans le Valider et Créer réponses.
Dans la version V4 SAP utilise la valeur GUID fournie par votre DMS dans le pac_order_id propriété et la renvoie dans le Valider réponse.
Cependant, SAP renvoie une valeur différente dans la réponse Créer.
🛑 Le pac_order_id propriété retournée dans le Créer la réponse doit être sauvegardée car elle est nécessaire pour identifier la commande de pièces dans un appel à la Annuler et Obtenir services.
curl --location 'https://cloud-api.brp.com/dcp/v4/parts/orders?dealer_no=0000702933&pac_order_id=051MX0o97kw9hgy42hBbD0' \
--header 'Authorization-Dealer: DEALER_TOKEN' \
--header 'Authorization: Bearer REPLACE_ME' Obtenir le résumé des commandes
Cet exemple montre comment obtenir le résumé des commandes de pièces en utilisant une plage de dates. Lorsqu'il est utilisé, le résumé paramètre indique à l'API de commande de pièces de ne renvoyer que les propriétés listées de chaque commande de pièces. Cela permet à votre DMS de récupérer rapidement une liste de commandes de pièces et de montrer la liste au concessionnaire. Votre DMS pourrait alors récupérer les commandes de pièces complètes lorsque le concessionnaire souhaite approfondir.
Dans cet exemple, le DMS appelle l'API de commande de pièces pour récupérer uniquement l'en-tête des commandes de pièces, les prix et le statut.
La demande utilise le limite paramètre pour limiter la réponse à 3 commandes par page.
Les liens fournissent les informations pour naviguer sur les pages. Consultez la Pagination section pour plus d'informations.
curl --location 'https://qa-cloud-api.brp.com/dcp/v4/parts/orders?limit=3&dealer_no=0000690012&creation_date_from=2024-07-01&creation_date_to=2024-08-01&summary=pricing,header_status' \
--header 'Authorization-Dealer: DEALER_TOKEN' \
--header 'Authorization: Bearer REPLACE_ME' Obtenir des commandes
Cette section présente des exemples d'utilisation du Obtenir service pour récupérer une liste de commandes de pièces.
Utiliser une plage de dates
Cet exemple montre comment obtenir les commandes de pièces en utilisant une plage de dates.
La demande utilise le limite paramètre pour limiter la réponse à 3 commandes par page.
Les liens propriété fournit les informations pour naviguer entre les pages. Référez-vous à la Pagination section pour plus d'informations.
curl --location 'https://cloud-api.brp.com/dcp/v4/parts/orders?creation_date_to=2023-07-18&creation_date_from=2023-07-01&dealer_no=0000702933&limit=5' \
--header 'Authorization-Dealer: DEALER_TOKEN' \
--header 'Authorization: Bearer REPLACE_ME' Utiliser le statut de la commande
Cette section présente un exemple de demande de commandes en fonction de leur statut.
Le liens fournit les informations pour naviguer dans les pages. Consultez la Pagination section pour plus d'informations.
curl --location 'https://cloud-api.brp.com/dcp/v4/parts/orders?dealer_no=0000696529&order_status=in_progress' \
--header 'Authorization-Dealer: DEALER_TOKEN' \
--header 'Authorization: Bearer REPLACE_ME'