Overview

Dotcom Distribution is the premier provider of logistics and fulfillment services to growing retailers & manufacturers.

The source code for the Dotcom Distribution Endpoint is available on Github.

Services

Send Shipment

Send a shipment to Dotcom Distribution.

Request

shipment_ready.json
{
    "message_id": "51af1dc5fe53543f1200f519",
    "message": "shipment:ready",
    "payload": {
      "shipment": {
        "number": "H67606710123",
        "order_number": "R805661123",
        "email": "brian@spreecommerce.com",
        "cost": 10.0,
        "status": "ready",
        "stock_location": null,
        "shipping_method": "Standard",
        "tracking": null,
        "updated_at": null,
        "shipped_at": null,
        "shipping_address": {
          "firstname": "Brian",
          "lastname": "Quinn",
          "address1": "2 Wisconsin Cir.",
          "address2": "",
          "zipcode": "20815",
          "city": "Chevy Chase",
          "state": "Maryland",
          "country": "US",
          "phone": "555-123-123"
        },
        "items": [
          {
            "name": "Socks",
            "sku": "9011CC",
            "external_ref": "",
            "quantity": 1,
            "price": 29.0,
            "variant_id": 4123,
            "options": {
              "size": "M",
              "color": "BLK"
            }
          },
          {
            "name": "Shoes",
            "sku": "2001SSBM",
            "external_ref": "",
            "quantity": 1,
            "price": 27.0,
            "variant_id": 4321,
            "options": {
              "option-name": "value"
            }
          },
          {
            "name": "Feet",
            "sku": "2002SSBS",
            "external_ref": "",
            "quantity": 1,
            "price": 29.0,
            "variant_id": 1234,
            "options": {
              "toes": "present"
            }
          }
        ]
      },
      "order": {},
      "original": {}
      ]
    }
}

Response

notification_info.json
{
  "message_id": "51af1dc5fe53543f1200f519",
  "notifications": [
    {
      "level": "info",
      "subject": "Successfully Sent Shipment to Dotcom Distribution",
      "description": "Successfully Sent Shipment to Dotcom Distribution"
    }
  ]
}

Tracking

Track shipment dispatches.

Request

dotcom_shipment_results_poll.json
{
  "message_id": "51af1dc5fe53543f1200f519",
  "message": "dotcom:shipment_results:poll",
  "payload": {}
}

Parameters

Name Value Example
API key Your Dotcom Distribution API key dj20492dhjkdjeh2838w7
password Your Dotcom Distribution account password dj20492dhjkdjeh2838w7
last_shipment_date Initial date shipment polling will start from 2013-01-01

Response

shipment_confirm.json
{
  "message_id": "51af1dc5fe53543f1200f519",
  "messages": [
    {
      "message": "shipment:confirm",
      "payload": {
        "shipment": {
          "number": "70201201334520004",
          "order_number": "104-0444357-8954627",
          "tracking_number": "915293072790136"
        }
      },
      "parameters": [
        {
          "name": "dotcom.last_shipment_date",
          "value": "2013-05-05"
        }
      ]
    }
  ]
}
x Spree Conf NYC 2014

Want to learn more about Spree?

Early Bird is 50% Off (Ends 12/31)

Learn More