Înregistrare Autentificare

API Recepție Marfă

Gestionarea recepțiilor de marfă — obținere, 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/booking/

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/booking/get

Obținerea unei singure recepții de marfă pe baza identificatorului, cu detalii complete (articole, numere de serie, proiect).

Parametri de interogare

Parametru Tip Obligatoriu Descriere
id int Identificatorul unic al recepției de marfă

Exemplu de cerere

GET /api/booking/get?id=42
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 42,
    "identify": "BK-2024-0042",
    "date_create": "2024-05-01 10:00:00",
    "date_perform": "2024-05-10",
    "status_id": 1,
    "partner_company_name": "Minta Kft.",
    "price_brutto": 127000,
    "price_netto": 100000,
    "price_tax": 27000,
    "currency_name": "HUF",
    "item": [
      {
        "product_id": 5,
        "quantity": 2,
        "price": 50000,
        "price_brutto": 63500
      }
    ]
  }
}
GET /api/booking/list

Obținerea paginată a listei de recepții de marfă, 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ă identificator (LIKE)
list_condition[company_name] string Filtrare după numele partenerului (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)
list_condition[partner_id] int Filtrare după ID-ul partenerului

Exemplu de cerere

GET /api/booking/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": 42,
      "identify": "BK-2024-0042",
      "date_create": "2024-05-01",
      "status_name": "Nyitott",
      "partner_company_name": "Minta Kft.",
      "price_brutto": 127000
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 87
  }
}
POST /api/booking/save

Crearea sau modificarea unei recepții de marfă. Pentru o recepție nouă data[id] = 0, pentru modificare specificați ID-ul existent.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
id int 0 = recepție de marfă nouă, >0 = modificare
company_id int Identificatorul companiei
company_user_id int ID-ul angajatului responsabil
company_address_id int ID-ul sediului companiei
date_perform datetime Data efectuării (YYYY-MM-DD HH:MM:SS)
currency_id int Identificatorul valutei
partner_id int Identificatorul partenerului/clientului
partner_shipping_id int ID-ul adresei de livrare a partenerului
comment_top string Observație vizibilă pentru client
comment_bottom string Observație internă
jobnumber_id int Identificatorul numărului de lucrare
project_id int Identificatorul proiectului
item array Array de articole (vezi mai jos)

Câmpuri articol — data[item][]

Câmp Tip Obligatoriu Descriere
product_id int Identificatorul produsului
store_id int Identificatorul depozitului
quantity float Cantitate
tax_id int Identificatorul cotei de TVA
price float Preț unitar net
price_discount float Procentul de reducere
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
download int 1 = generare PDF după salvare

Exemplu de cerere

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

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "company_address_id": 1,
    "date_perform": "2024-06-15 09:00:00",
    "partner_id": 12,
    "currency_id": 1,
    "comment_top": "Kérjük csomagolt szállítást.",
    "item": [
      {
        "product_id": 5,
        "store_id": 1,
        "quantity": 3,
        "tax_id": 2,
        "price": 15000
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 43,
    "identify": "BK-2024-0043"
  }
}
POST /api/booking/delete

Ștergerea unei recepții de marfă. Poate fi ștearsă doar o recepție deschisă (status_id=1) sau închisă (status_id=2), cu condiția ca numerele de serie să nu fie utilizate.

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul recepției de marfă de șters

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 42
  }
}

Exemplu de răspuns

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

Închiderea unei recepții de marfă deschise. Închiderea execută mișcarea de stoc și validarea cantităților. Poate fi închisă doar o recepție cu status_id = 1 (deschisă).

Câmpuri POST — obiectul data

Câmp Tip Obligatoriu Descriere
receipt_id int Identificatorul recepției de marfă de închis

Exemplu de cerere

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

{
  "data": {
    "receipt_id": 42
  }
}

Exemplu de răspuns

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

Descărcarea/generarea documentului recepției de marfă în diverse formate (PDF, string base64, stream).

Parametri de interogare

Parametru Tip Obligatoriu Descriere
receipt_id int Identificatorul recepției de marfă
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 (pentru căutare bazată pe ID)
template_id int ID-ul șablonului de printare 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/booking/download?receipt_id=42&file_type=pdf
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns (file_type=pdf)

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