Înregistrare Autentificare

API Transfer între depozite

Gestionarea transferurilor între depozite — interogare, creare, modificare, închidere și descărcare document

Endpoint-uri

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

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

GET /api/transmission/get

Interogarea unui singur transfer între depozite pe baza identificatorului, cu detalii complete (poziții, depozit sursă/destinație, numere de serie, proiect).

Parametri de interogare

Parametru Tip Obligatoriu Descriere
id int Identificatorul unic al transferului între depozite

Exemplu de cerere

GET /api/transmission/get?id=11
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 11,
    "identify": "TR-2024-0011",
    "date_create": "2024-05-06 08:30:00",
    "date_perform": "2024-05-06",
    "status_id": 1,
    "item": [
      {
        "product_id": 3,
        "quantity": 10,
        "src_store_id": 1,
        "src_store_locality_id": 4,
        "dst_store_id": 2,
        "dst_store_locality_id": 7
      }
    ]
  }
}
GET /api/transmission/list

Interogarea paginată a listei transferurilor între depozite, cu opțiuni de filtrare.

Parametri de interogare

Parametru Tip Obligatoriu Descriere
list_offset int Decalajul de paginare (implicit: 0)
list_condition[identify] string Filtrare după identificator (LIKE)
list_condition[status_id] int Filtrare după status (1=deschis, 2=închis)
list_condition[status_ids] array Filtrare după mai multe statusuri simultan
list_condition[company_user_id] int Filtrare după ID-ul angajatului 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[date_perform_from] date Data efectuării — de la (YYYY-MM-DD)
list_condition[date_perform_to] date Data efectuării — până la (YYYY-MM-DD)
list_condition[partnumber] string Filtrare după cod de articol sau cod de bare (LIKE)
list_condition[comment_bottom] string Filtrare după observația internă (LIKE)

Exemplu de cerere

GET /api/transmission/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": 11,
      "identify": "TR-2024-0011",
      "date_create": "2024-05-06",
      "status_name": "Nyitott",
      "company_user_name": "Kovács Péter"
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 8
  }
}
POST /api/transmission/save

Creare sau modificare a unui transfer între depozite. Pentru fiecare poziție trebuie specificat separat depozitul sursă și cel destinație. Pentru un transfer nou data[id] = 0, pentru modificare specificați ID-ul existent.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
id int 0 = transfer nou, >0 = modificare
company_id int Identificatorul companiei
company_user_id int ID-ul angajatului responsabil
date_perform datetime Data efectuării (YYYY-MM-DD HH:MM:SS)
comment_bottom string Observație internă
jobnumber_id int Identificatorul numărului de lucrare
departmentnumber_id int Identificatorul numărului de departament
project_id int Identificatorul proiectului
source_receipt_id int Identificatorul documentului sursă
source_receipt_type_id int Identificatorul tipului documentului sursă
item array Tabloul pozițiilor — este obligatorie cel puțin o poziție (vezi mai jos)

Câmpurile poziției — data[item][]

Câmp Tip Obligatoriu Descriere
product_id int Identificatorul produsului
quantity decimal Cantitatea de transferat
src_store_id int Identificatorul depozitului sursă
src_store_locality_id int Identificatorul locației sursă
src_pallet_id int Identificatorul paletului sursă
dst_store_id int Identificatorul depozitului destinație
dst_store_locality_id int Identificatorul locației destinație
dst_pallet_id int Identificatorul paletului destinație

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

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

Exemplu de cerere

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

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "date_perform": "2024-06-10 08:00:00",
    "item": [
      {
        "product_id": 3,
        "quantity": 10,
        "src_store_id": 1,
        "src_store_locality_id": 4,
        "dst_store_id": 2,
        "dst_store_locality_id": 7
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 12,
    "identify": "TR-2024-0012"
  }
}
POST /api/transmission/save_group

Creare de transfer grupat între depozite. Datele depozitului/locației/paletului sursă și destinație trebuie specificate la nivelul data — acestea se aplică în mod unitar tuturor pozițiilor.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
company_id int Identificatorul companiei
company_user_id int ID-ul angajatului responsabil
src_store_id int Identificatorul depozitului sursă (valabil pentru toate pozițiile)
src_store_locality_id int Identificatorul locației sursă (valabil pentru toate pozițiile)
src_pallet_id int Identificatorul paletului sursă (valabil pentru toate pozițiile)
dst_store_id int Identificatorul depozitului destinație (valabil pentru toate pozițiile)
dst_store_locality_id int Identificatorul locației destinație (valabil pentru toate pozițiile)
dst_pallet_id int Identificatorul paletului destinație (valabil pentru toate pozițiile)
date_perform datetime Data efectuării (YYYY-MM-DD HH:MM:SS)
comment_bottom string Observație internă
item array Tabloul pozițiilor — este necesar doar product_id și quantity pentru fiecare poziție

Exemplu de cerere

POST /api/transmission/save_group
X-API-KEY: {cheia_dvs_api}
Content-Type: application/json

{
  "data": {
    "company_id": 1,
    "company_user_id": 3,
    "src_store_id": 1,
    "src_store_locality_id": 4,
    "dst_store_id": 2,
    "dst_store_locality_id": 7,
    "date_perform": "2024-06-10 08:00:00",
    "item": [
      { "product_id": 3, "quantity": 10 },
      { "product_id": 7, "quantity": 4 }
    ]
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 13,
    "identify": "TR-2024-0013"
  }
}
POST /api/transmission/delete

Ștergerea unui transfer între depozite. Se poate șterge doar un document cu status_id = 1 (deschis) sau status_id = 2 (închis).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul transferului între depozite de șters

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 11
  }
}

Exemplu de răspuns

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

Închiderea unui transfer între depozite deschis. Se poate închide doar un document cu status_id = 1 (deschis).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul transferului între depozite de închis

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 11
  }
}

Exemplu de răspuns

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

Generarea documentului transferului între depozite în diverse formate (PDF, șir base64, stream).

Parametri de interogare

Parametru Tip Obligatoriu Descriere
receipt_id int Identificatorul transferului între depozite
file_type string Formatul de ieșire (vezi mai jos)
language string Numele folderului de limbă al șablonului (ex. hungarian)
language_id int Identificatorul limbii (implicit: 1)
template_id int ID-ul șablonului de tipărire personalizat

Valorile posibile pentru file_type

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

Exemplu de cerere

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

Exemplu de răspuns (file_type=pdf)

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "name": "TR-2024-0011.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