Înregistrare Autentificare

API Asamblare

Gestionarea documentelor de asamblare — preluare, creare, modificare, închidere și înregistrarea la nivel de articol a componentelor utilizate

Puncte finale asamblare

Autentificare

Fiecare cerere API necesită trimiterea header-ului X-API-KEY.

X-API-KEY: {cheia_dvs_api}

Mai ai întrebări?

Trimite-ne un tichet, sau caută în motorul nostru de căutare.

Dacă ți-a plăcut, distribuie-l și altora

URL de bază

https://{tenant}.logzi.com/api/assembly/

Fiecare cerere returnează un răspuns JSON. În cazul unui răspuns cu succes result.code == 1, în caz de eroare result.code == 0.

GET /api/assembly/get

Obținerea unui singur document de asamblare pe baza identificatorului, împreună cu componentele utilizate aferente.

Parametri de interogare

Parametru Tip Obligatoriu Descriere
id int Identificatorul unic al documentului de asamblare

Exemplu de cerere

GET /api/assembly/get?id=5
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 5,
    "identify": "ASM-2024-0005",
    "date_create": "2024-05-08 09:00:00",
    "status_id": 1,
    "store_id": 1,
    "product_id": 42,
    "quantity": 10,
    "company_user_name": "Kovács Péter",
    "item": [
      {
        "product_id": 12,
        "quantity": 20,
        "store_id": 1,
        "store_locality_id": null
      }
    ]
  }
}
GET /api/assembly/list

Preluarea paginată a listei documentelor de asamblare, cu opțiuni de filtrare.

Parametri de interogare

Parametru Tip Obligatoriu Descriere
list_offset int Decalajul paginării (implicit: 0)
list_condition[identify] string Filtrare după identificatorul documentului (LIKE)
list_condition[status_id] int Filtrare după status (1=deschis, 2=închis)
list_condition[date_create_from] date Data creării — de la (YYYY-MM-DD)
list_condition[date_create_to] date Data creării — până la (YYYY-MM-DD)

Exemplu de cerere

GET /api/assembly/list?list_offset=0&list_condition[status_id]=1
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 5,
      "identify": "ASM-2024-0005",
      "date_create": "2024-05-08",
      "status_name": "Nyitott",
      "product_id": 42,
      "quantity": 10,
      "company_user_name": "Kovács Péter"
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 3
  }
}
POST /api/assembly/save

Crearea sau modificarea unui document de asamblare. Trebuie specificate depozitul de destinație, produsul asamblat, cantitatea produsă și tabloul componentelor utilizate. Pentru un document nou data[id] = 0.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
id int 0 = document nou, >0 = modificare
company_id int Identificatorul companiei
company_user_id int Identificatorul angajatului responsabil
company_address_id int Identificatorul sediului
store_id int Identificatorul depozitului de destinație (aici ajunge produsul asamblat)
product_id int Identificatorul produsului asamblat (finit)
quantity decimal Cantitatea produsă (fabricată)
comment_bottom string Comentariu intern
item array Tabloul componentelor utilizate — este obligatoriu cel puțin un articol (vezi mai jos)

Câmpurile articolului — data[item][] (componente utilizate)

Câmp Tip Obligatoriu Descriere
product_id int Identificatorul componentei utilizate (produsului)
quantity decimal Cantitatea utilizată
store_id int Identificatorul depozitului sursă (de unde este scoasă componenta)
store_locality_id int Identificatorul locației de stocare
remove int 1 = ștergerea articolului la modificare

Câmpuri POST — obiectul params (opțional)

Câmp Tip Obligatoriu Descriere
close int 1 = închidere automată după salvare

Exemplu de cerere

POST /api/assembly/save
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "store_id": 1,
    "product_id": 42,
    "quantity": 10,
    "item": [
      {
        "product_id": 12,
        "quantity": 20,
        "store_id": 1
      },
      {
        "product_id": 15,
        "quantity": 10,
        "store_id": 1,
        "store_locality_id": 3
      }
    ]
  },
  "params": {
    "close": 0
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 6,
    "identify": "ASM-2024-0006"
  }
}
POST /api/assembly/delete

Ștergerea unui document de asamblare. Poate fi șters doar un document deschis (status_id = 1).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul documentului care urmează să fie șters

Exemplu de cerere

POST /api/assembly/delete
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "receipt_id": 5
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
POST /api/assembly/close

Închiderea unui document de asamblare deschis. Închiderea efectuează mișcarea de stoc: scade componentele utilizate și creditează produsul asamblat în depozitul de destinație. Poate fi închis doar un document cu status_id = 1 (deschis).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul documentului care urmează să fie închis

Exemplu de cerere

POST /api/assembly/close
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "receipt_id": 5
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}

Ia legătura cu noi

Ești interesat de software-ul nostru? Scrie-ne cu încredere!

Trimite o solicitare

Ai nevoie de ajutor?

Dacă nu găsești răspunsul și ai nevoie de asistență

Răsfoiește centrul de ajutor

Creează-ți contul acum,
plătește mai târziu!

Încearcă gratuit timp de 3 zile, fără riscuri și fără obligații!
Creare cont
Înregistrare