Set up Order Sync for Facebook Commerce Manager

Set up Order Sync for Facebook Commerce Manager in Productsup.

Introduction

Facebook Commerce Manager lets you showcase and sell your items in Facebook and Instagram Shops using Checkout. To synchronize orders between your shop system and Facebook and Instagram shops, use the following integrations in Productsup:

  • The Facebook Commerce Orders Import lets you pull orders from your Facebook and Instagram Shops to the Productsup platform.

  • The Facebook Commerce Order Cancellation and Facebook Commerce Order Fulfillment allow you to return order shipment or cancellation updates to Facebook Commerce.

Note

Currently, shop checkout integration is only available to the US market for a limited number of businesses. Facebook plans to expand this feature to other markets.

Requirements

For this integration, you need to have the Order Sync feature activated. Contact your account manager to learn more.

Add Facebook Commerce Orders export

  1. Choose Data Sources from the site's main menu, then select ADD DATA SOURCE. Next, add Facebook Commerce Orders.

    add_data_source.png
  2. In Authentication, select an existing authentication between Productsup and Facebook. See Add OAuth authentication to external systems to set up authentication at the account level.

  3. Select the timeframe from where you want to import the order in Updated After.

  4. Enter a specific description for this data source in Description (optional).

    Note

    The Productsup platform acknowledges the order status and automatically changes it from CREATED to IN_PROGRESS.

  5. Select Save.

    add_fb_commerce_orders.png

Add Facebook Commerce Orders Fulfillment export

The Facebook Commerce Orders Fulfilment lets you sync the order status by pushing updated shipping information to Facebook Commerce.

Additionally, the Facebook Commerce Orders Cancellations export is necessary for you to submit information about order cancellations or items belonging to an order. For best results, set up both exports.

add_fb_commerce_export.png
  1. In the site, choose Exports A/B from the main menu, then select ADD EXPORT. Next, add Facebook Commerce Orders Fulfillment.

    add_fb_commerce_export2.png
  2. In the Destinations section, select Add Destination and choose Facebook Commerce Order Updates from the drop-down list. Now, enter a destination Name.

    destinations.png
  3. Select your previously setup Authentication. Skip to 4 if you have already selected your authentication.

    1. If you don’t see an authentication in the drop-down list, create one by selecting Add New Authentication.

      authentication.png
    2. Enter a Page Name and the CMS ID (Commerce Merchant Settings ID) and select Add. The page name that you added automatically appears in the Pages field.

    3. Select Connect. You are now being forwarded to Facebook Commerce to verify your connection and credentials.

      verify.png
  4. Select Fulfillment as the Update Type.

  5. Select Active to switch the destination to On.

  6. Select Save.

  7. Go to Dataflow from the site's main menu. Then choose Facebook Commerce Orders Fulfillment from the drop-down menu as the data source.

  8. Connect the following Intermediate and Facebook Commerce Orders Fulfillment column attributes, which are necessary for providing export information:

    data_map.png
    • facebook_order_id: Unique order ID from Facebook

    • shipped_retailer_id: ID representing the product in the merchant catalog

    • shipped_quantity: Number of shipped items that are part of the shipment

    • order_state: The state’s value must be IN_PROGRESS to show that the order is ready to ship. Productsup automatically sets this up

    • tracking_info/carrier_code: Carrier that you choose for delivering the package

    • tracking_info/tracking_number: Carrier tracking number

      The following attributes are optional:

      • merchant_order_reference: Represents the unique order ID in your Order Management System (OMS)

      • external_shipment_id: Unique external shipment ID representing a shipment, as identified by the merchant

      • tracking_info/shipping_method_name: Description of the shipping method

Add Facebook Commerce Orders Cancellations export

  1. In the site, choose Exports A/B from the main menu, then select ADD EXPORT. Next, add Facebook Commerce Orders Cancellations.

    add_fb_commerce_export2.png
  2. In the Destinations section, select Add Destination and choose Facebook Commerce Order Updates from the drop-down list. Now, enter a destination Name.

    destinations.png
  3. Select your previously setup Authentication. Skip to 4 if you have selected your authentication.

    1. If you don’t see an authentication in the drop-down list, create one by selecting Add New Authentication.

    2. Enter a Page Name and the CMS ID (Commerce Merchant Settings ID) and select Add. The page name that you added automatically appears in the Pages field.

    3. Select Connect. You are now being forwarded to Facebook Commerce to verify your connection and credentials.

      verify.png
  4. Select Cancellation as the Update Type.

  5. Select Active to switch the destination to On.

  6. Select Save.

    authentication.png
  7. Go to Dataflow from the site's main menu. Then choose Facebook Commerce Orders Cancellations from the drop-down menu as the data source.

  8. Connect the following Intermediate and Facebook Commerce Orders Cancellations column attributes, which are necessary for providing export information:

    • facebook_order_id: Unique order ID from Facebook

    • cancellation_retailer_id: ID representing a product in a merchant catalog

    • order_state: The state value must be IN_PROGRESS to show that the order is ready to ship. Productsup automatically sets this up.

    • cancellation_reason_code: The reason for the cancellation

    • cancellation_quantity: Number of canceled items

      The following attributes are optional:

      • cancellation_reason_description: Reason for the cancellation

      • cancellation_restock_items: Default is set to FALSE but can be set to TRUE for returning an item to inventory

      data_map2.png