Rate Shop Integration Guide for Retailers & Suppliers

Transparency & Other Guides

This is a combined retailer/supplier guide intentionally so both parties transparently understand each other's integration requirements and responsibilities as success in e-commerce transactions is a two-party dance.

Overview

This guide explains how a supplier would use Rithum's Dsco platform and Rithum's Dsco Platform API to rate shop their orders.

Terms

Below are terms used throughout this guide.

Term Definition
Dsco platform support team The Dsco platform support team can be reached at support-dsco@rithum.com.

The Flow

A retailer places an order with a supplier, and the supplier acknowledged the order and is ready to ship. The supplier has prepared the order in their warehouse and is ready to ship, ideally with the most cost-efficient ship method that guarantees the order is delivered on time. The supplier makes a Dsco Platform API call to obtain a recommended ship method, providing various optional parameters such as ship methods, warehouse location, and delivery requirements, along with the Dsco order ID. The Rate Shop request yields the recommended ship method, which the supplier can then pass into another Dsco Platform API call to obtain a shipping label (documented in the Shipping Labels Guide). The shipping label request yields a tracking number, which the supplier can then pass into another Dsco Platform API call to create a shipment. Upon doing so, the order is reported as shipped and the supplier can download the shipping label and packing slip from the Dsco UI to print and attach to the package sent from their warehouse. The complete flow is as follows, and assumes both the retailer- and supplier accounts have onboarded to Dsco successfully and are ready for use.

  1. Retailer -> Supplier
    The retailer initiates a connection with the supplier to allow both parties to do business and provide goods to an end consumer.
  2. Supplier -> Dsco
    The supplier completes the connection onboarding process that involves setting up a warehouse and fulfilling test orders among others.
  3. Retailer -> Dsco
    The retailer verifies the supplier has completed all onboarding steps and activates the connection.
  4. Retailer -> Dsco
    The retailer authorizes the supplier to leverage Dsco's rate shop and shipping label features with the help of their Client Success Manager/Program Manager or the Dsco onboarding team.
  5. Retailer/Supplier -> Dsco
    Either the retailer or supplier connects their carrier account to the Dsco platform to ensure the shipping label request can be forwarded to the carrier on their behalf and they are billed the cost of the shipment by the carrier.
  6. Retailer -> Supplier
    The retailer creates an order to be fulfilled by the supplier.
  7. Supplier -> Dsco
    The supplier leverages the Dsco Platform API as described in this section's introduction to successfully rate shop an order, generate a shipping label, and ship the retailer's order.

Integrating the Dsco Platform API to rate shop orders

Multiple variants of valid Rate Shop requests to the Dsco Platform API can be found in a Postman collection available for download below.

© 2024 Rithum Holdings, Inc., together with its subsidiaries, all rights reserved, protected under U.S. and international copyright law. Rithum and the Rithum logo are trademarks of Rithum, LLC