> 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/sales-channels/rithum-integration.md). # Rithum Integration Order Desk can connect to your [Rithum](https://www.commercehub.com/) (formerly called CommerceHub) account and automatically download orders. **IMPORTANT** Rithum requires all customers to go through testing which requires our developers’ help. Due to this, there is an additional one-time fee for each Rithum vendor you plan to use with Order Desk. Rithum has their own separate setup and testing fees as well. ### Setup In Order Desk, click on **Manage Integrations** under the Integrations menu in the left sidebar. Under the **Shopping Carts** tab, find and enable Rithum. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FOvdrWD214d6LRcACzgY6%2Flegacy-eaa207700aa4585c26c8.png?alt=media) Alternatively, search for Rithum from the available integration search. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FqdopL7NSAolV61HTVHly%2Flegacy-c3b8628f4cef76855125.png?alt=media) Once enabled, add your Rithum FTP credentials and click to connect. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FGvsUkfiA0kfaPogUIlKQ%2Flegacy-1c941c7ce8cc95dcba87.png?alt=media) Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by Rithum. ### Download Orders ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FefN6MZ8Q3wCXTLTc4jkZ%2Flegacy-e30e9bc8b507b207fa33.png?alt=media) Once connected, you can set your download preferences. **IMPORTANT** If you have The Home Depot Canada enabled, you will see additional fields to add your GST, HST, and QST tax registration IDs. #### Check for New Orders Select how often you want Order Desk to look for and download new orders from Rithum. #### Folder for New Orders Select the folder where newly imported orders from Rithum should be placed. For more information, see the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide. #### After Shipment, Move To Select the folder you want orders to be moved into after Rithum 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 at Rithum. #### Order ID Format Select which number should be used as the order ID in Order Desk. If you select **Combo**, the order number will combine both numbers in this format: #### Customer Order Number-PO Number #### Sync Tracking Numbers If the **Sync Tracking Numbers** setting is enabled, Order Desk will automatically send shipment information back to Rithum and update the orders there. #### Send Invoices Enable this if an invoice should be sent to Rithum when tracking is added to an order. #### Sync Inventory Enable this if you want Order Desk to sync your inventory counts back to Rithum. #### Send Daily Feed Enable this option to have all of your inventory items and counts sent to Rithum at a specific time each day. > The **Sync Inventory** setting sends stock updates to Rithum for items whose stock counts have been updated in Order Desk. The **Send Daily Feed** setting triggers a stock sync for all items in Order Desk at a specific time each day, regardless of whether their stock counts have changed. #### Item SKU Style Use this to select which SKU field you’d like to use as your SKU. Options are **Shopping Cart SKU**, **Vendor SKU**, **Merchant SKU**, or **UPC**. #### Item Price Source Select the Rithum field you want Order Desk to use for the order item price. You can choose either **Unit Cost** or **Unit Price**. #### Include Item Name on Sync Enable this setting if you want Order Desk to pass item names along when sending inventory counts back to Rithum. If you’d prefer to keep the item names in Rithum as they are, leave this setting disabled. #### Inventory Whitelist Required If **Sync Inventory** is enabled, all item quantities will be sent to each vendor at Rithum. If you’d like to choose which item quantities are sent to specific vendors, enable **Inventory Whitelist Required**. If this option is enabled, items will be skipped when inventory is synced to Rithum unless they have item metadata telling Order Desk which vendors they should be synced to: | Vendor | Item Metadata Field | Metadata Value | | ----------------------------- | --------------------- | -------------- | | Belk | belk\_include | 1 | | Best Buy | bestbuy\_include | 1 | | BJ’s Wholesale | bjs\_include | 1 | | Bluestem | bluestem\_include | 1 | | Costco | costco\_include | 1 | | Hot Topic | hottopic\_include | 1 | | Home Shopping Network | hso\_include | 1 | | JC Penney | jcpenney\_include | 1 | | Lowe’s | lowes\_include | 1 | | Lowe’s Canada | lowesca\_include | 1 | | Macy’s | macys\_include | 1 | | QVC | qvc\_include | 1 | | Staples Business Advantage US | staplesadvus\_include | 1 | | Staples Quill | staplesquill\_include | 1 | | The Home Depot | thehomedepot\_include | 1 | | The Home Depot Canada | thdca\_include | 1 | | The Home Depot Special Orders | thdso\_include | 1 | For more information about adding item metadata fields to your inventory items, see the [**Inventory Details**](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk) guide. #### Download Packing Slips Select this to download packing slips with the orders. #### Order Prefix If needed, add a prefix of your choice to all orders downloaded from Rithum. #### Inventory Location Filter If you only want to download specific orders, use the **Inventory Location Filter** field to specify which ones you want. Enter multiple locations separated by commas. The inventory location name must match exactly as it appears on your inventory items in Order Desk. When importing new orders from Rithum, Order Desk will look at the SKUs on the items and compare them to the SKUs in your inventory. Any orders with items for a location that isn’t listed in this field will not be imported. For this to work, your inventory must be added to Order Desk, and the inventory location should be set on each item. For details, see [**How to Add Inventory**](/start-here/getting-started-series/quick-start-orders-and-inventory.md#working-with-inventory) and [**How to Store Extra Item Details**](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk). ### Select Vendors ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FIHMbVq03d43nRsCMm1sF%2Flegacy-981008cf5ace0409f381.png?alt=media) Select the vendors you use with Rithum. This list will expand as needed. If you use a vendor that isn’t listed yet, set up a project with Rithum for that vendor, and Contact Order Desk support to have it listed. ### Advanced Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FAjtgJeEuxTLZn3X7jIkJ%2Flegacy-b34597427ea86b3a04df.png?alt=media) #### Vendor Payable Number Enter your Hub ID Number. #### Discount Type Select your payment terms with Rithum. #### Discount Basis Date Select the beginning of the payment terms period. #### Net Number of Days Due Set the number of days before the invoice payment is due. #### Early Payment Set the number of days within which payment must be made in order to claim the discount. #### Early Payment Discount Add the discount percent for early payment. ### Warehouse Details ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FOAOKqDXJCU5skW1xtNCu%2Flegacy-983763786ff3d5b668e5.png?alt=media) Fill out your warehouse information to send shipments and invoice information to Rithum. These details can be found in your Rithum Warehouse Management. #### Warehouse ID Enter the warehouse ID from your Rithum dashboard. #### Warehouse Name and Address Enter the name and address of your warehouse. ### Manual Imports ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fo0Kno5lXyq6B76lStSDL%2Flegacy-ce03906646d866c6b339.png?alt=media) If you need to manually download orders, click here to import them. ### Shipping Method Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FqCv0FdqUTY6pZngSLbO8%2Flegacy-2456657267791e6ad5d5.png?alt=media) If your retail vendor requires a specific shipping service value when submitting shipments, you can use the Shipping Method Match setting to control what value is sent based on the carrier and method on your shipments. For detailed info about how this works, checkout our guide on [**how to set up Shipping Method Matches**](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-method-matches.md). ### Special Features #### Resubmit Order Invoice to Rithum When shipment details are added to a Rithum order and the shipment is sent to Rithum, Order Desk will also submit an invoice along with the shipment. If for any reason this invoice fails to submit, you can resubmit it with the **Resubmit Order Invoice to Rithum** button on the order details page: #### Cancel Order at Rithum If you need to cancel an order at Rithum, select the reason from the dropdown on the order details page: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F02srufx7pxNCfTGcmpG9%2Flegacy-aec5b5c56428dd3b92e9.png?alt=media) ### Sending Invoices and Shipments to Rithum #### Order Level Details The following details can be submitted with invoices and shipments as either checkout data or order metadata. | Field Name | Field Description | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | rithum\_invoice\_id\_override | Use this field to override the PO Number set by default. | | Width | **Only required for some Lowe’s orders**, specifically those that use the `GS1-128` packing slip format. Specify the shipment width. | | Length | **Only required for some Lowe’s orders**, specifically those that use the `GS1-128` packing slip format. Specify the shipment length. | | Height | **Only required for some Lowe’s orders**, specifically those that use the `GS1-128` packing slip format. Specify the shipment height. | | ContainerID | **Only required for some Lowe’s orders**, specifically those that use the `GS1-128` packing slip format. This is usually set automatically when the `GS1-128` packing slip is downloaded to Order Desk. Reach out to Rithum if you’re unsure which Container ID should be used for your order. | If you are unfamiliar with checkout data, see the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide. --- # 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/sales-channels/rithum-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.