External Shipping Methods

Updated 11 months ago by Colin Mollenhour

In addition to the officially supported carriers and shipping methods, ShipStream allows you to create your own custom shipping methods called "External Shipping Methods". These can be used for many purposes such as:

  • Completing shipments that don't require a traditional shipping label
  • Implement your own integrations with other carriers that are not supported by ShipStream
  • Internal operations like kitting projects or random product inspections

Configuration

Like other shipping methods you can control which methods are allowed at the Global scope and also at the Merchant scope. Manage the configuration at System > Configuration > Shipping Methods > External Processing.

Create New Methods

You can add and manage the External Shipping Methods from System > External Shipping Methods. Click "Create New External Shipping Method" to start creating a new one.

After the shipping method is created it must be selecting in "Allowed Methods" in the configuration before you can assign it to orders. See "Configuration" above.

Code

This is the suffix to the shipping method code that will uniquely identify this shipping method. The full code will be prefixed by external_ when referenced throughout the System. For example, if local_pickup is specified as the Code, the full shipping method code referenced internally, via scripts and APIs would be external_local_pickup. This value cannot be changed once it is saved.

Title

The title is the user-facing shipping method name that will appear throughout the UI and it can be changed at any time.

Allow for Batching

Set this to no to prevent orders with this shipping method from being included in automatically generated picking batches. They will still be included when creating batches from the order grid.

Label URL

If not specified, this shipping method will be treated as an "offline"-only method. You may still add tracking numbers to the order but the order will be considered complete as soon as it is packed and it is left up to the user to generate a shipping label if needed.

If a Label URL is specified then ShipStream will POST an HTTP request to the URL when it needs to fetch a shipping label. This allows your custom methods to create shipping labels automatically with the same level of integration as the officially supported shipping methods. Please see the External Shipping Method API guide for more information.

Tracking URL

If specified ShipStream will POST an HTTP request to the URL when it needs to fetch tracking information. Please see the External Shipping Method API guide for more information.

Combine Requests

If the Label URL is specified, this option will determine if requests sent you your Label URL are combined into one request for multi-package shipments, or if each package should be in a separate request.


How did we do?