Sign up Log in

Stock Reservation API

Manage stock reservations — retrieval, creation, modification, closing, and document download

Endpoints

Authentication

Every API request requires sending the X-API-KEY header.

X-API-KEY: {your_api_key}

Still have questions?

Open a ticket with us, or browse our help center.

If you liked it, share it with others

Base URL

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

Every request returns a JSON response. On success result.code == 1, on error result.code == 0.

GET /api/reserve/get

Retrieve a single stock reservation by identifier, with full details (items, stock data, project).

Query parameters

Parameter Type Required Description
id int Unique identifier of the stock reservation

Example request

GET /api/reserve/get?id=23
X-API-KEY: {your_api_key}

Example response

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 23,
    "identify": "RES-2024-0023",
    "date_create": "2024-05-05 09:15:00",
    "date_perform": "2024-05-20",
    "status_id": 1,
    "partner_company_name": "Minta Kft.",
    "price_brutto": 95000,
    "price_netto": 74803,
    "price_tax": 20197,
    "currency_name": "HUF",
    "item": [
      {
        "product_id": 8,
        "quantity": 5,
        "price": 14961,
        "price_brutto": 19000
      }
    ]
  }
}
GET /api/reserve/list

Paginated retrieval of the list of stock reservations with filtering options.

Query parameters

Parameter Type Required Description
list_offset int Pagination offset (default: 0)
list_condition[identify] string Filter by identifier (LIKE)
list_condition[company_name] string Filter by partner name (LIKE)
list_condition[status_id] int Filter by status (1=open, 2=closed)
list_condition[status_ids] array Filter by multiple statuses at once
list_condition[date_create_from] date Creation date — from (YYYY-MM-DD)
list_condition[date_create_to] date Creation date — to (YYYY-MM-DD)
list_condition[date_perform_from] date Fulfillment date — from (YYYY-MM-DD)
list_condition[date_perform_to] date Fulfillment date — to (YYYY-MM-DD)
list_condition[partner_id] int Filter by partner ID
list_condition[company_user_id] int Filter by responsible employee ID
list_condition[partnumber] string Filter by SKU or barcode (LIKE)
list_condition[comment_top] string Filter by customer-visible comment (LIKE)
list_condition[comment_bottom] string Filter by internal comment (LIKE)

Example request

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

Example response

{
  "result": { "code": 1, "message": "success" },
  "data": [
    {
      "id": 23,
      "identify": "RES-2024-0023",
      "date_create": "2024-05-05",
      "status_name": "Nyitott",
      "partner_company_name": "Minta Kft.",
      "price_brutto": 95000
    }
  ],
  "params": {
    "list_count": 10,
    "list_offset": 0,
    "list_all": 12
  }
}
POST /api/reserve/save

Create or modify a stock reservation. For a new reservation use data[id] = 0, for modification provide the existing ID.

POST fields — data object

Field Type Required Description
id int 0 = new stock reservation, >0 = modification
company_id int Company identifier
company_user_id int Responsible employee ID
company_address_id int Company site ID
date_perform datetime Fulfillment date (YYYY-MM-DD HH:MM:SS)
currency_id int Currency identifier
partner_id int Partner/customer identifier
partner_user_id int Partner contact person ID
partner_shipping_id int Partner shipping address ID
currency_exchange decimal Exchange rate (default: 1)
comment_top string Customer-visible comment
comment_bottom string Internal comment
jobnumber_id int Job number identifier
departmentnumber_id int Department number identifier
project_id int Project identifier
source_receipt_id int Source document identifier
source_receipt_type_id int Source document type identifier
item array Array of items — at least one item is required (see below)

Item fields — data[item][]

Field Type Required Description
id int 0 = new item, >0 = modify existing item
product_id int Product identifier
store_id int Warehouse identifier
store_locality_id int Storage location identifier
pallet_id int Pallet identifier
quantity decimal Quantity
tax_id int VAT rate identifier
price decimal Net unit price
price_discount decimal Discount/markup percentage
stock_change int Stock movement flag
comment_top string Comment for the item
remove int 1 = delete item during modification

POST fields — params object (optional)

Field Type Required Description
close int 1 = automatically close after saving
download int 1 = generate PDF after saving

Example request

POST /api/reserve/save
X-API-KEY: {your_api_key}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "company_id": 1,
    "company_user_id": 3,
    "company_address_id": 1,
    "date_perform": "2024-06-20 00:00:00",
    "partner_id": 12,
    "currency_id": 1,
    "item": [
      {
        "id": 0,
        "product_id": 8,
        "store_id": 1,
        "quantity": 5,
        "tax_id": 2,
        "price": 14961
      }
    ]
  },
  "params": {
    "close": 0,
    "download": 0
  }
}

Example response

{
  "result": { "code": 1, "message": "success" },
  "data": {
    "id": 24,
    "identify": "RES-2024-0024"
  }
}
POST /api/reserve/delete

Delete a stock reservation. Only a document with status_id = 1 (open) or status_id = 2 (closed) can be deleted.

POST fields — data object

Field Type Required Description
receipt_id int Identifier of the stock reservation to delete

Example request

POST /api/reserve/delete
X-API-KEY: {your_api_key}
Content-Type: application/json

{
  "data": {
    "receipt_id": 23
  }
}

Example response

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

Close an open stock reservation. Only a document with status_id = 1 (open) can be closed.

POST fields — data object

Field Type Required Description
receipt_id int Identifier of the stock reservation to close

Example request

POST /api/reserve/close
X-API-KEY: {your_api_key}
Content-Type: application/json

{
  "data": {
    "receipt_id": 23
  }
}

Example response

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

Generate the stock reservation document in various formats (PDF, base64 string, stream).

Query parameters

Parameter Type Required Description
receipt_id int Identifier of the stock reservation
file_type string Output format (see below)
language string Template language folder name (e.g. hungarian)
language_id int Language identifier (default: 1)
template_id int Custom print template ID

file_type possible values

Value Description
pdf Returns a base64-encoded PDF with metadata
pdf-string Same as pdf — base64 string + metadata
pdf-string-sample Preview PDF generation
stream Direct file stream (browser download)

Example request

GET /api/reserve/download?receipt_id=23&file_type=pdf
X-API-KEY: {your_api_key}

Example response (file_type=pdf)

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

Get in touch with us

Interested in our software? Feel free to write to us!

Send an inquiry

Need help?

If you can't find the answer and need assistance

Browse the help center

Create your account now,
pay later!

Try it free for 3 days, no risk, no obligation!
Create an account
Register