> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/fulfillment-services/wayfair-mcf-integration.md). # Wayfair MCF Integration If you have access to Wayfair’s CastleGate fulfillment network, Order Desk can download orders from your sales channels and send them to [**Wayfair**](https://www.wayfair.com/) for fulfillment. As those orders are fulfilled, shipment details will be pulled back into Order Desk and sent to your sales channels. ### Setup To connect to Wayfair MCF, click on **Manage Integrations** in the left sidebar and, under the **Fulfillment** tab, find and enable the Wayfair MCF integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FfrL8M7FhzGYbHU3g5bJ8%2Flegacy-e1277fb745119856070b.png?alt=media) Alternatively, search for ***Wayfair*** from the available integrations. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FvPRhzZ6yjcaxzAL4kjX8%2Flegacy-c2d112d19fb32df1093c.png?alt=media) Once enabled, enter your Wayfair MCF credentials (**Client ID**, **Secret Key**, and **Supplier ID**), then click **Connect**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FX1RlnmweNTNRha2kFqlt%2Flegacy-bc6482a51231c8580cc6.png?alt=media) **NOTE:** Order Desk isn’t able to help find or reset your Wayfair MCF credentials. If you need some help getting the credentials handy, you can reach out to Wayfair. ### Integration Settings After connecting the integration, you can set your preferences and adjust the available options. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FVKgEHHNsVPLa2BumDdGe%2Flegacy-3b372b33c2aed5e06761.png?alt=media) #### Environment This shows the current integration environment. If you initially connected to the sandbox version, you can switch to production here. #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Wayfair MCF. You can use one of the default folders or create your own. See the **Working with Folders** guide for more details. #### After Shipment, Move To Select the folder you want orders to be moved into as Wayfair MCF sends shipment details back to Order Desk. #### If Canceled, Move To Select the folder you want orders to be moved into if they are canceled in Wayfair MCF. #### Retailer ID Enter your retailer ID here. This is required unless you prefer to set it on the order level. See the Order Level Details section below. #### Shipping Account Enter your shipping account number here. This is required unless you prefer to set it on the order level. See the Order Level Details section below. #### Ship Speed Code Enter your preferred ship speed code. This is required unless you prefer to set it on the order level. See the Order Level Details section below. #### Signature Required Choose whether a delivery signature is required for your shipments. This can also be set on the order level. See the Order Level Details section below. #### Product Code Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FV4aWxwtFb33BFRjkZQQj%2Flegacy-2454ef3b71a6cf714088.png?alt=media) For detailed information on these settings, see the **Fulfillment Integration Product Settings** guide. #### Order Level Details The following fields can be added as checkout data or order metadata to be passed to Wayfair MCF on an order-by-order basis. If you’re not familiar with checkout data, see the **How to Work with Checkout Data** guide. | Field Name | Field Description | | ----------------------------- | ----------------------------------------------------------------- | | supplier\_id | Use this field to pass the supplier ID for the order. | | retailer\_id | Use this field to pass the retailer ID for the order. | | shipping\_account\_number | Use this field to pass the shipping account number for the order. | | ship\_speed\_code | Use this field to pass the shipping speed code for the order. | | delivery\_signature\_required | Set to `1` to require a delivery signature for the order. | ### Rules Reference In addition to the **general set of rule events and actions** in Order Desk, Wayfair MCF includes a number of rule events and actions that are specific to the integration. These aren’t found directly on the integration page. Instead, you’ll need to use the **Rule Builder** to access them. If you’re new to using rules in Order Desk, we recommend starting with our **How to Work With Rules** guide. #### Rule Events The following events are specific to Wayfair MCF. To find them, type **wayfair** in the **Event** dropdown menu in the Rule Builder: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fzx9Vn0KkyJe4qLBJb9Ho%2Flegacy-0fc53cf18133891a9fd3.png?alt=media) | Event | Description | | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *Order Canceled at Wayfair MCF* | Triggered when an order is canceled in Wayfair MCF. | | *Order Rejected at Wayfair MCF* | Triggered when an order is rejected in Wayfair MCF. | | *Order Scheduled to Wayfair MCF* | Triggered when an order is scheduled to be sent from Order Desk to Wayfair MCF. This triggers immediately after the order is scheduled to be sent, so it can be used when you want to take immediate action on the order at that point. | | *After Order Submitted to Wayfair MCF* | Triggers after an order has been successfully submitted to Wayfair MCF. | | *Before Order Submitted to Wayfair MCF* | Triggered just before an order is sent from Order Desk to Wayfair MCF. This is useful in cases where you want to make last-minute updates before an order is sent. | | *Order Not Submitted to Wayfair MCF Because of Invalid SKU* | Triggers when an order submission fails because one or more SKUs aren’t valid in Wayfair MCF. | | *Order Not Submitted to Wayfair MCF Because of General Error* | Triggers when a general error prevents the order from being submitted to Wayfair MCF. | | *Order Not Submitted to Wayfair MCF Because No Products Available* | Triggers when an order submission fails because no valid products were found for submission. | #### Rule Actions Wayfair MCF also supports specific rule actions that you can apply to your orders. These can be found in the **Actions** dropdown by searching for **wayfair**: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F5x5ZbgVzKd5kKmyBHexE%2Flegacy-6d5cb2bb9c8fd220867a.png?alt=media) | Action | Description | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | *Submit Order to Wayfair MCF* | Sends an order from Order Desk to Wayfair MCF. | | *Cancel Order at Wayfair MCF* | Attempts to cancel an order that has already been submitted to Wayfair MCF. Successful cancelation depends on the status of the order in Wayfair MCF. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/fulfillment-services/wayfair-mcf-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.