Back to Documentation

RackBeat Integration Guide

Complete guide to integrating RackBeat ERP with your Millbuddy marketplace. Learn how to configure synchronization, map data fields, and handle real-time updates.

Prerequisites

Required credentials and settings

RackBeat API Key

Generate an API key from your RackBeat dashboard


// Location: RackBeat Dashboard > Settings > API Keys
API_KEY=your_rackbeat_api_key
WAREHOUSE_ID=your_warehouse_id
          

Millbuddy Configuration

Configure your Millbuddy environment for RackBeat


// Add to your .env file
MILLBUDDY_RACKBEAT_ENABLED=true
MILLBUDDY_RACKBEAT_API_KEY=$API_KEY
MILLBUDDY_RACKBEAT_WAREHOUSE=$WAREHOUSE_ID
          

Data Mapping

Configure field mappings between systems

Product Mapping

Map RackBeat product fields to Millbuddy


// Example product mapping configuration
{
  "mappings": {
    "sku": "rackbeat_item_number",
    "name": "rackbeat_product_name",
    "price": "rackbeat_sales_price",
    "stock": "rackbeat_available_quantity",
    "category": "rackbeat_product_group"
  }
}
          

Order Mapping

Map order fields between systems


// Example order mapping configuration
{
  "mappings": {
    "order_number": "rackbeat_order_number",
    "customer_id": "rackbeat_customer_number",
    "status": "rackbeat_order_status",
    "shipping_method": "rackbeat_shipping_method"
  }
}
          

Sync Configuration

Set up synchronization settings

Sync Intervals

Configure data synchronization frequency


// Example sync configuration
{
  "sync_settings": {
    "products": {
      "interval": "5m",
      "batch_size": 100
    },
    "inventory": {
      "interval": "1m",
      "real_time": true
    },
    "orders": {
      "interval": "2m",
      "webhook_enabled": true
    }
  }
}
          

Webhook Setup

Configure real-time event notifications


// Example webhook configuration
{
  "webhooks": {
    "order_created": "/webhooks/rackbeat/order",
    "stock_updated": "/webhooks/rackbeat/inventory",
    "price_changed": "/webhooks/rackbeat/price"
  }
}
          

Common Issues & Solutions

Connection Timeout

Ensure your RackBeat API key has the correct permissions and check network connectivity.

Sync Delays

Verify sync interval settings and check for rate limiting on the RackBeat API.

Missing Data

Confirm field mappings are correct and all required fields are included in the configuration.

Need Integration Support?

Our RackBeat integration experts are here to help you get connected.

Contact Integration Team