Customer Offer Request API

Managing incoming customer offer requests — retrieval, creation, modification, closing and document download

Base URL

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

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

GET /api/offer_request/get

Retrieves a single customer offer request by identifier, with full details.

Query parameters

ParameterTypeRequiredDescription
idintUnique identifier of the offer request

Example request

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

Retrieves a paginated list of customer offer requests with filtering options.

Query parameters

ParameterTypeRequiredDescription
list_offsetintPagination offset (default: 0)
list_countintNumber of records per page
list_condition[identify]stringFilter by identifier (LIKE)
list_condition[company_name]stringFilter by partner name (LIKE)
list_condition[status_id]intFilter by status
list_condition[date_create_from]dateCreation date — from (YYYY-MM-DD)
list_condition[date_create_to]dateCreation 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}
POST /api/offer_request/save

Creates or updates a customer offer request. For a new record use data[id] = 0.

POST fields — data object

FieldTypeRequiredDescription
idint0 = new offer request, >0 = update
company_idintCompany identifier
company_user_idintID of the responsible employee
company_address_idintCompany site ID
currency_idintCurrency identifier
partner_idintPartner/customer identifier
comment_topstringComment
comment_bottomstringInternal comment
itemarrayArray of line items

Line item fields — data[item][]

FieldTypeRequiredDescription
product_idintProduct identifier
quantityfloatRequested quantity
pricefloatProposed unit price
tax_idintVAT rate identifier
removeint1 = remove item during update

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,
    "item": [
      { "product_id": 5, "quantity": 10 }
    ]
  }
}
POST /api/offer_request/delete

Deletes a customer offer request. Only a record with open status can be deleted.

POST fields — data object

FieldTypeRequiredDescription
receipt_idintIdentifier 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": 8 } }
POST /api/offer_request/close

Closes a customer offer request. Only a record with open status (status_id=1) can be closed.

POST fields — data object

FieldTypeRequiredDescription
receipt_idintIdentifier 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": 8 } }
GET /api/offer_request/download

Downloads the document of a customer offer request in various formats.

Query parameters

ParameterTypeRequiredDescription
receipt_idintIdentifier of the offer request
file_typestringpdf, pdf-string, pdf-string-sample, stream
languagestringName of the template language folder
template_idintCustom print template ID

Example request

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

Get in touch with us

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

Need help?

If you can't find the answer and need assistance

Create your account now,
pay later!

Try it free for 3 days, no risk, no obligation!