1. Contents
  2. Reference
  3. Channels and tasks
  4. Shöpping
  5. Orders Download

Orders Download

The task fetches the orders from Shöpping into TRADElube, with line items, billing and delivery address, vouchers and the customer behind them. It is the task by which a sale on the marketplace arrives in your order processing.

What gets transferred

For each order at Shöpping an order is created in TRADElube, and with it the records it hangs on: the line items, the two addresses and, where it does not exist yet, the customer. On this channel customers come in through this path only.

Beside the product items, up to three further kinds of line item are created: the shipping cost, the marketplace's vouchers and your own vouchers. Why the vouchers are kept apart is covered below, with the plan.

An order already transferred and unchanged since is skipped. Nothing is ever deleted: an order canceled at Shöpping stays in TRADElube, its order status changes.

The task's own configuration

One field, Age of Orders to Sync, at fourteen days out of the box. It limits how far back the search goes, so that an execution does not walk the entire order history every time.

The figure does not take effect on every execution but once an hour. That run looks at the orders within the days set, in all three open states. The executions in between look only at the last three hours, and within them only at the new orders.

For you that means a new order is there within minutes, while a change to an already confirmed order only arrives with the next hourly execution. Whoever does not want to wait starts the task through Execute.

How the transfer plan is built

One plan with nine sections. The tab bar above them is longer than the screen is wide: the arrows at its ends scroll it along.

Transfer plan of the orders download task with the scrolling section bar and the six rows of the Common section

Section What sits in it
Selection Which orders get taken over at all, and how an existing customer is recognized
Common The order itself: Release, Origin Order Number, Order Time, Order Status, Payment Method and Shipping Method
Billing Address Gender, Title, first and last name, street, Postal Code, City, Country and Phone Number
Shipping Address The same fields
Product Items Product Number, Product Name, Quantity, Gross Price and Tax Rate
Marketplace Voucher Items A discount granted by Shöpping
Merchant Voucher Items A discount granted by you
Initial Shipping Cost The shipping cost as it arrives with the order
Final Shipping Items The same item, once Shöpping reports the shipment, then with a Tracking Number

The two voucher sections are the reason this plan is so wide, and they are no duplication. A marketplace discount is not a deduction from your revenue: Shöpping takes it off the buyer and settles it with you separately. A discount you grant yourself does reduce your revenue. So the one comes in with a gross price of zero and carries its amount in the text only, the other with its amount.

With the shipping cost it is the same consideration over time. As long as the order is open, Shöpping knows the amount only. Once it is completed, the shipment comes along, with a Tracking Number and the carrier. So the second section overwrites the first, and the Tracking Number is the entry that makes it worth it: your customer's shipment tracking hangs on it.

Selection carries two rows, and both are unticked out of the box. Condition decides which orders get taken over at all. The order's state is available as its source. Existing Customer decides whether an order is attached to a customer already present in TRADElube. It is preset with the search by email address, and name, postal code and town are available as further sources should you want to search more finely.

Order Status, Payment Method and Shipping Method come from the channel's mapping tabs of the same name, see Shöpping. Where the row is missing there, the order still arrives and carries nothing in that place.

Individualization pays off on the addresses. Shöpping delivers the street in three fields, street name, house number and door number, and the row Address Line 1 assembles them into one line out of the box. Whoever needs it differently reaches the three fields separately through an assignment by script.

Special features and limits

A product does not have to exist in TRADElube. The line item carries product number and product name from the order, and the reference to the product is made where one with that number is present. Because this channel transfers no products, that number is the only link between the two sides, in full under Shöpping.

Shöpping's order number sits in TRADElube as Origin Order Number. TRADElube assigns your own order number beside it, so that the number ranges of several channels do not overlap.

The country is fixed to Austria. It is not a field of the order but a fixed value of the plan, and that suits a marketplace delivering to Austria.

Further reading