Μετάβαση στο περιεχόμενο
ShopentlyLearn
Ελληνικά

Παραγγελίες

Διαβάστε συνόψεις και λεπτομέρειες παραγγελιών και ενημερώστε την κατάσταση παραγγελίας ή πληρωμής.

Λειτουργίες

GETΛίστα · Καταστάσεις — Παραγγελίες/api/v1/order-statuses

Παράδειγμα αιτήματοςΠαράδειγμα απόκρισης

GETΛίστα — Παραγγελίες/api/v1/orders

Παράδειγμα αιτήματοςΠαράδειγμα απόκρισης

GETΑνάκτηση — Παραγγελίες/api/v1/orders/{order_id}

Παράδειγμα αιτήματοςΠαράδειγμα απόκρισης

PATCHΕνημέρωση · Κατάσταση πληρωμής — Παραγγελίες/api/v1/orders/{order_id}/payment-status

Παράδειγμα αιτήματοςΠαράδειγμα απόκρισης

PATCHΕνημέρωση · Κατάσταση — Παραγγελίες/api/v1/orders/{order_id}/status

Παράδειγμα αιτήματοςΠαράδειγμα απόκρισης

Αρχές

Η λίστα και οι λεπτομέρειες παραγγελιών περιλαμβάνουν delivery.dates. Οι ημερομηνίες YYYY-MM-DD είναι προγραμματισμένες και δεν επιβεβαιώνουν αποστολή. Οι τρέχουσες ημερομηνίες υπερισχύουν· οι παλιές παραγγελίες χρησιμοποιούν την αποθηκευμένη εκτίμηση. Διαγραμμένες ή άγνωστες τιμές είναι null. Οι λεπτομέρειες περιλαμβάνουν επίσης όλες τις γραμμές και εικόνες προϊόντων.

Λάβετε έγκυρα αναγνωριστικά κατάστασης από το /api/v1/order-statuses. Η κατάσταση παραγγελίας και η κατάσταση πληρωμής χρησιμοποιούν ξεχωριστά σημεία πρόσβασης PATCH και δικαιώματα. Η αλλαγή της καταγεγραμμένης κατάστασης πληρωμής δεν χρεώνει κάρτα ούτε εκτελεί επιστροφή μέσω παρόχου πληρωμών.

Ασφαλείς εγγραφές

Δικαιώματα και προγράμματα

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Ημερομηνίες αποστολής και παράδοσης: YYYY-MM-DD; null. Ζώνη ώρας αποστολής: IANA.

Παραγγελία · Σύνολα

Τα ποσά και οι συντελεστές προέρχονται από την αποθηκευμένη παραγγελία, μαζί με τις διορθώσεις γραμμών. Τα άγνωστα ιστορικά στοιχεία είναι null και δεν αντικαθίστανται από τρέχοντες συντελεστές καταλόγου. Τα ποσά παραμένουν δεκαδικές συμβολοσειρές.

  • tax_country_code · Φορολογική χώρα · Αποθηκευμένα στοιχεία παραγγελίας · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Μία μονάδα · Πριν τις εκπτώσεις; lines[].original_total_* · Πριν τις εκπτώσεις; lines[].total_* · Μετά τις εκπτώσεις.
  • lines[].discount_* · Εκπτώσεις; manual_discount · Χειροκίνητη έκπτωση; percentage "10" = 10%.
  • delivery.net / tax / gross · Μετά τις εκπτώσεις; delivery.original_* · Πριν τις εκπτώσεις; delivery.discount_* · Εκπτώσεις.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Άγνωστο: null· γνωστό μηδέν: 0.
  • totals · Σύνολα; tax_breakdown.groups · Φορολογικές ομάδες; Μη κατανεμημένος φόρος = order.tax − Σ groups.tax; ±.

Η λίστα επιστρέφει συνόψεις. Ανακτήστε GET /api/v1/orders/{order_id} για κάθε αποτέλεσμα για πλήρη οικονομικά στοιχεία. Οι επαναλήψεις GET είναι περιορισμένες και τηρούν το Retry-After. Η εξαγωγή βάσει ημερομηνίας δημιουργίας δεν συγχρονίζει μεταγενέστερες διορθώσεις.

Το payment.amount είναι το σύνολο παραγγελίας. Η κατάσταση πληρωμής δεν καθορίζει πληρωμένα, επιστραφέντα ή οφειλόμενα ποσά.

Σχήματα δεδομένων

Οδηγοί

Εξαγωγή παραγγελιών