Înregistrare Autentificare

API Cerere de ofertă către furnizor

Gestionarea cererilor de ofertă adresate furnizorilor — obținere, creare, modificare și închidere

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

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

GET /api/offer_request/get

Obținerea unei singure cereri de ofertă către furnizor pe baza identificatorului, cu detalii complete.

Parametri query

ParametruTipObligatoriuDescriere
idintIdentificatorul unic al cererii de ofertă

Exemplu de cerere

GET /api/offer_request/get?id=15
X-API-KEY: {cheia_dvs_api}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 15,
    "identify": "AK-2024-0015",
    "date_create": "2024-05-01 09:00:00",
    "date_perform": "2024-05-15",
    "status_id": 1,
    "partner_company_name": "Minta Szállító Kft.",
    "price_netto": 80000,
    "price_brutto": 101600,
    "currency_name": "HUF",
    "item": [
      { "product_id": 3, "quantity": 2, "price": 40000, "tax_id": 2 }
    ]
  }
}
GET /api/offer_request/list

Obținerea paginată a listei cererilor de ofertă către furnizor, cu opțiuni de filtrare.

Parametri query

ParametruTipObligatoriuDescriere
list_offsetintDecalajul de paginare (implicit: 0)
list_countintNumărul de înregistrări afișate pe pagină
list_sort[field]stringNumele câmpului de sortare
list_sort[sort]stringDirecția sortării: ASC sau DESC
list_condition[identify]stringFiltrare după identificator (LIKE)
list_condition[company_name]stringFiltrare după numele partenerului (LIKE)
list_condition[status_id]intFiltrare după status
list_condition[date_create_from]dateData creării — de la (YYYY-MM-DD)
list_condition[date_create_to]dateData creării — până la (YYYY-MM-DD)

Exemplu de cerere

GET /api/offer_request/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": 15, "identify": "AK-2024-0015", "partner_company_name": "Minta Szállító Kft.", "status_id": 1, "price_brutto": 101600 }
  ],
  "params": { "list_count": 20, "list_offset": 0, "list_all": 42 }
}
POST /api/offer_request/save

Creare sau modificare cerere de ofertă către furnizor. Pentru o înregistrare nouă folosiți data[id] = 0, pentru modificare indicați ID-ul existent.

Câmpuri POST — obiectul data

CâmpTipObligatoriuDescriere
idint0 = cerere de ofertă nouă, >0 = modificare
company_idintIdentificatorul companiei
company_user_idintID-ul angajatului responsabil
company_address_idintID-ul sediului companiei
currency_idintIdentificatorul monedei
partner_idintIdentificatorul partenerului furnizor
date_performdateData termenului limită (YYYY-MM-DD)
comment_topstringObservație vizibilă pentru furnizor
comment_bottomstringObservație internă
jobnumber_idintIdentificatorul numărului de lucrare
project_idintIdentificatorul proiectului
itemarrayVectorul de articole (vezi mai jos)

Câmpurile articolului — data[item][]

CâmpTipObligatoriuDescriere
product_idintIdentificatorul produsului
quantityfloatCantitate
pricefloatPreț unitar net orientativ
tax_idintIdentificatorul cotei de TVA
price_discountfloatProcent de discount
removeint1 = ștergerea articolului la modificare

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

CâmpTipObligatoriuDescriere
closeint1 = închidere automată după salvare
downloadint1 = generare PDF după salvare

Exemplu de cerere

POST /api/offer_request/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,
    "currency_id": 1,
    "partner_id": 12,
    "date_perform": "2024-06-30",
    "comment_top": "Kérjük az ajánlatot 15 napon belül visszaküldeni.",
    "item": [
      { "product_id": 5, "quantity": 10, "tax_id": 2 }
    ]
  },
  "params": { "close": 0, "download": 0 }
}

Exemplu de răspuns

{
  "result": { "code": 1, "message": "success" },
  "data": { "id": 16, "identify": "AK-2024-0016" }
}
POST /api/offer_request/delete

Ștergerea unei cereri de ofertă către furnizor. Se poate șterge doar o înregistrare deschisă (status_id=1).

Câmpuri POST — obiectul data

CâmpTipObligatoriuDescriere
receipt_idintIdentificatorul cererii de ofertă de șters

Exemplu de cerere

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

{ "data": { "receipt_id": 15 } }

Exemplu de răspuns

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

Închiderea unei cereri de ofertă deschise către furnizor. Se poate închide doar o înregistrare cu status_id = 1 (deschisă).

Câmpuri POST — obiectul data

CâmpTipObligatoriuDescriere
receipt_idintIdentificatorul cererii de ofertă de închis

Exemplu de cerere

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

{ "data": { "receipt_id": 15 } }

Exemplu de răspuns

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

Descărcarea documentului cererii de ofertă către furnizor în diverse formate.

Parametri query

ParametruTipObligatoriuDescriere
receipt_idintIdentificatorul cererii de ofertă
file_typestringpdf, pdf-string, pdf-string-sample, stream
languagestringNumele folderului de limbă al șablonului (ex. hungarian)
template_idintID-ul șablonului de tipărire personalizat

Exemplu de cerere

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

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