# Create transfer order

This operation is used to create a inventory transfer request between two Wineshipping managed inventory locations. Successful execution of this operation will generate a new transfer order in Wineshipping system. A transaction reference identifier is returned in this operation. Store this identifier in your application and systems as applicable. This reference ID is available in the event a problem occurs with the associated request. 

Endpoint: POST /api/InventoryMovement/CreateTransferOrder
Version: 3.1.3
Security: Authentication

## Request fields (application/json):

  - `Authentication` (object, required)
    Credentials are required for all API operations.

  - `Authentication.UserKey` (string, required)
    Example: "C445598CB576468EA35FBB22C55584EF"

  - `Authentication.Password` (string, required)
    Example: "AF63FDAC1E704DC1AC9460F669ABF107"

  - `Authentication.CustomerNo` (string, required)
    Example: "10703"

  - `TransferInfo` (object)

  - `TransferInfo.CustomerReferenceNo` (string, required)

  - `TransferInfo.RequestedDate` (string, required)

  - `TransferInfo.TransferFromWarehouse` (string, required)
    See [warehouse locations](../../../../docs/codes/warehouselocations) for possible values.
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `TransferInfo.InventoryStatusCode` (string, required)
    Enum: "GOOD-NO-TX", "GOOD-ST-EX", "GOOD-ST-TX", "GOOD-ST-BD", "GOOD-ST-IM", "GOOD-LB-TX"

  - `TransferInfo.TransferToWarehouse` (string, required)
    See [warehouse locations](../../../../docs/codes/warehouselocations) for possible values.
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `TransferInfo.TransferToInventoryStatusCode` (string)
    (COMING SOON) will default to 'TransferFromInventoryStatusCode'
    Enum: "GOOD-NO-TX", "GOOD-ST-EX", "GOOD-ST-TX", "GOOD-ST-BD", "GOOD-ST-IM", "GOOD-LB-TX"

  - `TransferInfo.FirstName` (string, required)

  - `TransferInfo.LastName` (string, required)

  - `TransferInfo.PhoneNumber` (string, required)
    Example: "7079339063"

  - `TransferInfo.EmailAddress` (string, required)

  - `TransferInfo.SpecialInstruction` (string)

  - `ItemsInfo` (array)

  - `ItemsInfo.ItemNo` (string, required)
    Example: "1466-SE"

  - `ItemsInfo.ItemDescription` (string)
    Example: "2016 CAB SAUV RESERVE NAPA VALLEY"

  - `ItemsInfo.ItemQuantity` (integer)
    Example: 6

  - `ItemsInfo.QuantityUnit` (string)
    Specify whether an item quantity should be denominated in Retail (i.e., bottles) or Wholesale (i.e., cases) when creating an order. If set to Auto, the Order Type determines the default quantity, i.e., bottles for Retail and cases for Wholesale.
    Enum: "RETAIL", "WHOLESALE", "AUTO"

  - `ItemsInfo.InventoryTaxStatus` (string)
    Specify an inventory tax status when creating an order for wholesale, DTT, or DTW. Not relevant to DTC orders.
    Enum: "GOOD-LB-TX", "GOOD-NO-BD", "GOOD-NO-CB", "GOOD-NO-TX", "GOOD-ST-BD", "GOOD-ST-EX", "GOOD-ST-IM", "GOOD-ST-TX"

  - `ItemsInfo.UnitPrice` (number)
    Unit sale price charged to the consumer.