Deliver to Post Office Part 3: How to display valid Deliver to Post Office locations in your checkout

Posted on Jan. 22, 2014 by @ship_cpc in Shipping Solutions

This post is part of our ongoing series on Deliver to Post Office.

Your online business has decided to offer the Deliver to Post Office delivery solution for your customers and now it’s time to start implementing this option on your e-commerce site. As the IT manager or developer, you’ve checked that your shipping system can handle Deliver to Post Office deliveries and you’re ready to get started.

Your shipping system must have integrated Deliver to Post Office so that it can accept shoppers' contact information and the ID number of the destination post office. This is necessary to produce the correct shipping label. You can only offer Deliver to Post Office if it is integrated into your shipping system. Find out if your system supports Deliver to Post Office.

In this post, you’ll learn how to use Canada Post web services to find post offices near your shopper’s desired location and how to present the choices in your checkout. Note: You’ll need to be a member of the Canada Post Developer Program. Join now.

1. Present shoppers with option to pick up their order at a post office

In the checkout phase where you present shipping and delivery preferences, offer shoppers the option to have their purchases delivered to a post office of their choice. Ask shoppers to enter a postal code or address to find a pickup location near them.

DTPO

2. Use web services to get valid post offices

Perform a web service call to Get Nearest Post Office. In your request to the web service, include the postal code the shopper entered and set the d2po flag to true. This flag ensures only locations that accept Deliver to Post Office parcels will be returned in the response. These locations may change and the list is updated daily.

Example request to Get Nearest Post Office:
GET https://ct.soa-gw.canadapost.ca/rs/postoffice?d2po=true&postalCode=K1Y1T8

By default, the web service will return the 10 closest post offices to the postal code you provide, along with address details for each location.

3. Display a map and list of pickup locations to shoppers

Use the information provided in the response from Get Nearest Post Office to present shoppers with a map and a list of the post offices near the location they specified. Ask them to select a pickup location.

DTPO

4. Save post office ID and shopper contact information

Each post office has a unique identifier referred to as an “office-id” in the response from Get Nearest Post Office. Save the office-id of the post office the shopper selects (there is no need to provide us with the post office address) as well as the shopper’s name, address, email address and phone number. Please note that the name and address provided must match what appears on the identification your shoppers will use when they pick up their parcel.

This is a critical step. After you have saved the post office ID and the shopper contact information, your e-commerce site will need to pass it to your shipping system to create the correct Deliver to Post Office shipping label. If not, parcels will not be delivered successfully. How you do this will depend on your shipping system: EST 2.0, web services, or a third-party/custom system.

Read more details on how to produce a Deliver to Post Office shipping label depending on which shipping system you use:

Alternative to web services for enterprise customers

Enterprise customers can request access to the list of valid post offices through a flat file on our secure server. Please contact your Canada Post sales representative for details.

Read Part 1: Why offering more delivery options gives your e-commerce site a competitive edge.
Read Part 2: How to implement Deliver to Post Office on your e-commerce site
Read Part 3: How to display valid Deliver to Post Office locations in your checkout.
Read Part 4: How to create a Deliver to Post Office shipping label in EST 2.0
Read Part 5: How to create a Deliver to Post Office shipping label using web services
Read Part 6: How to create Deliver to Post Office shipping labels if you are a shipping system provider

Shipping systems that support Deliver to Post Office
Shipping system Supports Deliver to Post Office? Implementation details
EST 2.0 Yes View details
Third-party or custom Contact your vendor View details
Web services Yes View details
E-commerce software View solution providers Contact your solution provider
×

Archive

Contact

Contact us about our e-commerce solutions for your business.

Contact Us

Or call:

1 (866) 282-7173

Mon – Fri (9 a.m. – 5 p.m. EST)

Developer Program

Integrate our web services directly into your e-commerce platform, website or custom applications using our APIs.

Join Now FREE