Channel orders
In short
How the channel's customer sends orders: as a file (CSV or XLSX) right here, into the orders folder of their "Own FTP", from their server on a schedule, or via API from their website. Below — received files and orders with the result for each line.
Why it matters
- Turn the customer's order file into a customer order with a reservation, without typing.
- Receive orders from the customer's website or their own Engrana automatically.
- See what was accepted, what was short and why a line was not accepted.
Who can
A manager with the sales channels permission and the administrator. Orders from files and the API are placed by the system channel bot.
How to do it
- Receive an order file. "Upload order file": a header row and rows "brand, part number, quantity". The customer's order number comes from a file column or the field; each number is accepted once.
- Order settings. What to do if there is less in stock than ordered, the customer manager and the column names in the customer's file (empty — the common ones are recognised, such as Brand / Marca, Reference / Referencia, Qty / Cantidad).
- Buyer columns — if the channel places orders for the end buyer: they are used to find or create the buyer's card.
- From the customer's server. "Pick up orders from the customer's server": server, folder, access, file name mask and how often to check. "Fetch now" — do not wait for the schedule.
- Via API. "Enable" — the program issues a key for the website; below is a sample request body. A customer with their own Engrana connects you as the "Engrana" supplier using this installation's address and this key.
Common messages
- "short: N" — this many lines were not fully accepted: the channel's warehouses did not have enough.
- "Order not created: no line was accepted" — check the brands and part numbers in the file.
- "waiting: will be created on the next import" — no stock now; the order will be created later.
- "The channel is disabled…" — enable the channel in "Marketplaces and sales channels".
Questions and answers
Can I upload a file with the same order number again? If an order has already been created under that number, no: "Customer order No. … for this channel has already been received and is not accepted again.". If the previous file did not create an order (no line was accepted), a corrected file with the same number is accepted.
At what price is the order from the file created? The price in the file is not read: the price is the one in the channel price list. If there is free stock — the price of our own stock; if not and the channel exports "on order" — based on the cheapest supplier offer. For an order via the API from your own website, it is the website price the buyer paid; without a price — also by the channel policy.
What happens if there is less in stock than ordered? As chosen in "If there is less in stock than ordered": with "reserve what is available and mark the line" (the default) the line goes into the order in full, what is available is reserved and the line result is "shortage: less reserved"; with "the line is not accepted" that line will not be in the order.
Why was a line not accepted? The reason is in the line result: "product not found", "several products with this part number: specify the brand", "no price under the channel policy", "price below the minimum: the product is not in the channel price list", "brand blocked: not for sale", "invalid quantity" or "not accepted: not enough stock" (with "the line is not accepted").
Are order files deleted from the customer's server? No: the files stay on the customer's server; the program remembers the ones it has already picked up (name, size and modification time) and does not take them again. A file the customer has changed is picked up as a new one.
Where next
- "Orders" — the channel orders created: picking, shipping, invoices.
- "Channel price list" — what the customer sees in the price list.