.. single-req.rst .. _shipping-single-label: ============================ Shipping to a Single Address ============================ The information in this section describes how to create shipment requests to a *single* recipient address from the YubiEnterprise Console. To create shipments to *multiple* addresses, see :ref:`shipping-multiple-label`. For information about shipment request concepts, see :ref:`shipments-label` and :ref:`requesting-shipment-label`. Creating a Shipment Request =========================== To request shipping of keys from your inventory to an individual address, click one of the following: * **CREATE SHIPMENT REQUEST** in the card for the appropriate subscription on the **Dashboard**. * The **Create shipment request** button in the **All shipments** page. This opens the **New shipping request** form to create a single shipment request. .. image:: graphics/ship-request-single-form3.png :width: 800 Enter information in the form fields as described in the following. For detailed descriptions of form fields and their values, see :ref:`csv-col-headings-label`. 1. If applicable, select a **Reseller** from the dropdown list. Your selection determines the inventories from which you can draw products from. The **Reseller ID** field is automatically populated depending on the selected reseller. 2. Enter the required **Recipient information**, either provide a company name or a recipient name, or both. 3. Enter the **Shipping information**. Ensure you enter a valid recipient address and phone number for a successful delivery. Only latin characters are permitted, including accented characters (à, á, ä etc.). When shipping to countries without postal codes, enter "00000" in that field. .. include:: includes/address-line-limits.rst 4. Select **Opt out of address validation** to override the Yubico address validation service if applicable, see :ref:`overriding-address-validation`. .. important:: If you chose to override the Yubico validation service and a shipment is returned or otherwise undeliverable, Yubico will not refund the product, shipping fees, applicable taxes and/or VAT associated with that shipment. 5. Select the **Delivery Type**, Normal or Expedited. Your selection determines the shipping fee, which is calculated after you complete the shipping request. 6. In the **Product selection** section, select one or more inventories to draw products from, and select the desired products and quantity from each inventory. If :ref:`inventory allocations ` apply for a product, this is indicated (in pink). Customized products can also be selected if available for your organization (FIDO Pre-reg type of customizations are excluded since these shipment requests are not created in the Console). Customization options are indicated by the associated Customization ID (in blue). .. image:: graphics/shipment-selections3.png :scale: 65 % .. note:: Accessories include for example lanyards, keyports and key covers that can be shipped together with YubiKeys. Accessories are currently not supported with subscription tiers, only with perpetual purchases. To add accessories to a shipment request, select the desired accessories from the **Physical products** section. 7. When done with the product selection, click **Continue**. 8. Click **Next: Confirm**, review the information in the **Shipment confirmation** dialog, and if satisfied click **Submit shipment request**. The new shipment request will appear in the **All shipments** page. .. _csv-col-headings-label: Shipment Request Form Fields ---------------------------- The table below provides descriptions of fields in the **New shipping request** form. Fields not marked as *Required* are optional. The **Limit** column displays the maximum number of alphanumeric characters permitted per field. You will be notified in the Console if the number of characters you enter in a field exceeds the limit. .. include:: includes/address-line-limits.rst .. table:: +--------------------------+-----------------------------------------------------------+------+ |Field Name |Description |Limit | +==========================+===========================================================+======+ || Reseller || Required. Even if the selling entity was Yubico |-- | || Reseller ID || (direct sale), the **Reseller** name must be selected. | | || || The **Reseller ID** is automatically populated. | | +--------------------------+-----------------------------------------------------------+------+ || First name || Name of recipient. Required if company name is not |15 | || || provided. Maps to the first line on the shipping label. | | +--------------------------+-----------------------------------------------------------+------+ || Last name || Recipient’s family name. Required if first name is |20 | || || provided. Maps to the first line on the shipping label. | | +--------------------------+-----------------------------------------------------------+------+ || Company || Required if name of recipient is not provided. Maps to |20 | || || the second line of the shipping label if the address is | | || || not residential. Do not provide a company name if | | || || shipping to a residential address. | | +--------------------------+-----------------------------------------------------------+------+ || Country || Required. Select a country from the list of destination |-- | || || countries that your organization is allowed to ship to. | | +--------------------------+-----------------------------------------------------------+------+ || Address 1 |Required. First line of address. |60 | +--------------------------+-----------------------------------------------------------+------+ || Address 2 || Required if address is undeliverable without, for |60 | || || example suite #. Field can be used to split addresses | | || || with long street names. | | +--------------------------+-----------------------------------------------------------+------+ |City |Required. City, town, or township. |60 | +--------------------------+-----------------------------------------------------------+------+ || Region/State || USPS codes are required for the US and Canada, see |-- | || || :ref:`usps-codes-us-ca-label`. Region/state is required | | || || for other countries if the address is undeliverable | | || || without it. | | +--------------------------+-----------------------------------------------------------+------+ || Postal code |Required. Zip code or postal code. |50 | +--------------------------+-----------------------------------------------------------+------+ || Phone || Required. Telephone number of shipment recipient. Any |40 | || || format is acceptable with or without spaces. Limit is | | || || 40 of the alphanumeric characters "0-9+-( )" unless | | || || the country code is IN, in which case the limit is 255. | | +--------------------------+-----------------------------------------------------------+------+ || Email address || Recipient’s email address. |80 | +--------------------------+-----------------------------------------------------------+------+ .. _LAAS-5623-label: Entering Shipping Information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. Note:: When creating shipment requests and selecting destination countries, you will only see countries that are enabled for your organization in the **Country** dropdown list. However, you can ship to all countries that are listed in the `YubiEnterprise Delivery pricing table <_static/YubiEnterprise-Delivery-Pricing-EXTERNAL.pdf>`_. To ship to other countries, contact `YubiEnterprise Delivery Support `_. For a successful delivery of your order, always ensure that the recipient information you provide is valid. The **Phone** field in the shipment request form is the telephone number of the shipment recipient, and is used by the carrier to complete the last stage of delivery. Ensure you submit a valid phone number to avoid the order being returned to the sender. Incomplete or incorrect address information might cause :ref:`validation errors `. For example, entering the following information for a shipment request would result in failure because USPS recognizes that there are multiple companies in the building whose address is 530 Lytton Avenue: .. code:: Jan Lindberg 530 Lytton Avenue Palo Alto, CA 94301 USA Similarly, entering the following information for a shipment request would result in failure because a residential address would not be associated with a company. .. code:: Jan Lindberg Yubico Inc. 6 Lea Rd Dronfield S18 1SB UK When adding address information, you can for example use the address formats provided by Google Maps, see note in :ref:`troubleshooting-label`. The limits on the various fields and the options for the dropdown are given in :ref:`csv-col-headings-label`. Verifying Shipment Status ------------------------- You can view the status of shipment requests on the **All shipments** page in the **Status** column. To ensure your shipping request is accepted for processing, always verify that it has not been flagged as *Incomplete* by the validation service. For more information on how to correct incomplete shipment requests, see :ref:`incompletes-label`. Editing and Deleting Shipment Requests ====================================== You can update an address or delete a shipment request until it is locked for processing and fulfillment. Editable shipment requests are shown with an **Edit** icon in the **Status** column in the list on the **All shipments** page. For more information, see :ref:`editing-shipment-label`. ------------------------------------- To file a support ticket for YubiEnterprise Delivery, click `Support `_.