> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rithum

> Integration details and setup guide for the Rithum connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                                                                                                          |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Authentication**                  | OAuth 2.0 (Authorization Code with refresh tokens) + Bearer Token (Basic format)                                 |
| **Two-Way Sync**                    | No                                                                                                               |
| **Events Supported**                | No                                                                                                               |
| **Realtime**                        | Polling                                                                                                          |
| **Supports Rate Limiting**          | Yes                                                                                                              |
| **Authentication Scopes Supported** | `orders` (read/write), `orders.readonly` (read-only), `inventory` (read/write), `inventory.readonly` (read-only) |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Rithum**:

* **Orders**
* **Inventory**
* **Products**
* **Fulfillments**
* **Returns**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                            |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Contact Rithum (formerly ChannelAdvisor) for trial or demo access. [Request demo](https://rithum.com/contact-us/) |
| **Requires paid sandbox?**                         | Yes. You typically need to work with Rithum to get sandbox environment access.                                    |
| **Requires partnership to obtain authentication?** | Yes. You need to be a Rithum partner or customer to obtain OAuth credentials.                                     |

***

### Authentication (OAuth 2.0)

For customers who want to completely whitelabel their OAuth experience, you can provide your own developer keys instead of using Alloy Automation's.

<steps>
  <step title="Contact Rithum for Partnership">
    1. Visit [https://www.rithum.com](https://www.rithum.com) (formerly ChannelAdvisor)
    2. Contact their partnership or developer relations team
    3. Request API and OAuth access for your integration
    4. Provide details about your use case and integration plans
  </step>

  <step title="Obtain Developer Credentials">
    1. Work with Rithum to set up a developer account
    2. Request sandbox environment access for testing
    3. Once approved, access the Rithum Developer Portal
  </step>

  <step title="Create OAuth Application">
    1. In the Rithum Developer Portal, create a new OAuth application
    2. Provide your application details (name, description, company)
    3. Set the redirect URL to: `https://api.runalloy.com/api/strategy/connector/rithum/callback`
    4. Select the OAuth scopes your integration needs (orders, inventory, etc.)
    5. Note your **Client ID** and **Client Secret**
  </step>

  <step title="Configure in Alloy Automation">
    1. In Alloy Automation, enter your Rithum Client ID and Client Secret
    2. Configure the required OAuth scopes for your use case
    3. Users will be redirected to Rithum to authorize access ([https://api.channeladvisor.com/oauth2/authorize](https://api.channeladvisor.com/oauth2/authorize))
    4. Alloy Automation will handle the OAuth flow and automatic token refresh
  </step>
</steps>

For API documentation, visit [Rithum Developer Portal](https://developer.rithum.com/).

***

## Use Cases

### 1) Multi-channel inventory management

Sync inventory levels between your warehouse management system and Rithum to maintain accurate stock counts across all sales channels and marketplaces.

### 2) Order fulfillment automation

Automatically pull orders from Rithum marketplaces to your fulfillment system and sync order status, tracking numbers, and shipping confirmations back to Rithum.

### 3) Marketplace expansion

Manage product listings, pricing, and inventory across multiple marketplaces (Amazon, eBay, Walmart, etc.) through Rithum's platform by integrating with your product management system.

### 4) Returns processing

Automate the returns workflow by syncing return requests from Rithum marketplaces to your returns management system and updating return status back to the marketplaces.

### 5) Analytics and reporting

Pull order and inventory data from Rithum into your business intelligence platform for cross-channel sales analytics, inventory optimization, and marketplace performance reporting.

***

## API Gotchas

* **Company rebrand:** Rithum was formerly known as ChannelAdvisor. API endpoints still use the channeladvisor.com domain. Be aware of this when configuring integrations and reading documentation.

* **OAuth scope requirements:** Rithum uses granular OAuth scopes for read and write access to orders and inventory. Plan your scope requirements carefully to avoid needing to re-authorize users later.

* **Bearer format:** Despite being OAuth 2.0, the Bearer token uses "Basic" format in some contexts. Follow the API documentation carefully for authentication header formatting.

* **Rate limiting:** The API enforces rate limits based on your partnership tier. Implement proper rate limiting and exponential backoff to handle throttling gracefully.

* **Marketplace-specific data:** Different marketplaces integrated with Rithum may have different data formats and requirements. Be prepared to handle marketplace-specific fields and validations.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.