About fulfillment contexts

In order to use Shipium’s APIs, your organization needs to establish your fulfillment network configurations within the Shipium platform. We refer to these configurations as Fulfillment Contexts. Configuring settings for a fulfillment context enables your organization to fulfill shipments according to preset rules, requiring less hands-on maintenance on your part.

A fulfillment context allows you to configure the characteristics for your network origins, carrier contracts, label augmentations, third party billing, injection shipping, and tenants, in addition to other feature settings. To set up and maintain fulfillment contexts, you'll first need to access the Shipium Console.

This document guides you through the general process for creating a fulfillment context. It also includes links to individual pages providing instructions for configuring each fulfillment context component:

• Origin. Required. An origin is the originating physical location to be used when creating a shipment. You must have an origin configured to have a valid fulfillment context. Each context will have only one origin associated with it.
• Carrier Contracts. Required. Carrier contracts define the carrier account, rates, and settings that will be used to cost shipments for a specific location. You must have at least one carrier contract to have a valid fulfillment context.
• Label Configuration. Optional. Label configuration entails setting label properties such as dimensions and orientation as well as any special augmentations.
• Third Party Billing. Optional. Third party billing allows your organization to bill another account, or third party, for the cost of shipping a package.
• Injection. Optional. Injection shipping is the use of an additional mode of transportation, typically long-haul truck, to pick up shipments from a fulfillment center (FC) and transport them to an alternative injection point for delivery by the carrier, which acts as the origin from the last-mile carrier perspective.

Configure a fulfillment context

To configure a fulfillment context, you'll first need to create a new context (step 1). Once you've completed the first step, providing details about the context and any applicable tenants and tags, you must add an origin (step 2) and at least one carrier contract (step 3). You won't be able to use the context without those required components.

Next, you can add optional configurations for labels (step 4), third party billing (step 5), and injection shipping (step 6). Steps that follow below for each of these required and optional configurations include a link to the documentation guiding you through each setup step.

The Shipium Console will assign a fulfillment context identification number (fulfillment context ID) that can be used later when making calls to the Shipium APIs.

Step 1. Create a new fulfillment context

To create a new fulfillment context, you'll need to access the Shipium Console. You'll navigate to Configure and then select Fulfillment Contexts.

Once on the Fulfillment Contexts home screen, you'll select the + Add Fulfillment Context button, as shown in the following screenshot.

Features of the fulfillment context include context and tenant details.

Context details

For Context Details, you'll provide a name for the context and determine the context type.

The Fulfillment Context Type will be "Customer" or "Hundredweight". Most often, you'll select Customer, which means your fulfillment context will be used for generating labels for customer shipments from a predefined set of origins, carriers, and carrier service methods. If your fulfillment context will be used to generate labels for hundredweight shipping, you'll select Hundredweight.

Tenant details

Within Tenant Details, you'll choose the tenant setting for your fulfillment context. If your organization doesn't include tenants, you'll select No Tenant (Global), which indicates that the context's settings, or configurations, can be used globally across your network within other fulfillment contexts.

If you do use tenants in your network and you want to associate one or more with your fulfillment context, you'll choose either Create a New Tenant or Select Existing Tenant, each of which indicates that the context's configuration will be limited to use only with other fulfillment contexts that have the same tenant(s) you select to be associated with the context.

👉

What is a tenant?

Within Shipium, tenant refers to an entity that is one of your organization’s customers, typically one that rents storage space at your warehouse, or fulfillment center. As a direct-to-consumer retailer, you may also use the tenant structure in order to divide shipments to your stores from shipments to your customers.

Tenant Details include a Tenant Name, Unique Identifier, and Tax Identification Number.

• The Tenant Name is the name by which your organization wishes to refer to a particular tenant. There are no character limitations for the name you choose.
• The Unique Identifier is an optional field that enables your organization to more easily reference a tenant when making calls to Shipium’s APIs. The unique identifier must be composed of only alphanumeric characters, hyphens, and underscores; otherwise, you'll receive an error warning.
• The tenant Tax Identification Number, also known as an Employer Identification Number or EIN, is required for international shipments. Other fields required for international shipments include the U.S. Principal Party in Interest (USPPI) address and contact. Finally, you'll need to provide a return address override and return contact override for a newly created tenant, but you must create the origin before setting these overrides.

Once you've completed context and tenant details and created a fulfillment context, you can configure any of the Carrier Contracts, Label Augmentations, Third Party Billing, and Injection components at any time from the home Fulfillment Contexts screen by selecting the Add button dropdown menu. Since each context only has one origin, the Add an Origin option disappears once a valid origin has been configured.

Context Tags are an optional value that can be passed when calling the Shipium APIs. If you enable context tags, only contexts that include the tag provided for the API call will be considered for completing a shipment. You'll supply a name for the tag, one that your organization can use to distinguish easily from other context tags, and the Shipium platform will assign a unique string ID for the tag value.

Any required step that hasn't been configured will be displayed with a red dot next to its tab within the fulfillment context home screen, as shown in the screenshot above.

Step 2. Configure an origin (required)

To begin using a fulfillment context, you must have an Origin associated with it. You can find guidance for origin configuration in the Origins document.

Step 3. Configure at least one carrier contract (required)

To begin using a fulfillment context, you must have at least one Carrier Contract associated with it. You can find guidance for setting up a carrier contract in the Carrier Contracts document.

Step 4. Configure labels (optional)

Label configuration is an optional step. You can establish label properties and augmentations following the Label Configuration guide.

Step 5. Configure third party billing (optional)

Third party billing is an optional configuration. You can set up a third party billing account using the instructions in the Third Party Billing document.

Step 6. Configure injection shipping (optional)

Configuration of injection shipping is optional. If your organization wishes to add an injection shipping site to your network, you can find guidance in the Injection document.

Maintain and make changes to a fulfillment context

Once you've established a fulfillment context, you'll see details for that context appear on your Fulfillment Contexts landing page, as shown in the following screenshot. The at-a-glance information includes the context's status, name, origin, and carriers.

You can also click on the funnel icon in the Status column to sort the list of existing fulfillment contexts by status. A fulfillment context status can be active; idle, or inactive; incomplete; or archived.

To edit an existing fulfillment context, you'll click on the name of the context in the Context column, as shown in the screenshot above, or you can click on the origin or carriers in the Origin or Carriers column to access the context. You can use the search function to locate a particular context you wish to edit.

You also may choose to archive a fulfillment context. To do so, you'll select the "kebab" dropdown menu, as shown in the following screenshot, and then choose Archive this Context. Archiving the context is irreversible and only should be selected if you do not plan to use the context again.

Resources

Your Shipium team member is available to help as you configure your fulfillment contexts. However, you might find these resources helpful:

• Common Terms and Definitions
• Troubleshooting Guide
• Contacting Shipium Support