# Canpar Guide

Canpar Express provides reliable, innovative, and cost-effective shipping solutions for anyone to ship with confidence within Canada, from Canada to the US, and from Canada to international.

This guide provides detailed information on utilizing Canpar shipping with the EasyPost API, focusing on account setup, rates, label creation, pickups, tracking, and more.

---

## Prerequisites

### Account Registration

Sign up for an EasyPost account to obtain a **Test** and **Production** API
key. See Authentication and Key Management for more information.

> Note: Negotiated rates are only available in Production mode.

Please review the Getting Started Guide for more information.

### Carrier Setup

Upon sign-up with EasyPost, users gain immediate access to Wallet Carrier Accounts, which can be enabled directly from the Dashboard. For additional carriers, EasyPost supports a Bring Your Own Account (BYOA) option. This requires users to register directly with the respective carrier.

#### Register with Canpar

1. Contact a Canpar sales representative to gain access to the sandbox environment.
2. Receive sandbox credentials: Login Username, Password, and Sandbox Account Number. Credentials for Production and Test mode are separate and will be provided by Canpar’s IT Service Desk.

#### Sandbox Testing

1. Add sandbox credentials to a new Canpar carrier account on the EasyPost Carrier Account page.
2. Generate a test label via EasyPost's Sandbox environment.
3. Submit the sample label, request, and response files to Canpar for production environment access.
4. Upon approval, receive production environment credentials: Login Username, Password, and Production Account Number.

#### Production Setup

1. Add production credentials to the EasyPost carrier account.
2. Begin generating Canpar production labels.

#### Canpar Account via API

The API structure specified by EasyPost can also be used to add the Canpar carrier shipper account.

```shell
curl -X POST https://api.easypost.com/v2/carrier_accounts \
  -u "$EASYPOST_API_KEY": \
  -H 'Content-Type: application/json' \
  -d '{
  "carrier_account": {
    "type": "CanparAccount",
    "description": "CanparAccount",
    "credentials": {
      "account_number": "VALUE",
      "password": "VALUE",
      "username": "VALUE"
    },
    "test_credentials": {
      "account_number": "VALUE",
      "password": "VALUE",
      "username": "VALUE"
    }
  }
}'
```

### Software Requirements

Download an EasyPost Client Library or utilize the REST API with cURL.

### Documentation Review

Examine the EasyPost Objects section to understand the API's structure, which is critical for constructing requests and interpreting responses.

Related:

- [Getting Started Guide](https://docs.easypost.com/guides/getting-started)
- [Manage Carrier Accounts](https://app.easypost.com/account/settings?tab=carriers)

---

## Rates

Canpar is live-rated. To access rates, first integrate Canpar with EasyPost. Detailed rate information, including surcharges, will be available through the EasyPost API once the Canpar account is linked and operational. Rates consist of four key components:

- Actual weight of the product.
- Dimensional weight of the product (which considers the package size).
- Origin and destination points.
- Service type selected.

---

## Service Levels

Canpar offers a variety of service levels to meet diverse shipping needs.

Service levels are generated from live carrier metadata and are not included in this file. Retrieve them from the Carrier Metadata endpoint: https://docs.easypost.com/docs/carrier-metadata. Use `carrier=canpar`.

---

## Predefined Packages

There are no predefined packages for Canpar.

---

## Generating Shipping Labels

With EasyPost, the process for generating shipping labels for Canpar is the same as generating them for any other carrier.

Review the Getting Started Guide for help generating a shipping label.

### Supported Options

#### Voiding Labels

Voiding Canpar labels through EasyPost is not supported.

#### Label Formats

EasyPost offers native Canpar labels in PNG and PDF formats.

#### Label Size

4x6 labels are supported.

Related:

- [Shipment Documentation](https://docs.easypost.com/docs/shipments)
- [Getting Started Guide](https://docs.easypost.com/guides/getting-started)

---

## Hazardous Materials (HAZMAT)

This guide does not specify handling hazardous materials with Canpar. Users are encouraged to consult with Canpar for hazardous materials policies and procedures.

See Canpar's What Not to Ship page for more information.

Related:

- [What Not to Ship](https://www.canpar.com/en/support/what_not_to_ship.htm)

---

## Manifests and Pickups

### Manifest Generation

1. Create an empty Batch object.
2. Add desired shipments to the Batch for manifesting.
3. Create a Manifest/ScanForm for the Batch.
4. Print the manifest document for Canpar drivers.

### Pickups

**Pickup Requests:** Can be made through the EasyPost API. \
**Pricing Details:** Consult a Canpar representative for specific pickup pricing. \
**Scheduling Pickups**: Detailed procedure is outlined in the Pickup documentation.

Related:

- [Batch Documentation](https://docs.easypost.com/docs/batches)
- [Pickups Documentation](https://docs.easypost.com/docs/pickups)

---

## Tracking

EasyPost simplifies package tracking by offering two methods:

- Tracking with an existing number and carrier.
- Using a Tracker included with an EasyPost-purchased shipping label.

The service integrates webhooks for timely shipment updates. For detailed information on tracking methods, visit the Tracking Guide.

Related:

- [Trackers Documentation](https://docs.easypost.com/docs/trackers)
- [Trackers Guide](https://docs.easypost.com/guides/tracking-guide)

---

## Additional Resources

### Carrier Metadata

The Carrier Metadata endpoint can programmatically return information about Canpar service levels, predefined packages, supported features, and shipment options.

Use this information to quickly integrate with Canpar and make educated decisions about the mix of carriers for shipping needs. Additionally, the Carrier Metadata endpoint is available to retrieve comprehensive information about all carriers on the EasyPost platform, enhancing decision-making for carrier services.

### Support and Troubleshooting

In addition to the guidance provided in our Carrier Guides, EasyPost offers support to assist with FAQs, troubleshooting issues, and inquiries related to the EasyPost platform.

Please visit the Help Center for more information.

Related:

- [Carrier Metadata](https://docs.easypost.com/docs/carrier-metadata)
- [Help Center](https://support.easypost.com/hc/en-us)

---

## Talk to a Shipping Expert

For questions about getting started with Canpar through the EasyPost API please talk to a Shipping Expert or Contact Support.

Related:

- [Talk to a Shipping Expert](https://www.easypost.com/talk-to-easypost)
- [Contact Support](https://support.easypost.com/hc/requests/new)