ShipMonk Fulfillment Integration Guide
This guide walks you through connecting UltraCart to ShipMonk for order fulfillment, including the ShipMonk API details, UltraCart transmission configuration, supported shipping method mapping, and item SKU setup.
Introduction
ShipMonk is a 3PL (third-party logistics) provider. When integrated with UltraCart, ShipMonk can receive orders for fulfillment and send shipment confirmations (tracking numbers, package details) back to UltraCart.
Prerequisites
An active ShipMonk account with API access enabled.
A ShipMonk API Store (not a manual/import store).
A ShipMonk API Key and Store ID.
UltraCart access to configure Distribution Centers and item fulfillment settings.
Prerequisite: In ShipMonk, you must create/authorize an API store before you can generate API keys. Obtaining Your API key
[Image Placeholder: ShipMonk “Stores” screen showing Integration API Keys + Store ID]
Step 1: Obtain your ShipMonk API credentials
Step 1: Generate a Store (If you already have a ShipMonk API Store created, proceed to Step 2)
Within the ShipMonk app, navigate to Account Settings > General Settings > Stores
Click on the Integrate Another Store graphic and fill out the Typeform. After filling out the form, an integrations team member from ShipMonk will reach out within 48 hours to complete your request.
Step 2: Create API Key
Once your store has been authorized, navigate to the Integration API Keys and create an API key. You can also grab your store's unique ID here. Make sure you save your API key somewhere secure if you lose your API key, you can always generate a new one. You can also revoke access of API keys from your Integration API Key settings by selection the Action > Revoke API Key.
Tip: Save the API key securely. If you lose it, you’ll need to generate a new one. Obtaining Your API key
Step 2: Configure the UltraCart transmission mechanism (ShipMonk)
UltraCart needs a fulfillment “endpoint” to send orders to ShipMonk and (optionally) receive shipment confirmations back.
In UltraCart, go to your Distribution Center configuration.
Main Menu: Operations → Fulfillment → Distribution Centers
Create a new Distribution Center (or edit an existing one you want ShipMonk to fulfill from).
Set the Transmission Mechanism to ShipMonk ilable on your account)
Enter ShipMonk connection details:
Base URL:
https://api.shipmonk.comAuthentication header:
Api-Key: YOUR_API_KEYStore ID: (from ShipMonk Integration API Keys screen) Obtaining Your API key
[Image Placeholder: UltraCart Distribution Center editor – Transmission Mechanism + endpoint configuration]
Note: Your exact UltraCart fields (URL, headers, credential storage) depend on which fulfillment transmission plugin/mechanism is enabled on your account. The required ShipMonk values above are consistent regardless of UI.
Step 3: Configure ShipMonk supported Shipping Methods in UltraCart
ShipMonk requires each order to include a shipping service/method that ShipMonk recognizes. In practice, you’ll map UltraCart shipping method names to ShipMonk “shipping service” values used by your ShipMonk store configuration.
In UltraCart, open the Distribution Center (ShipMonk) and go to the Shipping Methods / Method Mapping section.
Add mappings for the shipping methods you offer at checkout.
Recommended method mapping approach
Use a table like this and fill in the ShipMonk-side values that match your ShipMonk carrier/service configuration:
UltraCart Shipping Method (Checkout) | ShipMonk Shipping Service Value | Notes |
|---|---|---|
UPS Ground | [ShipMonk value] | Use the exact service configured for your ShipMonk store |
UPS 2nd Day Air | [ShipMonk value] |
|
UPS Next Day Air | [ShipMonk value] |
|
FedEx Ground | [ShipMonk value] |
|
FedEx 2Day | [ShipMonk value] |
|
FedEx Standard Overnight | [ShipMonk value] |
|
USPS Ground Advantage / First Class | [ShipMonk value] | Depends on account/carrier availability |
USPS Priority Mail | [ShipMonk value] |
|
DHL Express (International) | [ShipMonk value] | Optional |
[Image Placeholder: UltraCart shipping method mapping UI]
Tip: If you’re unsure what ShipMonk expects for a shipping service value, confirm in ShipMonk OMS store settings (or with ShipMonk support) and then mirror those values in UltraCart.
Step 4: Configure items with their ShipMonk SKU
For ShipMonk to pick/pack correctly, the SKU on each UltraCart line item must match the SKU in ShipMonk.
In UltraCart, edit an item:
Main Menu: Items → Edit Item → (select item)
Go to the item’s Fulfillment / Distribution Center settings.
For the ShipMonk Distribution Center, set the item’s Fulfillment SKU / External SKU / 3PL SKU to the exact ShipMonk SKU.
Save the item.
[Image Placeholder: UltraCart Item Editor – Fulfillment SKU field for a specific Distribution Center]
Warning: If the SKU does not match what ShipMonk has on file, ShipMonk may place the order on hold or fail fulfillment due to “SKU not found / insufficient inventory”.