API Numere de serie

Mod de funcționare

Setarea serialnumber_required a produsului determină modul în care sistemul gestionează numerele de serie:

• 1 – număr de serie obligatoriu: fiecare bucată este un rând separat de număr de serie, quantity este întotdeauna 1.
• 2 – număr LOT (lot) obligatoriu: un rând reprezintă mai multe bucăți, quantity este cantitatea din LOT.
• 3 – număr LOT și termen de valabilitate obligatorii: ca LOT, dar rândul are și date_expire (expirare).

Punctele finale de separare (save_separate, save_separate_all) împart rândurile LOT. La separare, rândurile noi primesc toate datele rândului sursă (produs, depozit, locație, palet, număr de serie/identificator LOT, expirare, data creării) precum și legăturile cu documentele; cantitatea totală din stoc nu se modifică.

Separarea este posibilă doar pentru un rând neutilizat (used = 0) și neșters (remove = 0).

Parametri de interogare

Câmpuri de răspuns (obiectul data)

Exemplu de cerere

GET /api/stock_serial/get?id=42
X-API-KEY: {cheia_ta_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": null },
  "data": {
    "id": 42,
    "product_id": 5,
    "store_id": 1,
    "date_create": "2024-03-15 10:22:00",
    "company_id": 1,
    "serial_number": "LOT-2024-00042",
    "remove": 0,
    "used": 0,
    "chk": "5f4dcc3b5aa765d61d8327deb882cf99",
    "store_locality_id": 7,
    "pallet_id": null,
    "quantity": 50,
    "date_expire": "2026-03-15 00:00:00"
  }
}

Înregistrare negăsită

HTTP 203
{
  "result": { "code": 0, "message": "Not found" },
  "data": null
}

Parametri de interogare

Câmpuri de răspuns (elementele tabloului data)

Elementele conțin toate câmpurile punctului final get, cu următoarele diferențe și completări:

Câmpuri de răspuns (obiectul params)

Exemplu de cerere

GET /api/stock_serial/list?list_offset=0&list_condition[product_id]=5&list_condition[used]=0
X-API-KEY: {cheia_ta_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": null },
  "data": [
    {
      "id": 42,
      "stock_serial_id": 42,
      "product_id": 5,
      "store_id": 1,
      "company_id": 1,
      "serial_number": "LOT-2024-00042",
      "quantity": 50,
      "used": 0,
      "remove": 0,
      "chk": "5f4dcc3b5aa765d61d8327deb882cf99",
      "store_locality_id": 7,
      "pallet_id": null,
      "date_create": "2024.03.15 10:22:00",
      "date_expire": "2026.03.15",
      "product_unit_name": "Laptop XYZ",
      "partnumber": "LTP-XYZ-001",
      "store_locality_barcode": "A-01-02",
      "pallet_barcode": null,
      "store_name": "Depozit central"
    }
  ],
  "params": {
    "list_count": 10000,
    "list_offset": 0,
    "list_all": 1
  }
}

Câmpuri POST - obiectul data

Câmpuri de răspuns (obiectul data)

Mesaje de eroare (result.message)

Exemplu de cerere

POST /api/stock_serial/save_separate
X-API-KEY: {cheia_ta_api}
Content-Type: application/json

{
  "data": {
    "stock_serial_id": 42,
    "quantity": 20
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success_msg" },
  "data": {
    "stock_serial_id": 42,
    "new_stock_serial_id": 57,
    "quantity_separated": 20,
    "quantity_left": 30
  }
}

Câmpuri POST - obiectul data

Câmpuri de răspuns (obiectul data)

Mesaje de eroare (result.message)

Exemplu de cerere

POST /api/stock_serial/save_separate_all
X-API-KEY: {cheia_ta_api}
Content-Type: application/json

{
  "data": {
    "stock_serial_id": 42
  }
}

Exemplu de răspuns (împărțirea unui rând de 3 bucăți)

{
  "result": { "code": 1, "message": "success_msg" },
  "data": {
    "stock_serial_id": 42,
    "quantity_before": 3,
    "count": 3,
    "stock_serial_ids": [42, 58, 59]
  }
}