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

Σχήματα δεδομένων: Απόθεμα

Σχήματα δεδομένων: Απόθεμα. Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.

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

Ποσότητες που έχουν κατανεμηθεί σε θέσεις αποθήκης

AllocationData · Σχήμα · Σχήματα δεδομένων: Απόθεμα
location_codeΣυμβολοσειράΥποχρεωτικό

Κωδικός θέσης αποθήκης.

Παράδειγμα: "example"
location_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό θέσης αποθήκης.

Παράδειγμα: "example"
location_nameΣυμβολοσειράΥποχρεωτικό

Όνομα θέσης αποθήκης.

Παράδειγμα: "example"
on_handΑκέραιοςΥποχρεωτικό

Ποσότητα φυσικού αποθέματος.

Παράδειγμα: 10

Πρόσθετα πεδία: Όχι

Λίστα · Αποθέματα — Απόθεμα — Απόκριση

ApiResponse_list_StockData__ · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
dataΠίνακας <StockData > Υποχρεωτικό

Παράδειγμα απόκρισης · ApiResponse_list_StockData__.

Παράδειγμα: [{"active":true,"available":5,"id":"stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ","manual_reserved":2,"on_hand":10,"reserved":3,"sellable_limit":10,"target_id":"example","target_type":"product","total_reserved":5,"updated_at":"2026-01-01T12:00:00Z","version":1,"warehouse_id":"example"}]
metaContextPageMeta ContextMeta PageMeta RequestMeta Υποχρεωτικό

Μεταδεδομένα απόκρισης.

