Zamiany stanów magazynowych

Struktura danych JSON

Obiekt WarehouseChange

  • id – ID w bazie danych
  • quantity – zmiana o ilość (dodatnia lub ujemna)
  • qtyBefore – stan towaru przed zmianą (lub null jeżeli niezatwierdzona)
  • qtyAfter – stan towaru po zmianie (lub null jeżeli niezatwierdzona)
  • type – typ zmiany stanu (co spowodowało dodanie zmiany stanu), enum: ORDER_ADD, ORDER_EDIT, ORDER_DELETE
  • commited – czy zatwiedzono?
  • changeDate – data utworzenia zmiany stanu magazynowego
  • commitDate – data zatwierdzenia zmiany stanu magazynowego (lub null gdy nie zatwierdzono)
  • item – obiekt JSON z danymi o zmienianym towarze
    • id – ID towaru
    • name – nazwa towaru
    • code – kod wewnętrzny towaru
    • gtin – GTIN towaru (lub null)
    • price – cena
    • countWare – ilość w magazynie
    • countOffer – ilość w ofercie (lub null)
  • order – obiekt JSON z danymi o zamówieniu które spowodowało zmianę
    • id – ID zamówienia
    • deleted – czy zamówienie zostało usunięte? Jeżeli true, to poniższe pola nie są przesyłane.
    • billOfLading – numer listu przewozowego (lub null)
    • addDate – data utworzenia zamówienia
    • orderDate – data zamówienia
    • lastModDate – data ostatniej modyfikacji zamówienia (lub null)

Pobieranie wszystkich zmian stanów dla danego miesiąca

GET

/warehouse_changes

Parametry w ścieżce zapytania
  • month – miesiąc
  • year – rok
/warehouse_changes?month=7&year=2022
Odpowiedź JSON - zawiera tablicę obiektów WarehouseChange
{
    "warehouseChanges": [
        ...
    ]
}

Pobieranie zmiany stanu magazynowego

GET

/warehouse_changes

Parametry w ścieżce zapytania
  • id – ID zmiany stanu
/warehouse_changes?id=1
Odpowiedź JSON
{
    "id":109,
    "quantity":1,
    "qtyBefore":null,
    "qtyAfter":null,
    "type":"ORDER_EDIT",
    "commited":false,
    "changeDate":"2022-06-28T14:23:10Z",
    "commitDate":null,
    "item":{
        "id":4,
        "name":"Rezystor 1k SMD 100szt",
        "code":"S101",
        "gtin":null,
        "price":8.99,
        "countWare":390,
        "countOffer":null
    },
    "order":{
        "id":139,
        "deleted":false,
        "billOfLading":null,
        "addDate":"2022-04-20T14:40:06Z",
        "orderDate":"2022-04-20T14:39:00Z",
        "lastModDate":"2022-06-28T14:23:10Z"
    }
}

Zatwierdzanie zmiany stanu magazynowego

PUT

/warehouse_changes

Dane JSON w zapytaniu (body)
  • id – ID zmiany stanu do zatwierdzenia
{
    "id": 1
}
Odpowiedź - 204 No Content

Usuwanie zmiany stanu magazynowego

DELETE

/warehouse_changes

Parametry w ścieżce zapytania
  • id – ID zmiany stanu do usunięcia
/warehouse_changes?id=1
Odpowiedź - 204 No Content

Pobieranie zmian stanów magazynowych z danego miesiąca jako CSV

GET

/warehouse_changes/export_csv

Parametry w ścieżce zapytania
  • month – miesiąc
  • year – rok
/warehouse_changes/export_csv?month=7&year=2022
Dane odpowiedzi JSON

W odpowiedzi zwrócony zostane pole „csv” z danymi zakodowanymi za pomocą Base64.