Marketplace

Incoming Orders

An order from the marketplace is a buyer asking. This is where you answer.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/marketplace/orders

Requires subscriptionmarket.publish10,000 IQD / month

The list

Marketplace → Incoming orders lists what buyers have sent, newest first. Filter by status, and press Refresh to check for new ones.

Columns
ParameterTypeRequiredDescription
Order nostringOptionalThe order's number.
Buyer / BusinessstringOptionalWho sent it and the business they buy for.
Phone / CitystringOptionalHow to reach them and where they are.
LinesintegerOptionalHow many products are on the order.
TotaldecimalOptionalThe order's total at your prices — empty when your prices were hidden.
ReceivedageOptionalHow long ago it arrived.
StatusbadgeOptionalPending, Confirmed, Rejected or Cancelled.

Statuses

ParameterTypeRequiredDescription
PendingstatusRequiredWaiting for your answer. The buyer can still cancel it.
ConfirmedstatusOptionalYou accepted it. The buyer is told.
RejectedstatusOptionalYou declined it, with a reason the buyer sees.
CancelledstatusOptionalThe buyer withdrew it while it was still pending.

Handling an order

  1. 1

    Open the order

    You see the buyer, their business, phone and city, any note they wrote, and the lines with unit, quantity and price.

    Marketplace — A marketplace order
    A marketplace order
    A marketplace order — An incoming order with the buyer's details, their note, the lines as they were when the order was sent, and the Confirm and Reject buttons.
  2. 2

    Phone the buyer

    Agree what is available, the final price, delivery and how they will pay. The order is a starting point for that conversation.

  3. 3

    Confirm or Reject

    Confirm tells the buyer you accept. Reject needs a reason — for example “Out of stock until next week” — and the buyer sees it.

  4. 4

    Record the sale

    When the goods go out, ring the sale up in Quick POS or raise a Sales Order, exactly as for any other customer. That is what moves stock and money.

Confirming does not create a saleConfirming tells the buyer you accept the order. It does not create a sale and does not change your stock. Nothing reaches your stock, finance or customer balances until you record the sale yourself.

Prices on an order are a snapshot

The names, units and prices on an order were copied at the moment the buyer sent it. If you have changed a price since, the order still shows what the buyer saw — your current product price may be different. If your prices were hidden when the order was sent, the order carries no prices at all.

Linking the buyer to a customer

When confirming, you can choose one of your own customers for this buyer. It is optional — you can confirm without one.

  • The next order from the same buyer is matched to that customer automatically, and you can change it.
  • Linking does not put anything on the customer's balance; it only saves you finding them again.
  • Choosing a customer needs the Customers feature. Without it you simply confirm without one.

One cart, several shops

NoteA buyer who fills one cart from three shops sends three orders — one per shop. You only ever see the lines that are yours, and the buyer is told before sending that each shop will call and deliver separately. An order that is sent twice by accident — a dropped connection, a double tap — arrives once.
Endpoints — /api/v1/market-admin
ParameterTypeRequiredDescription
GET /ordersendpointOptionalYour incoming orders, paged, by status.
GET /orders/{id}endpointOptionalOne order with its lines. Another shop's order is not found.
POST /orders/{id}/confirmendpointOptionalConfirm, optionally linking a customer.
POST /orders/{id}/rejectendpointOptionalReject, with the reason shown to the buyer.

Related