UPS® i-parcel™ Shipping Extension for Magento 2

THIS DOCUMENT IS THE CONFIDENTIAL INTELLECTUAL PROPERTY OF UNITED PARCEL SERVICE OF AMERICA. INC. USE, REPRODUCTION, AND

DISTRIBUTION OF THIS DOCUMENT IS LIMITED SOLELY TO AUTHORIZED PERSONNEL.

© 2019 United Parcel Service of America, Inc. UPS, the UPS brand mark, and the color brown are registered trademarks of United Parcel Service, Inc.

All Rights Reserved.

February 13, 2019

UPS i-parcel International Cart | Page 2 | Magento 2 Extension

Contents Contents .............................................................................................................................................................................................................................. 2

About this Guide ................................................................................................................................................................................................................. 3

Assumptions ........................................................................................................................................................................................................................ 3

Get the extension ................................................................................................................................................................................................................ 3

Setting up the UPS i-parcel extension ................................................................................................................................................................................. 3

Configuration ...................................................................................................................................................................................................................... 6

Catalog Sync Configuration ................................................................................................................................................................................................. 7

Catalog Mapping Attributes ................................................................................................................................................................................................ 8

Shipping Methods ............................................................................................................................................................................................................... 9

UPS i-parcel International Cart | Page 3 | Magento 2 Extension

About this Guide

This document describes starting and setting-up the UPS i-parcel Shipping extension for Magento.

Assumptions

1. You have a Magento admin account.

2. You have a Global Access account.

Get the extension

Download and install the UPS i-parcel International Cart extension.

You can install the UPS i-parcel extensions in several ways:

1. We can send you a zip file with the extension

2. Login in to your UPS i-parcel Global Access Dashboard and follow the links to Integrate > Magento > Install

3. Find the UPS i-parcel Shipping extension on the Magento Marketplace.

Setting up the UPS i-parcel extension

Get your customer ID and API key.

✓ Log into the UPS i-parcel Global Access Dashboard: https://globalaccess.i-parcel.com/Dashboard

https://globalaccess.i-parcel.com/Dashboard

UPS i-parcel International Cart | Page 4 | Magento 2 Extension

✓ Select the Integrate! Option in the left panel

✓ Select the API key link

✓ Store your Company Id and API key, which you may need later.

UPS i-parcel International Cart | Page 5 | Magento 2 Extension

✓ Log into your Magento Admin Panel with your Magento credentials ✓ The UPS i-parcel extension is nested in the Store View. Your

screen will have a shortcut to the UPS i-parcel tab.

UPS i-parcel International Cart | Page 6 | Magento 2 Extension

Configuration

Enter your Global Access Username

and Password here

Press this button to populate the Global Access API

keys in the fields below; or enter them in manually

(you can find them in the GA dashboard > Integrate).

This is your UPS i-parcel Company ID

number.

Select this button to go to the UPS i-

parcel Global Access Dashboard. If UPS i-parcel has not embedded any

front-end scripts on your site, this field

should be No.

UPS i-parcel International Cart | Page 7 | Magento 2 Extension

Catalog Sync Configuration

Turn off automatic catalog updates

Update the catalog when you

save product information.

Update the catalog at pre-

scheduled job updates.

The Upload Step Size describes how many

SKUs to upload at once. If your catalog has

1000 SKUs and you put 100 here, we will make

10 SubmitCatalog API requests.

If you put a number here, and your catalog upload is interrupted, then

the re-upload will begin at the SKU after this number. This is mostly a

concern for catalogs of 250 thousand SKUs or larger.

UPS i-parcel International Cart | Page 8 | Magento 2 Extension

Catalog Mapping Attributes

Use these fields to map

Magento attributes to the i-parcel

attribute elements. We use

attributes for classification.

HS Code is the item’s

Harmonization Code

Ship Alone is either True or False.

True means the item will ship by itself.

False means the item can be can be

bundled with other items. The value is

false by default.

Configurable products are products that have to

have a certain options selected before adding them

to the cart. For Price Type of configurable products,

by default, we take the price associated with the

item SKU. However, we can also take the price of

the parent or configurable product. For example, if

Red-Hood is the configurable products, we can use

its price or the price of its children i.e. Red-Hood- or

Red-Hood-XL.

Use these fields to map your

catalog items to the UPS i-

parcel length, width, height,

weight, and price fields.

UPS i-parcel International Cart | Page 9 | Magento 2 Extension

Shipping Methods

Select Yes to enable UPS i-

parcel as a shipping option.

You can label the shipping

method with this field.

You can opt not to show Tax

and Duty. You can opt to show

Tax and Duty on separate lines.

You can show Tax and Duty as

one line item.

You can opt to use the

customer’s shipping address for

UPS i-parcel orders.

You can relabel UPS i-parcel

shipping service levels through

this screen.

ContentsAbout this GuideAssumptionsGet the extensionSetting up the UPS i-parcel extensionConfigurationCatalog Sync ConfigurationCatalog Mapping AttributesShipping Methods