.. 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 use the Console 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 on the **Shipments** tab. The **New shipping request** form appears with the **SINGLE SHIPMENT** tab displayed by default. .. image:: graphics/ship-request-single-form1.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 succesful delivery, see :ref:`LAAS-5623-label`. 4. Select the **Delivery Type**, Normal or Expedited. Your selection determines the shipping fee, which is calculated after you complete the shipping request. 5. Under **Product selection**, click in the **Products** field to display available inventories. 6. Select one or more inventories to draw products from. .. image:: graphics/ship-request-single-product-selection.png :scale: 65 % 7. Select the desired products from each inventory. Note that inventory restrictions might apply, see :ref:`shippable-inventory-label`. For explanation of subscriptions, see :ref:`inventory-options-label`. .. image:: graphics/ship-request-single-product-quant.png :scale: 65 % 8. Click **Create shipment request**. The **Shipment Confirmation** popup appears. .. image:: graphics/shipment-confirmation.png :scale: 75% 9. Click **Confirm**. If all went well, you are notified that your request was accepted. The new shipment request will appear in the **Shipments** page. .. image:: graphics/request-accepted.png :scale: 75% .. _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. .. 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 #. | | +--------------------------+-----------------------------------------------------------+------+ |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 | +--------------------------+-----------------------------------------------------------+------+ Managing Long Recipient Names ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Long recipient or company names can be problematic because the shipment request will fail if the maximum number of permitted characters is exceeded for these fields. **Workaround:** When a recipient’s full name or company name exceeds the fields’ maximum lengths, split the names across the three fields, as in this example: .. table:: +--------------------+----------------------------+-----------------------+ |Field (limit=15) |Field (limit=20) |Field (limit=20) | +====================+============================+=======================+ |First name |Last name |Company | +--------------------+----------------------------+-----------------------+ |**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 | +--------------------+----------------------------+-----------------------+ .. _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 **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 a pencil icon in the list of **Shipments**. For more information, see :ref:`editing-shipment-label`. ------------------------------------- To file a support ticket for YubiEnterprise Delivery, click `Support `_.