Shipping to a Single Address (Console)

The information in Requesting Shipment: Introduction applies to shipping to a single address using the console.

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 POs.

The source of a purchase order (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) will be 1.

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.

Procedure

To use the Console to request shipping of keys from your inventory to one address,

Step 1:

Click Create shipment request. The New shipping request popup appears. Select the tab on the left, Single shipment.

_images/channel-partner-id-field.png
Step 2:

Fill in the address fields using Google Maps address formats (see Troubleshooting). The limits on the various fields are shown in Shipment Request Fields.

Step 3:

For the Delivery Type dropdown, select one of the two shipment types, Normal or Expedited. Your selection determines the shipping fee, which is calculated after you complete the shipping request.

Step 4:

Select the inventory that you are drawing on in the From stock dropdown list by clicking on the list, then on the appropriate checkbox(es. Multiple selections simultaneously are possible.

For a complete list and explanations of the options, see Inventory Types. In the screenshot below, the number 4 on the right in the From stock field shows that four inventories were selected - those shown below the field. (The field itself is too short to name more than one of them; the three dots following in the field indicate that further selections were made).

_images/from-stock-field-of-fields.png

If you select an inventory, but do not fill in any of the product fields, no shipment request is created.

Step 5:

As soon as you have selected the stock and clicked in the Shipping quantity field for a key, any quantities you previously entered in that field are displayed.

_images/from-stock-quantities.png

Enter the desired quantities in the appropriate fields.

Step 6:

Click Create shipment request. The Shipment confirmation popup appears:

_images/shipment-confirmation.png

Click Confirm. If all went well, you are notified that your request was accepted:

_images/request-accepted.png

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.

Shipment Request Fields
Console: Field Label
CSV: Column Heading
API
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 if company name not given 20
Address 1
street_line1
Mandatory. First line of address 60
Address 2
street_line2
Mandatory if address not deliverable 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
Mandatory for US and Canada, and also mandatory if
address is not deliverable without. (See footnote A)
Abbreviations OR full names
50
Postcode
postal_code
Zipcode or postal code 50
RecipientEmail
recipient_email
Email address of recipient 40
RecipientTelephone
recipient_telephone
Telephone number of recipient 40
DeliveryType
delivery_type
Type of shipping, Normal (1) or Expedited (2).
Integers (mandatory for API) OR words
InventoryType Mandatory.
ChannelPartnerId
channel_partner_ID
Mandatory. If inventory was purchased directly from
Yubico, enter “1”; otherwise 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 5Ci Number of keys to be shipped 3
YubiKey FIPS Number of keys to be shipped 3
YubiKey Nano FIPS Number of keys to be shipped 3
YubiKey C FIPS Number of keys to be shipped 3
YubiKey C Nano FIPS Number of keys to be shipped 3

Footnote A: 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.


To file a support ticket for YubiEnterprise Delivery, click Support.