Λήψη τιμοκαταλόγου

Ισχύει για: Dynamics 365 Sales

Σημείωμα

• Τα εργαλεία και τα παραδείγματα σε αυτήν την τεκμηρίωση απεικονίζουν τις τρέχουσες δυνατότητες. Τα ονόματα εργαλείων, οι περιγραφές, οι παράμετροι, οι μορφές απόκρισης και οι διαθέσιμες λειτουργίες μπορούν να αλλάξουν με την πάροδο του χρόνου.
• Όταν δημιουργείτε πράκτορες, ενοποιήσεις ή λογική ενορχήστρωσης, μην κωδικοποιείτε εξαρτήσεις από συγκεκριμένα ονόματα εργαλείων, δομές παραμέτρων, μεταδεδομένα εργαλείων ή σχήματα απόκρισης. Αντίθετα, σχεδιάστε τη λύση σας για να ανακαλύψετε και να χρησιμοποιήσετε τα διαθέσιμα εργαλεία κατά το χρόνο εκτέλεσης.
• Καθώς η πλατφόρμα εξελίσσεται, η Microsoft μπορεί να προσθέσει, να αφαιρέσει, να μετονομάσει ή να τροποποιήσει εργαλεία και μεταδεδομένα εργαλείων. Η σχεδίαση σε σχέση με τις δυνατότητες και όχι με συγκεκριμένα αναγνωριστικά εργαλείων συμβάλλει στη διατήρηση της συμβατότητας μεταξύ των ενημερώσεων υπηρεσίας.

Χρησιμοποιήστε αυτήν τη δυνατότητα όταν ένας πωλητής χρειάζεται λεπτομέρειες ή τιμές προϊόντων από έναν τιμοκατάλογο.

Τι κάνει

Ο βοηθός διαβάζει έναν τιμοκατάλογο με βάση το GUID ή το σαφές όνομα και μπορεί να συμπεριλάβει γραμμές τιμών προϊόντος από αυτόν τον τιμοκατάλογο. Όταν επιλύετε έναν τιμοκατάλογο με βάση το όνομα, ο βοηθός επιστρέφει τη λίστα που είναι έγκυρη σε μια δεδομένη ημερομηνία (σήμερα από προεπιλογή).

Δοκιμάστε προτροπές όπως

• Δείξε μου τον τιμοκατάλογο Microsoft Eval.
• Ποια προϊόντα περιλαμβάνονται σε αυτόν τον τιμοκατάλογο;
• Λάβετε λεπτομέρειες τιμοκαταλόγου πριν προσθέσετε ένα προϊόν.
• Εμφάνιση του τιμοκαταλόγου Microsoft Eval που ισχύει την 1η Ιουλίου 2026.

Τι θα δείτε στη συνομιλία

Ο βοηθός εμφανίζει μια απάντηση κειμένου απευθείας στη συνομιλία. Ο βοηθός δεν εμφανίζει ένα διαδραστικό στοιχείο εφαρμογής σε συνομιλία.

Χρήσιμες συμβουλές

• Χρησιμοποιήστε το όταν είναι διαθέσιμο. Η priceListId ανάλυση ονόματος απαιτεί σαφή αντιστοίχιση.
• Περιορίστε τα επιστρεφόμενα προϊόντα όταν top ο τιμοκατάλογος είναι μεγάλος.
• Από προεπιλογή, οι αναζητήσεις ονομάτων επιστρέφουν τον τιμοκατάλογο που ισχύει σήμερα. Περάστε asOfDate (για παράδειγμα, 2026-07-01) για να επιλέξετε τη λίστα που είναι έγκυρη σε μια συγκεκριμένη ημερομηνία. asOfDate αγνοείται όταν παρέχετε priceListId.

Τι συμβαίνει στη συνέχεια

Αφού εμφανιστούν οι λεπτομέρειες του τιμοκαταλόγου, χρησιμοποιήστε το get_product_pricing για τις γραμμές τιμών ενός προϊόντος ή τα εργαλεία γραμμής προϊόντων, όπως απαιτείται.

Αλλάζει αυτό τα δεδομένα;

Όχι. Αυτό το εργαλείο είναι μόνο για ανάγνωση.

Προϋποθέσεις

Αυτό το εργαλείο απαιτεί πρόσβαση ανάγνωσης σε τιμοκαταλόγους. Η επιστροφή γραμμών τιμών προϊόντων (includeProducts είναι αληθής από προεπιλογή) απαιτεί επιπλέον πρόσβαση σε καρτέλες τιμοκαταλόγου προϊόντων, τις οποίες επιβάλλει το Dataverse κατά τη στιγμή της κλήσης.

Σύνοψη εργαλείου

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Λήψη τιμοκαταλόγου
Όνομα εσωτερικού εργαλείου	get_price_list
Σκοπός	Διαβάστε τις λεπτομέρειες του τιμοκαταλόγου και τις τιμές των προϊόντων.

Συμπεριφορά εργαλείου

Το εργαλείο επιλύει έναν τιμοκατάλογο και προαιρετικά επιστρέφει φραγμένες γραμμές τιμών προϊόντων.

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	true	Αυτό το εργαλείο δεν τροποποιεί δεδομένα.

Έννοιες εισόδου

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
priceListId	Επιλύθηκε το GUID τιμοκαταλόγου.	Όχι
priceListName	Όνομα για επίλυση όταν το GUID δεν είναι γνωστό.	Όχι
includeProducts	Συμπεριλάβετε σειρές τιμών προϊόντων.	Όχι
top	Σειρές μέγιστης τιμής προϊόντος προς επιστροφή.	Όχι

Σχετικά εργαλεία

Εργαλείο	Σχέση
add_opportunity_product	Προσθέτει προϊόντα μετά την επιβεβαίωση της τιμολόγησης.

Σημειώσεις δρομολόγησης

Χρησιμοποιήστε το get_price_list για λεπτομέρειες σε επίπεδο τιμοκαταλόγου. Χρησιμοποιήστε το get_product_pricing για τις σειρές τιμών ενός προϊόντος.

Απόκριση και συμπεριφορά περιβάλλοντος εργασίας χρήστη

Αυτό το εργαλείο επιστρέφει μια απάντηση μόνο κειμένου με δομημένο περιεχόμενο και χωρίς στοιχείο εφαρμογής σε συνομιλία.

Ταξινόμηση μεταλλάξεων δεδομένων

Μόνο για ανάγνωση.