Sales
📄️ Where a buyer may collect an order (the seller's own active warehouses).
Where a buyer may collect an order (the seller's own active warehouses).
📄️ RFQs newest first, paged server-side; a plain rep sees only their territory.
RFQs newest first, paged server-side; a plain rep sees only their territory.
📄️ adminGetRfq
adminGetRfq
📄️ Close an open request nobody will quote (a duplicate, or one the buyer withdrew). It moves to cancelled, the reason is posted on the buyer-visible thread and the buyer is notified. 409 invalid_state once it has a quote or is already closed.
Close an open request nobody will quote (a duplicate, or one the buyer withdrew). It moves to cancelled, the reason is posted on the buyer-visible thread and the buyer is notified. 409 invalid_state once it has a quote or is already closed.
📄️ adminQuoteFromRfq
adminQuoteFromRfq
📄️ Catalogue products for a request line nobody matched, one group per part of a set, in the size asked.
Catalogue products for a request line nobody matched, one group per part of a set, in the size asked.
📄️ Quotes newest first, paged server-side; a plain rep sees only their territory.
Quotes newest first, paged server-side; a plain rep sees only their territory.
📄️ adminCreateQuote
adminCreateQuote
📄️ adminGetQuote
adminGetQuote
📄️ adminEditQuote
adminEditQuote
📄️ Delete a draft quote; a sent quote is the buyer's record and cannot be deleted.
Delete a draft quote; a sent quote is the buyer's record and cannot be deleted.
📄️ The record's message thread (staff view — includes internal notes).
The record's message thread (staff view — includes internal notes).
📄️ Post to the thread; visibility 'internal' keeps it staff-only.
Post to the thread; visibility 'internal' keeps it staff-only.
📄️ The buyer's latest counter-offer (note + proposed lines) behind a 'countered' status.
The buyer's latest counter-offer (note + proposed lines) behind a 'countered' status.
📄️ Negotiation history — one immutable snapshot per sent version (lines + subtotal + actor).
Negotiation history — one immutable snapshot per sent version (lines + subtotal + actor).
📄️ adminSendQuote
Sends the current lines as the next version and emails the buyer. A quote that is already sent (or revised) with no edits since is refused with 409 `already_sent` so the buyer is not emailed twice; editing a line withdraws it to draft, and a lapsed quote or a new valid_until is re-sent as a renewal. 422 `unpriced_lines` / `empty_quote` cover zero-priced and all-N/A quotes.
📄️ Replace who the quote goes to on Send; numbers are written the way WhatsApp needs them, addresses lower-cased, duplicates dropped.
Replace who the quote goes to on Send; numbers are written the way WhatsApp needs them, addresses lower-cased, duplicates dropped.
📄️ Delivery services (and cost) available for the quote's destination.
Delivery services (and cost) available for the quote's destination.
📄️ Set delivery-vs-pickup on a quote; shipping is re-priced server-side.
Set delivery-vs-pickup on a quote; shipping is re-priced server-side.
📄️ Set the commercial terms on a quote. Editing a live offer withdraws it to draft for re-send.
Set the commercial terms on a quote. Editing a live offer withdraws it to draft for re-send.
📄️ Files attached to a quote (datasheets, certificates).
Files attached to a quote (datasheets, certificates).
📄️ Attach a file to a quote. Multipart with `file` and an optional `label`; PDF, images, spreadsheets and Word documents up to 25 MB, kept in the private store.
Attach a file to a quote. Multipart with `file` and an optional `label`; PDF, images, spreadsheets and Word documents up to 25 MB, kept in the private store.
📄️ adminDeleteQuoteAttachment
adminDeleteQuoteAttachment
📄️ Orders newest first, paged server-side; a plain rep sees only their territory.
Orders newest first, paged server-side; a plain rep sees only their territory.
📄️ adminCreateOrder
adminCreateOrder
📄️ adminGetOrder
adminGetOrder
📄️ Delete a cancelled order nothing moved on. Refused with 409 `invalid_state` unless the order is cancelled, and with 409 `has_records` when it has a shipment, payment, return, credit note or an invoice that is not void; void invoices and the conversation are removed with it.
Delete a cancelled order nothing moved on. Refused with 409 `invalid_state` unless the order is cancelled, and with 409 `has_records` when it has a shipment, payment, return, credit note or an invoice that is not void; void invoices and the conversation are removed with it.
📄️ adminPatchOrderStatus
adminPatchOrderStatus
📄️ The buyer's own RFQs, newest first, a page at a time.
The buyer's own RFQs, newest first, a page at a time.
📄️ storefrontCreateRfq
storefrontCreateRfq
📄️ storefrontGetRfq
storefrontGetRfq
📄️ storefrontSubmitRfq
storefrontSubmitRfq
📄️ storefrontGetQuote
storefrontGetQuote
📄️ storefrontAcceptQuote
storefrontAcceptQuote
📄️ storefrontDeclineQuote
storefrontDeclineQuote
📄️ Propose a counter-offer on a quote (buyer side of multi-round negotiation)
Records a buyer counter (note + optional per-line proposed qty/price) as an auditable revision and sets the quote to 'countered' for the rep to revise.
📄️ The buyer's view of the negotiation history for their quote (versions + what each contained).
The buyer's view of the negotiation history for their quote (versions + what each contained).
📄️ Live shipping + tax estimate for the active cart
Returns shipping options and per-line VAT for a destination country. Advisory — amounts are re-resolved server-side at placement.
📄️ The buyer's own orders, newest first, a page at a time.
The buyer's own orders, newest first, a page at a time.
📄️ Place an order from the active cart
Converts the customer's active cart into a pending order in one transaction. Addresses default to the customer's defaults when omitted. Lines priced on request never check out; they go to a quote.
📄️ storefrontGetOrder
storefrontGetOrder
📄️ Quotes sent to the buyer (never unsent drafts), newest first, a page at a time.
Quotes sent to the buyer (never unsent drafts), newest first, a page at a time.