.. 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 Customer Portal. To create shipments to *multiple* addresses, see :ref:`shipping-multiple-label`. For more information about shipments, see also :ref:`shipments-label` and :ref:`requesting-shipment-label`. Creating a Shipment =========================== To request shipping of keys to a *single recipient address*, use one of the following options: * Click **Create shipment** for the appropriate inventory in the :ref:`Delivery overview ` page. * Click the **Create shipment** button in the :ref:`Shipments ` page. Either of these actions opens the **Create shipment** page with a form for entering shipment information. .. image:: graphics/single-shipment-form1.png :width: 800 .. image:: graphics/single-shipment-form2.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 a **Customer reference** note (optional, max 50 characters) for internal reference, see :ref:`customer-reference`. 3. Enter the required **Recipient information**, either provide a company name or a recipient name, or both. 4. 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.), see :ref:`restrictions-label`. When shipping to countries without postal codes, enter "00000" in that field. .. include:: includes/address-line-limits.rst 5. 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. 6. Select the **Delivery Type**, Normal or Expedited. Your selection determines the shipping fee, which is calculated after you complete the shipping request. 7. 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 Customer Portal). Customization options are indicated by the associated Customization label in blue. .. 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. If available, accessories are listed in the **Perpetual inventory** section. 8. Click **Next: Confirm**, review the information in the **Shipment confirmation** dialog, and if satisfied click **Create shipment**. The new shipment request will appear in the **Shipments** page. .. _LAAS-5623-label: .. _csv-col-headings-label: Shipment Form Fields ---------------------------- For a successful delivery of your order, always ensure that the recipient information you provide is valid. For example, 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. The table below provides descriptions of fields in the **Create shipment** 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 Customer Portal 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. |40 | +--------------------------+-----------------------------------------------------------+------+ || Address 2 || Required if address is undeliverable without, for |40 | || || 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, Canada, and |-- | || || international US military bases, see | | || || :ref:`usps-codes-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 | +--------------------------+-----------------------------------------------------------+------+ .. Note:: When creating shipments 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 `Yubico Support `_. Verifying Shipment Status ------------------------- You can view the status of shipment requests on the **Shipments** page in the **Shipment 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 Shipments ====================================== 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 shipment** icon in the **Actions** column in the list on the **Shipments** page. For more information, see :ref:`editing-shipment-label`.