Which Shipium APIs Should I Use?
Determine the API configuration best for your organization.
About Shipium's APIs
Your organization can use a single Shipium application programming interface (API) to meet a specific need, or take advantage of multiple APIs. Like standard APIs, ours enable communication between two application software entities, or endpoints, using rulesets and definitions.
The following diagram shows the Shipium APIs in sequence order:
What Shipium's APIs do
Each of Shipium's APIs can enhance your organization's shipping operations:
The API | What it does |
---|---|
Delivery promise API | Initiates a delivery with a promised delivery date |
Subscription timing API | Tells you when to ship product to your subscriber customers to meet a delivery date |
Packaging planner API | Selects the best set of packaging types/sizes for the shipped items |
Carrier and method selection API | Selects the least expensive carrier and ship method that meets your criteria |
Carrier label service API | Buys postage and retrieves label images |
Carrier and method selection and labeling in one call | Selects the least expensive carrier and ship method that meets your criteria and buys postage and retrieves label images |
You can combine APIs at different points in the ecommerce chain, or use a single API to meet a specific need. Use the individual links in the table above or scroll down for more details for each API and guidance for when to use each one.
Delivery promise API
Most customers want to know when a product will be delivered even before they buy it. For this reason, using delivery estimates is critical to cart conversion.
When to use this API:
- When your organization shows a customer a product, the API registers a page view and produces an accurate delivery estimate date.
- When a customer checks out, the API creates a representation of your order, maps
deliveryEstimateIds
to quantities in the order, and provides other order properties. - When a shipment leaves your FC, the API reports when your organization has shipped a package containing one or more items.
- The API tracks the package(s).
- On delivery, the API updates the delivery date/time.
For full details, see Delivery Promise.
Subscription timing API
If you use a subscription model, a common problem is knowing when to ship product to your customers to hit an approximate delivery date.
When to use this API:
- You can solve the problem of knowing when to ship by using information on your organization and carrier transit times to recommend when to ship each package.
For full details, see Subscription Timing API Overview.
Packaging planner API
When shipping product to your customers, your organization needs to determine package sizing.
When to use this API:
- You can determine an appropriate set of packaging types and sizes for one or more items in a shipment.
- Special processes and hazardous materials can be covered too.
- Your organization sets up the sizes and types of packages available at each FC in your network, and the API does the rest.
For full details, see Packaging Planner.
Carrier and method selection API
Optimizing carrier and method selection is one of the key places where ecommerce models can reduce costs.
When to use this API:
- You can find the least expensive shipping carrier and shipment method that meets a set of rules you define for any given shipment.
- Once the carrier and method have been determined, your software can obtain a label for that shipper as appropriate (see the next API below).
- Or use our one call flow as a single interface to all the major carriers.
For full details, see Carrier and Method Selection Flow.
Carrier label service API
After determining shipping carrier and method, your organization will need to determine postage and obtain an appropriate shipping label.
When to use this API:
- You can purchase postage and obtain an appropriate label for your shipper, after using the carrier and method selection API.
- You can also use this API on its own, if desired.
For full details, see Carrier Shipment Label Flow.
Carrier and method selection and labeling in one call
You can determine shipping carrier and method, and determine postage and an appropriate label in one single call, reducing your organization's network overhead.
When to use this API:
- You can combine the functions of the previous two APIs in a single call.
- You can optimize carrier selection and shipping method.
- You can purchase postage and obtain an appropriate label for your shipper.
For full details, see Carrier and Method Selection with Label Single Call.
Terminology guide
Updated about 2 months ago