Supplier Offer Request API

Manage offer requests sent to suppliers — retrieval, creation, update and closing

Endpoints

GET Get Single Record
GET Get List
POST Save / Create
POST Delete
POST Close
GET Download

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.

Base URL

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

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

GET /api/offer_request/get

Retrieve a single supplier offer request by identifier, with full details.

Query Parameters

Parameter	Type	Required	Description
`id`	int		Unique identifier of the offer request

Example Request

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

Example Response

{
  "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

Retrieve a paginated list of supplier offer requests with filtering options.

Query Parameters

Parameter	Type	Description
`list_offset`	int	Pagination offset (default: 0)
`list_count`	int	Number of records per page
`list_sort[field]`	string	Name of the sort field
`list_sort[sort]`	string	Sort direction: `ASC` or `DESC`
`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
`list_condition[date_create_from]`	date	Creation date — from (YYYY-MM-DD)
`list_condition[date_create_to]`	date	Creation date — to (YYYY-MM-DD)

Example Request

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

Example Response

{
  "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

Create or update a supplier offer request. Use data[id] = 0 for a new record, or provide the existing ID to update.

POST Fields — data object

Field	Type	Description
`id`	int	0 = new offer request, >0 = update
`company_id`	int	Company identifier
`company_user_id`	int	Responsible employee ID
`company_address_id`	int	Company site ID
`currency_id`	int	Currency identifier
`partner_id`	int	Supplier partner identifier
`date_perform`	date	Deadline date (YYYY-MM-DD)
`comment_top`	string	Comment visible to the supplier
`comment_bottom`	string	Internal comment
`jobnumber_id`	int	Job number identifier
`project_id`	int	Project identifier
`item`	array	Array of line items (see below)

Line Item Fields — data[item][]

Field	Type	Description
`product_id`	int	Product identifier
`quantity`	float	Quantity
`price`	float	Reference net unit price
`tax_id`	int	VAT rate identifier
`price_discount`	float	Discount percentage
`remove`	int	1 = remove the line item on update

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/offer_request/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,
    "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 }
}

Example Response

{
  "result": { "code": 1, "message": "success" },
  "data": { "id": 16, "identify": "AK-2024-0016" }
}

POST /api/offer_request/delete

Delete a supplier offer request. Only an open record (status_id=1) can be deleted.

POST Fields — data object

Field	Type	Required	Description
`receipt_id`	int		Identifier of the offer request to delete

Example Request

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

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

Example Response

{ "result": { "code": 1, "message": "success" }, "data": {} }

POST /api/offer_request/close

Close an open supplier offer request. Only a record with status_id = 1 (open) can be closed.

POST Fields — data object

Field	Type	Required	Description
`receipt_id`	int		Identifier of the offer request to close

Example Request

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

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

Example Response

{ "result": { "code": 1, "message": "success" }, "data": {} }

GET /api/offer_request/download

Download the supplier offer request document in various formats.

Query Parameters

Parameter	Type	Description
`receipt_id`	int	Identifier of the offer request
`file_type`	string	`pdf`, `pdf-string`, `pdf-string-sample`, `stream`
`language`	string	Name of the template language folder (e.g. `hungarian`)
`template_id`	int	Custom print template ID

Example Request

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

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!