This reference covers the sales-order import. It is separate from Amazon Seller, and it does not describe connector setup or your account's synchronization schedule.
Order fields
| Optiply field | Amazon Vendor value | How it is used |
|---|---|---|
remoteId | purchaseOrderNumber | Identifies the sales order. |
placed | orderDetails.purchaseOrderDate | Supplies the order date. The date text is formatted with a trailing Z; this is not a timezone conversion. |
totalValue | Fixed value 0.0 | The order header total is zero. It is not calculated from the line values. |
Amazon's purchaseOrderState is not transferred as the Optiply sales-order status.
Sales-order lines
The items within orderDetails.items supply the order's lines.
| Optiply field | Amazon Vendor value | How it is used |
|---|---|---|
productId | vendorProductIdentifier | Looks up the corresponding product and uses its Optiply product ID. |
quantity | orderedQuantity.amount | Becomes a whole-number quantity. |
subtotalValue | orderedQuantity.amount × listPrice.amount | Calculates the line value, rounded to two decimal places. |
The order header and its lines therefore have different value rules: a line can have a nonzero subtotalValue while the order's totalValue remains zero. Do not use the header total as a substitute for the imported line values.
Product matching
For a sales-orders-only connection that uses your existing Optiply products, the product lookup uses their EAN codes. The incoming vendorProductIdentifier must match a product in that lookup. Other connection arrangements use their own product lookup; the sales-orders-only EAN rule is not a choice of matching key for every setup.
Lines without a matching product are excluded. An order with no matching lines is not imported. If an order contains several lines for the same product identifier, only one of those lines is retained; they are not added together.
Existing orders
The import creates orders not already recorded by the connection. It does not update orders already recorded there, including later changes to their lines. Correcting an order in Amazon Vendor is therefore not a way to update a previously imported sales order in Optiply.