This article is for Marketplacer customers who use Adobe Commerce (Magento 2) as their e-commerce platform. If you are a seller who uses Adobe Magento to provide products to Marketplacer customers, see Adobe Commerce (Magento 2) for Sellers.
The Marketplacer Extension syncs the following between Marketplacer and Adobe Commerce. Note that this list covers the basics. A full field list can be obtained from your Marketplacer onboarding specialist.
|
Syncs |
Does not sync |
|---|---|
|
Products |
|
|
Product Category |
Product Media (PDF, Videos, etc.) |
|
Product Descriptions |
Custom Metafields |
|
Product Features |
Product Vetting |
|
Product Images |
Product Barcode |
|
Product QTY |
Product SKU |
|
Product Variants |
Product and Variant Tax code |
|
Product Status (un/published) |
|
|
Product Titles |
|
|
Variant images |
|
|
Product deletion |
|
|
Categories |
|
|
Category Name (Product Type) |
Category tax code |
|
Category Attributes (Product Options) |
Category Gender |
|
Category Tax Amount |
Category Condition (new or used) |
|
Orders |
|
|
Customer Name |
Order Cancellations |
|
Customer Address |
Order Exchanges |
| Customer Email |
Order Refunds |
| Customer Phone |
Order Returns |
| Order Value |
Merchant Fees |
| Order QTY |
Click and Collect or In Store |
| Order Status | |
| Order Number | |
|
Shipping |
|
|
GraphQL custom options |
Shipping prices |
|
Seller |
|
|
Seller Name, Address, Email, Phone |
Promotions |
|
Business number (e.g. ABN) |
Coupons |
|
Business Description |
Seller Shipping Cost |
|
Seller Business Information, including logo, opening hours, store image |
|
|
Seller policy |
|
|
Brand |
|
|
Brand name & logo |
How features synchronize
Marketplacer adverts (products) and variants
Marketplacer adverts (products) and their variants are synced to Adobe Commerce as configurable products and simple products. Marketplacer matches each product and variant to the equivalent on Adobe Commerce, e.g. Tee shirt, small / green.
Products are created using the default Adobe Commerce API endpoints, such as www.magentoserver.com/rest/all/V1/products
Because Marketplacer ‘adverts’ are treated as ‘configurable products’ in Adobe Commerce, and ‘variants’ are treated as ‘simple products’, the product API endpoint will be hit multiple times during each sync to create/update a single advert (since it has at least one variant).
A marketplacer_seller attribute code is included in the custom_attributes. Example: Configurable product
"product": {
"sku": "mp-advert-QWR2ZXJ0LTEwMDAwMDA2NQ==",
"name": "Amazing Shoes",
"status": "1",
"type_id": "configurable",
"visibility": "4",
"attribute_set_id": "10",
"custom_attributes": [
{
"value": "<p>Amazing Shoes are great</p>",
"attribute_code": "description"
},
{
"value": "277",
"attribute_code": "marketplacer_seller"
},
{
"value": "260",
"attribute_code": "marketplacer_brand"
}
],
"extension_attributes": {
"stock_item": {
"is_in_stock": false
},
"category_links": []
}
}
Example: Simple product
{
"product": {
"sku": "mp-variant-VmFyaWFudC0yODY=",
"name": "Big / Blue",
"price": "11.00",
"status": "1",
"type_id": "simple",
"visibility": "1",
"attribute_set_id": "10",
"custom_attributes": [
{
"value": "167",
"attribute_code": "size"
},
{
"value": "49",
"attribute_code": "color"
},
{
"value": "<p>Amazing Shoes are great</p>",
"attribute_code": "description"
},
{
"value": "277",
"attribute_code": "marketplacer_seller"
},
{
"value": "260",
"attribute_code": "marketplacer_brand"
}
],
"extension_attributes": {
"stock_item": {
"qty": "0",
"is_in_stock": "false"
},
"category_links": []
}
}
}
Behavior
- New and updated adverts (products) sync to Adobe Commerce in near real time.
- Adverts (products) show as in stock in Adobe Commerce. Infinite stock is not currently supported.
- If a product is deemed valid by Adobe Commerce (meaning all the relevant product details exist during sync, variants, etc.), regardless of its stock level it will be synced as active.
- If the product is invalid, it will be synced to Adobe Commerce as out-of-stock.
- Whether to show or hide out of stock products can be configured in Adobe Commerce.
NOTE: Stock levels in Adobe Commerce are not always equal to the product count on hand in Marketplacer. Specifically, the Adobe Commerce stock level is always equal to or greater than the Marketplacer count because Adobe Commerce has item reservations but Marketplacer doesn't.
Orders
Every ten minutes, Marketplacer ‘polls’ Adobe Commerce to check for new orders that are ready to process. An order might contain zero or more products from Marketplacer sellers.
During polling, Marketplacer checks all orders, but only syncs the ones that contain products sold by Marketplacer sellers, filtering out all other products. For example:
|
When this happens in Adobe Commerce |
This happens in Marketplacer |
|
A customer makes an order for 1 first-party item |
Marketplacer checks this order, determines that it contains no items sold by Marketplacer sellers, and ignores it. |
|
A customer makes an order for 3 items - 1 first-party item, 1 item sold by Marketplacer seller A, and 1 item sold by Marketplacer seller B. |
Marketplacer checks this order and determines it contains items sold by Marketplacer sellers. It filters out the 1 first-party item and creates an order on Marketplacer for the 2 remaining items from sellers A and B. The order is split accordingly in Marketplacer. |
This order data syncs to Adobe Commerce:
{
"base_grand_total": 264.95,
"customer_email": "tvw@hotmail.com",
"customer_firstname": "Tony",
"customer_lastname": "Von Wigglesworth",
"status": "processing",
"total_paid": 264.95,
"total_qty_ordered": 6,
"items": [
{
"name": "Watch - Small",
"product_type": "simple",
"qty_ordered": 2,
"row_total_incl_tax": 39.98,
"sku": "mp-variant-VmFyaWFudC0zNDE=",
"extension_attributes": {
"seller_id": 228,
"seller_name": "Damo's White Elephants"
}
}
]
}
Behavior
- Marketplacer looks for the marketplacer_seller extension attributes to detect product orders that need to be synced to Marketplacer.
Shipment details
Shipments details for Marketplacer products are added by the seller Marketplacer, and synced to Adobe Commerce. Shipment information also syncs with tracking information that is attached to the original order. Partial shipments are supported.
Shipping carriers need to be set up in Marketplacer for the details to come through successfully.
This shipment data syncs to Adobe Commerce:
{
"items":[
{
"qty": 1,
"order_item_id": "51"
}
],
"notify": true,
"tracks":[
{
"title": "www.shipping/com?track=AAA111",
"carrier_code": "Not Provided",
"track_number": "AAA111"
}
]
}
Behavior
- Shipping details are provided as a link.
- If we can’t provide a link or a carrier code, the value will default to “Not Provided”.
- A tracking number is provided for each shipment.
Product categories
Marketplacer refers to Adobe Commerce product categories as taxons in its code. This means that an extra mapping step is required to ensure that the product category setup in Adobe Commerce is mirrored in Marketplacer, and then sync will work correctly.
This is done as part of the Marketplacer Extension setup process. See Step 3: Set up and map entities between platforms.
Related articles