Skip to main content

Quote Endpoints

Quotes & Orders

QuotationHeader

GET /Quotation

Summary: List of QuotationHeader

Returns multiple QuotationHeader records. Requires authentication.

ParameterTypeDescription
awaiting_approvalbooleanFilter by quotes awaiting approval
client_idintegerFilter by client
closedbooleanFilter by closed status
countintegerNumber of records to return
currentclientorallintegerScope filter (current client or all)
includelinesbooleanInclude line items in response
my_approvalsbooleanFilter to quotes awaiting your approval
needsprocessingbooleanFilter by needs-processing status
openbooleanFilter by open status
orderstringPrimary sort field
order2order5stringSecondary–fifth sort fields
orderdescorderdesc5booleanDescending sort flags for each order field
page_nointegerPage number (when paginating)
page_sizeintegerPage size (when paginating)
pageinatebooleanEnable pagination
processedbooleanFilter by processed status
quote_statusstringFilter by quote status
searchstringFull-text search string
site_idintegerFilter by site
ticket_idintegerFilter by associated ticket
user_idintegerFilter by user
filetype_filterstringFilter to quotes that contain an attachment with the specified file type

Response 200: QuotationHeader_View


POST /Quotation

Creates one or more QuotationHeader records.

Request body: Array of QuotationHeader

Response 201: QuotationHeader


GET /Quotation/{id}

Summary: Get one QuotationHeader

Returns a single QuotationHeader by ID. Requires authentication.

ParameterTypeDescription
id (path, required)integerQuote ID
includedetailsbooleanInclude extra detail objects in response
isportalviewbooleanReturn portal-specific view

Response 200: QuotationHeader


DELETE /Quotation/{id}

Deletes a QuotationHeader by ID.

ParameterTypeDescription
id (path, required)integerQuote ID

Response 200: OK


POST /Quotation/Approval

Submits an approval decision for one or more quotes.

Request body: Array of QuotationApproval

Response 200: OK


POST /Quotation/View

Records viewer activity on a quote.

Request body: Array of Viewers

Response 200: OK


POST /Quotation/Lines

Creates or updates quotation line items.

Request body: Array of QuotationDetail

Response 200: OK


OrderHead

GET /SalesOrder

Summary: List of OrderHead

Returns multiple OrderHead (sales order) records. Requires authentication.

ParameterTypeDescription
advanced_searchstringAdvanced search string
billing_datestringFilter by billing date
client_idintegerFilter by client
client_idsstringFilter by multiple clients (comma-separated)
closedbooleanFilter by closed status
countintegerNumber of records to return
idonlybooleanReturn IDs only
needsconsigningbooleanFilter by needs-consigning status
needsinvoicingbooleanFilter by needs-invoicing status
needsorderingbooleanFilter by needs-ordering status
openbooleanFilter by open status
orderorder5stringSort fields (primary through fifth)
orderdescorderdesc5booleanDescending sort flags
page_nointegerPage number
page_sizeintegerPage size
pageinatebooleanEnable pagination
quote_statusstringFilter by quote/order status
ready_for_invoicingbooleanFilter by ready-for-invoicing status
searchstringFull-text search string
site_idintegerFilter by site
ticket_idintegerFilter by associated ticket
toplevel_idintegerFilter by top-level client
user_idintegerFilter by user

Response 200: OrderHead_View


POST /SalesOrder

Creates one or more sales orders.

Request body: Array of OrderHead

Response 201: OrderHead


GET /SalesOrder/{id}

Summary: Get one OrderHead

Returns a single sales order by ID. Requires authentication.

ParameterTypeDescription
id (path, required)integerSales order ID
consignablelinesbooleanReturn only consignable lines
includedetailsbooleanInclude extra detail objects
invoiceablelinesbooleanReturn only invoiceable lines
onelineintegerReturn a specific line
pendingpolinesbooleanReturn only lines with pending purchase orders

Response 200: OrderHead


DELETE /SalesOrder/{id}

Deletes a sales order by ID.

ParameterTypeDescription
id (path, required)integerSales order ID

Response 200: OK


POST /SalesOrder/View

Records viewer activity on a sales order.

Request body: Array of Viewers

Response 200: OK


OrderLine

GET /OrderLine

Returns order line records.

Response 200: OK


SupplierOrderHeader

GET /PurchaseOrder

Summary: List of SupplierOrderHeader

Returns multiple purchase order (supplier order) records. Requires authentication.

ParameterTypeDescription
awaiting_approvalbooleanFilter by suppliers awaiting approval
awaitingstockbooleanFilter by suppliers awaiting stock
client_idintegerFilter by client
closedbooleanFilter by closed status
countintegerNumber of records to return
deliver_to_usbooleanFilter on delivery-to-us option
deliver_to_user_salesorder_idintegerFilter by sales order for delivery
my_approvalsbooleanFilter by suppliers awaiting your approval
openbooleanFilter by open status
orderstringPrimary sort field name
order2order5stringSecondary–fifth sort field names
orderdescbooleanDescending sort on first order field
orderdesc2orderdesc5booleanDescending sort on remaining order fields
page_nointegerPage number when paginating
page_sizeintegerPage size when paginating
pageinatebooleanEnable pagination
po_statusstringFilter by PO status (comma-separated)
salesorder_idintegerFilter by associated sales order
searchstringFull-text search string
site_idintegerFilter by site
supplier_idintegerFilter by supplier
ticket_idintegerFilter by associated ticket
unsentbooleanFilter by unsent status
user_idintegerFilter by user

Response 200: SupplierOrderHeader_View


POST /PurchaseOrder

Creates one or more purchase orders.

Request body: Array of SupplierOrderHeader

Response 201: SupplierOrderHeader


GET /PurchaseOrder/{id}

Summary: Get one SupplierOrderHeader

Returns a single purchase order by ID. Requires authentication.

ParameterTypeDescription
id (path, required)integerPurchase order ID
extrareceivablelinesbooleanInclude deliver-to-us lines where received quantity exceeds current stock
includedetailsbooleanInclude extra objects in response
invoiceablelinesbooleanReturn only invoiceable lines
receivablelinesbooleanInclude only consignable (receivable) lines

Response 200: SupplierOrderHeader


DELETE /PurchaseOrder/{id}

Deletes a purchase order by ID.

ParameterTypeDescription
id (path, required)integerPurchase order ID

Response 200: OK


POST /PurchaseOrder/confirmreceipt

Confirms receipt of goods for a purchase order.

Request body: SupplierOrderHeader

Response 200: OK


POST /PurchaseOrder/View

Records viewer activity on a purchase order.

Request body: Array of Viewers

Response 200: OK


ConsignmentHeader

GET /Consignment

Summary: List of ConsignmentHeader

Returns multiple consignment records. Requires authentication.

ParameterTypeDescription
countintegerNumber of records to return
idonlybooleanReturn IDs only
orderorder5stringSort fields (primary through fifth)
orderdescorderdesc5booleanDescending sort flags
page_nointegerPage number
page_sizeintegerPage size
pageinatebooleanEnable pagination

Response 200: OK


POST /Consignment

Creates one or more consignment records.

Request body: Array of ConsignmentHeader

Response 200: OK


GET /Consignment/{id}

Summary: Get one ConsignmentHeader

Returns a single consignment by ID. Requires authentication.

ParameterTypeDescription
id (path, required)integerConsignment ID
includedetailsbooleanInclude extra detail objects

Response 200: OK


DELETE /Consignment/{id}

Deletes a consignment by ID.

ParameterTypeDescription
id (path, required)integerConsignment ID
deleteOrderbooleanAlso delete the associated order

Response 200: OK