Shipping to Multiple Addresses
The information in Requesting Shipment: Introduction applies to this method.
Use the YubiEnterprise Delivery template to create a bulk request in the form of a CSV file. Each row - i.e., each individual shipping request - is processed independently, so that problems with one request do not hold up subsequent requests.
Note
Always download the latest version of the shipment spreadsheet template. When a new CSV template becomes available, the outdated version of the template no longer produces valid shipping requests. The CSV template is autogenerated based on your inventory. The CSV template changes frequently; for example, when:
- Yubico releases new products in categories to which your organization is subscribed. Therefore, new fields are added to the template to take account of them.
- We release a new version of the YubiEnterprise Delivery software that includes updates to the template.
- You add new products to your inventory through a new PO. Subscription customers have columns for each of the keys in their subscription tier(s).
The CSV bulk upload does not support combining subscription and non-subscription products in a single shipment. If you want to create a shipment request that includes both types of products within a single shipment, see Using the API to Execute a Shipping Request or Shipping to a Single Address (Console).
When requesting shipment to multiple addresses, ensure that
- The columns of your own CSV file correspond exactly to those in the CSV template.
- The header row from the template is included in your own CSV file.
- The contents of the cells do not exceed the limits. The columns with table cells that have limits on the number of alpha-numeric characters (including spaces) are listed in Shipment Request Fields. Not all columns have limits. Note that the only products listed in your bulk_shipment_template.csv are those your organization has purchased. The table in Shipment Request Fields lists all products.
Recipient Names
On the Console, in the API and in the CSV file: recipient_firstname and recipient_lastname map to the first line on the shipping label.
For commercial or business addresses, the API’s recipient field and the Company field on the Console and in the CSV file all require the name of the recipient’s company. This is not necessarily the same as the name of your organization. For residential addresses, leave the Company / recipient field empty.
The Company / recipient fields map to the second line on the shipping label.
Long recipient names can be problematic for all methods of requesting shipment, because the shipment request will fail if the contents of the name and/or Company / recipient fields exceed the maximum number of characters permitted in these fields (shown in the table below).
Workaround: When a recipient’s full name or company name exceeds the fields’ maximum lengths, split the names across the three fields, for example:
| Location | Field (limit=15) | Limit | Field (limit=20) | Limit | Field (limit=20) | Limit |
|---|---|---|---|---|---|---|
| API | recipient_firstname |
15 | recipient_lastname |
20 | recipient |
20 |
| CSV | recipient_firstname | 15 | recipient_lastname | 20 | recipient_company | 20 |
| Console | First name | 15 | Last name | 20 | Company | 20 |
| Example of an overly long name before adjustment to fit the fields | ||||||
| Johannes-Maximilian | von Derschowitz-Dampfloch zu Querdenker | |||||
| Example after adjustment | ||||||
| Joh.-Maximilian | v.DerschowitzDampfloch | zu Querdenker | ||||
When requesting shipment, distinguish between inventory purchased directly from Yubico and inventory purchased from Yubico’s channel partners, because inventory is sorted according to the source from which it was purchased. The Dashboard shows your total inventory of any given product, combining quantities purchased from all sources: both directly from Yubico and indirectly through channel partners (if applicable). To find out what is in which inventory, check your purchase orders (POs).
Note
The source of a PO is always referred to as a channel partner, even if it was a direct purchase, in which case the Channel partner ID (or ChannelPartnerId or channelpartner_id) is 1.
Note
the selection of channel partner is not supported in the /shipments API.
To find out what the channel partner ID is:
| BEFORE shipment: | |
|---|---|
| The name and ID of the channel partner are shown on the purchase order detail page, accessible by clicking the ID of the PO on the Purchase orders page. | |
| DURING creation of shipment request: | |
| When selecting the Channel partner name on the Single shipment tab (accessed by clicking Create shipment request), the Channel partner ID populates automatically. | |
| AFTER shipment: | The Channel partner ID is shown on the shipment request detail page, accessible by clicking the ID of the shipment request on the Shipments tab. |
Although the system can deliver to Post Office (PO) Boxes within the United States, delivery to PO Boxes (or the equivalent) elsewhere in the world is unlikely to succeed.
Requesting Shipment from Multiple Channel Partners
To request shipment from two or more inventories, make a shipment request for each inventory. For example, to have three YubiKey 5C NFC delivered to Jan Lindberg, even if your dashboard shows that you have three such keys, if one of those keys was purchased from Yubico, the second from channel partner A and the third key from channel partner B, you need to make three shipment requests, each one of them drawing on a different inventory.
Procedure
| Step 1: | Click Create shipment request. The New shipping request popup appears: 
New shipping request popup |
||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Step 2: | From the Bulk Shipment tab of the New shipping request popup, click Download shipment spreadsheet template (csv), the name of which is bulk_shipment_template.csv. This button is not to be confused with the Download CSV button next to the Shipment request button on the Shipments tab. |
||||||||||||||||||
| Step 3: | Get the country codes required for populating this file: still on the Bulk Shipment tab of the New shipping request popup, click Download available countries (csv). |
||||||||||||||||||
| Step 4: | Save the CSV file preparatory to populating it with your information. The only purpose of the filename is to enable you to identify it correctly when you upload it. The following steps call out only certain fields. Shipment Request Fields below covers all the fields. |
||||||||||||||||||
| Step 5: | In the InventoryType column, enter the integer for your shipment request: InventoryTypeEnum
|
||||||||||||||||||
| Step 6: | The ChannelPartnerId column also calls for an integer. When requesting shipment, distinguish between inventory purchased directly from Yubico and inventory purchased from Yubico’s channel partners, because inventory is sorted according to the source from which it was purchased. The Dashboard shows your total inventory of any given product, combining quantities purchased from all sources: both directly from Yubico and indirectly through channel partners (if applicable). To find out what is in which inventory, check your purchase orders (POs). Note The source of a PO is always referred to as a channel partner, even if it was a direct purchase, in which case the Channel partner ID (or Note the selection of channel partner is not supported in the To find out what the channel partner ID is:
|
||||||||||||||||||
| Step 7: | When you have finished populating the CSV file:
If your CSV file uploads successfully, after pre-checks have been performed, notification of success appears under the Upload button.
If you later find that there were errors in the uploaded file, you can delete some or all of the rows (see Editing or Deleting a Shipment and/or Deleting Multiple Shipments). Note It can take some time before your requests appear in the list of shipment requests. Always allow time for corrections in case the system finds addresses marked as Incomplete - see below, Reviewing Incompletes. |
||||||||||||||||||
Shipment Request Fields
In the table below, all fields not marked as mandatory are optional. The Limit column displays the maximum number of alphanumeric characters permitted per field/table cell.
Console: Field Label
CSV: Column Heading
|
Description | Limit |
|---|---|---|
Country code
country_code_2 |
Mandatory. Country code from available_countries.csv | 2 |
Company recipient |
Mandatory if name of recipient is not provided | 20 |
First name
recipient_firstname |
Name of recipient. Mandatory if company name not given | 15 |
Last name
recipient_lastname |
Recipient’s family name. Mandatory, absent company name | 20 |
Address 1
street_line1 |
Mandatory. First line of address | 60 |
Address 2
street_line2 |
Mandatory if address undeliverable without (e.g. suite #) | 60 |
Address 3
street_line3 |
Not supported for expedited/rush orders | 60 |
| City | Mandatory. City, town, or township | 60 |
Region/State
region |
For the US and Canada, USPS codes are mandatory. See
USPS Codes for US and Canada. (Console users: Select code
from dropdown). For other countries, region or state is
mandatory if the address is not deliverable without it.
To check address deliverability, see Footnote
|
50 |
Postcode
postal_code |
Zip code or postal code | 50 |
RecipientEmail
recipient_email |
Recipient’s email address | 40 |
Contact Phone
RecipientTelephone
recipient_telephone |
Telephone number of shipment recipient
The limit is 40 of the alphanumeric characters
“0-9+-( )” unless the country code is IN, in which
case the limit is 255. Any format is acceptable,
with or without spaces
|
40 |
DeliveryType
delivery_type |
Type of shipping, “Normal” (1) or “Expedited” (2).
Integers (mandatory for API) OR words
|
– |
| InventoryType | Mandatory. Console users select from dropdown. | – |
ChannelPartnerId
channel_partner_ID |
Mandatory. If inventory was purchased directly from
Yubico, enter “1”; if not, enter the ChannelPartnerId
|
3 |
| Security Key NFC by Yubico | Number of keys to be shipped | 3 |
| Yubikey 5 NFC | Number of keys to be shipped | 3 |
| YubiKey 5 Nano | Number of keys to be shipped | 3 |
| YubiKey 5C | Number of keys to be shipped | 3 |
| YubiKey 5C Nano | Number of keys to be shipped | 3 |
| YubiKey 5C NFC | Number of keys to be shipped | 3 |
| YubiKey 5Ci | Number of keys to be shipped | 3 |
| YubiKey 5 NFC FIPS | Number of keys to be shipped | 3 |
| YubiKey 5 Nano FIPS | Number of keys to be shipped | 3 |
| YubiKey 5C FIPS | Number of keys to be shipped | 3 |
| YubiKey 5C Nano FIPS | Number of keys to be shipped | 3 |
| YubiKey 5C NFC FIPS | Number of keys to be shipped | 3 |
| YubiKey 5Ci FIPS | Number of keys to be shipped | 3 |
USPS Codes for US and Canada
| State (US) / Province or Territory (Canada) | Code |
|---|---|
| Alabama | AL |
| Alaska | AK |
| Alberta | AB |
| Arizona | AZ |
| Arkansas | AR |
| British Columbia/Colombie-Britannique | BC |
| California | CA |
| Colorado | CO |
| Connecticut | CT |
| Delaware | DE |
| District of Columbia | DC |
| Florida | FL |
| Georgia | GA |
| Hawaii | HI |
| Idaho | ID |
| Illinois | IL |
| Indiana | IN |
| Iowa | IA |
| Kansas | KS |
| Kentucky | KY |
| Louisiana | LA |
| Maine | ME |
| Manitoba | MB |
| Maryland | MD |
| Massachusetts | MA |
| Michigan | MI |
| Minnesota | MN |
| Mississippi | MS |
| Missouri | MO |
| Montana | MT |
| Nebraska | NE |
| Nevada | NV |
| New Brunswick/Nouveau-Brunswick | NB |
| New Hampshire | NH |
| New Jersey | NJ |
| New Mexico | NM |
| New York | NY |
| Newfoundland/Terre-Neuve | NF |
| North Carolina | NC |
| North Dakota | ND |
| Northwest Territories/Territoires du Nord-Ouest | NT |
| Nova Scotia/Nouvelle-Écosse | NS |
| Nunavut | NU |
| Ohio | OH |
| Oklahoma | OK |
| Ontario | ON |
| Oregon | OR |
| Pennsylvania | PA |
| Prince Edward Island/Île-du-Prince-Édouard | PE |
| Puerto Rico | PR |
| Quebec/Québec | QC |
| Rhode Island | RI |
| Saskatchewan | SK |
| South Carolina | SC |
| South Dakota | SD |
| Tennessee | TN |
| Texas | TX |
| Utah | UT |
| Vermont | VT |
| Virginia | VA |
| Washington | WA |
| West Virginia | WV |
| Wisconsin | WI |
| Wyoming | WY |
| Yukon | YK |
To find out if an address is deliverable, make a shipment request and see what status code or message it gets. Deliverability is determined by our shipping partners, and it is their codes and messages we display when it comes to questions of deliverability. For a fuller explanation, see Troubleshooting.
Deleting Multiple Shipments
This capability applies only to requests that are still editable. To delete multiple shipment requests simultaneously,
| Step 1: | On the Shipments tab, go to the Actions list dropdown, and select Bulk operations. The Bulk Operations screen appears, showing only the shipment requests that can be deleted (i.e., those that have not yet been processed). |
|---|---|
| Step 2: | Select the checkbox in the header row, then hit the Delete shipments button on the upper right. The selected shipment requests are deleted. To revert the Select all action, i.e., to deselect all the shipment requests, click the checkbox in the header row again. |
To file a support ticket for YubiEnterprise Delivery, click Support.