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 fieldAmazon Vendor valueHow it is used
remoteIdpurchaseOrderNumberIdentifies the sales order.
placedorderDetails.purchaseOrderDateSupplies the order date. The date text is formatted with a trailing Z; this is not a timezone conversion.
totalValueFixed value 0.0The 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 fieldAmazon Vendor valueHow it is used
productIdvendorProductIdentifierLooks up the corresponding product and uses its Optiply product ID.
quantityorderedQuantity.amountBecomes a whole-number quantity.
subtotalValueorderedQuantity.amount × listPrice.amountCalculates 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.