Înregistrare Autentificare

API colectare coduri de bare

Gestionarea fișelor de colectare — obținerea, crearea, modificarea, închiderea și schimbarea statusului colectărilor de intrare și ieșire

Endpointuri

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/collect/

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

GET /api/collect/get

Obținerea unei singure fișe de colectare pe baza identificatorului, cu detalii complete (articole, numere de serie, locații de depozit, proiect).

Parametri query

Parametru Tip Obligatoriu Descriere
id int Identificatorul unic al fișei de colectare

Exemplu de cerere

GET /api/collect/get?id=101
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 101,
    "identify": "COL-2024-0101",
    "date_create": "2024-05-01 10:00:00",
    "date_update": "2024-05-01 11:30:00",
    "receipt_type_id": 34,
    "status_id": 1,
    "company_id": 1,
    "company_user_id": 3,
    "pallet_based": 0,
    "order_out_identify": "OR-2024-0055",
    "comment_top": "",
    "comment_bottom": "",
    "item": [
      {
        "id": 201,
        "partnumber": "PROD-001",
        "quantity": 5,
        "price": 3000,
        "store_id": 1,
        "store_locality_id": 12,
        "pallet_id": null,
        "checked": 0,
        "status_id": 1
      }
    ]
  }
}
GET /api/collect/list

Obținerea paginată a listei de fișe de colectare, cu opțiuni de filtrare.

Parametri query

Parametru Tip Obligatoriu Descriere
list_offset int Decalajul paginării (implicit: 0)
list_count int Numărul de înregistrări afișate pe pagină
list_sort[field] string Numele câmpului de sortare
list_sort[sort] string Direcția sortării: ASC sau DESC
list_condition[identify] string Filtrare după identificator (LIKE)
list_condition[status_id] int Filtrare după status
list_condition[receipt_type_id] int Filtrare după tipul de colectare (32=intrare, 34=ieșire)
list_condition[company_user_id] int Filtrare după angajatul responsabil
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)
list_condition[partnumber] string Filtrare după codul produsului (LIKE)
list_condition[order_out_identify] string Filtrare după identificatorul comenzii de ieșire
list_condition[pallet_barcode] string Filtrare după codul de bare al paletului
list_condition[store_locality_barcode] string Filtrare după codul de bare al locației de depozit

Exemplu de cerere

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

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 101,
      "identify": "COL-2024-0101",
      "date_create": "2024-05-01 10:00:00",
      "receipt_type_id": 34,
      "status_id": 1,
      "status_name": "Nyitott",
      "company_user_id": 3
    }
  ],
  "params": {
    "list_count": 20,
    "list_offset": 0,
    "list_all": 134
  }
}
POST /api/collect/save

Crearea sau modificarea unei fișe de colectare. Pentru o colectare nouă folosiți data[id] = 0, pentru modificare indicați ID-ul existent.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
id int 0 = fișă de colectare nouă, >0 = modificare
receipt_type_id int Tipul colectării: 32 = intrare, 34 = ieșire
company_id int Identificatorul companiei
company_user_id int ID-ul angajatului responsabil
company_address_id int ID-ul punctului de lucru al companiei
pallet_based int 1 = colectare pe bază de paleți (pallet_id necesar pentru fiecare articol)
order_out_identify string Numărul de referință al comenzii de ieșire
order_in_identify string Numărul de referință al comenzii de intrare
invoice_in_identify string Numărul de referință al facturii de intrare
delivery_note_in_identify string Numărul de referință al avizului de însoțire de intrare
jobnumber_id int Identificatorul numărului de lucrare
departmentnumber_id int Identificatorul numărului de departament
comment_top string Observație (publică)
comment_bottom string Observație internă
item array Vectorul articolelor (vezi mai jos)

Câmpurile articolului — data[item][]

Câmp Tip Obligatoriu Descriere
id int 0 = articol nou, >0 = modificarea unuia existent
partnumber string Codul produsului
quantity float Cantitatea colectată
price float Preț unitar (dacă lipsește, se completează din lista de prețuri)
store_id int Identificatorul depozitului
store_locality_id int Identificatorul locației de depozit
pallet_id int Identificatorul paletului
checked int 1 = articol verificat/scanat
comment_top string Observație la nivel de articol
serialnumber array Vectorul numerelor de serie (vezi mai jos)
remove int 1 = ștergerea articolului la modificare

Câmpurile numărului de serie — data[item][][serialnumber][]

Câmp Tip Obligatoriu Descriere
val string Valoarea numărului de serie
expire date Data expirării (YYYY-MM-DD)
qty float Cantitatea aferentă acestui număr de serie

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

Câmp Tip Obligatoriu Descriere
close int 1 = închidere automată după salvare
status_change int Schimbare automată de status la valoarea indicată, după salvare

Exemplu de cerere

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

{
  "data": {
    "id": 0,
    "receipt_type_id": 34,
    "company_id": 1,
    "company_user_id": 3,
    "order_out_identify": "OR-2024-0055",
    "comment_bottom": "Sürgős kiszedés",
    "item": [
      {
        "partnumber": "PROD-001",
        "quantity": 5,
        "store_id": 1,
        "store_locality_id": 12,
        "checked": 1
      }
    ]
  },
  "params": {
    "close": 0
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 102,
    "identify": "COL-2024-0102",
    "item": {
      "1": {
        "id": 205,
        "partnumber": "PROD-001"
      }
    }
  }
}
POST /api/collect/delete

Ștergerea unei fișe de colectare. Statusuri care pot fi șterse: deschis (1), închis (2) și diverse stări de procesare (15, 16, 31–36).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul fișei de colectare de șters

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 101
  }
}

Exemplu de răspuns

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

Închiderea unei fișe de colectare deschise. Închiderea execută mișcarea de stoc și validează cantitatea articolelor. Poate fi închisă doar o colectare cu status_id = 1 (deschisă).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul fișei de colectare de închis

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 101
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
POST /api/collect/status_change

Schimbarea statusului fișei de colectare între pașii fluxului de procesare. Statusul 16 (ridicat) poate fi setat doar la colectările de ieșire (tip 34), din statusul 15.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul fișei de colectare
status_id int Identificatorul noului status
comment_bottom string Actualizarea observației interne
company_user_id int Transferarea angajatului responsabil către alt utilizator

Exemplu de cerere

POST /api/collect/status_change
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "receipt_id": 101,
    "status_id": 15,
    "comment_bottom": "Kiszedésre vár"
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {}
}
GET /api/collect/download

Descărcarea/generarea documentului fișei de colectare în diverse formate (PDF, string base64, stream).

Parametri query

Parametru Tip Obligatoriu Descriere
receipt_id int Identificatorul fișei de colectare
file_type string Formatul de ieșire (vezi mai jos)
language string Numele folderului lingvistic al șablonului (ex. hungarian)
language_id int Identificatorul limbii (pentru căutare pe bază de ID)
template_id int ID-ul șablonului de tipărire personalizat

Valori posibile pentru file_type

Valoare Descriere
pdf Returnarea unui PDF codificat base64, cu metadate
pdf-string Identic cu pdf — string base64 + metadate
pdf-string-sample Generare PDF de previzualizare
stream Stream direct de fișier (descărcare din browser)

Exemplu de cerere

GET /api/collect/download?receipt_id=101&file_type=pdf
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "COL-2024-0101.pdf",
    "content": "JVBERi0xLjQK...",
    "receipt": { ... }
  }
}

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