.. Requesting_Shipment.rst





.. _requesting-shipment-label:

====================
Requesting Shipment
====================

The methods of requesting shipment each have their own subsection; the information in this current section applies to all methods.

* :ref:`shipping-single-label`
* :ref:`shipping-multiple-label`
* :ref:`api-shipment-request`

If the address validation service catches a discrepancy between an address in a shipping request and post office standards, it will propose a change. Such requests are shown as "Incomplete" in the **Status** column of the Console, and they must be reviewed and the proposed change accepted or rejected before the request can be processed. Instructions for handling incompletes are given in `Reviewing Incompletes`_.


.. include:: /includes/channel-partners.rst

.. include:: includes/16-00hrsUTC.rst

.. include:: includes/limits+constraints.rst

.. include:: includes/name-constraints.rst

.. include:: includes/inventory-type.rst

.. include:: includes/init-buffer-repl.rst


For more details on subscription and non-subscription purchasing, see :ref:`modes-of-purchase`.


.. _incompletes-label:

Reviewing Incompletes
---------------------

The address validation service flags addresses that are problematic or defective in some way, and displays this information on the Console in the **Status** column on the **Dashboard** tab.  For a complete list of the different statuses and what they indicate, see :ref:`shipping-status-codes-label`. To ensure your shipping request is accepted and processed, always verify that it has not been flagged Incomplete.

:Step 1: On the **Shipments** tab, in the **Actions** menu next to the **Create shipping request** button, select **Review incompletes**. The list of shipping requests with incomplete addresses is displayed:

         .. image:: graphics/201857-review-incompletes-ok-copy.jpg

         *Review incomplete addresses*

:Step 2: To find out what is wrong with an address and/or correct it, click the Edit icon at the end of the row containing the item. See :ref:`editing-shipment-label`. The Edit shipment screen indicates the problem, as shown in the screenshot below, for example.

         .. image:: graphics/201857-undeliverable-name-ok.jpg

         *Error in name of recipient*

:Step 3: The address validation process stops at the first error it finds in a given request (or in the case of a CSV file, in a given row). In the screenshot above, it stopped at the name of the recipient, but the address in the example above would not be validated either. For this reason, continue to run the **Review Incompletes** activity until no more errors are found in your shipment request.



.. _editing-shipment-label:

Editing or Deleting a Shipment
------------------------------

You can update an address or delete a shipping request until it is locked for processing and fulfillment - see :ref:`timing-label`.

To delete shipment requests made via CSV file, see :ref:`del-mult-label`.

:Step 1: To edit a shipment, click the Edit icon in the appropriate row of the table. The **Edit shipment - <ID>** screen appears, as shown below.

         .. image:: graphics/edit-shipment-ok.png

         *Edit shipment screen*

:Step 2: Either make the required changes and click **Update** or click **Delete shipment**. The update function validates the fields, with a mouseover warning on any fields requiring input, as shown in the screenshot below:

         .. image:: graphics/please-fill-out-this-field.png

         *Mouseover warning*

:Step 3: Verify that the system is able to validate all the input in your shipment request by running the **Review Incompletes** activity (see :ref:`incompletes-label`).