Engrana manual

Contents › Sales

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

  1. 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.
  2. 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).
  3. Buyer columns — if the channel places orders for the end buyer: they are used to find or create the buyer's card.
  4. 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.
  5. 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.