Παράδειγμα: {"pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Πρόσθετα πεδία: Όχι

Ανάκτηση · Αποθέματα — Απόθεμα — Απόκριση

ApiResponse_StockDetailData_ · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
dataStockDetailData Υποχρεωτικό

Παράδειγμα απόκρισης · StockDetailData.

Παράδειγμα: {"active":true,"allocations":[{"location_code":"example","location_id":"example","location_name":"example","on_hand":10}],"available":5,"id":"stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ","manual_reserved":2,"on_hand":10,"reserved":3,"sellable_limit":10,"target_id":"example","target_type":"product","total_reserved":5,"updated_at":"2026-01-01T12:00:00Z","version":1,"warehouse_id":"example"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Υποχρεωτικό

Μεταδεδομένα απόκρισης.

Παράδειγμα: {"request_id":"example"}

Πρόσθετα πεδία: Όχι

Ενημέρωση · Χειροκίνητη κράτηση — Απόθεμα — Περιεχόμενο αιτήματος

ManualReservationUpdate · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
expected_versionΑκέραιοςΥποχρεωτικό

Έκδοση που διαβάστηκε πριν από την εγγραφή· αν δεν συμφωνεί, η ενημέρωση απορρίπτεται.

minimum: 1maximum: 9223372036854775807
Παράδειγμα: 1
manual_reservedΑκέραιοςΥποχρεωτικό

Ποσότητα δεσμευμένη χειροκίνητα.

minimum: 0maximum: 2147483647
Παράδειγμα: 1
reasonΣυμβολοσειράΠροαιρετικό

Αιτιολογία που καταγράφηκε για την αλλαγή.

maxLength: 500
Προεπιλογή: ""

Πρόσθετα πεδία: Όχι

Ενημέρωση · Όριο πωλήσεων — Απόθεμα — Περιεχόμενο αιτήματος

SalesLimitUpdate · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
expected_versionΑκέραιοςΥποχρεωτικό

Έκδοση που διαβάστηκε πριν από την εγγραφή· αν δεν συμφωνεί, η ενημέρωση απορρίπτεται.

minimum: 1maximum: 9223372036854775807
Παράδειγμα: 1
reasonΣυμβολοσειράΠροαιρετικό

Αιτιολογία που καταγράφηκε για την αλλαγή.

maxLength: 500
Προεπιλογή: ""
sellable_limitΑκέραιοςΥποχρεωτικό

Όριο πωλήσεων: -1 σημαίνει απεριόριστο και 0 απενεργοποιεί τις διαθέσιμες πωλήσεις.

minimum: -1maximum: 2147483647
Παράδειγμα: 1

Πρόσθετα πεδία: Όχι

Δημιουργία · Προσαρμογή αποθέματος — Απόθεμα — Περιεχόμενο αιτήματος

StockAdjustmentCreate · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
expected_versionΑκέραιοςΥποχρεωτικό

Έκδοση που διαβάστηκε πριν από την εγγραφή· αν δεν συμφωνεί, η ενημέρωση απορρίπτεται.

minimum: 0maximum: 9223372036854775807
Παράδειγμα: 0
locationsΠίνακας <LocationQuantity > Υποχρεωτικό

Θέσεις αποθήκης.

minItems: 1maxItems: 100
Παράδειγμα: [{"location_id":"example","on_hand":1}]
reasonΣυμβολοσειράΥποχρεωτικό

Αιτιολογία που καταγράφηκε για την αλλαγή.

minLength: 1maxLength: 500
Παράδειγμα: "Example"
target_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό προϊόντος ή παραλλαγής που επηρεάζει η λειτουργία.

Περιορισμοί
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Παράδειγμα: "example"
target_typeΣυμβολοσειράΥποχρεωτικό

Δείχνει αν η λειτουργία αφορά προϊόν ή παραλλαγή.

Περιορισμοί
enum
["product", "variant"]
Παράδειγμα: "product"
warehouse_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό αποθήκης.

Περιορισμοί
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Παράδειγμα: "example"

Πρόσθετα πεδία: Όχι

Ενημέρωση · Αποθέματα — Απόθεμα — Περιεχόμενο αιτήματος

StockAdjustmentUpdate · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
expected_versionΑκέραιοςΥποχρεωτικό

Έκδοση που διαβάστηκε πριν από την εγγραφή· αν δεν συμφωνεί, η ενημέρωση απορρίπτεται.

minimum: 1maximum: 9223372036854775807
Παράδειγμα: 1
locationsΠίνακας <LocationQuantity > Υποχρεωτικό

Θέσεις αποθήκης.

minItems: 1maxItems: 100
Παράδειγμα: [{"location_id":"example","on_hand":1}]
reasonΣυμβολοσειράΥποχρεωτικό

Αιτιολογία που καταγράφηκε για την αλλαγή.

minLength: 1maxLength: 500
Παράδειγμα: "Example"

Πρόσθετα πεδία: Όχι

Λίστα · Αποθέματα — Απόθεμα — Απόκριση

StockData · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
activeΛογική τιμήΥποχρεωτικό

Δείχνει αν ο πόρος είναι ενεργός.

Παράδειγμα: true
availableΑκέραιος nullΥποχρεωτικό

Ποσότητα διαθέσιμη προς πώληση· null σημαίνει απεριόριστη ποσότητα.

Παράδειγμα: 5
idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό πόρου· διατηρήστε το ακριβώς όπως επιστρέφεται. (StockData).

Παράδειγμα: "stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ"
manual_reservedΑκέραιοςΥποχρεωτικό

Ποσότητα δεσμευμένη χειροκίνητα.

Παράδειγμα: 2
on_handΑκέραιοςΥποχρεωτικό

Ποσότητα φυσικού αποθέματος.

Παράδειγμα: 10
reservedΑκέραιοςΥποχρεωτικό

Ποσότητα δεσμευμένη από παραγγελίες.

Παράδειγμα: 3
sellable_limitΑκέραιοςΥποχρεωτικό

Όριο πωλήσεων: -1 σημαίνει απεριόριστο και 0 απενεργοποιεί τις διαθέσιμες πωλήσεις.

Παράδειγμα: 10
target_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό προϊόντος ή παραλλαγής που επηρεάζει η λειτουργία.

Παράδειγμα: "example"
target_typeΣυμβολοσειράΥποχρεωτικό

Δείχνει αν η λειτουργία αφορά προϊόν ή παραλλαγή.

Περιορισμοί
enum
["product", "variant"]
Παράδειγμα: "product"
total_reservedΑκέραιοςΥποχρεωτικό

Συνολική δεσμευμένη ποσότητα.

Παράδειγμα: 5
updated_atΣυμβολοσειράΥποχρεωτικό

Χρόνος τελευταίας ενημέρωσης.

format: "date-time"
Παράδειγμα: "2026-01-01T12:00:00Z"
versionΑκέραιοςΥποχρεωτικό

Έκδοση πόρου για έλεγχο ταυτόχρονων εγγραφών.

Παράδειγμα: 1
warehouse_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό αποθήκης.

Παράδειγμα: "example"

Πρόσθετα πεδία: Όχι

Ανάκτηση · Αποθέματα — Απόθεμα — Απόκριση

StockDetailData · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.
activeΛογική τιμήΥποχρεωτικό

Δείχνει αν ο πόρος είναι ενεργός.

Παράδειγμα: true
allocationsΠίνακας <AllocationData > Υποχρεωτικό

Ποσότητες που έχουν κατανεμηθεί σε θέσεις αποθήκης.

Παράδειγμα: [{"location_code":"example","location_id":"example","location_name":"example","on_hand":10}]
availableΑκέραιος nullΥποχρεωτικό

Ποσότητα διαθέσιμη προς πώληση· null σημαίνει απεριόριστη ποσότητα.

Παράδειγμα: 5
idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό πόρου· διατηρήστε το ακριβώς όπως επιστρέφεται. (StockDetailData).

Παράδειγμα: "stock_v1_WyJleGFtcGxlIiwicHJvZHVjdCIsImV4YW1wbGUiXQ"
manual_reservedΑκέραιοςΥποχρεωτικό

Ποσότητα δεσμευμένη χειροκίνητα.

Παράδειγμα: 2
on_handΑκέραιοςΥποχρεωτικό

Ποσότητα φυσικού αποθέματος.

Παράδειγμα: 10
reservedΑκέραιοςΥποχρεωτικό

Ποσότητα δεσμευμένη από παραγγελίες.

Παράδειγμα: 3
sellable_limitΑκέραιοςΥποχρεωτικό

Όριο πωλήσεων: -1 σημαίνει απεριόριστο και 0 απενεργοποιεί τις διαθέσιμες πωλήσεις.

Παράδειγμα: 10
target_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό προϊόντος ή παραλλαγής που επηρεάζει η λειτουργία.

Παράδειγμα: "example"
target_typeΣυμβολοσειράΥποχρεωτικό

Δείχνει αν η λειτουργία αφορά προϊόν ή παραλλαγή.

Περιορισμοί
enum
["product", "variant"]
Παράδειγμα: "product"
total_reservedΑκέραιοςΥποχρεωτικό

Συνολική δεσμευμένη ποσότητα.

Παράδειγμα: 5
updated_atΣυμβολοσειράΥποχρεωτικό

Χρόνος τελευταίας ενημέρωσης.

format: "date-time"
Παράδειγμα: "2026-01-01T12:00:00Z"
versionΑκέραιοςΥποχρεωτικό

Έκδοση πόρου για έλεγχο ταυτόχρονων εγγραφών.

Παράδειγμα: 1
warehouse_idΣυμβολοσειράΥποχρεωτικό

Αναγνωριστικό αποθήκης.

Παράδειγμα: "example"

Πρόσθετα πεδία: Όχι