Important: Your enabled data flows and configuration can differ. Only the fields listed below are covered by this guide; other fields are not automatically implied to synchronise.

Reading the mapping tables

The Optiply field column identifies the field in Optiply. For an inbound flow it is the destination; for an outbound flow it is the origin. The second column gives the corresponding external field or documented transformation. Read each table with its entity and direction. The entity and direction matter: inbound EasyEcom-to-Optiply mappings are separate from outbound Optiply-to-EasyEcom mappings.

Trace one field: outbound Buy Order Line unit price

Purpose

Trace the documented unit-price mapping for a Buy Order Line sent from Optiply to EasyEcom, including the source’s tax condition.

Before you start

Identify an outbound Optiply-to-EasyEcom Buy Order Line, not an inbound EasyEcom Buy Order Line. A sample is optional for tracing the published mapping. If comparing an example’s tax treatment, use read-only information and know the send_tax_rate setting for that example; this guide does not verify that setting.

Steps

  1. Confirm the record is an outbound Buy Order Line. The inbound and outbound Buy Order tables have different mappings.
  2. Read the outbound line row below and record its exact field path.
  3. If assessing an example’s tax treatment, check the documented send_tax_rate condition without changing the setting.
  4. Report the mapping and, only when the setting is known, whether the documented tax condition applies.

Fields and columns

  • subTotalValue / quantity: the documented Optiply value expression for the outbound Buy Order Line.
  • items.unitPrice: the EasyEcom destination field; the documented tax condition is described above.

The source maps subTotalValue / quantity to items.unitPrice. The source says send_tax_rate defaults to false; when it is true, the product tax_rate is added to the unit price before export. A default in the source does not establish the setting for a particular account.

Expected result

The documented outbound field path is items.unitPrice. Tax is added under the documented condition only when send_tax_rate is true. If the setting for an example is unknown, whether tax was added is not assessable from this mapping alone.

Limitations

This guide describes the cited mapping; it does not confirm an account’s current settings, enabled flow, or export. It does not establish the send_tax_rate value for an account or the value of any particular order line.

Errors and recovery

If the field path, sample, or relevant setting is unavailable—or the sample appears inconsistent—mark that part “not assessable” and ask Optiply Support to review read-only information. Do not change a setting to test the mapping.

Synchronisation schedule and direction

The table shows the documented direction and interval. The Product Deletions row’s #N/A is not a polling frequency: deleted products are not retrieved from EasyEcom, so this source cannot currently identify them. The source lists the outbound Buy Order and Buy Order Line mappings separately below the schedule.

EntityDirectionFrequency / note
ProductsEasyEcom > OPevery 30 minutes
Product Deletions (*2)EasyEcom > OP#N/A; deleted products are not retrieved and cannot currently be identified
SuppliersEasyEcom > OPevery 30 minutes
SupplierProductsEasyEcom > OPevery 30 minutes
Sell OrdersEasyEcom > OPevery 30 minutes; all statuses except Canceled (id=9) by default
Buy OrdersEasyEcom > OPevery 30 minutes
Buy Orders and Buy Order LinesOP > EasyEcomevery 10 minutes
Receipt LinesEasyEcom > OPevery 30 minutes

Mapped fields

Product

Optiply fieldSource field / expression
nameproduct_name
skuCodesku
pricemrp
unlimitedStockFalse
stockLevelinventory
assembledIf cp_sub_products_count>0 THEN TrueElse False
statusactive
remoteIDcp_id
articleCodeproduct_id
createdAtRemotecreated_at

Product composition

Optiply fieldSource field / expression
remoteIdcp_id
composedproductidcp_id
partQuantitysub_products.quantity
partproductidsub_products.cpId
createdAtRemotecreated_at

Kits and Combos are mapped the same way as assembled products.

Supplier

Optiply fieldSource field / expression
namevendor_name
remoteIdvendor_code

Locations are also mapped as suppliers. The source identifies their name from products.company and remoteId from products.c_id.

Supplier product

Optiply fieldSource field / expression
nameproduct_name
remoteIdcp_id
skuCodesku
eanCodeproduct_id
statusactive
supplierIdvendor_code
pricecost

Sell order

Optiply fieldSource field / expression
totalValuetotal_amount
placedorder_date
remoteIdorder_id

By default, all status Sell Orders are mapped except Canceled (id=9). Order changes, line changes, line deletions, and new lines added to existing orders are not updated in Optiply.

Sell order line

Optiply fieldSource field / expression
productIdsuborders.sku
quantitysuborders.item_quantity
subtotalValuesuborders.selling_price
remote_idsuborders.suborder_id

Receipt line

Optiply fieldSource field / expression
quantitygrn_items.received_quantity
occurredgrn_created_at
buyOrderLineIdgrn_items.purchase_order_detail_id
remoteIdgrn_items.grn_detail_id

Buy Orders (EasyEcom > OP)

Optiply fieldSource field / expression
Idid
supplier idsupplier_name > get the Id from the name
placedcreated
remoteIdid
completedpo_updated_date

(*1) The order is set to completed when po_status_id is in [4, 5, 7].

Buy Order Lines (EasyEcom > OP)

Optiply fieldSource field / expression
quantitypo_items.original_quantity
subtotalValuepo_items.item_price*po_items.original_quantity
buyOrderIdpo_id
remoteIdpo_items.purchase_order_detail_id

The inbound Buy Order Line product-identity mapping is not included in this guide. Do not infer it from another mapped field.

Buy Orders (OP > EasyEcom)

Optiply fieldSource field / expression
IdreferenceCode
supplier_remoteIdvendorId
created_atexpDeliveryDate

Buy Orders Lines (OP > EasyEcom)

Optiply fieldSource field / expression
product.article_codeitems.sku
quantityitems.quantity
subTotalValue / quantityitems.unitPrice

(*1) For the outbound line mapping, unitPrice can include tax if send_tax_rate=True. The product tax rate is added to the unit price before exporting Buy Orders to EasyEcom. send_tax_rate defaults to false.

Limitations and recovery

  • EasyEcom does not return deleted products, so the documented source cannot identify or recover their deletions. #N/A is not a failed polling interval or a supported deletion flow.
  • Sell Order changes, line changes, line deletions, and new lines added to existing orders are not updated in Optiply.
  • This guide does not include an inbound Buy Order Line product-identity mapping. If that identity is needed for a comparison, ask Optiply Support to confirm it rather than substituting another field.
  • If the outbound tax setting is unknown, the mapped unit-price path can still be traced, but whether tax was added is not assessable. Do not change a setting to test it.
  • If the requested field is absent from the tables or a sample conflicts with them, report “not documented” or “not assessable” and contact Optiply Support. The source map does not prove active flows, settings, or current account values.