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.

Τελευταία τροποποίηση: 30 Jun 2021
Ήταν χρήσιμη αυτή η σελίδα;
Χρειάζεστε ακόμα βοήθεια;