API αποθεμάτων
Χρησιμοποιήστε το API αποθέματος για εξαγωγή πληροφοριών τιμής και αποθέματος για προϊόντα (ή παραλλαγές) ή για ενημέρωση δεδομένων (απόθεμα, τρέχουσα τιμή ή παλιά τιμή) των υπαρχόντων προϊόντων (ή παραλλαγών).
- Διαθέσιμα πεδία
- Εξαγωγή δεδομένων προϊόντος (ή παραλλαγή)
- Αλλαγή πληροφοριών προϊόντος (ή παραλλαγής)
Διαθέσιμα πεδία
Η παρακάτω λίστα δείχνει όλα τα διαθέσιμα πεδία για αυτό το API, τα οποία επιστρέφονται όταν εξαγάγετε μια μεμονωμένη λίστα ή πόρο, οι οποίοι μπορούν να τροποποιηθούν, οι οποίοι είναι υποχρεωτικοί κατά τη δημιουργία ενός νέου πόρου ή την ενημέρωση ενός υπάρχοντος πόρου.
Κωδικός περιγραφής
Υπόδειξη
Περιγραφή
Λίστα
Μεταβλητές
ID
int
Αναγνωριστικό προϊόντος
sku
σειρά
Κωδικός SKU προϊόντος
ean
σειρά
Κωδικός EAN προϊόντος
inventory_enabled
σειρά
Ενεργοποίηση της λειτουργίας αποθέματος προϊόντος (προεπιλογή απενεργοποιημένη)
στοκ
int
Ποσότητα σε απόθεμα
αποθήκες
πίνακας
Διανομή αποθεμάτων από αποθήκες (εγκατεστημένη εφαρμογή πολλαπλής διαχείρισης)
price_net
float
Καθαρή τιμή
τιμή_ ακαθάριστο
float
Περιλαμβάνεται τιμή με φόρους
old_price_net
float
Η παλιά μη μειωμένη τιμή του προϊόντος
old_price_gross
float
Μη μειωμένη τιμή παλιού προϊόντος (περιλαμβάνονται φόροι)
ΥΠΟΔΕΙΞΗ
Τυχόν επιστρεφόμενα και χωρίς έγγραφα πεδία μπορούν να αγνοηθούν επειδή δεν είναι ακόμη διαθέσιμα.
Εξαγωγή δεδομένων προϊόντος (ή παραλλαγή)
Εμφανίζει τα δεδομένα μιας μεμονωμένης εγγραφής βάσει αναγνωριστικού, κωδικού SKU ή κωδικού EAN.
Τύπος : Ατομικός πόρος
ρήμα : GET
Url :/api/v2/inventory/{type}/{identifier}
Ο κωδικός απόκρισης http είναι 200
σε περίπτωση επιτυχίας, η απάντηση θα έχει τη μορφή ενός μεμονωμένου πόρου που σχετίζεται με το αναγνωριστικό που ζητήσατε. Στην περίπτωση αναγνωριστικών SKU, η τιμή τους πρέπει να κωδικοποιηθεί στη διεύθυνση URL.
Αίτημα μορφοποίησης
Παράδειγμα αιτήματος CURL που επιστρέφει μια μεμονωμένη εγγραφή:
curl --request GET \
--url 'https://shop.demo.ro/api/v2/inventory/id/10001' \
--header 'Accept: application/json' \
--header 'Content-type: application/json' \
--header 'Authorization: Basic {base64-encoded-credentials}'
Εξαγωγή δεδομένων βάσει αναγνωριστικού
Παράδειγμα αιτήματος
GET /api/v2/inventory/id/10001
Παράδειγμα απάντησης
Εξαγωγή δεδομένων με βάση τον κωδικό SKU
Παράδειγμα αιτήματος
GET /api/v2/inventory/sku/TShirt.Blk.XL
Παράδειγμα απάντησης
{
"id": 10002,
"sku": "TShirt.Blk.XL",
"ean": null,
"inventory_enabled": "off",
"price_net": 75.63,
"price_gross": 90.00
}
Εξαγωγή δεδομένων με βάση τον κωδικό EAN (εγκατεστημένη εφαρμογή πολλαπλής διαχείρισης)
Παράδειγμα αιτήματος
GET /api/v2/inventory/ean/7332543402632
Παράδειγμα απάντησης
{
"id": 10003,
"sku": "ZCG212H1WA",
"ean": "7332543402632",
"inventory_enabled": "on",
"stock": 20,
"warehouses": [
{
"id": 1,
"name": "Depozit central",
"stock": 5
},
{
"id": 2,
"name": "Depozit furnizor (Nod)",
"stock": 15
}
],
"price_net": 756.30,
"price_gross": 900.00
}
Αλλαγή πληροφοριών προϊόντος (ή παραλλαγής)
Σας επιτρέπει να ενημερώσετε μια υπάρχουσα εγγραφή βάσει αναγνωριστικού, κωδικού SKU ή κωδικού EAN.
Τύπος : Δυναμικού Ενημέρωση
ρήμα : PATCH
Url :/api/v2/inventory/{type}/{identifier}
Ο κωδικός http απόκρισης είναι 200
επιτυχής, η απόκριση θα έχει τη μορφή ενός μεμονωμένου πόρου που αντιπροσωπεύει την εγγραφή που μόλις ενημερώθηκε. Στην περίπτωση αναγνωριστικών SKU, η τιμή τους πρέπει να κωδικοποιηθεί στη διεύθυνση URL.
Αίτημα μορφοποίησης
Παράδειγμα αιτήματος CURL που ενημερώνει μια υπάρχουσα εγγραφή:
curl --request PATCH \
--url 'https://shop.demo.ro/api/v2/inventory/id/10001' \
--header 'Accept: application/json' \
--header 'Content-type: application/json' \
--header 'Authorization: Basic {base64-encoded-credentials}' \
--data-raw '{
"stock": 20,
"price_net": 1344.54
}'
Ενημερώστε την ποσότητα και την καθαρή τιμή με βάση το αναγνωριστικό
Παράδειγμα αιτήματος
PATCH /api/v2/inventory/id/10001
{
"stock": 20,
"price_net": 1344.54
}
Παράδειγμα απάντησης
{
"id": 10001,
"sku": "WMY71443LB2",
"ean": "8690842009112",
"inventory_enabled": "on",
"stock": 20,
"price_net": 1344.54,
"price_gross": 1600.00
}
Ενεργοποιήστε τη λειτουργία αποθέματος με βάση το αναγνωριστικό
Παράδειγμα αιτήματος
PATCH /api/v2/inventory/id/10002
{
"inventory_enabled": "on",
"stock": 5
}
Παράδειγμα απάντησης
{
"id": 10002,
"sku": "TShirt.Blk.XL",
"ean": null,
"inventory_enabled": "on",
"stock": 5,
"price_net": 67.23,
"price_gross": 80.00
}
Ενημέρωση τιμής με φόρους που περιλαμβάνονται βάσει του κωδικού SKU
Παράδειγμα αιτήματος
PATCH /api/v2/inventory/sku/TShirt.Blk.XL
{
"price_gross": 80.00
}
Παράδειγμα απάντησης
{
"id": 10002,
"sku": "TShirt.Blk.XL",
"ean": null,
"inventory_enabled": "off",
"price_net": 67.23,
"price_gross": 80.00
}
Αύξηση μετοχών βάσει κωδικού SKU
Παράδειγμα αιτήματος
PATCH /api/v2/inventory/sku/TShirt.Blk.XL
{
"inventory_enabled": "on",
"stock": {
"adjust_by": 3
}
}
Παράδειγμα απάντησης
{
"id": 10002,
"sku": "TShirt.Blk.XL",
"ean": null,
"inventory_enabled": "on",
"stock": 8,
"price_net": 67.23,
"price_gross": 80.00
}
Ενημέρωση ποσότητας αποθεμάτων με βάση τον κωδικό EAN (εγκατεστημένη εφαρμογή πολλαπλής διαχείρισης)
Παράδειγμα αιτήματος
PATCH /api/v2/inventory/ean/7332543402632
{
"warehouses": [
{
"name": "Depozit central",
"stock": 10
},
{
"name": "Depozit furnizor (Nod)",
"stock": 15
}
]
}
Παράδειγμα απάντησης
{
"id": 10003,
"sku": "ZCG212H1WA",
"ean": "7332543402632",
"inventory_enabled": "on",
"stock": 25,
"warehouses": [
{
"id": 1,
"stock": 10,
"name": "Depozit central"
},
{
"id": 2,
"stock": 15,
"name": "Depozit furnizor (Nod)"
}
],
"price_net": 756.30,
"price_gross": 900.00
}
ΥΠΟΔΕΙΞΗ
Εάν είναι εγκατεστημένη η εφαρμογή πολλαπλής διαχείρισης, η αλλαγή αποθεμάτων δεν μπορεί να γίνει απευθείας χρησιμοποιώντας το πεδίο stock
αλλά μόνο χρησιμοποιώντας το πεδίο warehouses
.