MerchantFlowMerchantFlow Docs
Integrations

Connect Speedfulfill 3PL — MerchantFlow

How to connect Speedfulfill to MerchantFlow for warehouse fulfillment data, shipping costs, and tracking numbers in your profitability reports.

Connect Speedfulfill 3PL to MerchantFlow

The Speedfulfill integration connects your Speedfulfill 3PL (third-party logistics) account to MerchantFlow, bringing warehouse fulfillment data, shipping costs, and tracking numbers into your profitability reports. This is one of MerchantFlow's supported 3PL integrations, for merchants who use Speedfulfill for order fulfillment.

What Is the Speedfulfill Integration?

Speedfulfill is a third-party logistics provider that handles warehousing and order fulfillment. MerchantFlow's Speedfulfill integration pulls fulfillment data directly from Speedfulfill, replacing your configured fulfillment cost method with actual shipping and warehouse costs for more accurate profitability tracking.

How to Connect Speedfulfill

Open Settings > Integrations and locate the Speedfulfill connection area. Unlike the marketing and Google integrations, Speedfulfill is configured directly inside MerchantFlow with credential fields rather than a browser OAuth redirect.

The Speedfulfill setup requires two credential values, both taken from the SpeedFulfill merchant backend under Settings > App API:

  • API Key
  • API Secret

The settings UI opens a modal for these values. The API Secret is encrypted at rest. Owners or admins can update credentials at any time.

Connecting requires the integrations:manage permission, and -- as with every other integration except WooCommerce -- a verified email and a satisfied two-factor check before the credentials are saved. The two-factor check applies to accounts that sign in to MerchantFlow with a password; connecting from inside your Shopify admin does not need it.

If You Connected Before the API Change

SpeedFulfill replaced its older credential scheme (enterprise code plus token keys) with the API key and secret pair above. Connections created under the old scheme are marked as needing attention and show one of these messages:

  • Reconnection required. SpeedFulfill upgraded its API - please reconnect with your new credentials.
  • SpeedFulfill credentials expired. Please reconnect with your current API key and secret.

Reopen the Speedfulfill modal and save your current API key and secret to clear either state. Nothing else about the integration changes.

What Data Does MerchantFlow Sync from Speedfulfill?

  • Tracking numbers -- shipment tracking for fulfilled orders
  • Shipping costs -- actual per-order shipping expenses for accurate P&L reporting
  • Product cost -- the purchase price Speedfulfill records for the order. It is stored for reference only: Speedfulfill is a shipping-cost source, so your COGS keeps coming from your COGS setup. Only Gooten and Printful write COGS from 3PL billing
  • Tax and duty -- a per-order tax/duty charge that Speedfulfill bills separately from shipping, added by the vendor in August 2026. Orders fulfilled before that rollout have no tax/duty figure
  • Replacement shipments -- when Speedfulfill reissues an order (a reship or replacement), it bills that shipment on top of the original. MerchantFlow adds the reissue charge to the same order's fulfillment cost, so a reshipped order shows what it actually cost to deliver. A free replacement adds nothing. Because a replacement is usually billed weeks after the original shipped, MerchantFlow re-checks every order from the last 120 days for new reissue charges once a day, rather than on every sync, so a new charge can take up to a day to appear. Orders older than that window are only re-read by a full-history run
  • Fulfillment status -- normalized to processing, ready_to_ship, or shipped
  • Total payable -- Speedfulfill's PayableAmount for the order, stored as reported. MerchantFlow deliberately does not use it to calculate cost: on some orders it carries the product's retail price rather than the amount billed, so fulfillment cost is always built from shipping less discount, plus tax/duty and any reissue charge

Speedfulfill also emits per-parcel split-shipment rows that share an order ID with their parent. MerchantFlow excludes those from the billing record so a split shipment is not double-counted.

How Speedfulfill Works in MerchantFlow

  • Speedfulfill appears as its own scope in the Manual Sync Runner for targeted syncs
  • Updating credentials does not require changing your commerce platform connection
  • Disconnecting Speedfulfill falls back to your non-3PL fulfillment setup - the percentage or per-product method configured in Fulfillment Costs

If You Do Not Use a Supported 3PL

MerchantFlow can still track fulfillment costs for orders no connected 3PL covers: set a percentage of product cost, or enter per-unit rates per product (with optional per-country overrides and quantity tiers). While less precise than actual carrier data, both ensure your P&L reports include fulfillment expenses. See Fulfillment Costs for configuring either method.

Frequently Asked Questions

Do I need Speedfulfill to use MerchantFlow?

No. Speedfulfill is optional. If you do not use Speedfulfill, MerchantFlow uses your configured fulfillment cost method instead. Your P&L and profitability reports still include fulfillment expenses.

Can MerchantFlow integrate with other 3PL providers?

Yes. MerchantFlow supports seven fulfillment cost sources in total:

ProviderCredentialsAvailability
SpeedfulfillAPI key + API secretAll workspaces
CJ DropshippingAPI keyAll workspaces
GootenRecipe ID + partner billing keyAll workspaces
Fulfilment PlusCartonCloud client ID + secret + customer IDAll workspaces
Supply Chain FusionAPI user name + password, one per marketAll workspaces (beta)
ShipMonkAPI key + store IDBehind the shipmonk_enabled flag
PrintfulPrivate bearer token (store ID optional)Behind the printful_enabled flag

Gooten and Printful are print-on-demand providers that supply actual per-order COGS alongside shipping. For any other fulfillment provider, use the percentage or per-product fulfillment cost method to include fulfillment expenses in your reports.

How do I update my Speedfulfill credentials?

Navigate to Settings > Integrations, find the Speedfulfill section, and open the credential modal. You can update your API key and API secret at any time without affecting your other integrations.


Last updated: September 23, 2026

Last updated on

On this page